Tested with: KSA Version 2026.10.19.5638
Because KSA is a realistic spaceflight simulator, units and coordinate systems matter a lot.
This page documents:
KSA uses a standard physics unit system:
All position, velocity, acceleration, and force values throughout the simulation are expressed using these base units.
All coordinate frames in KSA are right-handed.
This applies universally: global, local, orbital, and body-fixed frames.

Vectors are suffixed with the frame in which they are expressed:
positionCce is position in Celestial-Centered EclipticvelocityCcf is velocity in Celestial-Centered, Celestial-FixedFrame rotations use the notation X2Y to denote a passive rotation taking vectors from frame X into frame Y. Examples:
cci2Ccf is inertial → celestial-fixedorb2Cce is orbital → eclipticActive vector rotations are also suffixed:
jointAngleBody is rotation expressed in the vehicle’s body frameBelow is a summary of all major coordinate frames used in the simulation.
The global “world” frame used for rendering and for comparing orientations throughout the system.
Identical to CCE and CCI when centered on the sun.

A surface-fixed rotating frame used for surface-relative calculations.

Used for orbital simulation around a celestial.
Axes remain inertially fixed with respect to the ecliptic.

Shares the celestial’s origin but uses global ecliptic axes.
Useful for cross-celestial orientation comparisons.

Defines the orbital plane of a spacecraft or celestial. Commonly used in Keplerian element conversions.

Useful for spacecraft attitude control.
Provides intuitive axes (down, forward, etc.) for a vehicle in orbit.

Designed for maneuver planning using prograde/normal/radial axes.

Fixed to the spacecraft geometry. Defines roll, pitch, and yaw axes.

Used for computing aerodynamic forces.
Aligns X with the relative wind direction.
