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_degis the lowest elevation the station tracks at;horizon(a list ofazimuth_deg,elevation_degpoints) 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),losin UTC, the azimuths,max_elevation_deg,min_range_m. A pass the orbit’s start or end cuts has noaosor nolos.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_daysfrom 1 (the orbit’s own prediction) to 7 (that prediction continued: its uncertainty grows to kilometres in a week), andlight_time:none(geometric),receive(a downlink, for optical links) ortransmit(an uplink).