Documentation / @interstellar-tools/equations / cr3bpMassRatio
Function: cr3bpMassRatio()
ts
function cr3bpMassRatio(m1: number, m2: number): number;Defined in: three-body/cr3bp-mass-ratio.ts:39
Compute the mass ratio
Where:
is the larger body's mass, the smaller's
Units
- Inputs:
m1andm2in the same unit: kg, or gravitational parameters in m³/s² (the ratio is the same). - Output:
, dimensionless, in (0, 0.5].
Notes
- In the normalised rotating frame, the larger body sits at
and the smaller at ; their centre of mass is the origin. - Earth–Moon:
. Sun–Earth: . Sun–Jupiter: . - The Lagrange points L4 and L5 are stable for
.
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
number
The mass ratio
Throws
- If any input is not a finite number.
- If
m1 <= 0,m2 <= 0orm2 > m1.
Example
ts
// Earth and Moon, from their gravitational parameters
cr3bpMassRatio(3.986004418e14, 4.902800118e12); // ≈ 0.012151