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.
Where:
is the transmitted frequency (Hz) is the range rate (m/s), from lookAngles is the speed of light, 299 792 458 m/s
Units
- Inputs:
frequencyin Hz,rangeRatein m/s. - Output:
in Hz: positive while the satellite approaches.
Notes
- First order in
: relativistic terms are below a millihertz for satellites in Earth orbit. - A ground station tunes to
to receive a downlink, and transmits on for the satellite to hear an uplink on .
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 HzParameters
| Parameter | Type | Description |
|---|---|---|
frequency | number | Transmitted frequency |
rangeRate | number | Range rate |
Returns
number
The Doppler shift
Throws
- If an input is not a finite number.
- If
frequency <= 0, orrangeRateis as fast as light or faster.
Example
ts
dopplerShift(437_000_000, 5000); // ≈ -7 288 Hz: a UHF signal from a leaving satellite