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.
Where:
is Greenwich mean sidereal time (rad), from greenwichMeanSiderealTimein@interstellar-tools/equationsis Earth's rotation, rad/s about the z axis
Units
- Inputs:
rin m,vin m/s, and aDate. - Output:
rin m,vin 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
| Parameter | Type | Description |
|---|---|---|
state | StateVectorInterface | The position r in m and velocity v in m/s in TEME, as propagate returns them. |
date | Date | The moment of the position, as a Date. |
Returns
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
- subSatellitePoint
- https://celestrak.org/publications/AIAA/2006-6753/ Vallado, Crawford, Hujsak & Kelso (2006), Revisiting Spacetrack Report #3, section on TEME