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:
Where:
, are the latitude and longitude below the satellite (rad) is the footprint's angular radius (rad) are the directions, clockwise from north
Units
- Inputs: the position's
phiandlambdain radians andhin m;minElevationin radians. - Output: the polygon's points,
phiandlambdain radians, longitude in (-π, π], andh0.
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
; with many points, sphericalPolygonAreain@interstellar-tools/equationsgives the same.
Parameters
| Parameter | Type | Default value | Description |
|---|---|---|---|
position | GeodeticCoordinatesInterface | undefined | The point below the satellite and its height, as subSatellitePoint returns them. |
minElevation? | Radians | ... | Minimum elevation in radians (in [0, π/2), default 0). |
points? | number | 72 | Number 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
pointsis not an integer. - If
phiis outside [-π/2, π/2],h <= 0,minElevationis outside [0, π/2), orpoints < 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));