Skip to main content

GRSS: Gauss-Radau Small-body Simulator

Project description

GRSS

PyPI Build docs) Python tests) C++ tests) PSJ JOSS GPLv3

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:

Getting Started

There are currently two different ways to install the GRSS library.

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. 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.

Contributing

If you would like to contribute to the GRSS library or raise an issue, please see the contributing file.

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

grss-4.4.2.tar.gz (2.4 MB view details)

Uploaded Source

Built Distributions

grss-4.4.2-cp313-cp313-musllinux_1_2_x86_64.whl (6.2 MB view details)

Uploaded CPython 3.13musllinux: musl 1.2+ x86-64

grss-4.4.2-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded CPython 3.13manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

grss-4.4.2-cp313-cp313-macosx_14_0_arm64.whl (5.9 MB view details)

Uploaded CPython 3.13macOS 14.0+ ARM64

grss-4.4.2-cp312-cp312-musllinux_1_2_x86_64.whl (6.2 MB view details)

Uploaded CPython 3.12musllinux: musl 1.2+ x86-64

grss-4.4.2-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded CPython 3.12manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

grss-4.4.2-cp312-cp312-macosx_14_0_arm64.whl (5.9 MB view details)

Uploaded CPython 3.12macOS 14.0+ ARM64

grss-4.4.2-cp311-cp311-musllinux_1_2_x86_64.whl (6.2 MB view details)

Uploaded CPython 3.11musllinux: musl 1.2+ x86-64

grss-4.4.2-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded CPython 3.11manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

grss-4.4.2-cp311-cp311-macosx_14_0_arm64.whl (5.9 MB view details)

Uploaded CPython 3.11macOS 14.0+ ARM64

grss-4.4.2-cp310-cp310-musllinux_1_2_x86_64.whl (6.2 MB view details)

Uploaded CPython 3.10musllinux: musl 1.2+ x86-64

grss-4.4.2-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl (5.1 MB view details)

Uploaded CPython 3.10manylinux: glibc 2.24+ x86-64manylinux: glibc 2.28+ x86-64

grss-4.4.2-cp310-cp310-macosx_14_0_arm64.whl (5.9 MB view details)

Uploaded CPython 3.10macOS 14.0+ ARM64

File details

Details for the file grss-4.4.2.tar.gz.

File metadata

  • Download URL: grss-4.4.2.tar.gz
  • Upload date:
  • Size: 2.4 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for grss-4.4.2.tar.gz
