Documentation / @interstellar-tools/equations / trueToHyperbolicAnomaly
Function: trueToHyperbolicAnomaly()
ts
function trueToHyperbolicAnomaly(nu: Radians, e: number): number;Defined in: anomalies/true-to-hyperbolic-anomaly.ts:42
Convert a true anomaly on a hyperbola to the hyperbolic anomaly
Units
- Inputs:
nuin radians,edimensionless. - Output:
in radians (dimensionless, unbounded).
Notes
- The hyperbolic counterpart of the eccentric anomaly. Feed it to
to get a time from periapsis. nuis wrapped to (-π, π] first, so the incoming branch can be given either as a negative angle or just below 2π, as stateToElements returns it.- Only
exists on a hyperbola; see asymptoteTrueAnomaly.
Parameters
| Parameter | Type | Description |
|---|---|---|
nu | Radians | True anomaly |
e | number | Eccentricity |
Returns
number
Hyperbolic anomaly
Throws
- If any input is not a finite number.
- If
e <= 1ornuis at or beyond the asymptotes.
Example
ts
import type { Radians } from '@interstellar-tools/types';
const F = trueToHyperbolicAnomaly((Math.PI / 2) as Radians, 2);
// F ≈ 1.317 (cosh F = e)