satkit.propagation.tle_list

TLE list helper functions.

Classes

TleRangeFilterParams(value[, names, module, ...])	TLE Range Filtering Parameters.
TleStorage(tle_list)	TLE storage class that keeps a list of TLE data from multiple satellites, at multiple times and without any ordering.
TleTimeSeries(tle_list, sat_number)	TLE storage class that keeps a list of TLE data from a single satellite, at multiple times and with time order.
TleValueFilterParams(value[, names, module, ...])	TLE Value Filtering Parameters.

class TleRangeFilterParams(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

TLE Range Filtering Parameters.

ARG_OF_PERIGEE = 'perigeeArgument'

BSTAR = 'bStar'

DATE = 'date'

E = 'e'

ECCENTRICITY = 'e'

ELEMENT_NR = 'elementNumber'

EPOCH = 'date'

INCL = 'i'

INCLINATION = 'i'

LAUNCH_NR = 'launchNumber'

LAUNCH_YR = 'launchYear'

MEAN_ANOMALY = 'meanAnomaly'

MEAN_MOTION = 'meanMotion'

N = 'meanMotion'

N_DOT = 'meanMotionFirstDerivative'

N_DOT_DOT = 'meanMotionSecondDerivative'

RAAN = 'raan'

REV_NR = 'revolutionNumberAtEpoch'

SAT_NR = 'satelliteNumber'

class TleStorage(tle_list)

TLE storage class that keeps a list of TLE data from multiple satellites, at multiple times and without any ordering.

This class is the entry point for reading a TLE file, from which various sublists (e.g. single satellite, all LEO sats etc.) can be derived.

Parameters

tle_list (list[TLE]) – initial list of TLE objects (shallow copied into object)

classmethod from_path(tle_file_path)

Read a set of TLE data from file. Tries to extract satellite names from the list, if no name is found, an empty string (not None) is assigned.

Parameters

tle_file_path (Path) – Path of the text file to be read

Returns

A TleStorage object that contains the list of TLE data

Return type

TleStorage

classmethod from_string(tle_string)

Read a set of TLE data from a text. Tries to extract satellite names from the list, if no name is found, an empty string (not None) is assigned.

Parameters

tle_string (str) – String containing successive TLE data

Returns

A TleStorage object that contains the list of TLE data

Return type

TleStorage

to_tle_timeseries(sat_number)

Filters the TLE list for a single satellite to initialise a TleTimeSeries.

Parameters

sat_number – Satellite Catalog Number

Returns

A TleTimeSeries object that contains the list of TLE data of a single satellite

Return type

TleTimeSeries

class TleTimeSeries(tle_list, sat_number)

TLE storage class that keeps a list of TLE data from a single satellite, at multiple times and with time order.

The entry point is ideally the TleStorage class, where a TLE file is usually read, and a single satellite is filtered. Once this class is initialised, various sublists (e.g. specific time range) can be derived.

Parameters

tle_list (list[TLE]) – initial list of TLE objects (shallow copied into object)

class TleValueFilterParams(value, names=None, *, module=None, qualname=None, type=None, start=1, boundary=None)

TLE Value Filtering Parameters.

CLASSIFICATION = 'classification'

ELEMENT_NR = 'elementNumber'

EPHEMERIS_TYPE = 'ephemerisType'

LAUNCH_NR = 'launchNumber'

LAUNCH_PIECE = 'launchPiece'

LAUNCH_YR = 'launchYear'

REV_NR = 'revolutionNumberAtEpoch'

SAT_NR = 'satelliteNumber'