Skip to content

Documentation / @interstellar-tools/equations / phasingWaitTime

Function: phasingWaitTime() ​

ts
function phasingWaitTime(
  thetaNow: Radians,
  thetaRequired: Radians,
  nChaser: number,
  nTarget: number
): number;

Defined in: manoeuvres/phasing-wait-time.ts:55

Compute how long to wait for a phase angle: when a target, leading a chaser on another circular orbit, will be at the angle a manoeuvre needs.

The phase angle θ is how far the target is ahead of the chaser, and it changes at the difference in mean motions:

θ˙=ntarget−nchaser,twait=θrequired−θnowntarget−nchaser(modTsyn)

returning the first time that's not negative.

Units

  • Inputs: angles in radians, mean motions in rad/s.
  • Output: twait in s, in [0,Tsyn).

Notes

  • A chaser in a lower, faster orbit closes the gap: the phase angle shrinks.
  • For a Hohmann transfer to a target on a circular orbit, the required angle is θ=π−ntargetttransfer.
  • If the required angle is just behind, the wait is almost a whole synodic period; see synodicPeriod.

Parameters ​

ParameterTypeDescription
thetaNowRadiansCurrent phase angle, target ahead of chaser, in radians (finite).
thetaRequiredRadiansPhase angle wanted, in radians (finite).
nChasernumberChaser's mean motion in rad/s (finite, > 0).
nTargetnumberTarget's mean motion in rad/s (finite, > 0, not equal to nChaser).

Returns ​

number

Waiting time in s, in [0, synodic period).

Throws ​

  • If any input is not a finite number.
  • If a mean motion is <= 0, or both are equal (the phase never changes).

Example ​

ts
import type { Radians } from '@interstellar-tools/types';

// Chaser 1° per orbit faster, target 10° ahead, burn when it's 4° ahead
const nTarget = 0.00113;
const nChaser = nTarget * (1 + 1 / 360);
const t = phasingWaitTime(
  ((10 * Math.PI) / 180) as Radians,
  ((4 * Math.PI) / 180) as Radians,
  nChaser,
  nTarget
);
// t ≈ 6 orbits of the target

See ​