Observation and Coverage
Collect Observations
- tatc.analysis.collect_observations(point: Point, satellite: Satellite, start: datetime, end: datetime, instrument_index: int = 0, omit_solar: bool = True) GeoDataFrame[source]
Collect single satellite observations of a geodetic point of interest.
- Parameters:
point (Point) – The ground point of interest.
satellite (Satellite) – The observing satellite.
instrument (Instrument) – The observing instrument.
start (datetime.datetime) – Start of analysis period.
end (datetime.datetime) – End of analysis period.
instrument_index (int) – The index of the observing instrument in satellite.
omit_solar (bool) – True, to omit solar angles to improve performance.
- Returns:
The data frame with recorded observations.
- Return type:
Collect Multi Observations
- tatc.analysis.collect_multi_observations(point: Point, satellites: Satellite | List[Satellite], start: datetime, end: datetime, omit_solar: bool = True) GeoDataFrame[source]
Collect multiple satellite observations of a geodetic point of interest.
- Parameters:
point (Point) – The ground point of interest.
satellites (Satellite or List[Satellite]) – The observing satellite(s).
start (datetime.datetime) – Start of analysis period.
end (datetime.datetime) – End of analysis period.
omit_solar (bool) – True, to omit solar angles to improve performance.
- Returns:
The data frame with all recorded observations.
- Return type:
Aggregate Observations
- tatc.analysis.aggregate_observations(observations: GeoDataFrame) GeoDataFrame[source]
Aggregate constellation observations. Interleaves observations by multiple satellites to compute aggregate performance metrics including access (observation duration) and revisit (duration between observations).
- Parameters:
observations (geopandas.GeoDataFrame) – The collected observations.
- Returns:
The data frame with aggregated observations.
- Return type:
Reduce Observations
- tatc.analysis.reduce_observations(aggregated_observations: GeoDataFrame) GeoDataFrame[source]
Reduce constellation observations. Computes descriptive statistics for each geodetic point of interest contained in aggregated observations.
- Parameters:
aggregated_observations (geopandas.GeoDataFrame) – The aggregated observations.
- Returns:
The data frame with reduced observations.
- Return type:
Grid Observations
- tatc.analysis.grid_observations(reduced_observations: GeoDataFrame, cells: GeoDataFrame) GeoDataFrame[source]
Grid reduced observations to cells.
- Parameters:
reduced_observations (geopandas.GeoDataFrame) – The reduced observations.
cells (geopandas.GeoDataFrame) – The cell specification.
- Returns:
The data frame with gridded observations.
- Return type: