ssapy_toolkit.Plots.globe_plot

ssapy_toolkit.Plots.globe_plot(r, t=None, limits=None, title='', c='black', figsize=(7, 8), save_path=None, el=5.0, az=5.0, scale=5.0, fontsize=18, labels=None, orbit_colors=None, show_legend=True, legend_kwargs=None, lon0=0.0, globe_time=None)[source]

Plot a textured Earth and scatter satellite positions in 3D.

Parameters:

  • r (passed to valid_orbits to normalize [1].)

  • t (passed to valid_orbits to normalize [1].)

  • limits (None, scalar, or [[x1,x2],[y1,y2],[z1,z2]]) – None -> auto; scalar -> cube [-L,L] for all axes; 3x2-like -> explicit per-axis limits.

  • labels (list of str, optional) – Per-orbit labels for legend; must match number of tracks if provided.

  • orbit_colors (list or array-like, optional) – Per-orbit colors. If provided, length must match number of tracks. Each entry can be any Matplotlib color (name, hex, RGB tuple, etc.).

  • show_legend (bool) – If True and labels are provided, draw a legend.

  • legend_kwargs (dict) – Extra kwargs forwarded to ax.legend().

  • lon0 (float) – Rotation of the globe texture about the z-axis in degrees. Positive values rotate longitudes eastward.

  • globe_time (astropy.time.Time or float, optional) – If provided, overrides lon0 by computing the Earth-rotation angle from this time using gst94 (same as drawEarth) [1].

Returns:

fig, ax

Return type:

Matplotlib Figure and 3D Axes.