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

Rigid body

MuJoCo and Jolt: joints with damping, friction and mimic, contacts and friction, mesh colliders as hulls, contact force and joint reaction

Vehicles and wheeled bases

A car’s suspension, Magic Formula tyres, brakes, steering and powertrain; the diff-drive and swerve controllers

Water

Buoyancy, drag, currents, waves, added mass and Fossen’s model with a real vehicle’s coefficients

Rotors

Thrust and torque of each propeller: coefficients or blade elements, ground and ceiling effect, vortex ring state

Downwash

The air a drone pushes: the jet under it, the outwash on the ground, walls and roofs, the live lattice Boltzmann box

Aerodynamics and wind

Drag on links, the wind and its gusts, wind fields, rain pushing links; the wind tunnel and OpenFOAM

Motors

Motor currents and torque from the bus voltage: the dq-frame model and its current loops

Battery

Terminal voltage and state of charge: the equivalent circuit, and how it compares with a real cell

Electrical network

The buses, converters, fuses, switches and diodes between them, loads, and circuits from a netlist

Thermal

Lumped heat networks: copper and drive losses, heating, cooling, derating

Sensors

Lidar, camera, thermal camera, radar, IMU, GNSS, magnetometer, barometer, and sensor delays

Weather

Air density, fog, rain, snow and dust extinction, wet and icy friction, dirty lenses, fields

EMI and radio links

Fields of power lines and motors and what they do to sensors; radio link budgets and CAN errors

Traffic

Cars following lanes and lights, lane changes, crossings, pedestrians, OpenSCENARIO

Humans

People as moving capsules: walking with planted feet, steering round robots and each other

Tethers

A cable from a winch to a drone or any body: sag, drag, snagging, tangling, its pull and its hits

Heat conduction

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

rigid_body.md

closed forms, MuJoCo against Jolt, the MCube pushing measurements

Electrical

electrical.md

closed forms, ngspice, the LG HG2 cell

Thermal

thermal.md

closed forms

Aerodynamics, wind

aerodynamics.md

closed forms, NACA Report 640, NeuroBEM flights

Rotor downwash

rotor_aero.md

Bauersfeld 2024, Tanner 2015, Kiran 2025, own OpenFOAM

Wind tunnel, CFD

cfd.md

OpenFOAM; the tunnel’s wall friction is known to be 3.1 times too high

Weather

weather.md

Koschmieder, Beer–Lambert, Marshall–Palmer, ICAO density

EMI

emi.md

closed forms (conductor, dipole, far field)

Comms

comms.md

Friis, thermal noise, bit errors, ISO 11898-1

Sensors

sensors.md

analytic scenes, OpenCV calibration, EMVA 1288, radar equation, WMM 2025, ICAO, Planck

Vehicle dynamics

vehicle_dynamics.md

braking distance, the linear bicycle model, the Magic Formula’s shape

Hydrodynamics

hydrodynamics.md

closed forms, von Benzon et al. 2022’s BlueROV2 model (itself within about 10 % of pool runs)

Traffic

traffic.md

IDM equilibrium, light cycles

Radiation

radiation.md

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.