poliastro.earth.plotting.groundtrack

Holds ground-track plotter for Earth satellites

Module Contents

Classes

GroundtrackPlotter

Generates two-dimensional ground-track

class poliastro.earth.plotting.groundtrack.GroundtrackPlotter(fig=None, color_palette=EARTH_PALETTE)

Generates two-dimensional ground-track

update_geos(self, **config)

Enables user to customize geo figure

Parameters

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

update_layout(self, **config)

Enables user to customize figure layout

Parameters

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

add_trace(self, trace)

Adds trace to custom figure

_get_raw_coords(self, ss, t_deltas)

Generates raw orbit coordinates for given epochs

Parameters
  • ss (orbit) – Orbit to be propagated

  • t_deltas (DeltaTime) – Desired observation time

Returns

  • raw_xyz (array) – A collection of raw cartessian position vectors

  • raw_epochs (array) – Associated epoch with previously raw coordinates

_from_raw_to_ITRS(self, raw_xyz, raw_obstime)

Converts raw coordinates to ITRS ones

Parameters
  • raw_xyz (array) – A collection of rwa position coordinates

  • raw_obstime (array) – Associated observation time

Returns

itrs_xyz – A collection of coordinates in ITRS frame

Return type

ITRS

_trace_groundtrack(self, ss, t_deltas, label, line_style)

Generates a trace for EarthSatellite’s orbit grountrack

Parameters
  • ss (Orbit) – EarthSatellite’s associated Orbit

  • t_deltas (DeltaTime) – Collection of epochs

  • label (string) – Name for the trace

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

Returns

gnd_trace – Trace associated to grountrack

Return type

Scattergeo

_trace_position(self, 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 (dictionary) – Dicitonary holding plotly marker configuration

Returns

trace – Scattergeo trace for current position

Return type

Scattergeo

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

Plots desired Earth satellite orbit for a given time span

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

  • t_span (TimeDelta) – A collection of epochs

  • color (string) – Desired lines and traces color

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

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

Returns

fig – Output figure

Return type

Figure