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
returning the first time that's not negative.
Units
- Inputs: angles in radians, mean motions in rad/s.
- Output:
in s, in .
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
. - If the required angle is just behind, the wait is almost a whole synodic period; see synodicPeriod.
Parameters
| Parameter | Type | Description |
|---|---|---|
thetaNow | Radians | Current phase angle, target ahead of chaser, in radians (finite). |
thetaRequired | Radians | Phase angle wanted, in radians (finite). |
nChaser | number | Chaser's mean motion in rad/s (finite, > 0). |
nTarget | number | Target'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