Physics reference¶
How Lagrange computes each number, in plain words, with the main equations and how far the result can be trusted. Each page links to its domain’s design document, which holds the full derivation, every constant and the signal listings.
One step of a run¶
Every model is a module on the signal bus. The scheduler runs each at its own step and passes values between them only as signals with units:
flowchart LR
subgraph fast ["50–100 µs"]
E["Electrical<br/>battery, bus, motor currents"]
end
subgraph mid ["1 ms"]
RA["Rotor aero<br/>thrust, torque"]
RB["Rigid body<br/>MuJoCo or Jolt"]
end
subgraph slow ["50–100 ms"]
W["Weather"]
T["Thermal"]
end
AE["Aerodynamics<br/>drag, wind, downwash"]
E -->|"joint torque"| RB
RB -->|"joint speed"| E
RB -->|"rotor speed, pose"| RA
RA -->|"thrust, drag torque"| RB
RA -->|"thrust, induced velocity"| AE
AE -->|"air at each rotor,<br/>force on links"| RA
AE --> RB
W -->|"air density, friction"| RA
E -->|"copper loss"| T
T -->|"winding temperature"| E
A value written by a slower or later module is read at its last update, so there is no loop inside one step. See Concepts for the scheduler and substitutes.
Every model¶
Page |
What it computes |
|---|---|
MuJoCo and Jolt: joints with damping, friction and mimic, contacts and friction, mesh colliders as hulls, contact force and joint reaction |
|
A car’s suspension, Magic Formula tyres, brakes, steering and powertrain; the diff-drive and swerve controllers |
|
Buoyancy, drag, currents, waves, added mass and Fossen’s model with a real vehicle’s coefficients |
|
Thrust and torque of each propeller: coefficients or blade elements, ground and ceiling effect, vortex ring state |
|
The air a drone pushes: the jet under it, the outwash on the ground, walls and roofs, the live lattice Boltzmann box |
|
Drag on links, the wind and its gusts, wind fields, rain pushing links; the wind tunnel and OpenFOAM |
|
Motor currents and torque from the bus voltage: the dq-frame model and its current loops |
|
Terminal voltage and state of charge: the equivalent circuit, and how it compares with a real cell |
|
The buses, converters, fuses, switches and diodes between them, loads, and circuits from a netlist |
|
Lumped heat networks: copper and drive losses, heating, cooling, derating |
|
Lidar, camera, thermal camera, radar, IMU, GNSS, magnetometer, barometer, and sensor delays |
|
Air density, fog, rain, snow and dust extinction, wet and icy friction, dirty lenses, fields |
|
Fields of power lines and motors and what they do to sensors; radio link budgets and CAN errors |
|
Cars following lanes and lights, lane changes, crossings, pedestrians, OpenSCENARIO |
|
People as moving capsules: walking with planted feet, steering round robots and each other |
|
A cable from a winch to a drone or any body: sag, drag, snagging, tangling, its pull and its hits |
|
Temperatures inside each part from its material: hot spots of LEDs and chips, contacts, convection |
Radiation is not built yet; its zero substitute stands in (radiation.md).
Checked against¶
Each page ends with what its model was checked against. In short:
Domain |
Design document |
Checked against |
|---|---|---|
Rigid body |
closed forms, MuJoCo against Jolt, the MCube pushing measurements |
|
Electrical |
closed forms, ngspice, the LG HG2 cell |
|
Thermal |
closed forms |
|
Aerodynamics, wind |
closed forms, NACA Report 640, NeuroBEM flights |
|
Rotor downwash |
Bauersfeld 2024, Tanner 2015, Kiran 2025, own OpenFOAM |
|
Wind tunnel, CFD |
OpenFOAM; the tunnel’s wall friction is known to be 3.1 times too high |
|
Weather |
Koschmieder, Beer–Lambert, Marshall–Palmer, ICAO density |
|
EMI |
closed forms (conductor, dipole, far field) |
|
Comms |
Friis, thermal noise, bit errors, ISO 11898-1 |
|
Sensors |
analytic scenes, OpenCV calibration, EMVA 1288, radar equation, WMM 2025, ICAO, Planck |
|
Vehicle dynamics |
braking distance, the linear bicycle model, the Magic Formula’s shape |
|
Hydrodynamics |
closed forms, von Benzon et al. 2022’s BlueROV2 model (itself within about 10 % of pool runs) |
|
Traffic |
IDM equilibrium, light cycles |
|
Radiation |
not built yet |
The Validation report lists every check with its error and its test,
including the ones that fail. tools/ci/realism.sh runs the checks against measured data.