Expand description
Warnings for known errors in HPR Sim’s drag, each by its issue number: where a flight’s speed and its design’s shape meet the condition under which a number is known to read wrong (ADR-163 §4, ADR-180).
Drag that reads high makes three numbers flatter than they are: the apogee reads low against a waiver’s ceiling; the top speed reads low, so the flutter margin and the largest dynamic pressure look better; the drift reads small. Each warning names them. Every flight still flies; a warning only says which numbers to trust less, and which way they lean. A flight flown on a drag of its own (a table or a model in place of HPR Sim’s) meets none of these.
| issue | the error | the condition |
|---|---|---|
| #67 | the closed-form cone’s pressure drag reads high, transonic | a nose or a shoulder whose shape takes it (takes_cone_formula), past Mach 0.8 |
| #68 | base drag reads high from Mach 0.8 to 1.2, low from 1.5 | every rocket, past Mach 0.8 |
| #70 | a sharp fin section’s drag reads high, supersonic | an Airfoil fin set, past Mach 1 |
| #72 | a steep boattail’s drag reads high, supersonic | a boattail steeper than 10°, past Mach 1 |
| #222 | supersonic pressure drag about twice OpenRocket’s | an Ogive nose or an Airfoil fin set, past Mach 1 |
| #73 | a boattail’s drag by Niskanen’s subsonic rule, up to +41.7% on a measured one | a boattail steeper than 9.46° (SUBSONIC_BOATTAIL_RULE_RAD), any flight |
| #18 | skin friction taken as fully turbulent reads high on a surface smooth enough for a laminar run | every flight (friction_issue_warnings) |
Others warn where the margin reads high (stability_issue_warnings,
layout_stability_issue_warnings):
a forward-swept fin past Mach 1 (#64), fin sets sharing a station (#325), a
freeform fin set at any speed (#326, ADR-190), the
supersonic switches (#87, #120, #121), #172 on every flight (ADR-189), and the
center of pressure on every flight with a margin from Mach 0.6 (#1290) and past
Mach 0.8 (#1198).
Two more warn where a part flies on its own after a separation, with only its devices’ drag
(separated_part_issue_warnings): a booster (#179), and a part that starts with
nothing open (#354). They read the flight’s bodies, not its drag, so a flight on a drag
of its own meets them too.
Four more have signs that depend on the case, flattering on some flights and not on others
(ADR-188 §2, ADR-201), and warn whatever the rocket’s drag. They bear on
the flight’s path, the apogee and the drift, rather than on the drag or the margin
(IssueKind::Flight):
| issue | the error | the condition |
|---|---|---|
| #219 | HPR Sim flies the moment the thrust makes about a center of gravity off the axis; OpenRocket doesn’t, and no reference sizes it | the center of gravity more than OFF_AXIS_CG_LIMIT_M off the axis at launch, at a motor’s ignition or burnout, at a separation, or fully burnt, on the stack or a sustainer (center_of_gravity_issue_warnings) |
| #213 | a single pod’s drag and normal force act on the axis, so their trim and roll are left out | a pod set of one pod off the axis that holds a part (pod_issue_warnings) |
| #106 | a body part’s pitch and yaw damping is sampled away from its own center of pressure | the shock-expansion join, past its start on the stack or on a sustainer, each by its own join and its own top speed (body_station_issue_warnings) |
| #8 | a near-calm wind level’s direction still swings the interpolated direction | a tabulated level at or below NEAR_CALM_WIND_M_S turning against its neighbor, inside the flight’s heights (wind_issue_warnings) |
Each Mach edge is exclusive, as the envelope’s are (crate::envelope): a flight whose top
Mach number is exactly at an edge raises nothing, and a NaN top Mach number raises every
warning whose shape the design has, so a broken number can’t hide one.
Structs§
- Issue
Warning - A known issue a flight meets, with the flight’s top Mach number and the parts whose shape meets its condition.
- Supersonic
Join - Where one vehicle’s supersonic join starts, and where its stations rejoin their centers of
pressure (
IssueDetail::SupersonicJoins).
Enums§
- Issue
Detail - The flight’s own figures an issue’s message quotes (
IssueWarning::detail). - Issue
Kind - Which of a flight’s numbers a known issue bears on.
- Known
Issue - A known error in HPR Sim’s drag, its stability margin or its flight’s path that a flight can meet.
Constants§
- BASE_
DRAG_ HIGH_ MACH - Where base drag starts to read high: Mach 0.8 (issue #68: Fleeman’s formula gives 0.225 at Mach 0.9 where MIL-HDBK-762’s measured data give 0.156).
- BASE_
DRAG_ HIGH_ TOP_ MACH - The last Mach number where base drag is measured to read high: 1.2 (0.208 against
MIL-HDBK-762’s 0.194, issue #68). Past it a
flight’s warning adds the low side (
BASE_DRAG_LOW_MACH); between the two the sign is unmeasured. - BASE_
DRAG_ LOW_ MACH - Where base drag is measured to read low: from Mach 1.5 (5% under Love’s correlation, NACA TN 3819, at Mach 1.5, 17% at 2.0, 14% at 3.0; issue #68). There the apogee reads high.
- FINS_
WITHOUT_ INTERFERENCE - The most fins that one station can hold before the fin–fin interference factor drops below
1: four (Niskanen 2009 table 3.3,
hpr_aero::fins::fin_count_factor). Fin sets at one station with more than this between them are counted apart by HPR Sim and together by OpenRocket (issue #325). - FIN_
SETS_ AT_ ONE_ STATION_ CAL - How much of the margin gap on OpenRocket’s Pods–airframes and winglets example counting fin sets apart explains, calibers: about 0.029 of 0.071 to 0.076 (issue #325).
- FORWARD_
SWEEP_ MACH - Where a forward-swept fin’s warning starts: Mach 1 (ADR-188). Its measured error is
a normal-force slope that rises by up to 7.7% past linear theory’s start, Mach 1.2
(
hpr_aero::fins::SUPERSONIC_START_MACH), peaking up to 0.37 past it (issue #64); the warning starts at the lowest supersonic Mach number, below that rise. The transonic join into linear theory starts at Mach 0.8 (hpr_aero::fins::TRANSONIC_START_MACH); below Mach 1 the error isn’t measured. - FREEFORM_
FIN_ MARGIN_ CAL - The share of the static margin, calibers, that a kinked freeform fin’s center of pressure takes on OpenRocket’s Pods–airframes and winglets example, where HPR Sim’s sits 1.6 mm aft of OpenRocket 24.12’s (issue #326). Unprobed on other outlines, so every freeform fin set warns.
- LAMINAR_
FRICTION_ PERCENT - How much of the friction a laminar run takes off on RocketPy’s Calisto at Mach 0.3, where
HPR Sim takes it fully turbulent (issue #18):
Barrowman 1967’s transitional term
1700/R(eq. 4-6) atR = 1.8e7, against Niskanen 2009’s smooth turbulent coefficient1/(1.50 ln R − 5.6)²(eq. 3.78), in percent. Barrowman gives no rule for when a surface is too rough to stay laminar, so every flight on HPR Sim’s drag warns. - MARGIN_
HIGH_ BOUND_ CAL - How far the static margin read high against OpenRocket 24.12, calibers: the largest gap on the private designs, 0.1108 (four designs read 0.0350 to 0.1108 calibers more stable in HPR Sim, none with a measured cause; Accuracy of the margin on the stability page, issue #172).
- NEAR_
CALM_ WIND_ M_ S - The fastest wind, m/s, whose reported direction counts as near calm for issue #8: 1.5 m/s, the top of Beaufort force 1, light air, 0.3 to 1.5 m/s (force 0, calm, is 0 to 0.2 m/s), in MeteoSwiss’s Table of medium wind speeds according to Beaufort Wind Scale (Federal Office of Meteorology and Climatology, November 2023), 1 to 3 knots in the UK Met Office’s Beaufort wind force scale. Its land criterion, in the Hong Kong Observatory’s Beaufort Wind Scale – Land and Sea Criteria: “Direction of wind shown by smoke drift, but not by wind vanes.” A vane reads no direction in such a wind, so a level this slow has no direction worth interpolating.
- OFF_
AXIS_ CG_ LIMIT_ M - How far the center of gravity may sit from the rocket’s axis, m, before it counts as off it
(issue #219): 1e-9 m. A symmetric design’s
center of gravity sits about 1e-18 m off the axis, rounding in the sum of its parts’ places;
the 54 mm test rocket’s rail buttons put it about 5.8e-5 m off at launch
(
a_rail_button_puts_the_test_rocket_off_its_axis_and_none_leaves_it_on). The limit lies between, far from both. - STEEP_
BOATTAIL_ RAD - A boattail steeper than this, in radians, warns past
SUPERSONIC_DRAG_MACH: 10°, the steepest that issue #72 measured inside its spread (−6.3% to +17.4% at 10° and below). It measured 15° at +13.5% to +50.8% and 16° at +26.4% to +54.1%; between 10° and 15° is unmeasured, so the warning takes it in rather than leave a high drag unwarned. - SUBSONIC_
BOATTAIL_ RULE_ RAD - The steepest boattail that Niskanen’s subsonic rule gives no drag, rad: where its length
ratio
γ = l/(d₁ − d₂)is 3, soatan(1/6), 9.46° (Niskanen 2009 eq. 3.88,hpr_aero::drag::boattail_factor). A steeper one takes a share of base drag below Mach 0.8, which read from −40.8% to +41.7% on Cubbage’s measured 16° boattails and high on the Arcas Robin’s 15° one (issue #73); between 9.46° and 15° is unmeasured, so the warning takes it in. - SUBSONIC_
CP_ AFT_ CAL - How far aft of the measured center of pressure HPR Sim’s sat on NASA TN D-4013’s short Arcas
Robin model below the transonic join, calibers: rounded outward from 0.11705 (Mach 0.6) and
0.91170 (Mach 0.8), against the reading’s ±0.0546, from
validation/fixtures/aero/normal-force-vs-mach.json, whose figures a test recomputes from the committed designs and the tunnel’s points. The fins are still on Prandtl-Glauert at both speeds, so the join is not the cause. The long model reads the other way (0.360 calibers forward at Mach 0.6, and +0.067 at 0.8, inside its ±0.071), so one measured model of two supports the warning. Both figures are the committed basis, the report’s faired curve against HPR Sim fitted over −2° to 2°; fitted on the tunnel’s points over the same angles, they are −0.03 and +0.87 calibers over −2° to 2°, and −0.49 and +0.08 over −3° to 4° (docs/research/arcas-fin-share-cp-station.md§4). The warning quotes the committed basis, the largest, the side that doesn’t flatter the margin, and gives the −3° to 4° fit’s 0.08 beside it. - SUBSONIC_
CP_ MACH - Where the subsonic center-of-pressure warning starts: Mach 0.6, NASA TN D-4013’s slowest
tunnel point on the two Arcas Robin models, where the short model’s center of pressure already
reads aft of the report’s faired curve (its Fig. 11) by more than the reading’s uncertainty.
That holds on the committed basis only: fitted on the tunnel’s plotted points over the same
angles as HPR Sim, the Mach 0.6 miss is −0.03 calibers over −2° to 2° and −0.49 over −3° to 4°
(
docs/research/arcas-fin-share-cp-station.md§4), so starting here is the cautious side. The tunnel has no slower point, so where the error starts below Mach 0.6 is unmeasured; against RASAero II, a code and no measurement, HPR Sim’s center of pressure reads 0.16 calibers aft on Calisto at Mach 0.5 (issue #1290). - SUBSONIC_
CP_ WIDE_ CAL - The most the short Arcas Robin model’s center of pressure reads aft of the tunnel’s at Mach
0.6 and 0.8 when both are fitted on the tunnel’s points over −3° to 4°, calibers: +0.08 at
Mach 0.8 (and −0.49, forward, at 0.6), from
docs/research/arcas-fin-share-cp-station.md§4, whose table gives two decimals, so the warning says “about”. The #1290 warning quotes it besideSUBSONIC_CP_AFT_CAL, so a reader sees how far the quoted miss rests on the narrow window. - SUPERSONIC_
DRAG_ MACH - Where the supersonic drag warnings start: Mach 1 (issues #70, #72 and #222). Their measured gaps start at Mach 1.0 to 1.5; the warning starts at the lowest.
- SUPERSONIC_
SWITCH_ MACH - Where the supersonic body switches start to matter: Mach 1.2, the earliest the
shock-expansion method joins slender-body theory (
hpr_aero::SUPERSONIC_JOIN_START_MACH). - TRANSONIC_
CP_ AFT_ CAL - How far aft of the measured center of pressure HPR Sim’s sat on NASA TN D-4013’s two Arcas
Robin wind-tunnel models at Mach 0.9, calibers, rounded outward from 0.67936 (the long model)
and 1.34260 (the short), from
validation/fixtures/aero/normal-force-vs-mach.json, whose figures a test recomputes from the committed designs and the tunnel’s points. Mach 0.9 is the one speed on the join where both models read aft by more than the reading’s uncertainty: at Mach 0.8 the fins are still on Prandtl-Glauert, and the long model’s +0.067 is inside its ±0.071, though the short model’s +0.912 there, against ±0.055, is already aft on Prandtl-Glauert (issue #1290); nearer Mach 1 the error turns both ways (the short model 0.41 calibers forward at Mach 1.0; the long model’s +2.36 there rests on a faired curve its plotted points contradict,docs/research/arcas-fin-share-cp-station.md). These are errors in the flight margin, taken at the flight’s Mach number; the static margin, taken at Mach 0, is clear of the join. - TRANSONIC_
CP_ MACH - Where the transonic center-of-pressure warning starts: Mach 0.8, where the fins’ normal force
leaves Prandtl-Glauert for the straight-line join to linear theory
(
hpr_aero::fins::TRANSONIC_START_MACH; issue #1198). - TRANSONIC_
NOSE_ DRAG_ MACH - Where the closed-form cone’s transonic pressure drag starts to read high: Mach 0.8 (issue #67: +87% at Mach 0.8 and +105% at 0.85 against Stoney’s measured 3:1 cone, NASA TR R-100; 2 to 9 times MIL-HDBK-762’s 3:1 tangent ogive from Mach 0.9 to 1.2; still +15% at Mach 1.5).
Functions§
- body_
station_ issue_ warnings - The body’s damping-station issue a flight meets (#106, ADR-201): when the
shock-expansion method flies a vehicle’s body (
AeroModel::supersonic_body) and that vehicle’s own top Mach number is past its join’s start (exclusive; NaN counts as past). Each ofvehiclesis a vehicle the flight flew as a rigid body, in order, with its aerodynamics and its top Mach number while it was the one flying: the launch stack first, then each sustainer a powered separation handed the flight to (crate::Simulation::flown_vehicles,crate::FlightMetrics::max_mach_by_vehicle). A sustainer is a shorter body than the stack, so its join can start lower, and a stack the method doesn’t fly can leave a sustainer it does. The warning lists the body parts the method covers on any vehicle that meets it, each once, in the layout’s order, and keeps each such vehicle’s join (IssueDetail::SupersonicJoins). Inside the join a nose’s or cylinder’s station is joined linearly between the two models’ while its force blends their slopes and moments, so the two agree only at the join’s ends (AeroModel::component_station_m); the station is only where the flight samples the part’s local flow for pitch and yaw damping, and the margins never read it. - center_
of_ gravity_ issue_ warnings - The off-axis center of gravity’s issue a flight meets (#219, ADR-201):
when the center of gravity sits more than
OFF_AXIS_CG_LIMIT_Mfrom the rocket’s axis in any ofmasses, a NaN distance counting as more. A flight passes each vehicle it flew’s samples (crate::FlownVehicle::mass_samples): the stack at launch, at each motor’s ignition and burnout and fully burnt, and each sustainer from its separation to its end. Its distance is√(x² + y²)ofMassProperties::cg_m, the largest over them. HPR Sim’s equations of motion are written about the nose tip with the center of gravity where it is, so the thrust along the axis turns the rocket about an offset one; no reference sizes how much that does, so the warning holds whatever the drag and at any speed. None for a flight with no top Mach number. - friction_
issue_ warnings - The friction issue a flight on HPR Sim’s own drag meets: #18 whenever it has a top Mach
number, at any speed and on any finish, since Barrowman 1967 gives no rule for when a surface
is too rough to stay laminar (
LAMINAR_FRICTION_PERCENT). Apart fromissue_warnings, which reads the design’s shape. - highest_
height_ m - The highest a flight reached, m above the launch site: the largest height of its events, its
final sample, and each separated body’s and released part’s start, events and final sample
(
crate::BodyFlight,crate::ReleasedFlight). An apogee is an event, so it is among them. NaN if any of those is, so a broken height can’t hide a warning. - issue_
warnings - The issues a flight meets: one whose top Mach number is
max_mach, of a rocket whose parts areparts, each an id and its part, flown on HPR Sim’s own drag. InKnownIssue’s order, each listing the parts that meet its condition. A flight with no top Mach number meets none. - layout_
issue_ warnings issue_warningsover every part oflayout, pods’ included.- layout_
stability_ issue_ warnings - The stability issues a design’s shape meets, on a flight whose top Mach number is
max_mach(ADR-189): #64 for its forward-swept fin sets pastFORWARD_SWEEP_MACH, then #325 for its fin sets that share a station, then #326 for its freeform fin sets at any speed (FREEFORM_FIN_MARGIN_CAL). They are errors in HPR Sim’s normal force, not its drag, so a flight on a drag of its own meets them and one on a normal-force table of its own doesn’t, as withstability_issue_warnings. A flight with no top Mach number meets none. - pod_
issue_ warnings - The single pod’s issue a flight meets (#213, ADR-201): a pod set of one
pod (
hpr_design::PodSet::count) off the rocket’s axis (a radial offset not 0, a NaN one counting as off) that holds at least one part, listing those pod sets’ ids in the layout’s order. A pod set holding nothing adds no force (hpr_aero::AeroModel::new); two pods or more stand evenly round the axis, so their offsets add to zero and so do the moments HPR Sim leaves out (hpr_aero::PodSetAero). A parallel stage is laid out as a pod set (hpr_design::ParallelStage), so a single strap-on booster counts. A single pod inside a set of several counts too, though the copies’ moments may cancel: an over-warning, on the safe side. At any speed and whatever the drag; none for a flight with no top Mach number. - separated_
part_ issue_ warnings - The separated parts’ issues a flight meets (ADR-200), read from the bodies that
flew on their own (
FlightResult::bodies), whatever the rocket’s drag: each part’s descent is a point under its open devices (crate::recovery), never the rocket’s drag. - stability_
issue_ warnings - The stability issues a flight meets (ADR-181): one whose top Mach number is
max_mach, whose aerodynamics stopped the supersonic body run forfallback(hpr_aero::AeroModel::supersonic_fallback), and whose smallest static margin ismin_static_margin. Issues #87, #120 and #121 when their switch stopped the run and the flight is pastSUPERSONIC_SWITCH_MACH, naming the component; #172 whenever the flight has a smallest static margin, #1290 when it also reachesSUBSONIC_CP_MACH, and #1198 when it passesTRANSONIC_CP_MACH. A flight with no top Mach number meets none. - wind_
issue_ warnings - The wind’s issue a flight meets (#8, ADR-201): the spans of a tabulated wind
over which its direction is interpolated between two levels (
hpr_atmos::Wind::direction_turns) where the direction still swings although a level is near calm, inside the flight’s heights. A span counts when neither level’s speed is exactly 0 (a calm level takes its neighbor’s direction, so nothing turns), at least one is at or belowNEAR_CALM_WIND_M_S, their directions differ, and the span reaches insideheights_msl_m, the flight’s lowest and highest heights above mean sea level, as a wind is read: the ground and the highest point any body reached (highest_height_m). A span that only touches either end doesn’t count: the wind there is the end level’s own. Any NaN counts the way that warns. The spans that count are kept in the warning, lowest first.