Skip to content

Documentation / @interstellar-tools/equations / cwTwoImpulseTransfer

Function: cwTwoImpulseTransfer() ​

ts
function cwTwoImpulseTransfer(
  state0: CwState,
  target: CwState,
  n: number,
  t: number
): CwTwoImpulseTransferInterface;

Defined in: manoeuvres/cw-two-impulse-transfer.ts:62

Compute the two burns of a Clohessy–Wiltshire rendezvous: from a relative state to a target state in a given time.

v0+=Φrv−1(rf−Φrrr0),Δv1=v0+−v0,Δv2=vf−(Φvrr0+Φvvv0+)

with the blocks of Φ(t) from cwStateTransition.

Units

  • Inputs: states in m and m/s, n in rad/s, t in s.
  • Output: both burns in m/s, as vectors in the LVLH frame.

Notes

  • The first burn puts the deputy on a path that reaches the target position after t; the second matches the target velocity there. For a rendezvous with the chief, the target state is all zeros.
  • Some transfer times can't be targeted: in the orbital plane, every whole number of orbits (nt=2πk), and out of plane, every half orbit, where the cross-track motion returns to ±z0 whatever the burn. At a half orbit the cross-track burn is zero if the target is already on that path, and otherwise the function throws.
  • Valid near a circular reference orbit, for small separations.

Parameters ​

ParameterTypeDescription
state0CwStateDeputy's relative state before the first burn [x, y, z, xDot, yDot, zDot] (finite).
targetCwStateState to arrive at [x, y, z, xDot, yDot, zDot] (finite); all zeros to rendezvous with the chief.
nnumberMean motion of the circular reference orbit in rad/s (finite, > 0).
tnumberTransfer time in s (finite, > 0).

Returns ​

CwTwoImpulseTransferInterface

The two burns dv1 and dv2 in m/s.

Throws ​

  • If any input is not a finite number.
  • If n <= 0, t <= 0, or the transfer time can't be targeted.

Example ​

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

// 1 km behind the chief, at rest: rendezvous in a quarter of an orbit
const n = 0.00113;
const { dv1, dv2 } = cwTwoImpulseTransfer(
  [0, -1000, 0, 0, 0, 0],
  [0, 0, 0, 0, 0, 0],
  n,
  Math.PI / 2 / n
);

See ​