Skip to content

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 F.

tanh⁡F2=e−1e+1tan⁡ν2

Units

  • Inputs: nu in radians, e dimensionless.
  • Output: F in radians (dimensionless, unbounded).

Notes

  • The hyperbolic counterpart of the eccentric anomaly. Feed it to Mh=esinh⁡F−F to get a time from periapsis.
  • nu is 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 ​

ParameterTypeDescription
nuRadiansTrue anomaly ν in radians (finite, inside the asymptotes).
enumberEccentricity e (finite, > 1).

Returns ​

number

Hyperbolic anomaly F in radians: negative before periapsis, positive after.

Throws ​

  • If any input is not a finite number.
  • If e <= 1 or nu is 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)

See ​