Skip to main content

GRSS: Gauss-Radau Small-body Simulator

Project description

grss

PyPi Version Build Sphinx docs) Python tests) C++ tests) GPL

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.

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

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

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 .

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. The author 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-1.5.0.tar.gz (3.0 MB view hashes)

Uploaded Source

Supported by

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