Skip to content

Coordinate frames and units

QuantityUnit
position, length, altitude, radius, SMAm
velocity and speedm/s
masskg
thrust, impulseN, N·s
time, UT, periodseconds
/sim schedule offsets and registry timesmilliseconds
most anglesdegrees
angular rate / accelerationrad/s, rad/s²
pressure, density, power, energyPa, kg/m³, W, J
attitude quaternionunit x y z w, Body to CCI

Track authoring times are seconds even though live schedule registry times are milliseconds. Camera lengths are meters and camera angles degrees. FX fields state their own unit in the field name or help output.

FrameMeaningTypical use
ECLsystem ecliptic framebody motion
CCEcelestial-centered eclipticbody-local inertial data
CCIcelestial-centered inertial about vessel parentvessel position, velocity, attitude target, burns
CCF / bodyfixedrotating body frameground-relative placement
ENUeast, north, up at a surface pointlocal ground operations
LVLHlocal vertical/local horizontalorbital-relative guidance
body / assemblyvessel axes and CoMmanual RCS, body-frame impulse

position/cci, velocity/cci, attitude/quat, ctl/burn, teleport state, and default debug impulse all use CCI. CCI has +Z along the parent north pole, +X at the vernal direction, and an equatorial X-Y plane. The attitude quaternion transforms a body-frame vector into CCI.

Use bodies/<parent>/{mu,radius,rotation_rate} for orbital calculations. Surface speed differs from inertial/orbital speed because it includes parent rotation. For camera’s six named placement frames, see Camera.