Skip to content

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.

CJ=x2+y2+2(1−μ)r1+2μr2−(x˙2+y˙2+z˙2)=2U−v2

Where:

  • r1, r2 are the distances to the two bodies, as in cr3bpDerivatives
  • v is the speed in the rotating frame

Units

  • Input: state in normalised units, mu dimensionless.
  • Output: CJ, normalised.

Notes

  • The only quantity the CR3BP keeps constant: an energy in the rotating frame. Watch it to check a numerical integration.
  • Since v2≥0, a body can only go where 2U≥CJ. The boundaries, the zero-velocity curves, wall off regions of space: with a high CJ, a spacecraft near Earth can't reach the Moon at all.
  • The walls first open at L1. For Earth–Moon, CJ 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 ​

ParameterTypeDescription
stateCr3bpStateCR3BP state [x, y, z, xDot, yDot, zDot] (finite, not at either body).
munumberMass ratio μ (finite, in (0, 0.5]).

Returns ​

number

The Jacobi constant CJ.

Throws ​

  • If mu or a state component is not finite.
  • If mu is 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.98800

See ​