Observation and Coverage
Collect Observations
- tatc.analysis.collect_observations(point: Point, satellite: Satellite, instrument: Instrument, start: datetime, end: datetime, 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.
omit_solar (bool) – True, to omit solar angles to improve computational efficiency; otherwise False.
- Returns
The data frame with recorded observations.
- Return type
Collect Multi Observations
- tatc.analysis.collect_multi_observations(point: Point, satellites: Union[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 computational efficiency; otherwise False.
- 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