# Motion instrument

Instance `components/motion_panel.tscn`. Run `scenes/motion_demo.tscn` with F6 for simulated telemetry; pause the feed to preview stale status.

```gdscript
$MotionPanel.set_telemetry(
	Vector3(roll_degrees, pitch_degrees, heading_degrees),
	Vector3(momentum_x, momentum_y, momentum_z),
	Vector3(accel_x, accel_y, accel_z)
)
```

- Orientation: positive roll right side down, positive pitch nose up, heading clockwise from north (0–360°).
- Body axes: X forward, Y right, Z down.
- Angular momentum: kg·m²/s, distinct from gyroscope angular velocity.
- Acceleration: m/s², with gravity removed upstream.

Missing values show dashes; non-finite samples are rejected. After `stale_after_seconds` (default 2), the banner marks held values STALE. `acceleration_full_scale` sets plot limits; numeric values remain unclamped.

Edit layout and Labels in the scene tree. Preserve scene-unique names used by `motion_panel.gd`. The four graphics use `motion_instrument.gd`; `radius_source` keeps the circles and Z scale aligned. Colors inherit the active theme; see [colors.md](colors.md).