satkit 0.2.4__tar.gz

satkit-0.2.4/Cargo.toml

@@ -0,0 +1,51 @@
+[package]
+name = "satkit"
+version = "0.2.4"
+edition = "2021"
+description = "Satellite Toolkit"
+readme = "README.md"
+licence = "MIT"
+license-file = "LICENSE"
+homepage = "https://github.com/ssmichael1/satkit"
+repository = "https://github.com/ssmichael1/satkit"
+documentation = "https://docs.rs/satkit"
+keywords = ["satellite", "orbit", "ephemeris", "tle", "astrodynamics"]
+categories = ["aerospace", "algorithms", "mathematics", "science"]
+
+
+# See more keys and their definitions at 
+# https://doc.rust-lang.org/cargo/reference/manifest.html
+[lib]
+name = "satkit"
+
+
+[dependencies]
+nalgebra = "0.32.3"
+ndarray = "0.15.6"
+libc = "0.2"
+chrono = "0.4.19"
+cty = "0.2.2"
+num-traits = "0.2"
+thiserror = "1.0"
+simba = "0.8"
+once_cell = "1.6.0"
+numpy = { version = "0.20.0", optional = true }
+pyo3 = { version = "0.20.0", features = ["extension-module"], optional = true }
+ureq = "2.9.1"
+json = "0.12.4"
+process_path = "0.1.4"
+
+[build-dependencies]
+cc = { version = "1.0.74", features = ["parallel"] }
+chrono = "0.4.19"
+pyo3-build-config = { version = "0.20.0", optional = true }
+
+[dev-dependencies]
+rand = "0.8.5"
+approx = "0.5.1"
+
+[features]
+pybindings = ["pyo3", "numpy", "pyo3-build-config"]
+
+[profile.test]
+opt-level = 3

satkit-0.2.4/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2022 Steven Michael
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

satkit-0.2.4/MANIFEST.in

@@ -0,0 +1,5 @@
+include Cargo.toml
+recursive-include src *.rs python extern
+include LICENSE
+include README.md
+include pyproject.toml

satkit-0.2.4/PKG-INFO

