Skip to content

Documentation / @interstellar-tools/equations / zonalHarmonicsAcceleration

Function: zonalHarmonicsAcceleration() ​

ts
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, J2 and up, on top of the central −μr/r3.

A planet isn't a sphere. Earth bulges at the equator, J2, and is slightly pear-shaped, J3; the higher zonals are smaller ripples from pole to pole. The bulge turns a satellite's orbit plane and its perigee, which is what makes sun-synchronous orbits and frozen orbits possible.

a=∑n≥2μJnr2(Rr)n[((n+1)Pn(u)+uPn′(u))r^−Pn′(u)z^],u=zr

Where:

  • r is the position from the planet's centre, on axes with z along its rotation axis (m)
  • μ is the planet's gravitational parameter (m³/s²) and R the reference radius of its Jn (m)
  • Pn is the Legendre polynomial of degree n, and Pn′ its derivative

Units

  • Inputs: r and Re in m, mu in m³/s², J dimensionless.
  • Output: the acceleration in m/s², on the axes of r.

Notes

  • Only the perturbation: add the central acceleration −μr/r3 for the full gravity.
  • J2 is a few thousandths of the central pull in low Earth orbit; J3 to J6 are each a few thousandths of J2 or less.
  • The Jn 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.
In practiceJ₂ on the ISS

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.

ts
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 ​

ParameterTypeDescription
rVector3DTupleTypePosition r in m, from the planet's centre, with z along its rotation axis (finite, not zero).
munumberGravitational parameter μ in m³/s² (finite, > 0).
RenumberReference radius R in m of the coefficients (finite, > 0).
Jreadonly number[]The zonal coefficients J2,J3,… in order, from J2 (finite numbers).

Returns ​

Vector3DTupleType

The acceleration in m/s², without the central term.

Throws ​

  • If r is not three finite numbers, or a number in mu, Re or J is not finite.
  • If r is zero, or mu or Re is not > 0.

Example ​

ts
// 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 it

See ​