# autowarefoundation/autoware_universe architecture

> Architecture diagram of the GitHub repository autowarefoundation/autoware_universe, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-01). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/autowarefoundation/autoware_universe
- Repository: https://github.com/autowarefoundation/autoware_universe

## Overview

Autoware Universe is a large collection of packages extending autonomous-driving capabilities, rather than one executable application. Its product areas include control, perception, planning, localization, sensing, simulation, and system management. The visible control workflow accepts joystick input and runs a trajectory-follower node that selects lateral and longitudinal controllers; other shown components provide independent perception, planning, and operational capabilities. Edges are limited to relationships evidenced by the excerpts or SOURCE INDEX; unsampled subsystems are represented without speculative connections.

Main entry points: [`control/autoware_trajectory_follower_node/src/controller_node.cpp`](https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_trajectory_follower_node/src/controller_node.cpp) (Trajectory Follower), [`simulator/autoware_carla_interface/src/autoware_carla_interface/modules/ros_publisher_manager.py`](https://github.com/autowarefoundation/autoware_universe/blob/main/simulator/autoware_carla_interface/src/autoware_carla_interface/modules/ros_publisher_manager.py) (CARLA ROS Publishers), [`control/autoware_joy_controller/src/joy_controller_node.cpp`](https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_joy_controller/src/joy_controller_node.cpp) (Joystick Control), [`control/autoware_mpc_lateral_controller/src/mpc_lateral_controller.cpp`](https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_mpc_lateral_controller/src/mpc_lateral_controller.cpp) (MPC Lateral)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_control["Vehicle Control"]
  node_joy["Joystick Control"]
  node_follower["Trajectory Follower"]
  node_mpc["MPC Lateral"]
  node_pid["PID Longitudinal"]
  node_pursuit["Pure Pursuit"]
end

subgraph group_planning["Planning"]
  node_goalplanner["Goal Planner<br/>[manager.cpp]"]
  node_intersection["Intersection Velocity Planner<br/>[manager.cpp]"]
  node_turnindicator["Turn Indicator Postprocessing"]
end

subgraph group_perception["Perception And Sensing"]
  node_trackerinput["Tracker Input<br/>[input_manager.cpp]"]
  node_bevpreprocess["BEV Image Preprocessing"]
  node_bevinference["BEVFormer Inference"]
  node_pointcloud["Pointcloud Concatenation"]
end

subgraph group_localization["Localization"]
  node_landmarks["Landmark Manager"]
end

subgraph group_operations["System And Simulation"]
  node_drivingmode["Driving Mode Manager"]
  node_mrmreset["MRM Reset Manager"]
  node_latencymonitor["Pipeline Latency Monitor"]
  node_carlasensors["CARLA Sensor Manager<br/>[sensor_manager.py]"]
  node_carlapublishers["CARLA ROS Publishers"]
end

subgraph group_common["Common Components"]
  node_boundary["Boundary Departure Check"]
end

node_operator(("Operator"))

node_operator -->|"sends input"| node_joy
node_follower -->|"selects controller"| node_mpc
node_follower -->|"selects controller"| node_pid
node_follower -->|"selects controller"| node_pursuit
node_carlapublishers -->|"references module"| node_carlasensors

click node_joy "https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_joy_controller/src/joy_controller_node.cpp"
click node_follower "https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_trajectory_follower_node/src/controller_node.cpp"
click node_mpc "https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_mpc_lateral_controller/src/mpc_lateral_controller.cpp"
click node_pid "https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_pid_longitudinal_controller/src/pid_longitudinal_controller.cpp"
click node_pursuit "https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_pure_pursuit/src/autoware_pure_pursuit/autoware_pure_pursuit_lateral_controller.cpp"
click node_boundary "https://github.com/autowarefoundation/autoware_universe/blob/main/common/autoware_boundary_departure_checker/src/uncrossable_boundary_checker.cpp"
click node_goalplanner "https://github.com/autowarefoundation/autoware_universe/blob/main/planning/behavior_path_planner/autoware_behavior_path_goal_planner_module/src/manager.cpp"
click node_intersection "https://github.com/autowarefoundation/autoware_universe/blob/main/planning/behavior_velocity_planner/autoware_behavior_velocity_intersection_module/src/manager.cpp"
click node_turnindicator "https://github.com/autowarefoundation/autoware_universe/blob/main/planning/autoware_diffusion_planner/src/postprocessing/turn_indicator_manager.cpp"
click node_trackerinput "https://github.com/autowarefoundation/autoware_universe/blob/main/perception/autoware_multi_object_tracker/src/processor/input_manager.cpp"
click node_bevpreprocess "https://github.com/autowarefoundation/autoware_universe/blob/main/perception/autoware_tensorrt_bevformer/src/preprocessing/preprocessing_pipeline.cpp"
click node_bevinference "https://github.com/autowarefoundation/autoware_universe/blob/main/perception/autoware_tensorrt_bevformer/src/bevformer_inference_engine.cpp"
click node_pointcloud "https://github.com/autowarefoundation/autoware_universe/blob/main/sensing/autoware_pointcloud_preprocessor/include/autoware/pointcloud_preprocessor/concatenate_data/concatenation_info_manager.hpp"
click node_landmarks "https://github.com/autowarefoundation/autoware_universe/blob/main/localization/autoware_landmark_based_localizer/autoware_landmark_manager/src/landmark_manager.cpp"
click node_drivingmode "https://github.com/autowarefoundation/autoware_universe/blob/main/system/autoware_driving_mode_manager/src/driving_mode_manager.cpp"
click node_mrmreset "https://github.com/autowarefoundation/autoware_universe/blob/main/system/autoware_mrm_reset_manager/src/mrm_reset_manager/mrm_reset_manager.cpp"
click node_latencymonitor "https://github.com/autowarefoundation/autoware_universe/blob/main/system/autoware_pipeline_latency_monitor/src/pipeline_latency_monitor_node.cpp"
click node_carlasensors "https://github.com/autowarefoundation/autoware_universe/blob/main/simulator/autoware_carla_interface/src/autoware_carla_interface/modules/sensor_manager.py"
click node_carlapublishers "https://github.com/autowarefoundation/autoware_universe/blob/main/simulator/autoware_carla_interface/src/autoware_carla_interface/modules/ros_publisher_manager.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_joy,node_follower,node_mpc,node_pid,node_pursuit toneBlue
class node_goalplanner,node_intersection,node_turnindicator toneAmber
class node_trackerinput,node_bevpreprocess,node_bevinference,node_pointcloud toneMint
class node_landmarks toneRose
class node_drivingmode,node_mrmreset,node_latencymonitor,node_carlasensors,node_carlapublishers,node_operator toneIndigo
class node_boundary toneTeal
```

## Components

### Vehicle Control

- [Joystick Control](https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_joy_controller/src/joy_controller_node.cpp): `control/autoware_joy_controller/src/joy_controller_node.cpp`
- [Trajectory Follower](https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_trajectory_follower_node/src/controller_node.cpp): `control/autoware_trajectory_follower_node/src/controller_node.cpp`
- [MPC Lateral](https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_mpc_lateral_controller/src/mpc_lateral_controller.cpp): `control/autoware_mpc_lateral_controller/src/mpc_lateral_controller.cpp`
- [PID Longitudinal](https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_pid_longitudinal_controller/src/pid_longitudinal_controller.cpp): `control/autoware_pid_longitudinal_controller/src/pid_longitudinal_controller.cpp`
- [Pure Pursuit](https://github.com/autowarefoundation/autoware_universe/blob/main/control/autoware_pure_pursuit/src/autoware_pure_pursuit/autoware_pure_pursuit_lateral_controller.cpp): `control/autoware_pure_pursuit/src/autoware_pure_pursuit/autoware_pure_pursuit_lateral_controller.cpp`

### Planning

- [Goal Planner](https://github.com/autowarefoundation/autoware_universe/blob/main/planning/behavior_path_planner/autoware_behavior_path_goal_planner_module/src/manager.cpp): `planning/behavior_path_planner/autoware_behavior_path_goal_planner_module/src/manager.cpp`
- [Intersection Velocity Planner](https://github.com/autowarefoundation/autoware_universe/blob/main/planning/behavior_velocity_planner/autoware_behavior_velocity_intersection_module/src/manager.cpp): `planning/behavior_velocity_planner/autoware_behavior_velocity_intersection_module/src/manager.cpp`
- [Turn Indicator Postprocessing](https://github.com/autowarefoundation/autoware_universe/blob/main/planning/autoware_diffusion_planner/src/postprocessing/turn_indicator_manager.cpp): `planning/autoware_diffusion_planner/src/postprocessing/turn_indicator_manager.cpp`

### Perception And Sensing

- [Tracker Input](https://github.com/autowarefoundation/autoware_universe/blob/main/perception/autoware_multi_object_tracker/src/processor/input_manager.cpp): `perception/autoware_multi_object_tracker/src/processor/input_manager.cpp`
- [BEV Image Preprocessing](https://github.com/autowarefoundation/autoware_universe/blob/main/perception/autoware_tensorrt_bevformer/src/preprocessing/preprocessing_pipeline.cpp): `perception/autoware_tensorrt_bevformer/src/preprocessing/preprocessing_pipeline.cpp`
- [BEVFormer Inference](https://github.com/autowarefoundation/autoware_universe/blob/main/perception/autoware_tensorrt_bevformer/src/bevformer_inference_engine.cpp): `perception/autoware_tensorrt_bevformer/src/bevformer_inference_engine.cpp`
- [Pointcloud Concatenation](https://github.com/autowarefoundation/autoware_universe/blob/main/sensing/autoware_pointcloud_preprocessor/include/autoware/pointcloud_preprocessor/concatenate_data/concatenation_info_manager.hpp): `sensing/autoware_pointcloud_preprocessor/include/autoware/pointcloud_preprocessor/concatenate_data/concatenation_info_manager.hpp`

### Localization

- [Landmark Manager](https://github.com/autowarefoundation/autoware_universe/blob/main/localization/autoware_landmark_based_localizer/autoware_landmark_manager/src/landmark_manager.cpp): `localization/autoware_landmark_based_localizer/autoware_landmark_manager/src/landmark_manager.cpp`

### System And Simulation

- [Driving Mode Manager](https://github.com/autowarefoundation/autoware_universe/blob/main/system/autoware_driving_mode_manager/src/driving_mode_manager.cpp): `system/autoware_driving_mode_manager/src/driving_mode_manager.cpp`
- [MRM Reset Manager](https://github.com/autowarefoundation/autoware_universe/blob/main/system/autoware_mrm_reset_manager/src/mrm_reset_manager/mrm_reset_manager.cpp): `system/autoware_mrm_reset_manager/src/mrm_reset_manager/mrm_reset_manager.cpp`
- [Pipeline Latency Monitor](https://github.com/autowarefoundation/autoware_universe/blob/main/system/autoware_pipeline_latency_monitor/src/pipeline_latency_monitor_node.cpp): `system/autoware_pipeline_latency_monitor/src/pipeline_latency_monitor_node.cpp`
- [CARLA Sensor Manager](https://github.com/autowarefoundation/autoware_universe/blob/main/simulator/autoware_carla_interface/src/autoware_carla_interface/modules/sensor_manager.py): `simulator/autoware_carla_interface/src/autoware_carla_interface/modules/sensor_manager.py`
- [CARLA ROS Publishers](https://github.com/autowarefoundation/autoware_universe/blob/main/simulator/autoware_carla_interface/src/autoware_carla_interface/modules/ros_publisher_manager.py): `simulator/autoware_carla_interface/src/autoware_carla_interface/modules/ros_publisher_manager.py`

### Common Components

- [Boundary Departure Check](https://github.com/autowarefoundation/autoware_universe/blob/main/common/autoware_boundary_departure_checker/src/uncrossable_boundary_checker.cpp): `common/autoware_boundary_departure_checker/src/uncrossable_boundary_checker.cpp`

### Other components

- **Operator**

## Connections

- Operator → Joystick Control: sends input (evidence: `control/autoware_joy_controller/src/joy_controller_node.cpp`)
- Trajectory Follower → MPC Lateral: selects controller (evidence: `control/autoware_trajectory_follower_node/src/controller_node.cpp`)
- Trajectory Follower → PID Longitudinal: selects controller (evidence: `control/autoware_trajectory_follower_node/src/controller_node.cpp`)
- Trajectory Follower → Pure Pursuit: selects controller (evidence: `control/autoware_trajectory_follower_node/src/controller_node.cpp`)
- CARLA ROS Publishers → CARLA Sensor Manager: references module (evidence: `simulator/autoware_carla_interface/src/autoware_carla_interface/modules/ros_publisher_manager.py`)
