Documentation / @interstellar-tools/equations / lagrangePoints
Function: lagrangePoints()
function lagrangePoints(
m1: number,
m2: number,
separation: number
): LagrangePointsInterface;Defined in: three-body/lagrange-points.ts:107
The five Lagrange points of two bodies circling each other: where a third, small body can stay put relative to them. JWST, Gaia and SOHO are parked at Sun-Earth L1 and L2, and the Trojan asteroids gather at Sun-Jupiter L4 and L5.
L4 and L5 sit at the corners of equilateral triangles with the two bodies. L1, L2 and L3 lie on the line through them, at distances
solved with Newton's method from the Hill approximation
Where:
is the distance, in units of the separation, of L1 and L2 from the smaller body, and of L3 from the larger , are the larger and the smaller body's masses
Units
- Inputs:
m1andm2in the same unit, kg or gravitational parameters in m³/s²;separationin m. - Output: positions in m, in the frame turning with the bodies, from their barycentre: see LagrangePointsInterface.
Notes
- The larger body is at
and the smaller at , as in cr3bpDerivatives scaled by the separation . - L1, L2 and L3 are unstable: a spacecraft there needs small manoeuvres every few weeks to stay. L4 and L5 are stable when the mass ratio is small enough: see areTrojanPointsStable.
- Spacecraft "at" L1 or L2, such as JWST, fly halo orbits around them, hundreds of thousands of kilometres across.
1.5 million km
From Earth, straight away from the Sun
Four times the Moon's distance, where Earth's pull and the Sun's let a spacecraft keep pace with Earth around the Sun, in Earth's shadow side.
const { L2 } = lagrangePoints(1.32712440041e20, 4.0350323e14, 1.495978707e11);
L2[0] - (1 - 3.04e-6) * 1.495978707e11; // ≈ 1.5e9 m beyond EarthParameters
| Parameter | Type | Description |
|---|---|---|
m1 | number | Mass (or gravitational parameter) of the larger body (finite, > 0). |
m2 | number | Mass (or gravitational parameter) of the smaller body (finite, > 0, <= m1). |
separation | number | Distance between the two bodies in m (finite, > 0). |
Returns
L1 to L5 in m: see LagrangePointsInterface.
Throws
- If any input is not a finite number.
- If
m1 <= 0,m2 <= 0,m2 > m1orseparation <= 0.
Example
// Earth and the Moon, 384 400 km apart
const { L1 } = lagrangePoints(3.986004418e14, 4.9028e12, 384_400_000);
L1[0]; // ≈ 321 710 km from the barycentre: 326 381 km from Earth