pyorbital

library1.12.1pypypi✓ verified 86d ago

Pyorbital is a Python library for orbital mechanics and satellite pass prediction. It provides tools to compute satellite positions, orbit propagation, and ground track calculations. Current version is 1.12.1, with a stable release cadence.

devops

pip install pyorbital

INSTALL

IMPORT

SIG · PYORBITAL

pyorbital

devopspythonv1.12.1

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Orbital

✓ from pyorbital.orbital import Orbital

✗ from pyorbital import Orbital

Orbital class is in the orbital submodule, not top-level.

get_observer_look

✓ from pyorbital.orbital import get_observer_look

✗ from pyorbital import get_observer_look

Function resides in orbital module.

Create an Orbital object for a satellite (e.g., ISS) and compute its current longitude, latitude, and altitude.

from pyorbital.orbital import Orbital import datetime sat = Orbital('ISS (ZARYA)') now = datetime.datetime.utcnow() lon, lat, alt = sat.get_lonlatalt(now) print(f'ISS position: Lon {lon:.2f}, Lat {lat:.2f}, Alt {alt:.2f} km')

Debug

Known issues

gotchaSatellite names must be exactly as in TLE data (e.g., 'ISS (ZARYA)'). Case-sensitive and includes parentheses.

fix

Use the exact name from the TLE catalog.

affects: all

deprecatedPython 3.9 support dropped in pyorbital 1.12.0; requires Python >=3.10.

fix

Upgrade Python to 3.10+ or pin pyorbital<1.12.0.

affects: >=1.12.0

breakingThe function 'get_observer_lookup' was renamed to 'get_observer_look' in version 1.8.0.

fix

Use 'get_observer_look' instead.

affects: >=1.8.0

Errors

Common errors & fixes

TLE data unavailable

No internet connection or Celestrak is blocked.

fix

Provide local TLE file via Orbital('ISS (ZARYA)', line1='...', line2='...').

ValueError: Satellite name not found in TLE

Incorrect satellite name spelling or missing from default catalog.

fix

Check exact name at Celestrak; use Orbital('ISS (ZARYA)') with proper casing.

Upgrade

Version history

1.12.1latest on PyPI · released Mar 5, 2026

Audit

Dependencies

No dependency data recorded yet.

Agent activity

4 hits · last 30 days

node

Resources

No resource links recorded.