lox

Lox – Oxidized Astrodynamics

Lox is an MPLv2-licensed Rust astrodynamics library with first-class Python bindings for orbital mechanics, mission analysis, and telecommunications.

lox-space is the main entry point for both the Rust and Python APIs, re-exporting all functionality from the Lox ecosystem through a unified interface and providing a prelude of the most commonly used types. Each module mirrors the corresponding standalone crate; enable the matching cargo feature to pull it in.

Python Quick Start

import lox_space as lox

# Parse a UTC epoch and convert to the TDB time scale
epoch = lox.UTC.from_iso("2025-01-01T12:00:00").to_scale("TDB")

# Load Earth orientation parameters
provider = lox.EOPProvider("finals2000A.all.csv")

# Design a sun-synchronous orbit at 800 km altitude with a 10:30 LTAN
sso = lox.Keplerian.sso(
    epoch, altitude=800 * lox.km, ltan=(10, 30), provider=provider
)

# Convert to Cartesian state and propagate with J2 perturbations
state = sso.to_cartesian()
j2 = lox.J2(state)
trajectory = j2.propagate(epoch, end=epoch + 100 * lox.minutes)

Rust Quick Start

…

Installation

Python

uv add lox-space
# or
pip install lox-space

Rust

cargo add lox-space

Or add to your Cargo.toml:

[dependencies]
lox-space = "0.1"

Features

• Orbital Mechanics — Keplerian elements, state vectors, SSO design, Vallado/J2/SGP4 propagation, TLE parsing
• Time Systems — TAI, TT, TDB, TCB, TCG, UTC, UT1; femtosecond precision, leap-second aware
• Reference Frames — ICRF, ITRF, TEME; CIO and equinox-based transformation chains
• Ground Stations — Visibility windows, elevation masks, pass prediction
• Constellation Design — Walker Delta/Star, Street-of-Coverage, Flower
• RF Link Budgets — Antenna patterns, modulation schemes, path loss
• Python Bindings — Full API with type stubs and NumPy interop

Status

Lox is pre-1.0. The API may change between releases.

Documentation

• Python:
• Rust:

Community

• Zulip Chat

Why "Lox"?

Liquid oxygen—abbreviated LOx, LOX or Lox in the aerospace, submarine and gas industries—is the liquid form of molecular oxygen. It was used as the oxidizer in the first liquid-fueled rocket invented in 1926 by Robert H. Goddard, an application which has continued to the present. Wikipedia