poliastro2.worldview.earth.plotting.groundtrack

Holds ground-track plotter for Earth satellites.

Classes

GroundtrackPlotter([fig, color_palette])

Generates two-dimensional ground-track.
class poliastro2.worldview.earth.plotting.groundtrack.GroundtrackPlotter(fig=None, color_palette={'dessert_color': 'd8c596', 'lake_color': '#e9eff9', 'land_color': '#9fc164', 'ocean_color': '#b2d9ff'})

Generates two-dimensional ground-track.

_from_raw_to_ITRS(raw_xyz, raw_obstime)

Converts raw coordinates to ITRS ones.

Parameters:

  • raw_xyz (numpy.ndarray) – A collection of rwa position coordinates

  • raw_obstime (numpy.ndarray) – Associated observation time

Returns:

itrs_xyz – A collection of coordinates in ITRS frame

Return type:

ITRS

_get_raw_coords(orb, t_deltas)

Generates raw orbit coordinates for given epochs.

Parameters:

  • orb (Orbit) – Orbit to be propagated

  • t_deltas (DeltaTime) – Desired observation time

Returns:

  • raw_xyz (numpy.ndarray) – A collection of raw cartesian position vectors

  • raw_epochs (numpy.ndarray) – Associated epoch with previously raw coordinates

_trace_groundtrack(orb, t_deltas, label, line_style)

Generates a trace for EarthSatellite’s orbit grountrack.

Parameters:

  • orb (Orbit) – EarthSatellite’s associated Orbit

  • t_deltas (DeltaTime) – Collection of epochs

  • label (string) – Name for the trace

  • line_style (dict) – Dictionary for customizing groundtrack line trace

Returns:

gnd_trace – Trace associated to grountrack

Return type:

Scattergeo

_trace_position(ss, label, marker)

Adds marker trace to self figure showing current position.

Parameters:

  • ss (Orbit) – EarthSatellite’s orbit

  • label (string) – Label for the orbit

  • marker (dict) – Dicitonary holding plotly marker configuration

Returns:

trace – Scattergeo trace for current position

Return type:

Scattergeo

add_trace(trace)

Adds trace to custom figure.

plot(earth_orb, t_span, label, color, line_style={}, marker={})

Plots desired Earth satellite orbit for a given time span.

Parameters:

  • earth_orb (EarthSatellite) – Desired Earth’s satellite to who’s grountrack will be plotted

  • t_span (TimeDelta) – A collection of epochs

  • label (str) – Label for the groundtrack.

  • color (string) – Desired lines and traces color

  • line_style (dict) – Dictionary for customizing groundtrack line trace

  • marker (dict) – Dictionary for customizing groundtrack marker trace

Returns:

fig – Output figure

Return type:

Figure

update_geos(**config)

Enables user to customize geo figure.

Parameters:

**config (dict) – A collection of custom values for geo figure

update_layout(**config)

Enables user to customize figure layout.

Parameters:

**config (dict) – A collection of custom values for figure layout