10 releases

new 0.4.1 Nov 9, 2024
0.4.0 Oct 24, 2024
0.3.14 Oct 14, 2024
0.3.11 Sep 15, 2024
0.2.5 Mar 23, 2024

#196 in Algorithms

Download history 129/week @ 2024-07-26 145/week @ 2024-08-02 175/week @ 2024-08-09 153/week @ 2024-08-16 151/week @ 2024-08-23 261/week @ 2024-08-30 357/week @ 2024-09-06 295/week @ 2024-09-13 367/week @ 2024-09-20 279/week @ 2024-09-27 204/week @ 2024-10-04 359/week @ 2024-10-11 426/week @ 2024-10-18 236/week @ 2024-10-25 279/week @ 2024-11-01 333/week @ 2024-11-08

1,320 downloads per month

Custom license

1MB
18K SLoC

Rust 14K SLoC // 0.1% comments C 1.5K SLoC // 0.2% comments Python 1.5K SLoC // 0.6% comments Jupyter Notebooks 548 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

~8–11MB
~202K SLoC