Algorithm Hash digest
SHA256 2b4295480c942892b1481b77d62c236543d44a742bd01f8b60f567f1c5034bb8
MD5 204d8235c4ba06df298232852e7c0a14
BLAKE2b-256 5927e949840992e5e2877d6a4a494af8432f8acb88c406c08a6c7b9cd0aeffca

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2.tar.gz:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp313-cp313-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp313-cp313-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 2e3d641192f1e762345b2be96f8171be997393c6b8b5c2d3576aa06f36e067be
MD5 8846e5e3e87842f99adef8713a349db9
BLAKE2b-256 b6c8c31417aa4e46ba1a985ceb78b6951a3d99079d7e56c4a400b138e391c5ea

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp313-cp313-musllinux_1_2_x86_64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 823f0eeee12ee55aa35e802a244fb288fabad5afbf51a4bff825ec3a183e5db8
MD5 55e0ccce297b1b2827d6e095a1b6aa62
BLAKE2b-256 fc6f0b3acfbae9b2abc37267db97cf15f1d68c5f1fa2644db19ec6a4e5b9e6a7

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp313-cp313-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp313-cp313-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp313-cp313-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 59000baf9d4832d59fa5815d594b364f0ceb955cfe7f1d0eb557d3ecb7f52411
MD5 7ddf1ecdbe3ae15572552fbe9e6509ce
BLAKE2b-256 7e5793aa4f3628d84968a03e2581d9df8b53f5a506bc6396e162b209624e36ec

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp313-cp313-macosx_14_0_arm64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp312-cp312-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp312-cp312-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 527f9fce1d9b727475225da493c967468fced497404d14fbac1008bd00b21127
MD5 e232eaf303d1fb0aef779ed4371d94be
BLAKE2b-256 85f33d302a64dc71c1d98306222639f5b5f8fba6fda7ba62aaf28e63b37927d5

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp312-cp312-musllinux_1_2_x86_64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 5dd65bed71a3cedf440f2151ce112fd9075be2527f7f66aa5b1f7d310716d24f
MD5 30cba6c86e057c92b6de4616988174c4
BLAKE2b-256 20c9b7d5f0434e73a45051c35b632658f3df6b7f6c2bcd9b29bef63dcd23767c

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp312-cp312-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp312-cp312-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp312-cp312-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 85b1f863d25d126a05e52ff66b914358e18afaef83a7d203e940aa7b96ec1b23
MD5 02b2fdf9246bf017c9202ec89c4d76c3
BLAKE2b-256 92eb395ca70373c4faf38aacba9ee02fb00694f517282c204341ef40cfd3b30a

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp312-cp312-macosx_14_0_arm64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp311-cp311-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp311-cp311-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 12e0cea26f4a24ad310002addd381595cc2478990e544689baeb54578aada082
MD5 17e08b964e7da5df2d7f77ef2f7375c2
BLAKE2b-256 a0685dda526ea21a3e0ac91c8a97a811fed61a378bc0ee9615fb3abcd896612f

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp311-cp311-musllinux_1_2_x86_64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 fe206c7e9c610c02aac26bf55f6b698e2f7e9854cbbbe05fc156f5f060409d95
MD5 eb38bf7c2cd20ddfd171a50d06a82191
BLAKE2b-256 e0010394b4bc5cb1237d5e79bb49e31e446e9bb8fb2f833f46521eab4988b15b

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp311-cp311-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp311-cp311-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp311-cp311-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 b54dbeb116c36f7504768a19ed1d798db60ef41d026991b5049d5f121e846606
MD5 21f835f4c511b8cd1d90f2029dbc66bc
BLAKE2b-256 2f54dd13721a42c9edbab54d2102beb2e58c46918163a6f7eab0b477dc2c6861

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp311-cp311-macosx_14_0_arm64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp310-cp310-musllinux_1_2_x86_64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp310-cp310-musllinux_1_2_x86_64.whl
Algorithm Hash digest
SHA256 50feb8691220996c1c7155b93a0a9f13e1180234e918da5437705a307e9b5f6e
MD5 90a1724eb91632c2f650a11f71b28ade
BLAKE2b-256 0900487b0c8afd603ef80c7b54918ad5638073f884e42983b71076f391bd4005

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp310-cp310-musllinux_1_2_x86_64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 ed2e60738bb9e69a50ac834bf8743b8d6dccd3cbf9ee8c95a9e367b2de336bca
MD5 f149ab1275685c89d9a0c7edeb4d8169
BLAKE2b-256 fdfe93dc034ee7b4876c145d24a7443aa4aba54b71328bb120273c9c4f164735

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp310-cp310-manylinux_2_24_x86_64.manylinux_2_28_x86_64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file grss-4.4.2-cp310-cp310-macosx_14_0_arm64.whl.

File metadata

File hashes

Hashes for grss-4.4.2-cp310-cp310-macosx_14_0_arm64.whl
Algorithm Hash digest
SHA256 cdf02930d5545f938869fa4eb58f2b547a1f72a43c1c4884c44fbceb3e99075e
MD5 bfbd4a7b733b8463c39e7c63318921d1
BLAKE2b-256 530552ffe6df0a4ce085554c21304cd893322cca57738f0d57f9e42419958436

See more details on using hashes here.

Provenance

The following attestation bundles were made for grss-4.4.2-cp310-cp310-macosx_14_0_arm64.whl:

Publisher: pypi.yml on rahil-makadia/grss

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page