ssapy_toolkit.Plots.groundtrack_dashboard

ssapy_toolkit.Plots.groundtrack_dashboard(r, t, save_path=None, pad=500, show=False, show_legend=True, t0=None, limit=None, fontsize=18, labels=None)[source]

Visualizes multiple satellite ground tracks, altitude/velocity over time, and 3D trajectories.

Parameters:

  • r (array_like or list of array_like) – Position vectors in meters. Either a single (n,3) array or a list of (n,3) arrays for multiple orbits.

  • t (array_like or list of array_like) – Time arrays in seconds or any format convertible by to_gps. Single array or list matching r.

  • save_path (str or None, optional) – If provided, saves the figure to the specified path.

  • pad (float, optional) – Padding (in meters) for the 3D plot’s bounding cube. Defaults to 500 m.

  • show (bool, optional) – If True, displays the figure.

  • show_legend (bool, optional) – If True, shows legends.

  • t0 (float or None, optional) – Reference start time in GPS seconds for relative-time plots. If None, uses the min of first timestamps.

  • limit (float or None, optional) – Fixed half-extent (in km) for 3D axes. If None, computed from data with padding.

  • fontsize (int, optional) – Base fontsize. Other text scales relative to this.

  • labels (list of str or None, optional) – Optional per-orbit labels. If None, defaults to [“Orbit 1”, “Orbit 2”, …].

Returns:

  • fig (matplotlib.figure.Figure) – The complete dashboard figure object.

  • Author (Travis Yeager)