Documentation / @interstellar-tools/equations / zonalHarmonicsAcceleration
Function: zonalHarmonicsAcceleration()
function zonalHarmonicsAcceleration(
r: Vector3DTupleType,
mu: number,
Re: number,
J: readonly number[]
): Vector3DTupleType;Defined in: gravity/zonal-harmonics-acceleration.ts:78
The pull of a planet's flattening and pear shape on a satellite: the acceleration from its zonal harmonics,
A planet isn't a sphere. Earth bulges at the equator,
Where:
is the position from the planet's centre, on axes with along its rotation axis (m) is the planet's gravitational parameter (m³/s²) and the reference radius of its (m) is the Legendre polynomial of degree , and its derivative
Units
- Inputs:
randRein m,muin m³/s²,Jdimensionless. - Output: the acceleration in m/s², on the axes of
r.
Notes
- Only the perturbation: add the central acceleration
for the full gravity. is a few thousandths of the central pull in low Earth orbit; to are each a few thousandths of or less. - The
belong with the reference radius they were fitted with: for EGM2008, 6 378 136.3 m. - Zonal harmonics only: the tesseral terms, which make gravity vary with longitude, matter for geostationary station-keeping and precise orbits, not for most satellite lifetimes.
- The series describes the field outside the planet; it doesn't converge inside it.
0.014 m/s²
420 km up, over 45° latitude
A six-hundredth of the 8.6 m/s² of the central pull, and up to 0.025 m/s² over the poles: enough to turn the ISS's orbit plane 5° a day westward.
const r = 6_798_000;
const at45 = [r * Math.SQRT1_2, 0, r * Math.SQRT1_2];
const a = zonalHarmonicsAcceleration(
at45,
3.986004418e14,
6_378_136.3,
[1.0826e-3]
);
Math.hypot(...a); // ≈ 0.0138 m/s²Parameters
| Parameter | Type | Description |
|---|---|---|
r | Vector3DTupleType | Position |
mu | number | Gravitational parameter |
Re | number | Reference radius |
J | readonly number[] | The zonal coefficients |
Returns
The acceleration in m/s², without the central term.
Throws
- If
ris not three finite numbers, or a number inmu,ReorJis not finite. - If
ris zero, ormuorReis not > 0.
Example
// EGM2008's J2 to J6, at a satellite over the equator
zonalHarmonicsAcceleration(
[7_000_000, 0, 0],
3.986004415e14,
6_378_136.3,
[1.0826e-3, -2.5324e-6, -1.6199e-6, -2.2775e-7, 5.4067e-7]
); // ≈ [-0.0110, 0, 0]: toward the planet, from the bulge's extra mass under itSee
- j2NodalPrecessionRate
- thirdBodyAcceleration
- Vallado, Fundamentals of Astrodynamics and Applications, 4th ed. (2013), on the zonal harmonics