ssapy_toolkit.Plots.tracking_plot

ssapy_toolkit.Plots.tracking_plot(r: ndarray, t: ndarray, ground_stations=None, limits=None, title: str = '', figsize=(12, 8), save_path=None, scale: float = 1) → None[source]

Create a 3D tracking plot of satellite positions over time on Earth’s surface.

Parameters:

  • r (numpy.ndarray or list of numpy.ndarray) – Satellite positions in GCRF coordinates. If a single numpy array, it represents the satellite’s position vector over time. If a list of numpy arrays, it represents multiple satellite position vectors.

  • t (numpy.ndarray) – Timestamps corresponding to the satellite positions.

  • ground_stations (list of (lat, lon) or None) – Optional list of ground stations as (latitude, longitude) pairs [deg].

  • limits (float or None) – Plot limits for x, y, z axes. If float, use that for all axes. If None, limits are auto-determined from the data.

  • title (str) – Plot title.

  • figsize (tuple) – Figure size in inches (width, height).

  • save_path (str or None) – If provided, path where the plot image/PDF will be saved.

  • scale (float) – Scaling factor for the Earth image.

Return type:

None