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.
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.
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.
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.
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.
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 profilesedan_city.yaml.
Docs.
The cars tutorial (
docs/guide/tutorial-cars.md, run bytools/ci/tutorial_cars.sh).The Autoware guide.
Acceptance (roadmap §7)¶
Epic |
Acceptance |
Status |
Evidence |
|---|---|---|---|
Vehicle dynamics |
|
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 ( |
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 ( |
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 ( |
Traffic |
|
partly met |
IDM equilibrium, light cycle, flowing traffic with no entry on red, pedestrians on their sidewalks, same seed same tracks ( |
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 ( |
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 ( |
Sample sedan, city block, tutorials |
Tutorials run in CI where no external stack is needed |
met, locally |
|
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 above
lagrange_core(with the Autoware messages underlay), 0 failures.
Release checklist¶
[x] Every v0.6 epic done, partly done or left out by the owner’s decision, with evidence above
[x] Release notes drafted
[x] 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[x] Released:
devmerged intomainand taggedv0.6.0on 2026-10-25 at the owner’s request (release-please could not run with GitHub Actions disabled)