Skip to content

Flight data variables

orhelper.FlightDataType has one member for each variable that OpenRocket records during a simulation. Pass members (or their names as strings) to Helper.get_timeseries and Helper.get_final_values.

Units

Values are returned in SI units (metres, kilograms, seconds, radians), whatever unit OpenRocket shows in its user interface. For example, TYPE_MOTOR_MASS is in kg and TYPE_ROLL_RATE is in rad/s. The Unit (SI) column gives the unit of each variable.

Latitude and longitude changed unit in OpenRocket 24.12

TYPE_LATITUDE and TYPE_LONGITUDE are in radians in OpenRocket 22.02 and 23.09, but in degrees in 24.12 and later. The same simulation gives 0.7854 for a launch site at 45°N in 22.02/23.09 and 45.0 in 24.12 and later, with no error. Check the version you use, or convert with numpy.degrees when the values are small.

A variable that doesn't exist in the OpenRocket version you run raises an AttributeError when you request it; the last column shows where each is available. TYPE_PROPELLANT_MASS is a legacy name of TYPE_MOTOR_MASS, and either can be used with any version. Some variables are nan at some time steps, for example at the first one; use numpy.nanmax and friends.

Member Name in OpenRocket Symbol Unit (SI) Available in
TYPE_TIME Time t s all
TYPE_ALTITUDE Altitude h m all
TYPE_VELOCITY_Z Vertical velocity Vz m/s all
TYPE_ACCELERATION_Z Vertical acceleration Az m/s² all
TYPE_VELOCITY_TOTAL Total velocity Vt m/s all
TYPE_ACCELERATION_TOTAL Total acceleration At m/s² all
TYPE_POSITION_X Position East of launch Px m all
TYPE_POSITION_Y Position North of launch Py m all
TYPE_POSITION_XY Lateral distance Pl m all
TYPE_POSITION_DIRECTION Lateral direction θl rad all
TYPE_VELOCITY_XY Lateral velocity Vl m/s all
TYPE_ACCELERATION_XY Lateral acceleration Al m/s² all
TYPE_LATITUDE Latitude φ rad (22.02, 23.09)
° N (24.12, 26.xx)
all
TYPE_LONGITUDE Longitude λ rad (22.02, 23.09)
° E (24.12, 26.xx)
all
TYPE_GRAVITY Gravitational acceleration g m/s² all
TYPE_AOA Angle of attack α rad all
TYPE_ROLL_RATE Roll rate (Z) dΦ rad/s all
TYPE_PITCH_RATE Pitch rate (Y) dθ rad/s all
TYPE_YAW_RATE Yaw rate (X) dΨ rad/s all
TYPE_MASS Mass m kg all
TYPE_PROPELLANT_MASS Motor mass mp kg all
TYPE_LONGITUDINAL_INERTIA Longitudinal moment of inertia Il kg·m² all
TYPE_ROTATIONAL_INERTIA Rotational moment of inertia Ir kg·m² all
TYPE_CP_LOCATION CP location Cp m all
TYPE_CG_LOCATION CG location Cg m all
TYPE_STABILITY Stability margin calibers S – all
TYPE_MACH_NUMBER Mach number M – all
TYPE_REYNOLDS_NUMBER Reynolds number R – all
TYPE_THRUST_FORCE Thrust Ft N all
TYPE_DRAG_FORCE Drag force Fd N all
TYPE_DRAG_COEFF Drag coefficient (CD) Cd – all
TYPE_AXIAL_DRAG_COEFF Axial drag coefficient (CA) Cda – all
TYPE_FRICTION_DRAG_COEFF Friction drag coefficient (CD_friction) Cdf – all
TYPE_PRESSURE_DRAG_COEFF Pressure drag coefficient (CD_pressure) Cdp – all
TYPE_BASE_DRAG_COEFF Base drag coefficient (CD_base) Cdb – all
TYPE_NORMAL_FORCE_COEFF Normal force coefficient (CN) Cn – all
TYPE_PITCH_MOMENT_COEFF Pitch moment coefficient (Cm) Cθ – all
TYPE_YAW_MOMENT_COEFF Yaw moment coefficient CτΨ – all
TYPE_SIDE_FORCE_COEFF Side force coefficient Cτs – all
TYPE_ROLL_MOMENT_COEFF Roll moment coefficient CτΦ – all
TYPE_ROLL_FORCING_COEFF Roll forcing coefficient CfΦ – all
TYPE_ROLL_DAMPING_COEFF Roll damping coefficient CζΦ – all
TYPE_PITCH_DAMPING_MOMENT_COEFF Pitch damping coefficient Cζθ – all
TYPE_YAW_DAMPING_MOMENT_COEFF Yaw damping coefficient CζΨ – all
TYPE_CORIOLIS_ACCELERATION Coriolis acceleration Ac m/s² all
TYPE_REFERENCE_LENGTH Reference length Lr m all
TYPE_REFERENCE_AREA Reference area Ar m² all
TYPE_ORIENTATION_THETA Vertical orientation (zenith) Θ rad all
TYPE_ORIENTATION_PHI Lateral orientation (azimuth) Φ rad all
TYPE_WIND_VELOCITY Wind velocity Vw m/s all
TYPE_AIR_TEMPERATURE Air temperature T K all
TYPE_AIR_PRESSURE Air pressure P Pa all
TYPE_SPEED_OF_SOUND Speed of sound Vs m/s all
TYPE_TIME_STEP Simulation time step dt s all
TYPE_COMPUTATION_TIME Computation time tc s all
TYPE_ALTITUDE_ABOVE_SEA Altitude above sea level ha m 24.12, 26.xx
TYPE_MOTOR_MASS Motor mass mp kg all
TYPE_THRUST_WEIGHT_RATIO Thrust-to-weight ratio Twr – 24.12, 26.xx
TYPE_WIND_DIRECTION Wind direction θw rad 24.12, 26.xx
TYPE_AIR_DENSITY Air density ρ kg/m³ 24.12, 26.xx
TYPE_ACCELERATION_X Acceleration to the East Ax m/s² 26.xx
TYPE_ACCELERATION_Y Acceleration to the North Ay m/s² 26.xx
TYPE_ACCELERATION_BODYX X body acceleration Abx m/s² 26.xx
TYPE_ACCELERATION_BODYY Y body acceleration Aby m/s² 26.xx
TYPE_ACCELERATION_BODYZ Z body acceleration Abz m/s² 26.xx
TYPE_DAMPING_RATIO Damping ratio ζ – 26.xx
TYPE_NATURAL_FREQUENCY Natural frequency ωn rad/s 26.xx
TYPE_THRUST_CORRECTION Thrust Pressure Correction Fta N 26.xx
TYPE_CNA Normal force coefficient derivative (CNα) CNα – 26.xx
TYPE_DAMPING_MOMENT_COEFF Damping moment coefficient Cdm kg·m²/s 26.xx
TYPE_DAMPING_MOMENT_COEFF_AERODYNAMIC Damping moment coefficient (aerodynamic) Cdm_aero kg·m²/s 26.xx
TYPE_DAMPING_MOMENT_COEFF_PROPULSIVE Damping moment coefficient (propulsive) Cdm_prop kg·m²/s 26.xx
TYPE_CORRECTIVE_MOMENT_COEFF Corrective moment coefficient Ccm N·m 26.xx