Latency
Collect Downlinks
- tatc.analysis.collect_downlinks(stations: GroundStation | List[GroundStation], satellite: Satellite, start: datetime, end: datetime) GeoDataFrame[source]
Collect satellite downlink opportunities to ground station(s) of interest.
- Parameters:
stations (GroundStation or List[GroundStation]) – The ground stations.
satellite (Satellite) – The observing satellite.
start (datetime.datetime) – Start of analysis period.
end (datetime.datetime) – End of analysis period.
- Returns:
The data frame of collected downlink results.
- Return type:
Compute Latencies
- tatc.analysis.compute_latencies(observations: GeoDataFrame, downlinks: GeoDataFrame) GeoDataFrame[source]
Collect latencies between an observation and the first downlink opportunity.
- Parameters:
observations (geopandas.GeoDataFrame) – The data frame of observations to downlink.
downlinks (geopandas.GeoDataFrame) – The data frame of downlink opportunities.
- Returns:
The data frame of collected latency results, sorted by the ‘observed’ column in ascending order. It includes the following columns: - ‘point_id’ (int64): Identifier for the observation point. - ‘geometry’ (geometry): Geometry representing the observation point. - ‘satellite’ (object): Name or identifier of the satellite. - ‘instrument’ (object): Name or identifier of the instrument. - ‘sat_alt’ (float64): Altitude of the satellite at the time of observation. - ‘sat_az’ (float64): Azimuth of the satellite at the time of observation. - ‘station’ (object): Name or identifier of the ground station for downlink. - ‘downlinked’ (datetime64[ns, UTC]): Timestamp when the observation data was downlinked. - ‘latency’ (timedelta64[ns]): Latency between observation and downlink. - ‘observed’ (datetime64[ns, UTC]): Timestamp when the observation was made.
- Return type:
Reduce Latencies
- tatc.analysis.reduce_latencies(latency_observations: GeoDataFrame) GeoDataFrame[source]
Reduce observation latencies. Computes descriptive statistics for each pair of observation and first downlink opportunities.
- Parameters:
latency_observations (geopandas.GeoDataFrame) – The latency observations.
- Returns:
The data frame with reduced latencies.
- Return type:
Grid Latencies
- tatc.analysis.grid_latencies(reduced_latencies: GeoDataFrame, cells: GeoDataFrame) GeoDataFrame[source]
Grid reduced latencies to cells.
- Parameters:
reduced_latencies (geopandas.GeoDataFrame) – The reduced latencies.
cells (geopandas.GeoDataFrame) – The cell specification.
- Returns:
The data frame with gridded latencies.
- Return type: