Skip to content

Documentation / @interstellar-tools/tracking / subSatellitePoint

Function: subSatellitePoint() ​

ts
function subSatellitePoint(
  elements: MeanElementsInterface,
  date: Date
): GeodeticCoordinatesInterface;

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

Find the point on Earth under a satellite at a moment: the geodetic latitude, longitude and height on the WGS 84 ellipsoid.

Propagates the elements with SGP4 (propagate), turns the position with Earth (temeToEarthFixed) and converts it to geodetic coordinates (bodyFixedToGeodetic in @interstellar-tools/equations). Taking it at a series of times draws the satellite's ground track.

Notes

  • The point is where the normal to the ellipsoid through the satellite meets it: the geodetic latitude on maps and GPS receivers.
  • The height is above the WGS 84 ellipsoid, not above the ground or sea level.
  • It's as accurate as the elements: about 1 km at the epoch, growing a few kilometres a day.

Parameters ​

ParameterTypeDescription
elementsMeanElementsInterfaceThe mean elements, from parseTle or parseOmm.
dateDateThe moment, as a Date.

Returns ​

GeodeticCoordinatesInterface

phi, the geodetic latitude in radians, lambda, the longitude in radians (east positive, in (-π, π]), and h, the height in m.

Throws ​

  • If date is not a valid Date, or a value of elements is not a finite number.
  • If SGP4 fails at that time, as in propagate.

Example ​

ts
const { phi, lambda, h } = subSatellitePoint(
  iss,
  new Date('2026-11-04T12:00:00Z')
);
// |phi| up to 51.6°, the ISS's inclination; h about 420 km

See ​

temeToEarthFixed