ADCS.helpers.plot.control.attitudeplot module

class ADCS.helpers.plot.control.attitudeplot.AttitudePlot(*, sources=None, time='time_s', title='Attitude Animation (ECI)', reference_attr='target_hist', body_axis='z', axis_limits=1.0, interval_ms=50, show_env=True)[source]

Bases: Subplot

Interactive 3D attitude animation subplot.

This class provides an interactive Matplotlib-based 3D animation for visualizing spacecraft attitude in the Earth-Centered Inertial frame. It supports visualization of true attitude, estimated attitude, and reference goals, as well as optional environmental vectors such as magnetic field and Sun direction.

The class integrates with the ADCS plotting framework via Subplot.

Reference goals are read from the simulation attribute specified by reference_attr and may be provided in mixed formats:

Goal row format

Interpretation

[nan, tx, ty, tz]

Reference vector in ECI

[q0, q1, q2, q3]

Quaternion goal, body to ECI

Legacy Nx3 arrays are interpreted as vector-only reference histories.

Parameters:

  • sources (list[str] or None) – List of attitude sources to visualize. Supported values are real, estimated, and reference. Defaults to ["real"].

  • time (str) – Name of the time attribute on the simulation object.

  • title (str) – Title displayed on the animation window.

  • reference_attr (str) – Name of the simulation attribute containing reference goal history.

  • body_axis (str) – Body axis identifier used for reference alignment. Must be x, y, or z.

  • axis_limits (float) – Symmetric axis limits applied to all ECI axes.

  • interval_ms (int) – Animation update interval in milliseconds.

  • show_env (bool) – Enable visualization of environmental vectors when available.

Returns:

None

Return type:

None

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

None