Skip to content

Documentation / @interstellar-tools/tracking / coverageFootprint

Function: coverageFootprint() ​

ts
function coverageFootprint(
  position: GeodeticCoordinatesInterface,
  minElevation?: Radians,
  points?: number
): GeodeticCoordinatesInterface[];

Defined in: satellites/ground-track.ts:260

The coverage footprint of a satellite: the circle on the ground from which it's above a minimum elevation, as a polygon of latitudes and longitudes, ready to draw on a map.

The circle's angular radius is footprintRadius, and its points are the destinations at that distance from the point below the satellite, in every direction:

φk=arcsin⁡(sin⁡φcos⁡λ0+cos⁡φsin⁡λ0cos⁡αk)λk=λ+atan2(sin⁡αksin⁡λ0cos⁡φ, cos⁡λ0−sin⁡φsin⁡φk)

Where:

  • φ, λ are the latitude and longitude below the satellite (rad)
  • λ0 is the footprint's angular radius (rad)
  • αk=2πk/n are the directions, clockwise from north

Units

  • Inputs: the position's phi and lambda in radians and h in m; minElevation in radians.
  • Output: the polygon's points, phi and lambda in radians, longitude in (-π, π], and h 0.

Notes

  • On a sphere of Earth's equatorial radius: the flattening moves the edge by a fraction of a percent.
  • Near the antimeridian or a pole, the polygon wraps: points jump from one edge of a flat map to the other, or circle the pole. Split it, or draw it on an azimuthal projection, before filling it.
  • Its area on the sphere is 2πR2(1−cos⁡λ0); with many points, sphericalPolygonArea in @interstellar-tools/equations gives the same.

Parameters ​

ParameterTypeDefault valueDescription
positionGeodeticCoordinatesInterfaceundefinedThe point below the satellite and its height, as subSatellitePoint returns them.
minElevation?Radians...Minimum elevation in radians (in [0, π/2), default 0).
points?number72Number of points on the circle (an integer, at least 3): 72 by default, one every 5°.

Returns ​

GeodeticCoordinatesInterface[]

The polygon, in order clockwise from north: geodetic latitude phi and longitude lambda in radians, and h 0.

Throws ​

  • If a value is not a finite number, or points is not an integer.
  • If phi is outside [-π/2, π/2], h <= 0, minElevation is outside [0, π/2), or points < 3.

Example ​

ts
const below = subSatellitePoint(iss, new Date());

// Where the ISS is at least 10° above the horizon
const footprint = coverageFootprint(below, toRad(10));

See ​