lumos.constellation.library.ConstellationFromTLE

class lumos.constellation.library.ConstellationFromTLE(tle_file_path)[source]

Bases: Constellation

This class builds a constellation from a TLE file

Parameters:

tle_file_path (str) – Path to a TLE text file

Methods

get_hcs_position

Gets position of all satellites in constellation in HCS frame

get_teme_position

Gets positions of all satellites in TEME coordinate frame

plot_hcs

Plots satellite constellation in HCS coordinate frame

plot_teme

Plots satellite constellation in TEME coordinate frame

get_hcs_position(time, earth_location)

Gets position of all satellites in constellation in HCS frame

Parameters:
  • time (astropy.time.Time) – Time at which to get positions

  • earth_location (astropy.coordinates.EarthLocation) – Location at which to get positions in HCS frame

Returns:

altitudes (degrees), azimuths (degrees), heights (meters)

Return type:

tuple[np.ndarray]

get_teme_position(time)

Gets positions of all satellites in TEME coordinate frame

Parameters:

time (astropy.time.Time) – Time at which to get positions

Returns:

(x, y, z) position measured in meters

Return type:

tuple[np.ndarray]

plot_hcs(ax, time, location)

Plots satellite constellation in HCS coordinate frame

Parameters:
  • ax (matplotlib.pyplot.Axes) – Axis for plotting onto (must be polar projection)

  • time (astropy.time.Time) – Time at which to plot constellation

  • location (astropy.coordinates.EarthLocation) – Location on Earth at which to plot constellation

plot_teme(ax, time)

Plots satellite constellation in TEME coordinate frame

Parameters:
  • ax (matplotlib.pyplot.Axes) – Axis for plotting onto (must be 3D projection)

  • time (astropy.time.Time) – Time at which to plot constellation