Skip to content

Documentation / @interstellar-tools/equations / hohmannTransfer

Function: hohmannTransfer() ​

ts
function hohmannTransfer(
  r1: number,
  r2: number,
  mu: number
): HohmannTransferReturnType;

Defined in: manoeuvres/hohmann-transfer.ts:49

Hohmann transfer (coplanar, circular (r1→r2)).

Definitions

at=r1+r22Δv1=μr1(2r2r1+r2−1),Δv2=μr2(1−2r1r1+r2)Δvtotal=Δv1+Δv2,tt=πat3μ

Conventions

  • Inputs in SI: (r1,r2) in meters, (μ) in m³/s².
  • The returned (Δv1,Δv2) are magnitudes (non-negative). Their signs (prograde/retrograde) are provided separately for clarity.
  • Works for (r2>r1) (raise) and (r2<r1) (lower). If (r1=r2): (Δv)s are 0 and (tt) is half the circular period.

Domain

  • (r1>0, r2>0, μ>0)

Parameters ​

ParameterTypeDescription
r1numberInitial circular-orbit radius (m).
r2numberTarget circular-orbit radius (m).
munumberStandard gravitational parameter (μ) (m³/s²).

Returns ​

HohmannTransferReturnType

Object with transfer semi-major axis at (m), burn magnitudes dv1, dv2, their sum dvTotal (m/s), transfer time tTransfer (s), and burn directions dir1, dir2.

Throws ​

If an input is not a number.

Throws ​

If (r1≤0), (r2≤0), or (μ≤0), or a value is non-finite.