Skip to main content

Module simulations

Module simulations 

Source
Expand description

The simulations OpenRocket last ran on a .ork design: the launch conditions each was flown in and the results it stored.

Where a .ork keeps them. <simulations> holds one <simulation> per run, with a name, a status, the <conditions> it was flown in, and, when OpenRocket saved them, its results in <flightdata>: ten summary figures as attributes, and a <databranch> per stage, each a time series (<datapoint> rows, comma-separated, in the order its types attribute names) with the flight’s <event>s (the file specification, Simulation Data).

What the numbers mean. The file-format page gives units only for the multilevel wind (meters, m/s and radians), and its own example writes the launch rod’s direction as 90.0 and the wind’s as 1.5707963267948966. A committed probe (validation/oracles/openrocket/conditions.py, results in validation/fixtures/ork/openrocket-conditions.json) runs OpenRocket 24.12 and settles it:

  • launchrodangle and launchroddirection are degrees; this reader gives them in radians. The direction is a compass bearing, clockwise from north: a rod tilted toward 90 lands the rocket to the east. With launchintowind, OpenRocket writes the wind’s bearing, in degrees, as the rod’s.
  • winddirection is radians, the bearing the wind blows from: in a wind from the east a rocket drifts west. It is never the rod’s direction (Loft lesson L64: Loft read it from launchroddirection).
  • In the eight columns the probe compared, the time series is SI with angles in radians and latitude in degrees, rounded when stored: to three decimal places (287.857 K), and a large value to four significant figures (100,796.6 Pa is stored as 100,800). NaN marks a quantity OpenRocket did not compute at that step, and this reader keeps it as None.

All of this is measured on OpenRocket 24.12; a file written by a much older version may have meant the rod’s direction otherwise, which is not measured.

Structs§

LaunchConditions
The launch conditions a stored simulation was flown in. Each is None where the file does not say.
StoredBranch
One stage’s stored time series.
StoredEvent
An event a stored simulation logged.
StoredResults
What a stored simulation gave: its summary and its time series.
StoredSimulation
A simulation stored in a .ork.
WindLevel
One level of a multilevel wind.

Enums§

Atmosphere
The atmosphere a stored simulation was flown in.
StoredReferenceExclusion
Why a stored simulation cannot be used as a validation reference.

Constants§

OPENROCKET_CALCULATOR
The aerodynamic calculator identifier accepted for an OpenRocket reference.
OPENROCKET_SIMULATOR
The simulator identifier accepted for an OpenRocket reference.