Skip to main content
Join the official 2020 Python Developers SurveyStart the survey!

Library to work with two-line element set files

Project description


PyPI PyPI - License PyPI - Python Version PyPI - Wheel

TLE-tools is a small library to work with two-line element set files.


The purpose of the library is to parse TLE sets into convenient TLE objects, load entire TLE set files into pandas.DataFrame's, convert TLE objects into poliastro.twobody.Orbit's, and more.

From Wikipedia:

A two-line element set (TLE) is a data format encoding a list of orbital elements of an Earth-orbiting object for a given point in time, the epoch. The TLE data representation is specific to the simplified perturbations models (SGP, SGP4, SDP4, SGP8 and SDP8), so any algorithm using a TLE as a data source must implement one of the SGP models to correctly compute the state at a time of interest. TLEs can describe the trajectories only of Earth-orbiting objects.


1 25544U 98067A   19249.04864348  .00001909  00000-0  40858-4 0  9990
2 25544  51.6464 320.1755 0007999  10.9066  53.2893 15.50437522187805

Here is a minimal example on how to load the previous TLE:

from tletools import TLE

tle_string = """
1 25544U 98067A   19249.04864348  .00001909  00000-0  40858-4 0  9990
2 25544  51.6464 320.1755 0007999  10.9066  53.2893 15.50437522187805

tle_lines = tle_string.strip().splitlines()

tle = TLE.from_lines(*tle_lines)

Then tle is:

TLE(name='ISS (ZARYA)', norad='25544', classification='U', int_desig='98067A',
epoch_year=2019, epoch_day=249.04864348, dn_o2=1.909e-05, ddn_o6=0.0, bstar=4.0858e-05,
set_num=999, inc=51.6464, raan=320.1755, ecc=0.0007999, argp=10.9066, M=53.2893,
n=15.50437522, rev_num=18780)

and you can then access its attributes like t.argp, t.epoch...

TLE format specification

Some more or less complete TLE format specifications can be found on the following websites:


Install and update using pip:

pip install -U TLE-tools


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for TLE-tools, version 0.2.3
Filename, size File type Python version Upload date Hashes
Filename, size TLE_tools-0.2.3-py2.py3-none-any.whl (10.4 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size TLE-tools-0.2.3.tar.gz (9.4 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page