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::runand the flight builder’sfly_with.
Enums§
- Height
Kind - What a log’s height stands for.
- Phase
- A part of the flight, on the log’s readings.
- Residuals
Error - Why a log can’t be compared with a simulation.
- Speed
- The speed’s residuals, which need the smoother.
Functions§
- compare
log, read asread, againstsimulated.