Skip to content

Documentation / @interstellar-tools/tracking / temeToEarthFixed

Function: temeToEarthFixed() ​

ts
function temeToEarthFixed(
  state: StateVectorInterface,
  date: Date
): StateVectorInterface;

Defined in: satellites/earth-fixed.ts:65

Turn a position and velocity in TEME, the frame SGP4 works in, into Earth-fixed coordinates, by turning them with Earth through Greenwich mean sidereal time.

rEF=Rz(θGMST)rTEME,vEF=Rz(θGMST)vTEME−ω⊕×rEF

Where:

  • θGMST is Greenwich mean sidereal time (rad), from greenwichMeanSiderealTime in @interstellar-tools/equations
  • ω⊕ is Earth's rotation, 7.292115×10−5 rad/s about the z axis

Units

  • Inputs: r in m, v in m/s, and a Date.
  • Output: r in m, v in m/s, Earth-fixed: x through the prime meridian, z along the rotation axis.

Notes

  • Polar motion is ignored: the result is the pseudo Earth-fixed frame (PEF), which differs from ITRF, the frame of GPS coordinates, by up to about 15 m at the surface as the pole wanders.
  • UT1 is taken as UTC, as in greenwichMeanSiderealTime: up to 0.9 s of Earth's rotation, about 400 m on the equator.
  • The velocity is relative to the rotating Earth, as a ground station sees it, not inertial.

Parameters ​

ParameterTypeDescription
stateStateVectorInterfaceThe position r in m and velocity v in m/s in TEME, as propagate returns them.
dateDateThe moment of the position, as a Date.

Returns ​

StateVectorInterface

The Earth-fixed position r in m and velocity v in m/s.

Throws ​

If r or v is not three finite numbers, or date is not a valid Date.

Example ​

ts
const date = new Date('2026-11-04T12:00:00Z');
const { r } = temeToEarthFixed(propagate(iss, date), date);

See ​