Skip to content

Documentation / @interstellar-tools/equations / hyperbolicToTrueAnomaly

Function: hyperbolicToTrueAnomaly() ​

ts
function hyperbolicToTrueAnomaly(F: number, e: number): Radians;

Defined in: anomalies/hyperbolic-to-true-anomaly.ts:38

Convert a hyperbolic anomaly F to the true anomaly on a hyperbola.

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

Units

  • Inputs: F in radians, e dimensionless.
  • Output: ν in radians, in (−ν∞,ν∞).

Notes

  • The inverse of trueToHyperbolicAnomaly.
  • As F→±∞, ν approaches the asymptotes ±ν∞ but never reaches them.
  • Returns a signed angle, negative before periapsis. Use norm2pi for [0, 2π).

Parameters ​

ParameterTypeDescription
FnumberHyperbolic anomaly F in radians (finite).
enumberEccentricity e (finite, > 1).

Returns ​

Radians

True anomaly ν in radians, in (-π, π).

Throws ​

  • If any input is not a finite number.
  • If e <= 1.

Example ​

ts
const nu = hyperbolicToTrueAnomaly(Math.acosh(2), 2);
// nu ≈ π/2

See ​