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.
Where:
is the periapsis distance from the body's centre (m) is the hyperbolic excess speed (m/s) is the body's gravitational parameter (m³/s²)
Units
- Inputs:
vInfinityin m/s,rpin m,muin m³/s². - Output:
dimensionless, > 1.
Notes
- From
with . - A slow, close pass gives
just above 1, a nearly parabolic swing; a fast, distant one gives a large and a nearly straight path. - The trajectory turns through
; 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.440Parameters
| Parameter | Type | Description |
|---|---|---|
vInfinity | number | Hyperbolic excess speed |
rp | number | Periapsis distance |
mu | number | Gravitational parameter |
Returns
number
Eccentricity
Throws
- If any input is not a finite number.
- If
vInfinity <= 0,rp <= 0ormu <= 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