Skip to content

Documentation / @interstellar-tools/equations / hyperbolicEccentricity

Function: hyperbolicEccentricity() ​

ts
function hyperbolicEccentricity(
  vInfinity: number,
  rp: number,
  mu: number
): number;

Defined in: orbits/hyperbolic-eccentricity.ts:55

Compute the eccentricity of a hyperbola from the excess speed and the periapsis distance.

e=1+rpv∞2μ

Where:

  • rp is the periapsis distance from the body's centre (m)
  • v∞ is the hyperbolic excess speed (m/s)
  • μ is the body's gravitational parameter (m³/s²)

Units

  • Inputs: vInfinity in m/s, rp in m, mu in m³/s².
  • Output: e dimensionless, > 1.

Notes

  • From rp=a(1−e) with a=−μ/v∞2.
  • A slow, close pass gives e just above 1, a nearly parabolic swing; a fast, distant one gives a large e and a nearly straight path.
  • The trajectory turns through 2arcsin⁡(1/e); see gravityAssistTurningAngle.
In practiceApollo 11, arriving at the Moon

1.44

Approach hyperbola: 1.08 km/s excess speed, closest approach 113.9 km above the surface

ts
hyperbolicEccentricity(1080, 1_737_400 + 113_900, 4.902800118e12); // ≈ 1.440

Parameters ​

ParameterTypeDescription
vInfinitynumberHyperbolic excess speed v∞ in m/s (finite, > 0).
rpnumberPeriapsis distance rp in m (finite, > 0).
munumberGravitational parameter μ in m³/s² (finite, > 0).

Returns ​

number

Eccentricity e (> 1).

Throws ​

  • If any input is not a finite number.
  • If vInfinity <= 0, rp <= 0 or mu <= 0.

Example ​

ts
// A Jupiter flyby: v∞ = 6 km/s, periapsis at 5 Jupiter radii
const e = hyperbolicEccentricity(6000, 5 * 71_492e3, 1.26686534e17);
// e ≈ 1.102

See ​