Repository navigation
Lagrange v0.4.0: drones
Lagrange v0.4.0: drones (release notes)
v0.3 added arms and the electrical and thermal domains. v0.4 adds drones: rotors built from
their propellers' blades, wind and turbulence, GNSS, magnetometer and barometer, a sample
quadcopter that flies on its own power system, and PX4 and ArduPilot flying it in lockstep.
Status: released on 2026-10-25 as v0.4.0, at the owner's request.
Highlights
- Rotors.
RotorAPI_1on rotor joints, with the propeller's hand, its mount (puller or pusher) and
its propeller file (*.prop.yaml: blade chord, twist and sections from root to tip).- The
coefficientsfidelity: thrust and torque from measured CT and CP, inflow lag,
Cheeseman–Bennett ground effect. - The
bemfidelity: blade-element momentum on the propeller's geometry, in climb, descent,
forward flight and wind; turning the wrong way or mounted back to front, a propeller gives
what a real one gives. Checked against NACA Report 640's full-scale propeller, with nothing
fitted. Each propeller is tabulated once at load, so a step is a lookup. - Folding blades that hang folded when stopped and open as they spin up.
- Rotors are drawn as their blades in the viewer, spinning and folding.
- Aerodynamics and wind. Link drag (
AeroAPI_1) against a logarithmic mean wind with
Dryden turbulence; the wind reaches the rotors (env/wind/velocity). - Sensors. GNSS, magnetometer (World Magnetic Model 2025) and barometer (ICAO standard
atmosphere) on the site's geo origin, published on ROS 2 asNavSatFix,MagneticField,
FluidPressureandTemperature. - Autopilots. PX4 v1.17.0 SITL through its simulator MAVLink interface, and ArduPilot
Copter-4.7.2 through its JSON interface, both in lockstep (--mavlink px4|ardupilot). Both fly
a square mission, calm and in 8 m/s of gusty wind. - Electrical. Small fast motors at 50 µs; a low battery sags the bus and costs thrust.
- Samples.
quad_x500(URDF, overlay, USD) with generic 10-inch propellers matched to the
measured APC 10x4.7 SF; variants with folding blades and with motors under the arms
(pushers); two- and three-blade propellers; theopen_fieldworld; profiles for hover, gusty
wind and the blade-element fidelity. - Docs. The drone tutorial, from the quadcopter's files to a PX4 mission
(docs/guide/tutorial-drone.md, run bytools/ci/tutorial_drone.sh).
Acceptance (roadmap §5)
| Epic | Acceptance | Status | Evidence |
|---|---|---|---|
| Rotor aero | domains/aerodynamics.md §7 |
met, with owed items | test_rotor_aero (closed forms, ground effect, lag), test_bem: NACA Report 640 propeller 5868-9 within 8 % CT and 6 % CP over the attached-flow range, momentum theory, the classical H-force within 1 %; owed: small-propeller test data (the UIUC database states no licence), measured ground effect, stall delay |
| Aerodynamics and wind | Spectra and field tests | partly met | Dryden variances and correlation time (test_aerodynamics; the periodogram check of the spectrum is not done); field sampling (VDB) moves to v0.5 with the fields infrastructure |
| MAVLink bridge | Mission scenario in robot-classes.md §5 |
met | tools/ci/px4_mission.sh [--wind], tools/ci/ardupilot_mission.sh [--wind]: take-off, 10 m square at 5 m, landing; test_px4_lockstep, test_ardupilot_json |
| Sensors | Sensor tests | met | test_wmm (100 NOAA test points, worst 7e-4 nT), test_geo_sensors |
| ESC and battery at 50 µs | Coupling tests at J = 1e-5 kg·m² | met | test_coupling's DroneCoupling: within 2 % RMS of a 1 µs reference |
| Sample quadcopter and tutorial | Tutorial runs in CI with SITL in a container | partly met | The tutorial runs headless with both SITL steps on the development machine, and in the container image without them (podman run --rm lagrange:dev tools/ci/tutorial_drone.sh: hover, gusty wind and the site checked; PX4 and ArduPilot are not in the image, so their steps are left out) |
| Rebase in flight | huge-worlds.md §6 |
deferred | Needs the runtime rebase (C5), which the owner deferred to v0.7 |
Known issues
- Blade-element limits. No wake skew or blade flapping beyond the hub moment; no stall
delay, so a highly pitched propeller's thrust near static is under-predicted
(aerodynamics.md §7.1). - Dryden turbulence. MIL-HDBK-1797 equation numbers are marked TODO(verify) in the code.
- Viewer. Rotors at hundreds of rad/s are drawn at the frame rate, so the blades strobe.
- Start-up warnings.
lagrange validateand the Python API build a run before they apply a
profile, so they log that rotors and geo sensors need their site parameters even when the
profile gives them. - From v0.3: Jolt's drive-wheel slip, Nav2's occasional start-up discovery failure.
- Not run while GitHub Actions are disabled: the sanitizer builds and the nightly jobs.
Everything else was verified locally with colcon.
Release checklist
- Every v0.4 epic done or moved, with evidence above
- Release notes drafted
- Gated changes merged under the v0.4 mandate listed for review (
progress.md) - Owner review of those merges (the aerodynamics and geo sensor schemas,
RotorAPI_1's
propeller and mount) - GitHub Actions re-enabled and green on
dev - Released:
devmerged intomainand taggedv0.4.0on 2026-10-25 at the owner's request
(release-please could not run with GitHub Actions disabled)