Skip to content

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 ρ=r−robs is turned into the observer's east-north-up frame:

ρE=−sin⁡λρx+cos⁡λρyρN=−sin⁡φcos⁡λρx−sin⁡φsin⁡λρy+cos⁡φρzρU=cos⁡φcos⁡λρx+cos⁡φsin⁡λρy+sin⁡φρz

and then

A=atan2(ρE,ρN),E=atan2(ρU,ρE2+ρN2),ρ˙=ρ⋅v‖ρ‖

Where:

  • φ, λ are the observer's geodetic latitude and longitude (rad)
  • r, v are the satellite's Earth-fixed position (m) and velocity (m/s)
  • robs is the observer's Earth-fixed position on WGS 84 (m)

Units

  • Inputs: r in m, v in m/s, Earth-fixed as temeToEarthFixed returns them; the observer's phi and lambda in radians and h in m.
  • Output: azimuth and elevation in radians, range in m, rangeRate in 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 v must be the Earth-fixed velocity, relative to the ground, not the inertial one.

Parameters ​

ParameterTypeDescription
stateStateVectorInterfaceThe satellite's Earth-fixed position r in m and velocity v in m/s.
observerGeodeticCoordinatesInterfaceThe observer's geodetic latitude phi and longitude lambda in radians, and height h above the WGS 84 ellipsoid in m.

Returns ​

LookAnglesInterface

The azimuth, elevation, range and range rate: see LookAnglesInterface.

Throws ​

  • If r or v is not three finite numbers, or the observer's coordinates aren't finite.
  • If the observer's phi is 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 }

See ​

lookAngles