Skip to content

Lagrange v0.4.0: drones

Choose a tag to compare

@Danendra10 Danendra10 released this 25 Oct 05:00
· 312 commits to dev since this release
dc3d4eb

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

  • 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: 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)