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_1 on 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 coefficients fidelity: thrust and torque from measured CT and CP, inflow lag, Cheeseman–Bennett ground effect.

    • The bem fidelity: 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 as NavSatFix, MagneticField, FluidPressure and Temperature.

  • 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; the open_field world; 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 by tools/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 validate and 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

  • [x] Every v0.4 epic done or moved, with evidence above

  • [x] Release notes drafted

  • [x] 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

  • [x] Released: dev merged into main and tagged v0.4.0 on 2026-10-25 at the owner’s request (release-please could not run with GitHub Actions disabled)