Skip to content

Autoware CARLA Scenario

Welcome to the documentation for autoware-carla-scenario, a CARLA scenario testing framework for Autoware autonomous driving software.

Overview

This package provides a framework for creating and running automated scenario tests in the CARLA simulator, designed for validating Autoware's autonomous driving capabilities.

Features

  • Automated scenario execution in CARLA simulator (UE5: 0.10.0 and ue5-dev), through the statically typed typesafe_carla client
  • Configurable scenarios using Hydra compose + structured configs
  • Glob-pattern batch execution of multiple scenarios in a single CARLA session
  • Condition-based scenario evaluation: timing, collisions, traffic signals, speed / standstill, lane / area position, waypoint crossing, plus logical (And / Or / Not), latching (Sticky), and persistent combinators
  • Action system for side effects: turns, lane changes, traffic-light state, speed and routing, spawning and despawning, adversarial NPCs and pedestrians
  • Entity management for ego (EgoVehicle) and NPC vehicles with spawn retry and ground projection
  • Coordinate transforms between Lanelet2, OpenDRIVE, and CARLA world
  • Lanelet-based constraint sweeping via a Hydra lanelet_constraint sweeper plugin (also resolvable without CARLA from the viewer)
  • Web UI (FastAPI + Uvicorn) for browsing results and triggering runs
  • A trajectory log of every run (actors, lights, map, plan, conditions, verdict; JSON Schema published), which a Rerun recording is made from to see the run (Seeing a run), beside CARLA's native recording
  • scenario-setup downloads CARLA's nightly build, which the runner then launches by itself
  • pytest integration via CarlaScenarioFixture (auto-skip when no CARLA server answers and there is none to launch)

Project Information

Getting Help

If you encounter any issues or have questions:

  1. Check the documentation sections above
  2. Search existing GitHub Issues
  3. Create a new issue if your problem hasn't been reported