GRSS: Gauss-Radau Small-body Simulator
Project description
GRSS
GRSS (pronounced "grass"), the Gauss-Radau Small-body Simulator is a Python package with a C++ binding for propagating and fitting the orbits of small bodies in the solar system, such as asteroids and comets.
If you use GRSS in your research, please cite at least one of the following:
- Makadia et al. (2024), "Measurability of the Heliocentric Momentum Enhancement from a Kinetic Impact: The Double Asteroid Redirection Test (DART) Mission", Planetary Science Journal, 5, 38.
- Makadia et al. (2023), "GRSS: An open-source small-body science tool for planetary defense", 55th Annual Meeting of the Division for Planetary Sciences.
Getting Started
There are currently two different ways to install the GRSS library.
- Using the Python Package Index (PyPI)
- Using the source code from the GitHub repository
Install via PyPI
The GRSS library is available on PyPI and can be installed using the following command:
pip install grss
If this installation fails (i.e., you get an error when importing GRSS), you can try installing it without using the binary wheel on PyPI by using the following command:
pip install grss --no-binary grss
NOTE: The GRSS library is currently not pip-installable on Intel-based Macs. To use the library on an Intel-based Mac, please install the library using the source code from the GitHub repository (see below for instructions).
Install via source code (Python)
The source code for the GRSS library is available on GitHub and can be downloaded using the following command:
git clone https://www.github.com/rahil-makadia/grss
Once the source code has been downloaded, the library can be installed using the following command:
cd grss
source initialize.sh
python3 -m pip install .
Install via source code (C++, reduced functionality)
The source code for the GRSS library is available on GitHub and can be downloaded using the following command:
git clone https://www.github.com/rahil-makadia/grss
Once the source code has been downloaded, the library can be installed using the following command:
cd grss
source initialize.sh
source build_cpp.sh
You will need to have CMake installed on your system to build the C++ library. Once the build script has completed, you can use the resulting static/shared library from the build
directory in your C++ projects.
Keep in mind the C++ library only contains support for propagating orbits and calculating observables. If you want to use the orbit fitting functionality, you will need to install the full Python library.
Usage
Once the GRSS library has been installed, it can be imported into a Python script using the following command:
import grss
The first time the library is imported, it will download some data files such as NAIF SPICE kernels and the data needed to debias optical astrometry. This should should take a few minutes, and if the download was completed, the following message will be printed for each file:
YYYY-MM-DD HH:MM:SS URL:url-of-downloaded-file [filesize] -> path/to/downloaded/file [1]
Once these files are available to the library, you are ready to use GRSS to its full potential!
Check out the examples on the GRSS website to get started.
Acknowledgements
GRSS Development Team:
- Rahil Makadia
- Steven R. Chesley
- Siegfried Eggl
- Davide Farnocchia
The GRSS library was developed by Rahil Makadia as part of his PhD dissertation at the University of Illinois at Urbana-Champaign. This work was supported by a NASA Space Technologies Graduate Research Opportunities (NSTGRO) Fellowship, Grant #80NSSC22K1173. Rahil would like to thank his advisor, Dr. Siegfried Eggl as well as his collaborators, Dr. Steven R. Chesley, and Dr. Davide Farnocchia for their guidance and support.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distributions
Hashes for grss-3.8.1-pp310-pypy310_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5179430e00bab00031289310283c99c683709e59062da8f884849f55a7915be8 |
|
MD5 | f2c4754d31c3cfce209fe25de0d1b9ca |
|
BLAKE2b-256 | 8b965ece28012b48e848d99b3b21b76a740d62735665f273e5235b9b8c1c89df |
Hashes for grss-3.8.1-pp310-pypy310_pp73-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 043744638673744f88359b5bd2e167aabdf122de749ea0d6ad7677ed51f6e33e |
|
MD5 | e9fe68a32c32a2a00f667f79e0cb4702 |
|
BLAKE2b-256 | 8f57d256296100294c3a6568e4f08a128d11f450149bd4af68b2f229c1f9b358 |
Hashes for grss-3.8.1-pp39-pypy39_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 5b8523cdf26339ab0b76b669a1a034101beefc2420459e91ef0cb047eb0d82b6 |
|
MD5 | 452b61f0a93e6bb877a224fdbb5a0327 |
|
BLAKE2b-256 | ee0e048fdec85b1b044e21b0d7876be864db22ef38e6ad76691990cfd807c9c1 |
Hashes for grss-3.8.1-pp39-pypy39_pp73-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 2af98a8d1e787990bf266460547edbf313aab98ff96108a04ef6cbaac9c6b8c3 |
|
MD5 | 9bdca0782b22033789d02c5499010680 |
|
BLAKE2b-256 | 12de14a1f46b3ab0225c00e4d240b41ff8babc629dae3721c89cdb231148d04b |
Hashes for grss-3.8.1-pp38-pypy38_pp73-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d3670485438d689b317461ebf444b9074f4a90f0fef913e82ef0ddb9bda54e94 |
|
MD5 | 93393737f3d2fe81019c68d2a43fd7b0 |
|
BLAKE2b-256 | e774b557dab8371e99d04378e418b3333e577a4a5b97db9bd4036752ccc228ff |
Hashes for grss-3.8.1-pp38-pypy38_pp73-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | caf6fd63d33a478804c677a24065d3abe5f6dc68c32ea340c8cc33c4885b3599 |
|
MD5 | e4f1c07dbd7c4336097e4d3ffff67342 |
|
BLAKE2b-256 | 04a87f0058411fde0e0f314a3408c80b1b34163d636d9571982f228c27dc09db |
Hashes for grss-3.8.1-cp312-cp312-musllinux_1_1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e8ae96a3c35e470cc68e190c4f2208c54335df0c58a62e3e3399d628526ac144 |
|
MD5 | 9237199c3ae63eccc79198b77bc1537b |
|
BLAKE2b-256 | b968553f489a59f8c98f4b656410405a939355dac44f14fc6e7f7cb55fc86254 |
Hashes for grss-3.8.1-cp312-cp312-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 8e647dd2a7978c2da2c3087272a887d4e4d6c5f528eda84a3b54b545667c7a11 |
|
MD5 | 82b157860c3a0368a7ebec162b255241 |
|
BLAKE2b-256 | a2b5e6438d0ca3a60ddb96c280f2da34383ea7d66edcd4dc1dcb07ec112cb6bf |
Hashes for grss-3.8.1-cp312-cp312-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | df39525777ca120ee95f18ed162a78d0219d9d01a31c61c41b3e14bdc68c75c4 |
|
MD5 | f49508bd7b9ef4affcc7eba2c1859f1f |
|
BLAKE2b-256 | 7531f4445480f72b00cd39228bf7467da3e981b42ef98158946f897327f99374 |
Hashes for grss-3.8.1-cp311-cp311-musllinux_1_1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d71bb6c2b9872f9bdcb06673ebccd8b4a1a487bc536267830db466384a8df100 |
|
MD5 | 0b11bab407d53c73ab19be394b0117e9 |
|
BLAKE2b-256 | 17066df1cfecc35f1f4c5c0c0af3d1a4e640ef34f0fdd2a6f5241c9ae5b87974 |
Hashes for grss-3.8.1-cp311-cp311-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 56b26a3b040ebfcbeaac56807e3a0cc69ebc599810cbcc184405ed89f567b882 |
|
MD5 | d634290e6c750e735e66eec5ad69533f |
|
BLAKE2b-256 | 726c43a585f4593627d9967e3fbce54b1803047a45ee226a215d240d22da30fb |
Hashes for grss-3.8.1-cp311-cp311-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 49ef1fecc4184d647c4f5133899643eb9c2ea3cbb34f827bca2dfdcc85a6e1b0 |
|
MD5 | 27aa00b971748c92f78f348372ebcb44 |
|
BLAKE2b-256 | 5a6eaf0f931bec5387d6e786ec06bbe113cda88844899ed07c561941925f070d |
Hashes for grss-3.8.1-cp310-cp310-musllinux_1_1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 3bc642819dc5097ea029d91a2a14e76a601b09240569dfd43de18e9cd067b86b |
|
MD5 | 7c85315abd85faba2caa33422a264ddc |
|
BLAKE2b-256 | 81f37feb9672f12a9073d4046788ae6f79c4f8e1d5e97f401b690d755b49ce26 |
Hashes for grss-3.8.1-cp310-cp310-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 344812a82d517d96fe99697e94b065c5d176dcf9ee69ff5718178ef86e727ca3 |
|
MD5 | c5b17ae3cbaeaba62ef94edbc3f2bb35 |
|
BLAKE2b-256 | ec614dc13b62929ea0742121a6567f61a86da8ba432cd3806333307508984c8e |
Hashes for grss-3.8.1-cp310-cp310-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | e12f583e7527187dcc0ecf50f2df31af8e0df1e54547e175f96566fd9a1b95f8 |
|
MD5 | 00da5df0d7a1ff91c308a4a74b37348c |
|
BLAKE2b-256 | d8ec0f74fab34b046dc37085d731e02173a176da108fce6aabd6a56874539ee1 |
Hashes for grss-3.8.1-cp39-cp39-musllinux_1_1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a73919c1b8dcbb96419bbb8a7ba6d0ea0a9467bf8f22b74e30d4c39d548b21b8 |
|
MD5 | 90d31908ca77bae27ca5ca19a6ef7c45 |
|
BLAKE2b-256 | b77e012f70db51be669d49d5f0c11f3ac0f6a2f0a724d8d5c69f2fbb1b46c1b2 |
Hashes for grss-3.8.1-cp39-cp39-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d77ad7c1af35dbb9ea5d8ecfd09afb12bf818e01defc19ea71cee5ed6f01d63c |
|
MD5 | c321a013f65c19b4ef062ae36ae1f427 |
|
BLAKE2b-256 | 5c9c24dcfb0dc530babac812977971b969f756861b90a822b13b92b65b373a5d |
Hashes for grss-3.8.1-cp39-cp39-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | a746476d5c21dba926608543c594d638beacf8de6bfae8439b99c69e3a21b3dd |
|
MD5 | 887eaa098548104ff9affcefd17cf5af |
|
BLAKE2b-256 | 0dcb21628b73ccd90aa85f0bf0181994c0ba330dea24a51b76fc59b55a7c9f2b |
Hashes for grss-3.8.1-cp38-cp38-musllinux_1_1_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | d52a56ec8068d0e3b294498b9570219d58bec2ad762d390c9bca5b25e57f6621 |
|
MD5 | 5f1b4643d31df19f1f3008ccba24f481 |
|
BLAKE2b-256 | a74a9c286cc10a45d98de946c37c91f5ac60f126eb4e0e8be5279c280af3bc32 |
Hashes for grss-3.8.1-cp38-cp38-manylinux_2_17_x86_64.manylinux2014_x86_64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 6d082ca69fd65a9a10a5ba7042e4aab8c59d4bc576e492f22f69ce1bb1f75dfd |
|
MD5 | 0b364e8458b0e5b09188aa7edfb94b7a |
|
BLAKE2b-256 | 0bfdd8914be61d84327d628e226c93190f197e3dcb0a6bb08bee7a273fba25e8 |
Hashes for grss-3.8.1-cp38-cp38-macosx_11_0_arm64.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 35c8000e59f1ad792a6a3dbb2212a7d356cf1107b36f1d7fa0131ea8b566c6ca |
|
MD5 | 0d0afba3215e5d488b7bda0afcd7470e |
|
BLAKE2b-256 | 6d9c72c0a8e139d4437299ef05623aad2e8700ce0a1a3b62e836e6a81d11efed |