Skip to main content

Module residuals

Module residuals 

Source
Expand description

A flight log against its simulation: how far the logged height and speed lie from the simulated ones, sample by sample, and each of the log’s readings beside the simulation’s.

What it is for. M7.3 starts from what NASA Student Launch’s handbook asks a team after a flight: “compare the predicted flight model to the actual flight data”. The fits that come later work on these same residuals.

One rule: the simulation is read as the log is. A logged height and a simulated one aren’t the same quantity. A barometric logger reads the standard atmosphere’s altitude of the pressure around it, so on a warm day it reads low (Barometer). And a reading such as apogee or top speed depends on how it was taken from the track. So the simulated flight is written out as a noise-free log at the real log’s median sample interval, its height as the real log’s sensor would read it, and handed to the same reader (hpr_flightdata::readings::read). The two clocks are lined up by what that reader calls liftoff on each, the shared liftoff that two logs of one flight use.

The sign. A residual is the logged value less the simulated one, so a positive height residual means the rocket read higher than the simulation did.

How far to trust it. A residual describes one flight against one simulation. It is the sum of what the simulation got wrong and what the logger got wrong, and it can’t tell them apart; it isn’t a verdict on either. The heights are the log’s own samples, unsmoothed, so an ejection charge’s pressure spike shows as a residual. The speeds are the smoother’s, each with its standard error (hpr_flightdata::smoother), its GNSS set aside on a barometric log so that the speed stays on the height’s scale. The clock is good to the bound it states, and on a log with coarse steps the log’s liftoff reads late, so an ascent’s height residual leans positive. The simulated values carry no error of their own here. The method is tested on constructed flights below and run on the 7 public flights in cargo xtask real-flights.

Structs§

Comparison
A log against its simulation.
Point
One sample’s residual.
Residuals
One quantity’s residuals, from liftoff to the log’s landing or its end.
Row
One reading beside the simulation’s.
Simulated
A simulated flight, its heights both as climbed and as a barometer on the pad reads them.
Summary
How a phase’s residuals fall.
Track
Keeps a flight’s samples as it flies: an observer for hpr_sim::Simulation::run and the flight builder’s fly_with.

Enums§

HeightKind
What a log’s height stands for.
Phase
A part of the flight, on the log’s readings.
ResidualsError
Why a log can’t be compared with a simulation.
Speed
The speed’s residuals, which need the smoother.

Functions§

compare
log, read as read, against simulated.