Skip to content

Documentation / @interstellar-tools/equations / cwStateTransition

Function: cwStateTransition() ​

ts
function cwStateTransition(n: number, t: number): CwStateTransitionInterface;

Defined in: orbits/cw-state-transition.ts:66

Compute the Clohessy–Wiltshire state transition matrix: the closed-form solution of the CW / Hill equations.

With s=sin⁡nt and c=cos⁡nt, in the LVLH frame of cwHillDerivatives (x radial, y along-track, z cross-track):

Φrr=[4−3c006(s−nt)1000c],Φrv=1n[s2(1−c)0−2(1−c)4s−3nt000s]Φvr=[3ns006n(c−1)0000−ns],Φvv=[c2s0−2s4c−3000c]

Units

  • Inputs: n in rad/s, t in s.
  • Output: dimensionless blocks, except Φrv in s and Φvr in 1/s.

Notes

  • Valid near a circular reference orbit, for separations small compared with its radius. Elliptic reference orbits need other solutions (e.g. Yamanaka–Ankersen).
  • The −3nt terms grow without bound: a deputy slightly lower than the chief drifts ahead every orbit.
  • Φ(0) is the identity, and Φ(t1+t2)=Φ(t2)Φ(t1).
  • Negative t propagates backwards.

Parameters ​

ParameterTypeDescription
nnumberMean motion of the circular reference orbit n in rad/s (finite, > 0).
tnumberTime since the initial state t in s (finite).

Returns ​

CwStateTransitionInterface

The four 3×3 blocks of Φ(t).

Throws ​

  • If any input is not a finite number.
  • If n <= 0.

Example ​

ts
// ISS-like orbit: n ≈ 0.00113 rad/s, a quarter of an orbit later
const { rr, rv } = cwStateTransition(0.00113, Math.PI / 2 / 0.00113);

See ​