Ground and Orbit Track

Collect Orbit Track

tatc.analysis.collect_orbit_track(satellite: Satellite, times: List[datetime], instrument_index: int = 0, elevation: float = 0, mask: Polygon | MultiPolygon | GeoDataFrame | GeoSeries | None = None, coordinates: OrbitCoordinate = OrbitCoordinate.WGS84, orbit_output: OrbitOutput = OrbitOutput.POSITION, sat_sunlit: bool = False, solar_altaz: bool = False, solar_beta: bool = False) → GeoDataFrame[source]

Collect orbit track points for a satellite of interest.

Parameters:

  • satellite (Satellite) – The observing satellite.

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

  • instrument_index (int) – The index of the observing instrument in satellite.

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

  • mask (Polygon, MultiPolygon, geopandas.GeoDataFrame, geopandas.GeoSeries) – An optional mask to constrain results.

  • coordinates (OrbitCoordinate) – The coordinate system of orbit track points.

  • orbit_output (OrbitOutput) – The output option.

  • sat_sunlit (bool) – True to include whether the satellite is sunlit.

  • solar_altaz (bool) – True to include solar altitude/azimuth angles.

  • solar_beta (bool) – True to include solar beta angles.

Returns:

The data frame of collected orbit track results.

Return type:

geopandas.GeoDataFrame

Collect Ground Track

tatc.analysis.collect_ground_track(satellite: Satellite, times: List[datetime], instrument_index: int = 0, elevation: float = 0, mask: Polygon | MultiPolygon | GeoDataFrame | GeoSeries | None = None, crs: str = 'EPSG:4087', sat_altaz: bool = False, solar_altaz: bool = False) → GeoDataFrame[source]

Collect ground track polygons for a satellite of interest.

Parameters:

  • satellite (Satellite) – The observing satellite.

  • instrument_index (int) – The index of the observing instrument in satellite.

  • 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, MultiPolygon, geopandas.GeoDataFrame, geopandas.GeoSeries) – 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. Selecting crs=”spice” uses SPICE to compute observation footprints.

  • sat_altaz (bool) – True to include satellite altitude/azimuth angles.

  • solar_altaz (bool) – True to include solar altitude/azimuth angles.

Returns:

The data frame of collected ground track results.

Return type:

geopandas.GeoDataFrame

Compute Ground Track

tatc.analysis.compute_ground_track(satellite: Satellite, times: List[datetime], instrument_index: int = 0, elevation: float = 0, mask: Polygon | MultiPolygon | GeoDataFrame | GeoSeries | None = None, crs: str = 'EPSG:4087', method: str = 'point', dissolve_orbits: bool = True) → GeoDataFrame[source]

Compute the aggregated ground track for a satellite of interest.

Parameters:

  • satellite (Satellite) – The observing satellite.

  • instrument_index (int) – The index of the observing instrument in satellite.

  • 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, MultiPolygon, geopandas.GeoDataFrame, geopandas.GeoSeries) – 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. Selecting crs=”spice” uses SPICE to compute footprints.

  • method (str) – The method for computing ground track: “point” buffers individual points and “line” buffers a line of points. The line method is not compatible with the crs=”spice” option above.

  • dissolve_orbits (bool) – True, to aggregate multiple orbits in one output.

Returns:

The data frame of aggregated ground track results.

Return type:

GeoDataFrame