Documentation / @interstellar-tools/equations / areTrojanPointsStable
Function: areTrojanPointsStable()
ts
function areTrojanPointsStable(m1: number, m2: number): boolean;Defined in: three-body/lagrange-points.ts:188
Whether the Trojan points L4 and L5 of two bodies are stable: whether a small body there, nudged, circles the point rather than drifting off. It's why Jupiter has thousands of Trojan asteroids.
Where:
is the mass ratio, from cr3bpMassRatio is Routh's critical mass ratio
Units
- Inputs:
m1andm2in the same unit, kg or gravitational parameters in m³/s². - Output:
trueif L4 and L5 are stable.
Notes
- Every planet with the Sun, and the Moon with Earth (
), is below the limit: the larger body must outweigh the smaller about 25 times. Pluto and Charon ( ) are above it. - L1, L2 and L3 are unstable for every mass ratio.
- Linear stability in the circular problem: the Sun's pull makes Earth-Moon L4 and L5 hold dust clouds at most, not a body.
Parameters
| 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). |
Returns
boolean
true if L4 and L5 are linearly stable.
Throws
- If any input is not a finite number.
- If
m1 <= 0,m2 <= 0orm2 > m1.
Example
ts
areTrojanPointsStable(1.32712440041e20, 1.26686534e17); // true: Sun and Jupiter
areTrojanPointsStable(8.69e11, 1.06e11); // false: Pluto and Charon