Ground stations and passes

Tell the service where you track your satellites from, and which satellite uses which station: each new orbit then brings its passes over them and the pointing through each pass.

kiruna = client.stations.create(
    "KIRUNA", latitude_deg=67.857, longitude_deg=20.964, height_m=402, mask_deg=5
)
client.stations.assign(satellite, [kiruna], passes_days=3, light_time="receive")
client.stations.list()
client.stations.of(satellite)
  • A position is geodetic on WGS84 (latitude north, longitude east, height above the ellipsoid in metres) or Cartesian, fixed to the Earth: cartesian_m={"x": ..., "y": ..., "z": ...} in ITRF metres.

  • client.stations.catalogue("svalbard") finds sites of the commercial, NASA and ESA networks to fill a station in from (from open sources; check the values against your station’s own survey).

  • mask_deg is the lowest elevation the station tracks at; horizon (a list of azimuth_deg, elevation_deg points) gives it by direction instead.

  • downlink_frequency_hz, if given, adds the Doppler to the pointing.

Passes and pointing

passes = client.passes.get(satellite)  # the current orbit's; request(...).wait() for new ones
for station in passes.stations:
    for one in station.passes:
        print(station.name, one.aos, one.max_elevation_deg, one.los)
passes.download("pointing", "pointing.csv")
  • Each pass: aos, tca (the highest elevation), los in UTC, the azimuths, max_elevation_deg, min_range_m. A pass the orbit’s start or end cuts has no aos or no los.

  • The products: passes (JSON), pointing (azimuth, elevation, range, range rate, light time and Doppler every 10 s through each pass, CSV) and, beyond a day, oem (the orbit the passes come from).

  • With the satellite’s stations: passes_days from 1 (the orbit’s own prediction) to 7 (that prediction continued: its uncertainty grows to kilometres in a week), and light_time: none (geometric), receive (a downlink, for optical links) or transmit (an uplink).