Repository files navigation

SpiceyPy is a Python wrapper for the NAIF C SPICE Toolkit, written using ctypes and Cython.

Continuous Integration	Code Coverage	Docs	Citation	Code Style

SpiceyPy is a python wrapper for theSPICE Toolkit.SPICE is an essential tool for scientists and engineers alike in the planetaryscience field for Solar System Geometry. Please visit the NAIF website for more details about SPICE.

IMPORTANT: The code is provided "as is", use at your own risk. However, the NAIF now distributes python "lessons" that use SpiceyPy as the python to spice interface.

If you are publishing work that uses SpiceyPy, please cite SpiceyPy and the SPICE toolkit.

SpiceyPy can be cited using the JOSS DOI (https://doi.org/10.21105/joss.02050) or with the following:

Annex et al., (2020). SpiceyPy: a Pythonic Wrapper for the SPICE Toolkit. Journal of Open Source Software, 5(46), 2050,https://doi.org/10.21105/joss.02050

Instructions for how to cite the SPICE Toolkit are available on the NAIF website:

https://naif.jpl.nasa.gov/naif/credit.html.

To cite information about SpiceyPy usage statistics, please cite my 2017 and or 2019 abstracts as appropriate below:

1. 2017 abstract:https://ui.adsabs.harvard.edu/abs/2017LPICo1986.7081A/abstract.
2. 2019 abstract:https://ui.adsabs.harvard.edu/abs/2019LPICo2151.7043A/abstract.

PyPI	Conda Forge

SpiceyPy can be installed using pip by running:pip install spiceypy

Anaconda users should use the conda-forge distribution of SpiceyPy by running:

conda config --add channels conda-forge

conda install spiceypy

or the same commands prefixed by mamba or micromamba or other conda-like system.

If you wish to install spiceypy from source first download or clone the project. Then runpython -m build and install the resulting wheel file in dist.To uninstall runpip uninstall spiceypy.

The SpiceyPy docs are available at:spiceypy.readthedocs.org.The documentation for SpiceyPy is intentionally abridged so as to utilize the excellentdocumentation provided by theNAIF.Please refer to C and IDL documentation available on the NAIF websitefor in-depth explanations. Each function docstring has a link to thecorresponding C function in the NAIF docs at a minimum.SpiceyPy documentation contains the NAIF authoredLessons for step-by-step tutorials with code examples.

Feedback is always welcomed, if you discover that a function is not working as expected,submit an issue detailing how to reproduce the problem. If you utilize SpiceyPy frequentlyplease consider contributing to the project by citing me using the Zenodo DOI above.

SpiceyPy is compatible with modern Linux, Mac, and Windowsenvironments. Since the package is a wrapper, any environment notsupported by the NAIF is similarly not supported by SpiceyPy.If you run into issues with your system please submit an issue with details.Please note that support for Python minor versions are generally phased outas newer versions are released.

• OS: OS X, Linux, Windows, FreeBSD
• CPU: x64, arm
• Python 3.10, 3.11, 3.12, 3.13
• ARM support for Linux-aarch64 & osx-arm64

• Support for Python 2.7 ended with version 2.3.2 January 2020 *

Supported in part through NASA PDART23 80NSSC25K7040 FY24-FY27.

DaRasch wrote spiceminer, which Ilooked at to get SpiceCells working, thanks!