opengnc.visualization package

Submodules

opengnc.visualization.attitude module

opengnc.visualization.attitude.plot_attitude_sphere(vectors: ndarray | list[list[float]], title: str = 'Attitude Sphere Visualization') → Figure[source]

Directional Attitude Visualization.

Projects vectors onto a unit sphere shell ($|mathbf{v}| = 1$).

Parameters:

  • vectors (np.ndarray | list[list[float]]) – Sequence of 3D pointing vectors $(N, 3)$.

  • title (str, optional) – Plot heading.

Returns:

Plotly 3D unit sphere object.

Return type:

go.Figure

opengnc.visualization.coverage module

opengnc.visualization.coverage.plot_coverage_heatmap(latitudes: ndarray | list[float], longitudes: ndarray | list[float], values: ndarray | list[float], title: str = 'Coverage Heat Map') → Figure[source]

Plots a density/heatmap on an Earth map to analyze access/coverage.

Parameters:

  • list) (values (numpy.ndarray or)

  • list)

  • list)

  • (str) (title)

Returns:

plotly.graph_objects.Figure

Return type:

The plotly figure object.

opengnc.visualization.ground_track module

opengnc.visualization.ground_track.plot_ground_track(latitudes: ndarray | list[float], longitudes: ndarray | list[float], times: ndarray | list[float] | None = None, title: str = 'Satellite Ground Track') → Figure[source]

2D Sub-Satellite Point (SSP) Visualization.

Projects the spacecraft trajectory onto a 2D equirectangular map tracking latitude and longitude evolution over time.

Parameters:

  • latitudes (Union[np.ndarray, List[float]]) – Geodetic or geocentric latitudes (deg). Range: $[-90, 90]$.

  • longitudes (Union[np.ndarray, List[float]]) – Geodetic or geocentric longitudes (deg). Range: $[-180, 180]$.

  • times (Optional[Union[np.ndarray, List[float]]], optional) – Simulation timestamps (s) for hover metadata.

  • title (str, optional) – Plot main heading.

Returns:

Interactive 2D map plot.

Return type:

plotly.graph_objects.Figure

Raises:

ValueError – If coordinate arrays have mismatched lengths.

opengnc.visualization.orbit module

opengnc.visualization.orbit.plot_orbit_3d(r_eci: ndarray | list[list[float]], r_earth: bool = True, title: str = '3D Orbit Visualization') → Figure[source]

Standard 3D Orbit Visualization.

Renders flight path relative to a spherical Earth ($R_e = 6378.137$ km).

Parameters:

  • r_eci (np.ndarray | list[list[float]]) – Sequence of ECI positions $(N, 3)$ (m).

  • r_earth (bool, optional) – Render Earth sphere. Default True.

  • title (str, optional) – Plot heading.

Returns:

Plotly 3D scatter object.

Return type:

go.Figure

Module contents

Visualization module for OpenGNC. Provides interactive 3D and 2D plotting capabilities for orbits, attitude, mapped data, and dashboards.

opengnc.visualization.plot_attitude_sphere(vectors: ndarray | list[list[float]], title: str = 'Attitude Sphere Visualization') → Figure[source]

Directional Attitude Visualization.

Projects vectors onto a unit sphere shell ($|mathbf{v}| = 1$).

Parameters:

  • vectors (np.ndarray | list[list[float]]) – Sequence of 3D pointing vectors $(N, 3)$.

  • title (str, optional) – Plot heading.

Returns:

Plotly 3D unit sphere object.

Return type:

go.Figure

opengnc.visualization.plot_coverage_heatmap(latitudes: ndarray | list[float], longitudes: ndarray | list[float], values: ndarray | list[float], title: str = 'Coverage Heat Map') → Figure[source]

Plots a density/heatmap on an Earth map to analyze access/coverage.

Parameters:

  • list) (values (numpy.ndarray or)

  • list)

  • list)

  • (str) (title)

Returns:

plotly.graph_objects.Figure

Return type:

The plotly figure object.

opengnc.visualization.plot_ground_track(latitudes: ndarray | list[float], longitudes: ndarray | list[float], times: ndarray | list[float] | None = None, title: str = 'Satellite Ground Track') → Figure[source]

2D Sub-Satellite Point (SSP) Visualization.

Projects the spacecraft trajectory onto a 2D equirectangular map tracking latitude and longitude evolution over time.

Parameters:

  • latitudes (Union[np.ndarray, List[float]]) – Geodetic or geocentric latitudes (deg). Range: $[-90, 90]$.

  • longitudes (Union[np.ndarray, List[float]]) – Geodetic or geocentric longitudes (deg). Range: $[-180, 180]$.

  • times (Optional[Union[np.ndarray, List[float]]], optional) – Simulation timestamps (s) for hover metadata.

  • title (str, optional) – Plot main heading.

Returns:

Interactive 2D map plot.

Return type:

plotly.graph_objects.Figure

Raises:

ValueError – If coordinate arrays have mismatched lengths.

opengnc.visualization.plot_orbit_3d(r_eci: ndarray | list[list[float]], r_earth: bool = True, title: str = '3D Orbit Visualization') → Figure[source]

Standard 3D Orbit Visualization.

Renders flight path relative to a spherical Earth ($R_e = 6378.137$ km).

Parameters:

  • r_eci (np.ndarray | list[list[float]]) – Sequence of ECI positions $(N, 3)$ (m).

  • r_earth (bool, optional) – Render Earth sphere. Default True.

  • title (str, optional) – Plot heading.

Returns:

Plotly 3D scatter object.

Return type:

go.Figure