Skip to content

test: characterization tests for Flight.step_simulation()#11

Open
thc1006 wants to merge 2 commits into
developfrom
enh/step-simulation-tests
Open

test: characterization tests for Flight.step_simulation()#11
thc1006 wants to merge 2 commits into
developfrom
enh/step-simulation-tests

Conversation

@thc1006

@thc1006 thc1006 commented Jun 27, 2026

Copy link
Copy Markdown
Member

Adds characterization tests for the stepped-simulation API (Flight.step_simulation()), which had no coverage. This API underpins real-time, one-node-at-a-time control loops (e.g. the Balloon Popping Challenge environment steps it every timestep).

Uncontrolled (TestStepSimulation): stepping (run_simulation=False + repeated step_simulation()) reproduces a one-shot simulate() — initial _step_state, multi-phase progression to finished, the final t/y_sol and full solution array matching simulate() to a tight tolerance (robust to LSODA last-bit noise), post-process artifacts on finish, and step-after-finished being a no-op.

Controlled (TestControlledStepSimulation): a roll command injected between steps (the fork's actual use case) changes the trajectory — a sustained command spins the body up while neutral stays at zero; a mid-flight reversal turns the roll rate around (only possible with per-step injection); a zero command leaves the angular state bit-identical to an uncontrolled run. Uses time_overshoot=False (as BPC does) so each step is one solver node.

Parachute-free calisto; tolerances rather than bit-exact equality for cross-platform robustness. 8 tests, ruff clean.

@thc1006 thc1006 force-pushed the enh/step-simulation-tests branch from db87517 to 0ab556f Compare June 27, 2026 13:29
Verify the stepped-simulation API (run_simulation=False plus repeated
step_simulation() calls) reproduces a one-shot simulate():

- initial step state is unfinished at the first phase
- stepping visits multiple phases and reaches the finished state
- the stepped trajectory (final t and the full solution array) matches simulate()
  to a tight tolerance, robust to LSODA last-bit noise across platforms
- post_process_simulation / initialize_prints_plots fire on finish
  (t_final, prints, plots present)
- stepping after finished is a no-op

Uses the parachute-free calisto flight (parachute triggers are not migrated into
the stepping path); the twin's launch parameters are read back from the
reference so it cannot drift. Scope: uncontrolled stepping only.
@thc1006 thc1006 force-pushed the enh/step-simulation-tests branch from 0ab556f to 4e42c4b Compare June 27, 2026 13:35
Inject a roll command between step_simulation() calls (the Balloon Popping
Challenge use case) and assert the trajectory responds:

- a sustained command spins the body up (roll rate w3 grows) while a neutral
  command leaves w3 at zero
- a mid-flight command reversal turns the roll rate around -- only possible if
  the command is re-read every step (a latched command could not)
- a zero command leaves the angular state bit-identical to an uncontrolled run,
  isolating the divergence as the command, not the actuator's presence

Uses time_overshoot=False (as BPC does) so each step advances one solver node
and the command is injected per timestep. Tolerances/thresholds are used rather
than bit-exact equality, to stay robust to LSODA last-bit noise across platforms.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant