across.tools.core.schemas.tle

Classes

TLEBase	A base schema representing a Two-Line Element (TLE) set for satellite tracking.
TLE	Two Line Element (TLE) data representation.

Module Contents

class TLEBase(/, **data)

Bases: across.tools.core.schemas.base.BaseSchema

A base schema representing a Two-Line Element (TLE) set for satellite tracking. :param norad_id: The NORAD Catalog Number (SATCAT) that uniquely identifies the satellite. :type norad_id: int or None :param satellite_name: The name or designation of the satellite. :type satellite_name: str or None :param tle1: The first line of the TLE set, must be exactly 69 characters long.

Contains information about satellite epoch, decay rate, etc.

Parameters:

tle2 (str) – The second line of the TLE set, must be exactly 69 characters long. Contains orbital elements like inclination, eccentricity, etc.

Notes

TLE is a data format encoding a set of orbital elements for Earth-orbiting objects. Each TLE line must be exactly 69 characters long per NORAD specification.

norad_id: int | None = None

satellite_name: str | None = None

tle1: str = None

tle2: str = None

class TLE(/, **data)

Bases: TLEBase

Two Line Element (TLE) data representation.

This class represents a Two Line Element Set, which is a data format used to convey sets of orbital elements that describe the orbits of Earth-orbiting satellites.

Parameters:

• norad_id (int) – The NORAD Catalog Number (SATCAT) that uniquely identifies the satellite

• satellite_name (str) – The name of the satellite (used as Partition Key)

• tle1 (str) – First line of the TLE, must be exactly 69 characters

• tle2 (str) – Second line of the TLE, must be exactly 69 characters

• epoch (datetime) – The epoch timestamp calculated from the TLE data

Notes

TLE format specifications can be found at: https://celestrak.org/NORAD/documentation/tle-fmt.php

Examples

>>> tle = TLE(
...     satname="ISS (ZARYA)",
...     tle1="1 25544U 98067A   08264.51782528 -.00002182  00000-0 -11606-4 0  2927",
...     tle2="2 25544  51.6416 247.4627 0006703 130.5360 325.0288 15.72125391563537"
... )

epoch: datetime.datetime

classmethod validate_tle(values)

Validate the TLE data. This checks whether the TLE lines are correctly formatted and contain valid information, as well as calculate the epoch. :rtype: The calculated epoch of the TLE.