5 releases

new 0.2.8 May 17, 2024
0.2.7 Apr 25, 2024
0.2.6 Apr 8, 2024
0.2.5 Mar 23, 2024
0.2.3 Mar 22, 2024

#273 in Algorithms

Download history 210/week @ 2024-03-17 40/week @ 2024-03-24 34/week @ 2024-03-31 110/week @ 2024-04-07 4/week @ 2024-04-14 162/week @ 2024-04-21 9/week @ 2024-04-28 172/week @ 2024-05-12

343 downloads per month

Custom license

775KB
16K SLoC

Rust 13K SLoC // 0.1% comments C 1.5K SLoC // 0.2% comments Python 705 SLoC // 0.3% comments Jupyter Notebooks 475 SLoC // 0.2% comments Batch 227 SLoC // 0.0% comments JavaScript 12 SLoC // 0.1% comments

Satellite Toolkit with Rust

An accurate, high-performance satellite orbital kinematics toolkit, written in Rust with a sensible interface.
Also includes python bindings for all functions via via pyo3

Github

Build Passing? Wheel Passing? GitHub License

Crates.io

Crates.io Version Crates.io Downloads (recent)

PyPi

PyPI - Version PyPI - Python Version PyPI - Implementation PyPI - Status

Read the Docs

Language Bindings

  • Native Rust bindings
  • Python bindings for compiled rust code ... speed of Rust with convenience of Python
    Install with pip install satkit
    PyPi includes binary packages for windows, macos (Intel & ARM), and linux. Python documentation is at: https://satellite-toolkit.readthedocs.io/latest/

Features

  • High-precision coordinate transforms between:
    • International Terrestrial Reference Frame (ITRF)
    • Geocentric Celestial Reference Frame (GCRF) using IAU-2000 reduction
    • True-Equinox Mean Equator (TEME) frame used in SGP4 propagation of TLEs
    • Celestial Intermediate Reference Frame (CIRF)
    • Terrestrial Intermediate Reference Frame (TIRF)
    • Terrestrial Geodetic frame (latitude, longitude)
  • Geodesic distances
  • SGP4, and Keplerian orbit propagation
  • JPL high-precision planetary ephemerides
  • High-order gravity models
  • High-precision, high-speed numerical satellite orbit propagation with high-order efficient Runga-Kutta solvers, ability to solve for state transition matrix, and inclusion following forces:
    • High-order Earth gravity with multiple models
    • Solar gravity
    • Lunar gravity
    • Drag (NRL MISE-00 density model)
    • Radiation pressure

ODE Solvers

The high-precision numerical satellite orbit propagation makes use of standard Runga-Kutta methods for integration of ordinary differential equations. The ODE solver is included as part of the library.

The methods use Runga-Kutta pairs for ODE integration and error estimation generated by Jim Verner: https://www.sfu.ca/~jverner/

References, Models, and External Software.

The equations and many of the unit tests underlying this work are drawn from the following sources:

This code makes reference to and relies on models generated by the following:

Verification

The code includes rust test modules and python test modules for verification of nearly calculations, including but not limited to:

  • JPL Ephemeris - Via JPL-provided test vectors for Chebychev polynomial calculation
  • SGP4 - Via SGP4 test vectors provided with original C++ distribution

Author

Steven Michael (ssmichael@gmail.com)

Please reach out of you find errors in code or calculations, are interested in contributing to this repository, or have suggestions for improvements to the API.

Dependencies

~7–14MB
~207K SLoC