Repository navigation
Lagrange v0.6.0: cars and autonomous cars
Lagrange v0.6.0: cars and autonomous cars (release notes)
v0.5 added the world around the robot. v0.6 adds road vehicles and the world they drive in:
- cars with tyres, suspension, brakes, steering and a powertrain;
- road networks from OpenDRIVE, with traffic and pedestrians on them;
- OpenSCENARIO scenarios;
- the sensors of an automated car: radar and a camera sensor model;
- interfaces for autonomy stacks, Autoware's included.
Status: released on 2026-10-25 as v0.6.0, at the owner's request.
Highlights
- Vehicle dynamics (
lagrange_vehicle_dynamics, domains/vehicle_dynamics.md §8).- A raycast vehicle on top of either physics backend, at 1 ms.
- Suspension preloaded at the ride height, with anti-roll bars.
- MF-Tyre 5.2 tyres from
.tirfiles (pure and combined slip), or linear tyres, with
relaxation lengths. - Brakes with bias and ABS. Ackermann steering with a rate limit and lag.
- Electric or engine-map powertrains with an automatic gearbox.
- The
idealsubstitute, a kinematic bicycle.
- Road networks (
lagrange_opendrive, formats.md §3.11).- Its own OpenDRIVE reader: lines, arcs, spirals, cubic polynomials, elevation, lane sections
and offsets, marks, links and junctions. lagrange_opendrive_importwrites road surfaces, road marks andRoadLaneAPI_1lanes.
- Its own OpenDRIVE reader: lines, arcs, spirals, cubic polynomials, elevation, lane sections
- Traffic (
lagrange_traffic, domains/traffic.md §8).- Kinematic agents, moved by MuJoCo as mocap bodies and by Jolt as kinematic bodies.
- IDM cars on the lanes, fixed-cycle lights, first-come right of way at junctions.
- Social-force pedestrians on the sidewalks.
--traffic vehicles=N,pedestrians=M,seed=S; thezerosubstitute.
- Scenarios (
lagrange_openscenario, traffic.md §8.1).- Its own runner for a subset of OpenSCENARIO 1.x: parameters, entities, Init, speed and
lane-change actions, and time, position, distance, speed and travelled conditions. --scenario FILE.xosc: the scenario's roads are the world unless--worldis given.
- Its own runner for a subset of OpenSCENARIO 1.x: parameters, entities, Init, speed and
- Sensors (domains/sensors.md §2).
- Radar by ray launching (
RadarAPI_1): echoes from the bodies' radar cross-section density,
one detection per object and range cell, Doppler, SNR by the radar equation. - The camera's sensor model: lens distortion (plumb_bob, equidistant), vignetting, a
rotational rolling shutter, exposure with shot and read noise, and auto exposure.
camera_infocarries the lens.
- Radar by ray launching (
- Driving a car over ROS 2.
/ackermann_cmd(steering angle and speed) for any road
vehicle, beside/cmd_vel. - Autoware (
lagrange_autoware, docs/guide/autoware.md).- A vehicle interface: Autoware's control, gear and indicator commands and its control-mode
request in; velocity, steering, gear and control-mode reports and a ground-truth kinematic
state out. - It builds only when the Autoware messages are found, since
autoware_vehicle_msgshas no
Lyrical binary.
- A vehicle interface: Autoware's control, gear and indicator commands and its control-mode
- Schemas.
- New libraries:
vehicle(VehicleAPI_1,WheelAPI_1) androad(RoadLaneAPI_1). - New:
RadarAPI_1. CameraSensorAPI_1gainselectronRateandvignetting.- Robots are named by their top prim, and kinematic bodies are part of the world tables.
- New libraries:
- Samples.
- The sedan: a URDF, with a USD layer for its vehicle schemas, radar and camera model.
- The city block: buildings, and OpenDRIVE roads written by
city_block_xodr.py. - The tyre file
generic_205_55R16.tir, the scenariocut_in.xosc, and the profile
sedan_city.yaml.
- Docs.
- The cars tutorial (
docs/guide/tutorial-cars.md, run bytools/ci/tutorial_cars.sh). - The Autoware guide.
- The cars tutorial (
Acceptance (roadmap §7)
| Epic | Acceptance | Status | Evidence |
|---|---|---|---|
| Vehicle dynamics | domains/vehicle_dynamics.md §7 |
partly met | Braking from 20 m/s within 5 % of v²/(2μg) (3.2 %), steady-state yaw rate within 3 % of the linear bicycle model (1.4 %), gear shifting, ride height (test_vehicle_dynamics); the Magic Formula's peak, slope and asymptote exact (test_tyre). Owed: a published MF parameter set (no openly licensed one found), the ISO manoeuvres, sloped ground, sim-vs-real |
| PhysX backend | Backend-agreement tests | not done | Left out by the owner's v0.6 decision (no new external engines). Vehicles run on MuJoCo and Jolt |
| OpenDRIVE | Alignment tests | met | Geometry of each road type against closed forms, lanes meeting end to start through links and junctions (test_opendrive). Owed: superelevation, lane heights, objects and signals |
| OpenSCENARIO | Conformance subset | partly met | The sample cut-in runs to its stop trigger with its events at the times and places its triggers say (test_openscenario, and in the server). Not built: esmini (the owner's decision), catalogs, the ASAM example scenarios |
| Traffic | domains/traffic.md §7 |
partly met | IDM equilibrium, light cycle, flowing traffic with no entry on red, pedestrians on their sidewalks, same seed same tracks (test_traffic). Not built: SUMO (the owner's decision). Owed: the pedestrian fundamental diagram |
| Tier 2 sensors | Tier-agreement and camera tests; RTF metric | partly met | Radar: a plate's RCS within 3 %, Doppler, the detection range by the radar equation (test_radar). Camera model: OpenCV's lens formulas, the photon-transfer variance within 3 % (EMVA 1288), cos⁴θ, rolling-shutter skew, auto exposure (test_camera_model). Both run on the CPU on every tier; hardware ray-query versions and an RTF metric are owed |
| Zero-copy ROS output | Copy-count measurement | not done | Owed |
| Autoware bridge | Demo or documented fallback | met (fallback) | The interface tested against a stand-in for Autoware and the simulator (test_autoware_interface); the documented fallback in docs/guide/autoware.md. Autoware itself is not released for Lyrical and was not run |
| Sample sedan, city block, tutorials | Tutorials run in CI where no external stack is needed | met, locally | tools/ci/tutorial_cars.sh runs every step; it passes locally (GitHub Actions are disabled) |
Known issues
- Not built, by the owner's v0.6 decision: the PhysX backend, SUMO co-simulation and esmini.
- Traffic: the lights are not drawn, pedestrians do not cross roads, no lane changes or
priority rules. - Radar: no rain attenuation, multipath or ghosts. Ground-plane echoes are dropped as
clutter. - Camera: no motion blur, no absolute light level (the scene's brightness is the camera's
electronRate), no colour filter array. SDFormat's<distortion>and<noise>are not
imported. - Autoware: the
/sensing/...remaps in the launch file follow Autoware's sample sensor kit
and need checking against the kit in use. - Scenarios: editing the scene after a scenario has ended logs its end a second time.
- From earlier releases: Jolt's drive-wheel slip, Nav2's occasional start-up discovery failure,
rotor strobing in the viewer. - Not run while GitHub Actions are disabled: the sanitizer builds and the nightly jobs.
Everything else was verified locally with colcon: 882 tests abovelagrange_core(with the
Autoware messages underlay), 0 failures.
Release checklist
- Every v0.6 epic done, partly done or left out by the owner's decision, with evidence above
- Release notes drafted
- Gated changes merged under the v0.6 mandate listed for review (
progress.md) - Owner review of those merges (the vehicle, road, radar and camera schema changes)
- GitHub Actions re-enabled and green on
dev - Released:
devmerged intomainand taggedv0.6.0on 2026-10-25 at the owner's request
(release-please could not run with GitHub Actions disabled)