Documentation / @interstellar-tools/tracking / earthFixedToTeme
Function: earthFixedToTeme()
ts
function earthFixedToTeme(
state: StateVectorInterface,
date: Date
): StateVectorInterface;Defined in: satellites/earth-fixed.ts:137
Turn an Earth-fixed position and velocity, such as a GPS receiver's fix, into TEME, the frame SGP4 works in: the reverse of temeToEarthFixed. It's the first step in fitting elements to GPS fixes with fitElements.
Units
- Inputs:
rin m,vin m/s, Earth-fixed, and aDate. - Output:
rin m,vin m/s, in TEME.
Notes
- As in temeToEarthFixed, polar motion is ignored and UT1 is taken as UTC: GPS positions are in ITRF, which this treats as the pseudo Earth-fixed frame. The difference, tens to hundreds of metres, is well inside SGP4's own error.
- The velocity is the one relative to the rotating Earth, as GPS receivers give it.
- GPS receivers usually time-tag fixes in GPS time, 18 s ahead of UTC since 2017: convert the time to UTC first, or the position lands 140 km along the orbit from where it was.
Parameters
| Parameter | Type | Description |
|---|---|---|
state | StateVectorInterface | The Earth-fixed position r in m and velocity v in m/s. |
date | Date | The moment of the position, as a UTC Date. |
Returns
The position r in m and velocity v in m/s in TEME.
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 fix = { r: [4_190_000, -3_870_000, 3_960_000], v: [2_480, 5_560, 2_810] };
earthFixedToTeme(fix, date); // { r: [...], v: [...] }, in TEME