Skip to content

Lagrange v0.3.0: arms, electrical and thermal

Choose a tag to compare

@Danendra10 Danendra10 released this 25 Oct 00:32
· 331 commits to dev since this release
086ac31

Lagrange v0.3.0: arms, electrical and thermal (release notes)

v0.2 was the simulation core and the AMR. v0.3 adds the electrical and thermal domains, a robot
arm with MoveIt 2, a raster camera, a second physics engine, and replay in the C++ server. The
AMR now drives on its own power system: a battery, a DC bus and two motor drives at 100 µs.

Status: released on 2026-10-25 as v0.3.0, at the owner's request, after v0.2.0.

Highlights

  • Electrical.
    • Six USD schemas (ElectricalMotorAPI_1, BatteryAPI_1, PortAPI_1, bus, load,
      converter), with ports on the same prims as the 3D parts.
    • A network module: DC bus with capacitor, battery equivalent circuit, averaged dq motor
      drives with current loops, regeneration, brake resistor and trips, DC-DC converters
      between buses.
    • Controllers command torque; the electrical domain delivers it, or its ideal substitute does.
    • Overlay files give an imported robot motors, a battery and a bus without editing its URDF.
    • Export to an ngspice netlist or a Modelica model (lagrange export).
    • An FMI 3.0 co-simulation host, with a reference FMU (lagrange_models/dc_drive).
  • Thermal.
    • Lumped thermal networks (ThermalAPI_1, ThermalLinkAPI_1) heated by the electrical
      losses, with derating.
    • The network runs when the site's ambient temperature is given.
  • Coupling. Stability checks across the electrical, thermal and physics rates at start-up;
    physics reports each joint's effective inertia for the motor models.
  • Bench mode. --bench run.mcap replaces physics by a recorded run; electrical, thermal and
    sensors run live, at 10 kHz electrical, about 59× real time.
  • Replay. lagrange_server --replay run.mcap replays a recording to the viewer, with
    seeking. The Python mock server is now a test tool (Q15).
  • Arm. The sample 6-DoF arm arm6 in a workcell; MoveIt 2 pick-and-place through
    joint_trajectory_controller at 1 kHz; a wrist camera.
  • Camera. A raster camera sensor (colour, depth, instance ids) on the same mesh pipeline as
    the viewer's viewport, published as ROS Image and CameraInfo and shown in the viewer.
  • Physics.
    • Jolt Physics 5.6 as a complete second backend (--physics jolt, or the profile's
      rigid_body.backend), checked against MuJoCo by an agreement suite.
    • Convex hull colliders in the world, in USD, in both backends and in the lidar (CPU and
      GPU).
    • collision_bake makes them from render meshes with CoACD.
  • Schemas and profiles. migrate_schema and migrate_profile bring old files up to date;
    the stage loader names the command when it meets an older schema version.
  • Viewer.
    • Scene editing: schema values change in a running simulation from the inspector.
    • The Electrical workspace runs on the simulator's power system.
    • Thermal false-colour and unlit shading in the viewport.
    • The camera view in the Sensors workspace.

Acceptance (roadmap §4)

Epic Acceptance Status Evidence
Electrical network domains/electrical.md §8 tests met, with owed items test_models, test_network, test_battery_dataset (LG HG2 cell data, CC BY 4.0: 5.4 to 6.2 mV RMS from 46 to 89 % state of charge, 21.5 mV at 24 %); owed: below 35 % state of charge, sim-vs-real (Q16), the drive-design review of the motor constants (RFC 0002 resolution 2)
Coupling stability architecture.md §8 tolerances met test_coupling; architecture.md §8.1; the scheduler steps flow readers at their window's end
Thermal domains/thermal.md §7 tests met, with owed items test_lumped, test_thermal_network, test_thermal_coupling; owed: a published or recorded motor heat run (Q16)
FMU host A reference FMU runs in place of the built-in motor model; Q8 closed met; Q8 partly open test_fmu_host with lagrange_models/dc_drive; on fmilibrary3_vendor, since Lyrical's fmilibrary_vendor is FMI 2.0 only. Accepting FMI 2.0 FMUs is still open in Q8
Bench mode bench_electrical_replay.yaml runs at 10 kHz in real time on a laptop CPU met About 59× real time on the development laptop
Arm integration Scenario in robot-classes.md §4 met tools/ci/arm_scenario.sh (derating scenario, about ten minutes)
Camera sensor (raster) Projection tests; the viewer shows the sensor view met OpenCV finds checkerboard corners within 0.066 px mean of the pinhole model; calibration recovers fx, fy, cx, cy with RMS 0.07 px; Sensors workspace camera view
Schema migration tooling Round-trip tests met tools/migrate/test (synthetic ExampleMotorAPI_0 → _1; profiles version 0 → 1, comments kept)
Exports Netlist runs in ngspice met test_export: round trip in ngspice within 0.05 %; Modelica checked for structure only (no OpenModelica on the machine)
Second rigid-body backend Backend-agreement tests met, with a known issue server/test/test_backends.cpp; Jolt wheel slip below
Viewer additions Golden images met test_headless.py: Electrical workspace on the schematic colours, thermal shading against the simulator (lit vs thermal)

v0.2 items that moved here are done: G2 overlay files, B8 collision bake, E6 scene editing, E8
replay in the C++ server. H7 (a thin electrical slice) was replaced by the full domain. C5
(runtime rebase) stays deferred to v0.7.

Known issues

  • Jolt: drive wheels slip while ramping up. On Jolt's rigid contacts the sample AMR's
    casters take most of the load; after the 6 s demo drive Jolt is about 0.4 m behind MuJoCo.
    MuJoCo stays the default.
  • Nav2 start-up (from v0.2): some launches have one ROS process never discover another's
    endpoint. Mitigated by retries; root cause not found.
  • Not run while GitHub Actions are disabled: the sanitizer builds of the USD packages and
    the nightly jobs. Everything else was verified locally with colcon.

Release checklist

  • Every v0.3 epic done, with evidence above
  • Release notes drafted
  • Gated changes merged under the autonomous mandate listed for review (progress.md)
  • Owner review of those merges (the electrical, thermal and camera schemas, the C ABI)
  • The v0.2.0 release published first (2026-10-25)
  • GitHub Actions re-enabled and green on dev
  • Released: dev merged into main and tagged v0.3.0 on 2026-10-25 at the owner's request
    (release-please could not run with GitHub Actions disabled)