Skip to content

Documentation / @interstellar-tools/tracking / dopplerShift

Function: dopplerShift() ​

ts
function dopplerShift(frequency: number, rangeRate: number): number;

Defined in: satellites/look-angles.ts:223

The Doppler shift of a radio signal from a satellite: how far the received frequency is from the transmitted one, as the satellite approaches or leaves.

Δf=−fρ˙c

Where:

  • f is the transmitted frequency (Hz)
  • ρ˙ is the range rate (m/s), from lookAngles
  • c is the speed of light, 299 792 458 m/s

Units

  • Inputs: frequency in Hz, rangeRate in m/s.
  • Output: Δf in Hz: positive while the satellite approaches.

Notes

  • First order in ρ˙/c: relativistic terms are below a millihertz for satellites in Earth orbit.
  • A ground station tunes to f+Δf to receive a downlink, and transmits on f−Δf for the satellite to hear an uplink on f.
In practiceISS, amateur radio downlink

+3.4 kHz

145.800 MHz, the ISS approaching at 7 km/s at the start of a low pass

The shift sweeps through 0 at the closest approach to -3.4 kHz as it leaves: radio operators retune through the pass.

ts
dopplerShift(145_800_000, -7000); // ≈ 3 404 Hz

Parameters ​

ParameterTypeDescription
frequencynumberTransmitted frequency f in Hz (finite, > 0).
rangeRatenumberRange rate ρ˙ in m/s (finite, slower than light).

Returns ​

number

The Doppler shift Δf in Hz.

Throws ​

  • If an input is not a finite number.
  • If frequency <= 0, or rangeRate is as fast as light or faster.

Example ​

ts
dopplerShift(437_000_000, 5000); // ≈ -7 288 Hz: a UHF signal from a leaving satellite

See ​

lookAngles