Skip to main content

Module recovery

Module recovery 

Source
Expand description

When a .ork design’s parachutes and streamers open, how much drag each states, and when each stage separates.

Where a .ork keeps them. A <parachute> or <streamer> names the event that deploys it (<deployevent>), a height for the event that needs one (<deployaltitude>) and a delay after it (<deploydelay>), and may change any of the three for one configuration in a <deploymentconfiguration configid="…">. A stage says when it separates the same way, with <separationevent>, <separationaltitude>, <separationdelay> and <separationconfiguration configid="…"> (the file specification). A per-configuration setting replaces the three one at a time: whichever it leaves out, the device’s or stage’s own stands.

What the words mean. OpenRocket’s documentation lists none of them. The words here are the ones OpenRocket 24.12 writes, each measured by setting it through the program’s public setters and saving (validation/oracles/openrocket/events.py, whose results validation/fixtures/ork/openrocket-events.json holds and a test reads). The same run shows a deploy height is above the ground, not the sea, and that in its run a parachute set to open above apogee did not open at all.

A per-configuration setting replacing the three one at a time is hpr’s reading: OpenRocket was not probed on a file that leaves one out.

Drag. <cd>auto</cd> leaves the drag coefficient to OpenRocket: 0.8 for a parachute, on the canopy’s area, which its technical documentation gives as the default (section 4.2.5) and the same run reads back, and for a streamer a value from the strip’s length and material, on the strip’s area (the documentation’s appendix C). This reader keeps the word, and the number when one is stated; choosing the model is the flight’s business.

Nothing here flies a device: hpr::ork::recovery maps these settings onto hpr-sim’s devices (ADR-153, the decision to fly them as OpenRocket does), since hpr-io does not depend on hpr-sim.

Structs§

EventSetting
An event, a height for the events that need one, and a delay after it: when a device deploys or a stage separates. Each is None where the file does not say.
Recovery
Every recovery setting in a .ork design.
RecoveryDevice
A parachute’s or streamer’s recovery settings.
StageSeparation
A stage’s separation settings.
UnreadDevice
A parachute or streamer inside a part hpr does not read, such as a pod.

Enums§

DeployEvent
What deploys a recovery device, as <deployevent> names it.
DeviceKind
Which kind of recovery device.
SeparationEvent
What separates a stage from the one above it, as <separationevent> names it. “This stage” is the stage that carries the setting, the lower one, which drops away.

Type Aliases§

Deployment
When a recovery device deploys.
Separation
When a stage separates.