Skip to main content

Module issues

Module issues 

Source
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.

issuethe errorthe condition
#67the closed-form cone’s pressure drag reads high, transonica nose or a shoulder whose shape takes it (takes_cone_formula), past Mach 0.8
#68base drag reads high from Mach 0.8 to 1.2, low from 1.5every rocket, past Mach 0.8
#70a sharp fin section’s drag reads high, supersonican Airfoil fin set, past Mach 1
#72a steep boattail’s drag reads high, supersonica boattail steeper than 10°, past Mach 1
#222supersonic pressure drag about twice OpenRocket’san Ogive nose or an Airfoil fin set, past Mach 1
#73a boattail’s drag by Niskanen’s subsonic rule, up to +41.7% on a measured onea boattail steeper than 9.46° (SUBSONIC_BOATTAIL_RULE_RAD), any flight
#18skin friction taken as fully turbulent reads high on a surface smooth enough for a laminar runevery 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):

issuethe errorthe condition
#219HPR Sim flies the moment the thrust makes about a center of gravity off the axis; OpenRocket doesn’t, and no reference sizes itthe 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)
#213a single pod’s drag and normal force act on the axis, so their trim and roll are left outa pod set of one pod off the axis that holds a part (pod_issue_warnings)
#106a body part’s pitch and yaw damping is sampled away from its own center of pressurethe 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)
#8a near-calm wind level’s direction still swings the interpolated directiona 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§

IssueWarning
A known issue a flight meets, with the flight’s top Mach number and the parts whose shape meets its condition.
SupersonicJoin
Where one vehicle’s supersonic join starts, and where its stations rejoin their centers of pressure (IssueDetail::SupersonicJoins).

Enums§

IssueDetail
The flight’s own figures an issue’s message quotes (IssueWarning::detail).
IssueKind
Which of a flight’s numbers a known issue bears on.
KnownIssue
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) at R = 1.8e7, against Niskanen 2009’s smooth turbulent coefficient 1/(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, so atan(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 beside SUBSONIC_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 of vehicles is 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_M from the rocket’s axis in any of masses, 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²) of MassProperties::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 from issue_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 are parts, each an id and its part, flown on HPR Sim’s own drag. In KnownIssue’s order, each listing the parts that meet its condition. A flight with no top Mach number meets none.
layout_issue_warnings
issue_warnings over every part of layout, 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 past FORWARD_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 with stability_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 for fallback (hpr_aero::AeroModel::supersonic_fallback), and whose smallest static margin is min_static_margin. Issues #87, #120 and #121 when their switch stopped the run and the flight is past SUPERSONIC_SWITCH_MACH, naming the component; #172 whenever the flight has a smallest static margin, #1290 when it also reaches SUBSONIC_CP_MACH, and #1198 when it passes TRANSONIC_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 below NEAR_CALM_WIND_M_S, their directions differ, and the span reaches inside heights_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.