ssapy_toolkit.Plots.groundtrack_video

ssapy_toolkit.Plots.groundtrack_video(r, t, ground_stations=None, save_path=None, title='Ground Track', show_legend=True, fontsize=18, start_end_markers=True, fps=30, bitrate=2400, max_frames=2000, progress=True, mode='map')[source]

Create an MP4 animation of satellite ground tracks.

Default mode=”map” renders a 2D lon/lat plot that matches your groundtrack_plot (full static track + moving marker). If you prefer a 3D path on the Earth’s surface, use mode=”surface3d” (uses groundTrack(…, format=’cartesian’)). The old ECI-in-space style can be done with mode=”eci3d” (plots r directly around a sphere).

Parameters:

  • r ((n,3) array_like or list of (n,3)) – GCRF/ECI positions [m]. Single orbit or a list of orbits.

  • t ((n,) array_like or list of (n,)) – Absolute times matching r (same as groundtrack_plot).

  • ground_stations ((k,2) array_like, optional) – (lat_deg, lon_deg) rows. Used in “map” and “surface3d” modes.

  • save_path (str, required, must end with '.mp4')

  • start_end_markers (bool)

  • fps (controls)

  • bitrate (controls)

  • max_frames (controls)

  • progress (controls)

  • mode ("map" | "surface3d" | "eci3d")