ADCS.helpers.plot.orbit.orbitpositionplot module

class ADCS.helpers.plot.orbit.orbitpositionplot.OrbitPositionPlot(*, sources=None, time='time_s', title='Orbit Position (ECI)', units='km', colors=('tab:blue', 'tab:orange', 'tab:green'), mag_color='tab:red', log_y=False)[source]

Bases: Subplot

Multi-panel visualization of spacecraft position components in ECI.

This class plots the Cartesian position components and the position magnitude of the spacecraft as functions of time, using orbital state histories from the simulation. Real and estimated positions can be shown together for comparison, arranged automatically in a fixed grid layout.

The plot emphasizes user-controlled settings such as data sources, colors, units, and axis scaling.

Parameters:

  • sources (list[str] or None) – List of orbit position sources to display. Supported values are real and estimated. If None, only the real position is shown.

  • time (str) – Name of the simulation attribute containing the time vector in seconds.

  • title (str) – Title displayed at the top of the plot group.

  • units (str) – Physical units of the position components.

  • colors (tuple[str, str, str]) – Colors used for the x, y, and z position components.

  • mag_color (str) – Color used for the position magnitude plot.

  • log_y (bool) – If True, the y-axes use logarithmic scaling.

plot(ax, sim)[source]
Return type:

None