13 releases
0.4.1 | Jul 30, 2024 |
---|---|
0.4.0 | Jul 19, 2023 |
0.3.8 | Mar 13, 2023 |
0.3.6 | Jul 5, 2022 |
0.2.1 | Nov 12, 2020 |
#120 in Science
280 downloads per month
160KB
3K
SLoC
sgp4-rs
This crate implements a wrapper around the C++ implementation of the SGP-4 orbital propagator as provided in the "Revisiting Spacetrack Report #3" paper (link). It provides high level bindings to the propagator library with a more modern interface.
Our approach separates the low-level unsafe
bindings into the sgp4_sys
module, while safe
functions are exported through the library's root module. Because the underlying SGP4 implementation
is thread-safe, this crate can be used in multithreaded environments and with async/await code.
We have not created bindings to every function in the library, especially as some of them are duplicative of Rust standard library functions. The core propagator functionality is exposed, and allows predicting an orbiting body's state vector at a given time from two line element data.
Building
sgp4
builds cleanly on the stable Rust channel, but does require a local C++ compiler to be
present in order to build the wrapped SGP4 library.
Experimental Features
The tlegen
feature adds basic support for creating custom TLEs from a set of orbital elements.
This feature is subject to several important caveats, so it is not enabled by default. See the
ClassicalOrbitalElements
documentation for details.
Related
The sgp4
crate is a pure Rust reimplementation of
the Vallado library which this crate wraps.
Dependencies
~2.2–3.5MB
~68K SLoC