Documentation / @interstellar-tools/equations / repeatGroundTrack
Function: repeatGroundTrack()
ts
function repeatGroundTrack(
revolutions: number,
days: number,
J2: number,
mu: number,
Re: number,
i: Radians,
e: number,
rotationRate: number
): number;Defined in: orbits/repeat-ground-track.ts:73
The semi-major axis of a repeat ground track orbit: one whose track over the ground repeats exactly after a whole number of revolutions in a whole number of days, so a satellite revisits the same places on a fixed cycle. Landsat 8 and 9 make 233 revolutions in 16 days.
The track repeats when the satellite has crossed the equator northbound
with the J2 drifts of the node, the perigee and the mean anomaly:
solved for
Where:
, are the revolutions and the days of the cycle is the planet's rotation rate (rad/s): 7.292115 × 10⁻⁵ for Earth is the mean motion, and , , are the planet's second zonal harmonic, equatorial radius (m) and gravitational parameter (m³/s²)
Units
- Inputs:
muin m³/s²,Rein m,iin radians,rotationRatein rad/s. - Output:
in m.
Notes
daysare nodal days: the time for the ground to turn once under the orbit's plane. For a sun-synchronous orbit they're solar days.- Keep
revolutionsanddayswithout a common factor: 30 in 2 repeats after 1 day, as 15 in 1. - First order in J2. Drag lowers a real orbit slowly, so missions trim it to keep the cycle.
Parameters
| Parameter | Type | Description |
|---|---|---|
revolutions | number | Revolutions in the cycle |
days | number | Nodal days in the cycle |
J2 | number | The planet's second zonal harmonic |
mu | number | The planet's gravitational parameter |
Re | number | The planet's equatorial radius |
i | Radians | Inclination |
e | number | Eccentricity |
rotationRate | number | The planet's rotation rate |
Returns
number
The semi-major axis
Throws
- If any input is not a finite number, or
revolutionsordaysis not an integer. - If
revolutions,days,mu,ReorrotationRateis not > 0,eis outside [0, 1), or the cycle has no orbit above the planet's surface.
Example
ts
// Landsat 8 and 9: 233 revolutions in 16 days, at 98.2°
repeatGroundTrack(
233,
16,
1.08262668e-3,
3.986004418e14,
6_378_137,
toRad(98.2),
0.0001,
7.292115e-5
);
// ≈ 7 077 700 m: Landsat's semi-major axis, 700 km above the equator