Documentation / @interstellar-tools/tracking / lookAnglesFromEarthFixed
Function: lookAnglesFromEarthFixed()
ts
function lookAnglesFromEarthFixed(
state: StateVectorInterface,
observer: GeodeticCoordinatesInterface
): LookAnglesInterface;Defined in: satellites/look-angles.ts:78
The look angles to a satellite from an observer, given the satellite's Earth-fixed position and velocity: azimuth, elevation, range and range rate. lookAngles does the same from orbital elements.
The line of sight
and then
Where:
, are the observer's geodetic latitude and longitude (rad) , are the satellite's Earth-fixed position (m) and velocity (m/s) is the observer's Earth-fixed position on WGS 84 (m)
Units
- Inputs:
rin m,vin m/s, Earth-fixed as temeToEarthFixed returns them; the observer'sphiandlambdain radians andhin m. - Output:
azimuthandelevationin radians,rangein m,rangeRatein m/s.
Notes
- The elevation is geometric: refraction lifts objects near the horizon by about half a degree, which this leaves out.
- The observer turns with Earth, so
vmust be the Earth-fixed velocity, relative to the ground, not the inertial one.
Parameters
| Parameter | Type | Description |
|---|---|---|
state | StateVectorInterface | The satellite's Earth-fixed position r in m and velocity v in m/s. |
observer | GeodeticCoordinatesInterface | The observer's geodetic latitude phi and longitude lambda in radians, and height h above the WGS 84 ellipsoid in m. |
Returns
The azimuth, elevation, range and range rate: see LookAnglesInterface.
Throws
- If
rorvis not three finite numbers, or the observer's coordinates aren't finite. - If the observer's
phiis outside [-π/2, π/2], or the satellite is at the observer.
Example
ts
const oslo = { phi: toRad(59.91), lambda: toRad(10.75), h: 20 };
const date = new Date('2026-11-04T12:00:00Z');
const state = temeToEarthFixed(propagate(iss, date), date);
lookAnglesFromEarthFixed(state, oslo); // { azimuth, elevation, range, rangeRate }