Documentation / @interstellar-tools/equations / jacobiConstant
Function: jacobiConstant()
ts
function jacobiConstant(state: Cr3bpState, mu: number): number;Defined in: three-body/jacobi-constant.ts:55
Compute the Jacobi constant of a state in the circular restricted three-body problem.
Where:
, are the distances to the two bodies, as in cr3bpDerivatives is the speed in the rotating frame
Units
- Input:
statein normalised units,mudimensionless. - Output:
, normalised.
Notes
- The only quantity the CR3BP keeps constant: an energy in the rotating frame. Watch it to check a numerical integration.
- Since
, a body can only go where . The boundaries, the zero-velocity curves, wall off regions of space: with a high , a spacecraft near Earth can't reach the Moon at all. - The walls first open at L1. For Earth–Moon,
there is about 3.188; below that, the way to the Moon is open.
In practiceApollo 11, the free return
1.778
The Jacobi constant of a free return from Apollo 11's TLI
Well below the 3.188 at L1, so the zero-velocity curves leave the whole Earth–Moon region open. Apollo 11 left Earth with energy to spare, as far as the walls are concerned; reaching the Moon was a matter of aim.
Parameters
| Parameter | Type | Description |
|---|---|---|
state | Cr3bpState | CR3BP state [x, y, z, xDot, yDot, zDot] (finite, not at either body). |
mu | number | Mass ratio |
Returns
number
The Jacobi constant
Throws
- If
muor a state component is not finite. - If
muis outside (0, 0.5], or the state is at the centre of either body.
Example
ts
import type { Cr3bpState } from '@interstellar-tools/types';
// At rest at L4, C_J = 3 − μ(1 − μ)
const mu = 0.012151;
jacobiConstant([0.5 - mu, Math.sqrt(3) / 2, 0, 0, 0, 0], mu); // ≈ 2.98800See
- cr3bpDerivatives
- https://en.wikipedia.org/wiki/Jacobi_integral Jacobi integral