# autonomousvision/carla_garage architecture

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

- Interactive diagram: https://gitdiagram.com/autonomousvision/carla_garage
- Repository: https://github.com/autonomousvision/carla_garage

## Overview

This repository is a CARLA autonomous-driving starter kit and leaderboard benchmark stack. Users configure routes and an agent, run closed-loop simulation against scenarios, and collect evaluation results; the expert-driving and data-collection code also supports dataset generation. The README documents separate leaderboard variants for ordinary evaluation, privileged data collection, and short Bench2Drive routes. Several implementation relationships below are documented rather than source-verified because the corresponding files were not sampled.

Main entry points: [`leaderboard/leaderboard/scenarios/scenario_manager.py`](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/scenarios/scenario_manager.py) (Route manager), [`leaderboard/leaderboard/leaderboard_evaluator.py`](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/leaderboard_evaluator.py) (Leaderboard evaluator), [`scenario_runner/srunner/scenariomanager/scenario_manager.py`](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/scenario_runner/srunner/scenariomanager/scenario_manager.py) (Scenario manager), [`leaderboard/leaderboard/utils/statistics_manager.py`](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/utils/statistics_manager.py) (Leaderboard statistics)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_evaluation["Evaluation"]
  node_routes["Route configuration<br/>[route_parser.py]"]
  node_evaluator["Leaderboard evaluator"]
  node_route_scenario["Route scenarios<br/>[route_scenario.py]"]
  node_leaderboard_manager["Route manager"]
  node_agent_wrapper["Agent wrapper<br/>[agent_wrapper.py]"]
  node_sensor_interface["Sensor interface"]
end

subgraph group_simulation["Simulation"]
  node_scenario_runner["Scenario runner<br/>[scenario_runner.py]"]
  node_scenario_manager["Scenario manager"]
  node_scenario_behaviors["Scenario behaviors"]
end

subgraph group_driving["Driving Agents"]
  node_autonomous_agent["Agent interface"]
  node_expert_driver["Privileged expert<br/>[autopilot.py]"]
  node_birdview["Bird’s-eye observations<br/>[obs_manager.py]"]
  node_controllers["Driving controllers"]
end

subgraph group_data["Data and Analysis"]
  node_data_collection["Data collection<br/>[data_collect.py]"]
  node_metrics["Scenario metrics<br/>[metrics_manager.py]"]
  node_statistics["Leaderboard statistics"]
  node_checkpoint["Checkpoint I/O"]
  node_results["Result output<br/>[result_writer.py]"]
end

node_user(("Benchmark user"))
node_carla["CARLA simulator"]

node_user -->|"runs evaluation"| node_evaluator
node_user -->|"selects routes"| node_routes
node_evaluator -.->|"evaluates routes"| node_route_scenario
node_evaluator -.->|"manages route run"| node_leaderboard_manager
node_leaderboard_manager -->|"invokes agent"| node_agent_wrapper
node_leaderboard_manager -->|"reads sensor data"| node_sensor_interface
node_scenario_runner -.->|"runs scenarios"| node_scenario_manager
node_scenario_manager -.->|"ticks behavior tree"| node_scenario_behaviors
node_scenario_manager -.->|"advances simulation"| node_carla
node_sensor_interface -.->|"receives measurements"| node_carla
node_agent_wrapper -->|"delegates control"| node_autonomous_agent
node_autonomous_agent -.->|"consumes observations"| node_sensor_interface
node_expert_driver -.->|"uses observations"| node_birdview
node_expert_driver -.->|"computes controls"| node_controllers
node_user -->|"collects dataset"| node_data_collection
node_data_collection -->|"uses expert driver"| node_expert_driver
node_scenario_runner -->|"reports metrics"| node_metrics
node_leaderboard_manager -.->|"records outcomes"| node_statistics
node_statistics -->|"loads checkpoint"| node_checkpoint
node_statistics -.->|"writes results"| node_results