@@ -0,0 +1,95 @@
+Metadata-Version: 2.1
+Name: satkit
+Version: 0.2.4
+Summary: Satellite Orbital Dynamics Toolkit
+Author-email: Steven Michael <ssmichael@gmail.com>
+Maintainer-email: Steven Michael <ssmichael@gmail.com>
+Keywords: satellite,orbit,astrodynamics,SGP4,TLE,JPL,Ephemeris
+Classifier: Development Status :: 3 - Alpha
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3.8
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Requires-Python: >=3.8
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: numpy>=1.20.0
+
+# Satellite Toolkit with Rust
+
+![Build Passing?](https://github.com/ssmichael1/satkit/actions/workflows/build.yml/badge.svg)
+![Wheel Passing?](https://github.com/ssmichael1/satkit/actions/workflows/wheels.yml/badge.svg)
+![GitHub License](https://img.shields.io/github/license/ssmichael1/satkit)
+<br/>
+An accurate, high-performance satellite orbital kinematics toolkit, written in Rust with a sensible interface.
+
+## Language Bindings
+
+- **Native Rust** bindings
+- **Python bindings** for compiled rust code ... speed of Rust with convenience of Python
+
+## Features
+
+- Timescale transformations (UTC, GPS, UT1, TBD, TT, ...)
+- 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/](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:
+
+- **"Fundamentals of Astrodynamics and Applications, Fourth Edition"**, D. Vallado, Microcosm Press and Springer, 2013.<br>
+  [https://celestrak.org/software/vallado-sw.php](https://celestrak.org/software/vallado-sw.php)
+- **"Satellite Orbits: Models, Methods, Applications"**, O. Montenbruck and E. Gill, Springer, 2000.<br>
+  [https://doi.org/10.1007/978-3-642-58351-3](https://doi.org/10.1007/978-3-642-58351-3)
+
+### This code makes reference to and relies on models generated by the following:
+
+- **SGP4 Orbit Propagator** - https://celestrak.org/software/tskelso-sw.php<br/>
+  NORAD / SGP4 orbit propagator used to generate position and velocity states from orbital ephemerides described by Two-Line Element Sets (TLEs). This code base includes a pure-rust translation of the SGP4 orbit propagator
+- **NRL MSISE-00 Density Model** - https://ccmc.gsfc.nasa.gov/models/NRLMSIS~00/<br/>
+  NRL model of air density, including density at high altitudes, used in to compute satellite drag
+- **Gravity Models** - http://icgem.gfz-potsdam.de/home<br/>
+  International Center for Global Earth Models (ICEGM), collection and archive in a common format of all existing global gravity field models
+- **Space Weather** - https://celestrak.org/SpaceData/<br/>
+  Space weather used to modulate the air density used in drag calculations
+- **Earth Orientation Parameters** - https://celestrak.org/SpaceData/<br/>
+  Time-varying Earth orientation parameters used for time epoch conversions and high-precision rotations between the inertial and Earth-fixed coordinate frames
+- **IERS Conventions** - https://www.iers.org/IERS/EN/Publications/TechnicalNotes/tn36.html<br/>
+  International Earth Rotation and Reference Systems Service Technical Note 36 for rotation between inertial and Earth-fixed coordinate systems.
+
+## 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<sup>++</sup> 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.

satkit-0.2.4/README.md

@@ -0,0 +1,76 @@
+# Satellite Toolkit with Rust
+
+![Build Passing?](https://github.com/ssmichael1/satkit/actions/workflows/build.yml/badge.svg)
+![Wheel Passing?](https://github.com/ssmichael1/satkit/actions/workflows/wheels.yml/badge.svg)
+![GitHub License](https://img.shields.io/github/license/ssmichael1/satkit)
+<br/>
+An accurate, high-performance satellite orbital kinematics toolkit, written in Rust with a sensible interface.
+
+## Language Bindings
+
+- **Native Rust** bindings
+- **Python bindings** for compiled rust code ... speed of Rust with convenience of Python
+
+## Features
+
+- Timescale transformations (UTC, GPS, UT1, TBD, TT, ...)
+- 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/](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:
+
+- **"Fundamentals of Astrodynamics and Applications, Fourth Edition"**, D. Vallado, Microcosm Press and Springer, 2013.<br>
+  [https://celestrak.org/software/vallado-sw.php](https://celestrak.org/software/vallado-sw.php)
+- **"Satellite Orbits: Models, Methods, Applications"**, O. Montenbruck and E. Gill, Springer, 2000.<br>
+  [https://doi.org/10.1007/978-3-642-58351-3](https://doi.org/10.1007/978-3-642-58351-3)
+
+### This code makes reference to and relies on models generated by the following:
+
+- **SGP4 Orbit Propagator** - https://celestrak.org/software/tskelso-sw.php<br/>
+  NORAD / SGP4 orbit propagator used to generate position and velocity states from orbital ephemerides described by Two-Line Element Sets (TLEs). This code base includes a pure-rust translation of the SGP4 orbit propagator
+- **NRL MSISE-00 Density Model** - https://ccmc.gsfc.nasa.gov/models/NRLMSIS~00/<br/>
+  NRL model of air density, including density at high altitudes, used in to compute satellite drag
+- **Gravity Models** - http://icgem.gfz-potsdam.de/home<br/>
+  International Center for Global Earth Models (ICEGM), collection and archive in a common format of all existing global gravity field models
+- **Space Weather** - https://celestrak.org/SpaceData/<br/>
+  Space weather used to modulate the air density used in drag calculations
+- **Earth Orientation Parameters** - https://celestrak.org/SpaceData/<br/>
+  Time-varying Earth orientation parameters used for time epoch conversions and high-precision rotations between the inertial and Earth-fixed coordinate frames
+- **IERS Conventions** - https://www.iers.org/IERS/EN/Publications/TechnicalNotes/tn36.html<br/>
+  International Earth Rotation and Reference Systems Service Technical Note 36 for rotation between inertial and Earth-fixed coordinate systems.
+
+## 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<sup>++</sup> 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.

satkit-0.2.4/pyproject.toml

@@ -0,0 +1,105 @@
+[build-system]
+requires = ["setuptools", "setuptools-rust"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "satkit"
+version = "0.2.4"
+dependencies = ["numpy>=1.20.0"]
+requires-python = ">= 3.8"
+authors = [{ name = "Steven Michael", email = "ssmichael@gmail.com" }]
+maintainers = [{ name = "Steven Michael", email = "ssmichael@gmail.com" }]
+readme = "README.md"
+description = "Satellite Orbital Dynamics Toolkit"
+keywords = [
+    "satellite",
+    "orbit",
+    "astrodynamics",
+    "SGP4",
+    "TLE",
+    "JPL",
+    "Ephemeris",
+]
+classifiers = [
+    # How mature is this project? Common values are
+    #   3 - Alpha
+    #   4 - Beta
+    #   5 - Production/Stable
+    "Development Status :: 3 - Alpha",
+
+    # Pick your license as you wish (see also "license" above)
+    "License :: OSI Approved :: MIT License",
+
+    # Specify the Python versions you support here.
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+]
+
+[tool.setuptools.packages]
+find = { where = ["python"] }
+
+[tool.cibuildwheel]
+build = ["cp312-*", "cp311-* cp310-* cp39-* cp38-*"]
+
+[tool.cibuildwheel.macos]
+archs = ["x86_64", "arm64"]
+before-build = [
+    "pip install -U setuptools-rust",
+    "rustup default stable",
+    "rustup target add aarch64-apple-darwin",
+    "rustup show",
+]
+environment = { PATH = "$PATH:$HOME/.cargo/bin" }
+# Skip trying to test arm64 builds on Intel Macs
+test-skip = "*-macosx_arm64 *-macosx_universal2:arm64"
+test-requires = "pytest"
+test-command = [
+    "ASTRO_DATA={package}/astro-data SATKIT_TESTVEC_ROOT={package}/satkit-testvecs pytest {project}/python/test/test.py",
+]
+
+
+[tool.cibuildwheel.linux]
+environment = { PATH = "$PATH:$HOME/.cargo/bin" }
+archs = ["x86_64"]
+skip = ["pp*", "*_i686", "*_s390x", "*_aarch64", "*_ppc64le", "*-musllinux*"]
+before-build = [
+    "pip install -U setuptools-rust",
+    "curl https://sh.rustup.rs -sSf | sh -s -- --default-toolchain=stable --profile=minimal -y",
+    "rustup show",
+]
+test-requires = "pytest"
+test-command = [
+    "ASTRO_DATA={package}/astro-data SATKIT_TESTVEC_ROOT={package}/satkit-testvecs pytest {project}/python/test/test.py",
+]
+
+[tool.cibuildwheel.windows]
+environment = { PATH = '$UserProfile\.cargo\bin;$PATH' }
+before-build = [
+    "pip install -U setuptools-rust",
+    "rustup toolchain install stable-x86_64-pc-windows-msvc",
+    "rustup default stable-x86_64-pc-windows-msvc",
+    "rustup override set stable-x86_64-pc-windows-msvc",
+    "rustup show",
+]
+archs = ["AMD64"]
+skip = ["pp*"]
+test-requires = "pytest"
+before-test = [
+    "set ASTRO_DATA={package}\\astro-data",
+    "set SATKIT_TESTVEC_ROOT={package}\\satkit-testvecs",
+]
+test-command = [
+    "set ASTRO_DATA={package}\\astro-data&&set SATKIT_TESTVEC_ROOT={package}\\satkit-testvecs&&pytest {project}\\python\\test\\test.py",
+]
+
+
+[[tool.setuptools-rust.ext-modules]]
+features = ["pybindings"]
+args = ["--crate-type", "cdylib"]
+target = "satkit/satkit"
+path = "Cargo.toml"
+binding = "PyO3"
+py-limited-api = "auto"

satkit-0.2.4/python/satkit/__init__.py

@@ -0,0 +1,8 @@
+from .satkit import *
+
+if utils.datadir() == None:
+    print(f"Could not find necessary data files.")
+    print(f'Run "satkit.utils.update_datafiles()" to download necessary files')
+    print(f"This includes JPL ephemeris, gravity, space weather, ")
+    print(f"Earth orientation parameters, leap seconds, and coefficients")
+    print(f"for inertial-to-Earth-fixed transforms")