Ground and Orbit Track

Collect Orbit Track

tatc.analysis.collect_orbit_track(satellite: Satellite, instrument: Instrument, times: List[datetime], elevation: float = 0, mask: Optional[Union[Polygon, MultiPolygon]] = None) → GeoDataFrame[source]

Collect orbit track points for a satellite of interest.

Parameters

  • satellite (Satellite) – The observing satellite.

  • instrument (Instrument) – The observing instrument.

  • times (List[datetime.datetime]) – The list of times to sample.

  • elevation (float) – The elevation (meters) above the datum in the WGS 84 coordinate system for which to calculate swath width.

  • mask (Polygon or MultiPolygon) – An optional mask to constrain results.

Returns

The data frame of collected orbit track results.

Return type

geopandas.GeoDataFrame

Collect Ground Track

tatc.analysis.collect_ground_track(satellite: Satellite, instrument: Instrument, times: List[datetime], elevation: float = 0, mask: Optional[Union[Polygon, MultiPolygon]] = None, crs: str = 'EPSG:4087') → GeoDataFrame[source]

Collect ground track polygons for a satellite of interest.

Parameters

  • satellite (Satellite) – The observing satellite.

  • instrument (Instrument) – The observing instrument.

  • times (List[datetime.datetime]) – The list of datetimes to sample.

  • elevation (float) – The elevation (meters) above the datum in the WGS 84 coordinate system for which to calculate ground track.

  • mask (Polygon or MultiPolygon) – An optional mask to constrain results.

  • crs (str) – The coordinate reference system (CRS) in which to compute distance (default: World Equidistant Cylindrical “EPSG:4087”). Selecting crs=”utm” uses Universal Transverse Mercator (UTM) zones for non-polar regions, and Universal Polar Stereographic (UPS) systems for polar regions.

Returns

The data frame of collected ground track results.

Return type

geopandas.GeoDataFrame

Compute Ground Track

tatc.analysis.compute_ground_track(satellite: Satellite, instrument: Instrument, times: List[datetime], elevation: float = 0, mask: Optional[Union[Polygon, MultiPolygon]] = None, crs: str = 'EPSG:4087', method: str = 'point') → GeoDataFrame[source]

Compute the aggregated ground track for a satellite of interest.

Parameters

  • satellite (Satellite) – The observing satellite.

  • instrument (Instrument) – The observing instrument.

  • times (List[datetime.datetime]) – The list of datetimes to sample.

  • elevation (float) – The elevation (meters) above the datum in the WGS 84 coordinate system for which to calculate ground track.

  • mask (Polygon or MultiPolygon) – An optional mask to constrain results.

  • crs (str) – The coordinate reference system (CRS) in which to compute distance (default: World Equidistant Cylindrical “EPSG:4087”). Selecting crs=”utm” uses Universal Transverse Mercator (UTM) zones for non-polar regions, and Universal Polar Stereographic (UPS) systems for polar regions.

  • method (str) – The method for computing ground track: “point” buffers individual points while “line” buffers a line of points.

Returns

The data frame of aggregated ground track results.

Return type

GeoDataFrame