Expand description
What a flight comes to: its peaks, its apogee, its stability margins, the ejection delay that would fire at apogee, and where each body landed (the flight-metrics milestone and its decision record; the guide’s Flight metrics page).
FlightMetricsis anObserver: fly aSimulationwith it, then ask it for aFlightSummary. It finds each peak on the integrator’s dense output, not in a recorded table, so a peak between two rows is not missed (Loft lesson L34).stabilitygives the static margin and the margin at the flight’s Mach number at one instant, andmarginthe margin of any flow. A margin that would be a ratio of nearly cancelling slopes isNone, with the pitch-moment slope beside it (L33).optimum_delaysflies the rocket with its charges held and gives, for each motor, the delay from its burnout to that apogee, so it doesn’t depend on the delay flown (L94).- Anything that did not happen is
None, never a zero, and every height names its datum (L35).
Heights. A height here is the center of mass’s ellipsoidal height above the launch site’s,
Sample::height_above_ground_m. The center of mass starts above the site (the rocket stands
on the rail), at FlightSummary::launch_height_m; Apogee::gain_m counts from there, as
OpenRocket’s altitude does.
Structs§
- Apogee
- The apogee of the flight’s center of mass.
- Body
Peak - A peak over one separated body’s own flight, with where and when it came.
- Flight
Metrics - Watches a flight and keeps its peaks, and its stability from the rail exit to apogee or the first deployment.
- Flight
Summary - The metrics of one flight. Every field that may not have happened is an
Option. - Landing
- Where something landed: the center of mass as it reached the launch site’s ellipsoidal height.
- Margin
- The stability margin of one flow.
- Optimum
Delay - The ejection delay that would fire a motor’s charge at apogee.
- Peak
- A peak over the flight, with where and when it came.
- Stability
- The rocket’s stability at one instant.
Constants§
- MARGIN_
CONDITION_ LIMIT - The largest ratio
κ = Σ |C_Nα,i| / C_Nαat which a margin is given:√10. - STATIC_
MARGIN_ MACH - The Mach number of the static margin: the air at rest, as RocketPy’s
static_margintakes it.
Functions§
- margin
- The margin of
aeroinflowwith the center of mass atcg_station_m(m aft of the nose tip). SeeMarginandMARGIN_CONDITION_LIMITfor when it isNone. - optimum_
delays - The optimum ejection delay of each motor that burns out before apogee: the time from its burnout to the apogee of the same flight with every recovery charge held, so that the answer is a property of the rocket, its motors and its air, and not of the delay flown (Loft lesson L94).
- optimum_
delays_ observed optimum_delays, withobserverseeing the held flight as it flies. Until a held device, split, mass shift or release would have fired, the held flight is the one flown, so up to then its steps give, for instance, how fast the rocket moves when a delay of that length fires.- stability
- The static margin and the flight margin of
aeroattime_s, with the center of massheight_above_ground_mabove the launch site and atcg_station_mon the airframe, and the flight’s air at Machmachpressing withdynamic_pressure_pa. - weakest_
margin - The least margin of
aeroat Machmach, the air along the axis, over the direction it crosses the rocket, with the center of mass atcg_station_m:marginin the weakest plane, whose direction it gives (Margin::roll_rad); or a plane where no margin can be given, if there is one (#329).