Skip to main content

Module catalog

Module catalog 

Source
Expand description

An offline motor catalog: motor metadata, thrust curves, and each curve’s provenance and license.

Catalog::bundled is the catalog compiled into the crate: ThrustCurve.org’s whole solid catalog, captured 2026-10-28, with 1,004 motors and 1,701 curve files; 80 of the motors have no file that reads, and can’t fly. Every lookup reads it (ADR-302). The decision record on solid motors and the first bundled catalog is ADR-005. Newer curves are fetched and cached by hpr-net, the online layer that starts at M5.1.

Every figure a motor lists in the bundled index comes from its curve file alone, written by cargo xtask motor-catalog (the rule ADR-186 set, issue #295). ThrustCurve.org grants no license for its API’s motor records and reserves copyright. ADR-287 lets the project use those records as published facts, with credit, so each motor also carries its record’s StatedFigures, and each curve file its CurveCheck against them, the 1% rule of ADR-005. A motor flies its CatalogMotor::default_curve, a passing file where it has one (ADR-298). ADR-288 plans the whole solid catalog for M5.7.

Size, masses and delays are the file header’s; total impulse, average and peak thrust and burn time are worked out from the curve by ThrustCurve’s own methods, the ones the simulator flies (the trapezoid integral and the NFPA 1125 burn window; their definitions and sources are on crate::curve). Only the names that identify a motor (ThrustCurve.org’s id for it, designation, maker, single-use or reload, case, propellant) and the file’s provenance (its ThrustCurve.org data-file id, who produced the data, its license and the download date) are written by hand, in the command’s table.

The index keeps the units motor files and catalogs use (mm, g, N·s, N, s), in fields named for them. CatalogMotor::motor converts to SI and takes the envelope (diameter, length and masses) from the index rather than the curve file’s header. In the bundled index the two are the same; another index (from Catalog::from_json) can correct a header that is wrong (Loft lesson L43: one said 75 mm for a 54 mm motor).

Structs§

Catalog
A motor catalog.
CatalogCounts
How many motors and files a catalog holds, and how many of them pass their check: the figures cargo xtask motor-catalog and hpr motors update print for the bundled catalog.
CatalogCurve
Where a thrust curve came from, under what terms, and how it compares with its motor’s stated figures.
CatalogMotor
One motor’s catalog entry, in the units motor files use.
CurveCheck
A curve file’s check against its motor’s StatedFigures (ADR-005’s 1% rule, definition A of the ThrustCurve.org data notes): the file’s total impulse over its whole curve, its NFPA 1125 burn time between the 5%-of-peak crossings, and its average thrust as that impulse over that burn time, each worked out by ThrustCurve’s own methods, the ones the simulator flies. The file passes when all three are within CHECK_BOUND of the stated figures: |file − stated| ≤ 0.01 × stated, so a gap of exactly 1% passes. A pass says the file agrees with the published figures; it says nothing about the curve’s shape between them.
FigureGap
One figure of a curve file’s check: the file’s value and the motor’s stated one.
LeftOut
A snapshot file a catalog leaves out, and why: a file whose uploader restricted it, or one that can’t be read as one motor’s curve.
MotorWarning
A warning for flying a catalog motor’s file, with what it is about.
Snapshot
Where and when a catalog’s curve files were downloaded. Each file’s own URL and SHA-256 are on its CatalogCurve.
StatedFigures
The figures ThrustCurve.org’s record of a motor states (its API’s totImpulseNs, avgThrustN, burnTimeS and maxThrustN), copied unchanged: published facts, used with credit (ADR-287). ThrustCurve.org stores them with the motor, from the certifying body or derived from its data or a curve, not worked out from each file; some are printed coarser than 1%. Its Motor Statistics page (https://www.thrustcurve.org/info/motorstats.html) defines the burn time between the 5%-of-peak crossings.

Enums§

CheckedFigure
A figure a curve file’s check compares.
CurveFormat
A thrust-curve file format.
CurveLicense
A curve’s data license, as ThrustCurve records it. ThrustCurve’s API leaves the key out when no license is recorded, which reads as CurveLicense::Unknown.
CurveSource
Who produced a curve (ThrustCurve’s source).
MotorType
Whether a motor is used once or reloaded into a reusable case.
MotorWarningKind
What a warning for flying a catalog motor’s file is about (CatalogMotor::flight_warning_kinds).

Constants§

BORE_TOLERANCE_MM
How far, in mm, a motor named for a mount may be wider than its bore and still fit, and by how much another motor must fit more closely to make the name ambiguous (Catalog::find_for_bore): the 1 mm Catalog::find_for_design allows between a design’s case and a catalog motor (ADR-302 §1).
BURNOUT_MASS_BOUND
How far a flown burnout mass (loaded less propellant: the empty case) may be from its record’s, either way, as a share of the record’s burnout mass, before flying it warns: 5%, the share LOADED_MASS_BOUND and PROPELLANT_SHORT_BOUND hold, applied to the motor’s mass after burnout. For a motor aft of the center of gravity, as on nearly every rocket, a light burnout mass puts the center of gravity forward after burnout, so the margin then reads high, the flattering side; a heavy one gives too low an apogee and too low a margin.
CHECK_BOUND
The relative bound of a curve file’s check: each figure within 1% of the motor’s stated one (ADR-005, ADR-298).
LOADED_MASS_BOUND
How far a flown loaded mass may be from its motor’s record, either way, as a share of the record’s, before flying it warns: 5%, the bound a file’s propellant mass has had since issue #578 (PROPELLANT_SHORT_BOUND). A heavy loaded mass gives too low an apogee, the side that flatters a waiver; a light one puts the center of gravity forward, so the margin after burnout reads high. Of the 840 bundled motors whose default file and record both give one, 36 are further apart than this (issue #1233); the Quest D8’s file gives 454 g against 45.6 g.
PROPELLANT_SHARE_SPAN
The span of propellant shares, propellant over loaded mass, that the bundled ThrustCurve.org records state: from 2.1 g of 18.2 g (Quest A3) to 0.75 (Jambol B1, Ultra B1, AMW GG-75-6000), over the 878 records giving both masses, leaving out one whose propellant is twice its loaded mass, which no motor can be. A flown share outside it warns (CatalogMotor::mass_warnings).
PROPELLANT_SHORT_BOUND
How far below its motor’s record a file’s propellant mass may be, as a share of the record’s, before flying it warns: 5%, the rule a fetched file has had since issue #578 (the reasoning, with its survey, is hpr_net::on_demand::PROPELLANT_SHORT_BOUND’s, which is this). A light propellant mass with a right loaded mass flies too heavy a burnout mass and too low an apogee, the flattering side for a waiver; a heavy one isn’t warned of.

Functions§

bundled_curve_text
The text of a bundled curve file, by its path in the bundled index.
bundled_size_bytes
The bytes of data compiled into the crate for Catalog::bundled: the index and every curve file it reads, as UTF-8 text. It counts the data alone, not the code that reads it; how much a binary grows by it isn’t measured.