Documentation / @interstellar-tools/equations / hyperbolicSemiMajorAxis
Function: hyperbolicSemiMajorAxis()
ts
function hyperbolicSemiMajorAxis(vInfinity: number, mu: number): number;Defined in: orbits/hyperbolic-semi-major-axis.ts:52
Compute the semi-major axis of a hyperbola from the hyperbolic excess speed.
Where:
is the hyperbolic excess speed: the speed left over far from the body (m/s) is the body's gravitational parameter (m³/s²)
Units
- Inputs:
vInfinityin m/s,muin m³/s². - Output:
in m, negative.
Notes
- Negative by convention, so that vis-viva
holds for hyperbolas too. comes from a speed at distance by energy: , or from characteristicEnergyC3 as .
In practiceApollo 11, arriving at the Moon
−4 203 km
Approach hyperbola, with 1.08 km/s left over far from the Moon
ts
hyperbolicSemiMajorAxis(1080, 4.902800118e12); // ≈ -4 203 361 mParameters
| Parameter | Type | Description |
|---|---|---|
vInfinity | number | Hyperbolic excess speed |
mu | number | Gravitational parameter |
Returns
number
Semi-major axis
Throws
- If any input is not a finite number.
- If
vInfinity <= 0ormu <= 0.
Example
ts
// Leaving Earth for Mars with v∞ ≈ 2.95 km/s
const a = hyperbolicSemiMajorAxis(2950, 3.986004418e14);
// a ≈ -45 803 km