click node_routes "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/utils/route_parser.py"
click node_evaluator "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/leaderboard_evaluator.py"
click node_route_scenario "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/scenarios/route_scenario.py"
click node_leaderboard_manager "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/scenarios/scenario_manager.py"
click node_agent_wrapper "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/autoagents/agent_wrapper.py"
click node_scenario_runner "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/scenario_runner/scenario_runner.py"
click node_scenario_manager "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/scenario_runner/srunner/scenariomanager/scenario_manager.py"
click node_scenario_behaviors "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/scenario_runner/srunner/scenariomanager/scenarioatomics/atomic_behaviors.py"
click node_sensor_interface "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/envs/sensor_interface.py"
click node_autonomous_agent "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/autoagents/autonomous_agent.py"
click node_expert_driver "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/team_code/autopilot.py"
click node_birdview "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/team_code/birds_eye_view/obs_manager.py"
click node_controllers "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/team_code/lateral_controller.py"
click node_data_collection "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/Bench2Drive/tools/data_collect.py"
click node_metrics "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/scenario_runner/metrics_manager.py"
click node_statistics "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/utils/statistics_manager.py"
click node_checkpoint "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/utils/checkpoint_tools.py"
click node_results "https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/utils/result_writer.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_routes,node_evaluator,node_route_scenario,node_leaderboard_manager,node_agent_wrapper,node_sensor_interface,node_user toneBlue
class node_scenario_runner,node_scenario_manager,node_scenario_behaviors toneAmber
class node_autonomous_agent,node_expert_driver,node_birdview,node_controllers toneMint
class node_data_collection,node_metrics,node_statistics,node_checkpoint,node_results toneRose
class node_carla toneIndigo
```

## Components

### Evaluation

- [Route configuration](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/utils/route_parser.py): `leaderboard/leaderboard/utils/route_parser.py`
- [Leaderboard evaluator](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/leaderboard_evaluator.py): `leaderboard/leaderboard/leaderboard_evaluator.py`
- [Route scenarios](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/scenarios/route_scenario.py): `leaderboard/leaderboard/scenarios/route_scenario.py`
- [Route manager](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/scenarios/scenario_manager.py): `leaderboard/leaderboard/scenarios/scenario_manager.py`
- [Agent wrapper](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/autoagents/agent_wrapper.py): `leaderboard/leaderboard/autoagents/agent_wrapper.py`
- [Sensor interface](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/envs/sensor_interface.py): `leaderboard/leaderboard/envs/sensor_interface.py`

### Simulation

- [Scenario runner](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/scenario_runner/scenario_runner.py): `scenario_runner/scenario_runner.py`
- [Scenario manager](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/scenario_runner/srunner/scenariomanager/scenario_manager.py): `scenario_runner/srunner/scenariomanager/scenario_manager.py`
- [Scenario behaviors](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/scenario_runner/srunner/scenariomanager/scenarioatomics/atomic_behaviors.py): `scenario_runner/srunner/scenariomanager/scenarioatomics/atomic_behaviors.py`

### Driving Agents

- [Agent interface](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/autoagents/autonomous_agent.py): `leaderboard/leaderboard/autoagents/autonomous_agent.py`
- [Privileged expert](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/team_code/autopilot.py): `team_code/autopilot.py`
- [Bird’s-eye observations](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/team_code/birds_eye_view/obs_manager.py): `team_code/birds_eye_view/obs_manager.py`
- [Driving controllers](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/team_code/lateral_controller.py): `team_code/lateral_controller.py`

### Data and Analysis

- [Data collection](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/Bench2Drive/tools/data_collect.py): `Bench2Drive/tools/data_collect.py`
- [Scenario metrics](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/scenario_runner/metrics_manager.py): `scenario_runner/metrics_manager.py`
- [Leaderboard statistics](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/utils/statistics_manager.py): `leaderboard/leaderboard/utils/statistics_manager.py`
- [Checkpoint I/O](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/utils/checkpoint_tools.py): `leaderboard/leaderboard/utils/checkpoint_tools.py`
- [Result output](https://github.com/autonomousvision/carla_garage/blob/leaderboard_2/leaderboard/leaderboard/utils/result_writer.py): `leaderboard/leaderboard/utils/result_writer.py`

### Other components

- **Benchmark user**
- **CARLA simulator**

## Connections

- Benchmark user → Leaderboard evaluator: runs evaluation (evidence: `README.md`)
- Benchmark user → Route configuration: selects routes (evidence: `README.md`)
- Leaderboard evaluator → Route scenarios: evaluates routes
- Leaderboard evaluator → Route manager: manages route run
- Route manager → Agent wrapper: invokes agent (evidence: `leaderboard/leaderboard/scenarios/scenario_manager.py`)
- Route manager → Sensor interface: reads sensor data (evidence: `leaderboard/leaderboard/scenarios/scenario_manager.py`)
- Scenario runner → Scenario manager: runs scenarios
- Scenario manager → Scenario behaviors: ticks behavior tree
- Scenario manager → CARLA simulator: advances simulation
- Sensor interface → CARLA simulator: receives measurements
- Agent wrapper → Agent interface: delegates control (evidence: `leaderboard/leaderboard/autoagents/agent_wrapper.py`)
- Agent interface → Sensor interface: consumes observations
- Privileged expert → Bird’s-eye observations: uses observations
- Privileged expert → Driving controllers: computes controls
- Benchmark user → Data collection: collects dataset (evidence: `README.md`)
- Data collection → Privileged expert: uses expert driver (evidence: `README.md`)
- Scenario runner → Scenario metrics: reports metrics
- Route manager → Leaderboard statistics: records outcomes
- Leaderboard statistics → Checkpoint I/O: loads checkpoint (evidence: `leaderboard/leaderboard/utils/statistics_manager.py`)
- Leaderboard statistics → Result output: writes results
