Documentation / @interstellar-tools/tracking / propagate
Function: propagate()
ts
function propagate(
elements: MeanElementsInterface,
date: Date
): StateVectorInterface;Defined in: satellites/propagate.ts:154
Propagate a satellite's mean elements with SGP4 to a moment: its position and velocity in the TEME frame. See propagateMinutes.
Notes
- The time since the epoch is taken in UTC, which SGP4 treats as UT1.
Parameters
| Parameter | Type | Description |
|---|---|---|
elements | MeanElementsInterface | The mean elements, from parseTle or parseOmm. |
date | Date | The moment, as a Date. |
Returns
The position r in m and velocity v in m/s, in the TEME frame.
Throws
- If
dateis not a validDate, or a value ofelementsis not a finite number. - If the elements are out of range, or SGP4 fails at that time: the satellite has decayed, or its eccentricity or mean motion left the model's range.
Example
ts
const iss = parseTle(
'1 25544U 98067A 26308.36953014 .00005228 00000+0 10236-3 0 9991',
'2 25544 51.6329 326.3987 0007186 346.7494 13.3304 15.49173979593483'
);
propagate(iss, new Date('2026-11-04T12:00:00Z')); // { r: [...], v: [...] }