SpiceyPy
========
SpiceyPy is a Python wrapper for the NAIF C SPICE Toolkit (N66), written using ctypes.
+------------------------+-------------------+--------+-----------------+------------+--------------+
| Continuous Integration | Code Coverage | Docs | Chat | Citation | Code Style |
+========================+===================+========+=================+============+==============+
| |Github Build Status| | |Coverage Status| | |Docs| | |Join the chat| | |JOSS| | |Black| |
+------------------------+-------------------+--------+-----------------+------------+--------------+
.. |Github Build Status| image:: https://img.shields.io/github/actions/workflow/status/AndrewAnnex/SpiceyPy/ci-build.yml?branch=main
:alt: Github - Build Status
:target: https://github.com/AndrewAnnex/SpiceyPy/actions
.. |Coverage Status| image:: https://img.shields.io/codecov/c/github/AndrewAnnex/SpiceyPy/main?logo=codecov
:alt: Codecov - Test Coverage
:target: https://codecov.io/gh/AndrewAnnex/SpiceyPy
.. |Docs| image:: https://img.shields.io/readthedocs/spiceypy/main
:alt: Readthedocs - Documentation
:target: http://spiceypy.readthedocs.org/en/main/
.. |Join the chat| image:: https://img.shields.io/gitter/room/andrewannex/spiceypy
:alt: Gitter - Chat room
:target: https://gitter.im/AndrewAnnex/SpiceyPy
.. |JOSS| image:: https://joss.theoj.org/papers/98136d30bea9982ad160d251e2039fee/status.svg
:alt: Citation Information: Journal of Open Source Software
:target: https://joss.theoj.org/papers/98136d30bea9982ad160d251e2039fee
.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg
:alt: Code Style - Black
:target: https://github.com/psf/black
Introduction
------------
SpiceyPy is a python wrapper for the `SPICE Toolkit <https://naif.jpl.nasa.gov/naif/>`__.
SPICE is an essential tool for scientists and engineers alike in the planetary
science 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.
Citing SpiceyPy
---------------
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>`__.
Installation
------------
+----------------+-------------------+
| PyPI | Conda Forge |
+================+===================+
| |PyPI| | |Conda Version| |
+----------------+-------------------+
.. |PyPI| image:: https://img.shields.io/pypi/v/spiceypy.svg
:alt: PyPI - python package index
:target: https://pypi.org/project/spiceypy/
.. |Conda Version| image:: https://img.shields.io/conda/vn/conda-forge/spiceypy.svg
:alt: Conda - conda-forge feedstock for SpiceyPy
:target: https://anaconda.org/conda-forge/spiceypy
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``
If you wish to install spiceypy from source first download or clone the project. Then run ``python setup.py install``.
To uninstall run ``pip uninstall spiceypy``.
Documentation
-------------
The SpiceyPy docs are available at:
`spiceypy.readthedocs.org <http://spiceypy.readthedocs.org>`__.
The documentation for SpiceyPy is intentionally abridged so as to utilize the excellent `documentation provided by the
NAIF. <https://naif.jpl.nasa.gov/pub/naif/toolkit_docs/C/index.html>`__
Please refer to C and IDL documentation available on the NAIF website
for in-depth explanations. Each function docstring has a link to the
corresponding C function in the NAIF docs at a minimum.
SpiceyPy documentation contains the NAIF authored `Lessons <https://spiceypy.readthedocs.io/en/main/lessonindex.html>`__ for step-by-step tutorials with code examples.
How to Help
-----------
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 frequently
please consider contributing to the project by citing me using the zenodo DOI above.
Known Working Environments:
---------------------------
SpicyPy is compatible with modern Linux, Mac, and Windows
environments. Since the package is a wrapper, any environment not
supported 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 out
as newer versions are released.
- OS: OS X, Linux, Windows, FreeBSD
- CPU: 64bit only!
- Python 3.6, 3.7, 3.8, 3.9, 3.10, 3.11
- ARM support for Linux-aarch64 & osx-arm64
* Support for Python 2.7 ended with version 2.3.2 January 2020 *
Acknowledgements
----------------
`DaRasch <https://github.com/DaRasch>`__ wrote spiceminer, which I
looked at to get SpiceCells working, thanks!
Raw data
{
"_id": null,
"home_page": "https://github.com/AndrewAnnex/SpiceyPy",
"name": "spiceypy",
"maintainer": "Andrew Annex",
"docs_url": null,
"requires_python": "<4,>=3.6",
"maintainer_email": "ama6fy@virginia.edu",
"keywords": "spiceypy,spice,cspice,naif,jpl,space,geometry,ephemeris",
"author": "Andrew Annex",
"author_email": "ama6fy@virginia.edu",
"download_url": "https://files.pythonhosted.org/packages/77/21/fa389a42cf2ab1425ef91007e549b7a3e58fe49c6834e687743609fe1386/spiceypy-6.0.0.tar.gz",
"platform": null,
"description": "SpiceyPy\n========\n\nSpiceyPy is a Python wrapper for the NAIF C SPICE Toolkit (N66), written using ctypes.\n\n+------------------------+-------------------+--------+-----------------+------------+--------------+\n| Continuous Integration | Code Coverage | Docs | Chat | Citation | Code Style |\n+========================+===================+========+=================+============+==============+\n| |Github Build Status| | |Coverage Status| | |Docs| | |Join the chat| | |JOSS| | |Black| |\n+------------------------+-------------------+--------+-----------------+------------+--------------+\n\n.. |Github Build Status| image:: https://img.shields.io/github/actions/workflow/status/AndrewAnnex/SpiceyPy/ci-build.yml?branch=main\n :alt: Github - Build Status\n :target: https://github.com/AndrewAnnex/SpiceyPy/actions\n.. |Coverage Status| image:: https://img.shields.io/codecov/c/github/AndrewAnnex/SpiceyPy/main?logo=codecov\n :alt: Codecov - Test Coverage\n :target: https://codecov.io/gh/AndrewAnnex/SpiceyPy\n.. |Docs| image:: https://img.shields.io/readthedocs/spiceypy/main\n :alt: Readthedocs - Documentation\n :target: http://spiceypy.readthedocs.org/en/main/\n.. |Join the chat| image:: https://img.shields.io/gitter/room/andrewannex/spiceypy\n :alt: Gitter - Chat room\n :target: https://gitter.im/AndrewAnnex/SpiceyPy\n.. |JOSS| image:: https://joss.theoj.org/papers/98136d30bea9982ad160d251e2039fee/status.svg\n :alt: Citation Information: Journal of Open Source Software\n :target: https://joss.theoj.org/papers/98136d30bea9982ad160d251e2039fee\n.. |Black| image:: https://img.shields.io/badge/code%20style-black-000000.svg \n :alt: Code Style - Black\n :target: https://github.com/psf/black\n\n\nIntroduction\n------------\n\nSpiceyPy is a python wrapper for the `SPICE Toolkit <https://naif.jpl.nasa.gov/naif/>`__.\nSPICE is an essential tool for scientists and engineers alike in the planetary\nscience field for Solar System Geometry. Please visit the NAIF website for more details about SPICE.\n\n*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.\n\nCiting SpiceyPy\n---------------\n\nIf you are publishing work that uses SpiceyPy, please cite SpiceyPy and the SPICE toolkit.\n\nSpiceyPy can be cited using the JOSS DOI (`https://doi.org/10.21105/joss.02050`) or with the following:\n 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\n\nInstructions for how to cite the SPICE Toolkit are available on the NAIF website: \n https://naif.jpl.nasa.gov/naif/credit.html. \n\nTo cite information about SpiceyPy usage statistics, please cite my 2017 and or 2019 abstracts as appropriate below:\n 1. 2017 abstract: `<https://ui.adsabs.harvard.edu/abs/2017LPICo1986.7081A/abstract>`__.\n 2. 2019 abstract: `<https://ui.adsabs.harvard.edu/abs/2019LPICo2151.7043A/abstract>`__.\n\nInstallation\n------------\n\n+----------------+-------------------+\n| PyPI | Conda Forge |\n+================+===================+\n| |PyPI| | |Conda Version| |\n+----------------+-------------------+\n\n.. |PyPI| image:: https://img.shields.io/pypi/v/spiceypy.svg\n :alt: PyPI - python package index\n :target: https://pypi.org/project/spiceypy/\n.. |Conda Version| image:: https://img.shields.io/conda/vn/conda-forge/spiceypy.svg\n :alt: Conda - conda-forge feedstock for SpiceyPy\n :target: https://anaconda.org/conda-forge/spiceypy\n\nSpiceyPy can be installed using pip by running:\n``pip install spiceypy``\n\nAnaconda users should use the conda-forge distribution of SpiceyPy by running:\n\n``conda config --add channels conda-forge``\n\n``conda install spiceypy``\n\nIf you wish to install spiceypy from source first download or clone the project. Then run ``python setup.py install``.\nTo uninstall run ``pip uninstall spiceypy``.\n\nDocumentation\n-------------\n\nThe SpiceyPy docs are available at:\n`spiceypy.readthedocs.org <http://spiceypy.readthedocs.org>`__.\nThe documentation for SpiceyPy is intentionally abridged so as to utilize the excellent `documentation provided by the\nNAIF. <https://naif.jpl.nasa.gov/pub/naif/toolkit_docs/C/index.html>`__\nPlease refer to C and IDL documentation available on the NAIF website\nfor in-depth explanations. Each function docstring has a link to the\ncorresponding C function in the NAIF docs at a minimum.\nSpiceyPy documentation contains the NAIF authored `Lessons <https://spiceypy.readthedocs.io/en/main/lessonindex.html>`__ for step-by-step tutorials with code examples. \n\nHow to Help\n-----------\n\nFeedback is always welcomed, if you discover that a function is not working as expected,\nsubmit an issue detailing how to reproduce the problem. If you utilize SpiceyPy frequently \nplease consider contributing to the project by citing me using the zenodo DOI above.\n\nKnown Working Environments:\n---------------------------\n\nSpicyPy is compatible with modern Linux, Mac, and Windows\nenvironments. Since the package is a wrapper, any environment not\nsupported by the NAIF is similarly not supported by SpiceyPy.\nIf you run into issues with your system please submit an issue with details. \nPlease note that support for Python minor versions are generally phased out \nas newer versions are released. \n\n- OS: OS X, Linux, Windows, FreeBSD\n- CPU: 64bit only!\n- Python 3.6, 3.7, 3.8, 3.9, 3.10, 3.11\n- ARM support for Linux-aarch64 & osx-arm64\n\n* Support for Python 2.7 ended with version 2.3.2 January 2020 *\n\nAcknowledgements\n----------------\n\n`DaRasch <https://github.com/DaRasch>`__ wrote spiceminer, which I\nlooked at to get SpiceCells working, thanks!\n\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "A Python Wrapper for the NAIF CSPICE Toolkit",
"version": "6.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/AndrewAnnex/SpiceyPy/issues",
"Changelog": "https://github.com/AndrewAnnex/SpiceyPy/blob/main/CHANGELOG.md",
"Conda-Forge": "https://anaconda.org/conda-forge/spiceypy",
"Documentation": "https://spiceypy.readthedocs.io",
"Homepage": "https://github.com/AndrewAnnex/SpiceyPy",
"Repository": "https://github.com/AndrewAnnex/SpiceyPy",
"Source": "https://github.com/AndrewAnnex/SpiceyPy"
},
"split_keywords": [
"spiceypy",
"spice",
"cspice",
"naif",
"jpl",
"space",
"geometry",
"ephemeris"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "2a97ccab62d2c0f37c422c75144323aa084f03261740387f48d116904fcbc06b",
"md5": "ff39d73bb60ba242d07c65cf85eb5c49",
"sha256": "70cda5b057d1b83dd8a4ecd9d4d2823b2f9c263b85fcdcc0df0370ca5b94c74f"
},
"downloads": -1,
"filename": "spiceypy-6.0.0-py3-none-macosx_10_9_x86_64.whl",
"has_sig": false,
"md5_digest": "ff39d73bb60ba242d07c65cf85eb5c49",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.6",
"size": 1455891,
"upload_time": "2023-08-31T21:37:21",
"upload_time_iso_8601": "2023-08-31T21:37:21.850633Z",
"url": "https://files.pythonhosted.org/packages/2a/97/ccab62d2c0f37c422c75144323aa084f03261740387f48d116904fcbc06b/spiceypy-6.0.0-py3-none-macosx_10_9_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "b4d622ccd3631f55e4b2ccc610e988a6ae5f46fa14d7c28eee02a22ef618c6a5",
"md5": "80212a02fe4eeb1b7d4d7047d128d918",
"sha256": "20d70ce09e6efa78e9e3f2400c6ee85bd7065f19edf2d4ebce257c79eb43e534"
},
"downloads": -1,
"filename": "spiceypy-6.0.0-py3-none-macosx_11_0_arm64.whl",
"has_sig": false,
"md5_digest": "80212a02fe4eeb1b7d4d7047d128d918",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.6",
"size": 1351710,
"upload_time": "2023-08-31T21:37:23",
"upload_time_iso_8601": "2023-08-31T21:37:23.889261Z",
"url": "https://files.pythonhosted.org/packages/b4/d6/22ccd3631f55e4b2ccc610e988a6ae5f46fa14d7c28eee02a22ef618c6a5/spiceypy-6.0.0-py3-none-macosx_11_0_arm64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "5668e4b1c6c7c7f5483ef4667760afdcdf13e45bf10890074b704aa728c0474c",
"md5": "717f03b69d559de77abfc5cc289aca2c",
"sha256": "22b50777174c6ef61cdb57aac4f4003ab8de69a0c4b0b87f66881f0a9758e9a2"
},
"downloads": -1,
"filename": "spiceypy-6.0.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"has_sig": false,
"md5_digest": "717f03b69d559de77abfc5cc289aca2c",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.6",
"size": 1628204,
"upload_time": "2023-08-31T21:37:25",
"upload_time_iso_8601": "2023-08-31T21:37:25.357098Z",
"url": "https://files.pythonhosted.org/packages/56/68/e4b1c6c7c7f5483ef4667760afdcdf13e45bf10890074b704aa728c0474c/spiceypy-6.0.0-py3-none-manylinux_2_17_aarch64.manylinux2014_aarch64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "ce8967f98fcfd5e8320a5e39b00d070e9f1ef32e4d9faa1c420b4c894d11b861",
"md5": "fe1f434592aa4a8a7c1610a1e79c9262",
"sha256": "a7da6cdb0eaa1e1a27a2198be58404262c0def0216ad62de7183223461e35aa0"
},
"downloads": -1,
"filename": "spiceypy-6.0.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"has_sig": false,
"md5_digest": "fe1f434592aa4a8a7c1610a1e79c9262",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.6",
"size": 1665804,
"upload_time": "2023-08-31T21:37:27",
"upload_time_iso_8601": "2023-08-31T21:37:27.203644Z",
"url": "https://files.pythonhosted.org/packages/ce/89/67f98fcfd5e8320a5e39b00d070e9f1ef32e4d9faa1c420b4c894d11b861/spiceypy-6.0.0-py3-none-manylinux_2_17_x86_64.manylinux2014_x86_64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9088ad0e920604097ff649672d5b69737e69373e91a5ab302ce9cce4b961215d",
"md5": "7d34a55dde2a885d5966982afee36726",
"sha256": "5737a4e19fb8030916b60d6280358d672330243d5aab6299954346a22c92ce58"
},
"downloads": -1,
"filename": "spiceypy-6.0.0-py3-none-win_amd64.whl",
"has_sig": false,
"md5_digest": "7d34a55dde2a885d5966982afee36726",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": "<4,>=3.6",
"size": 1427494,
"upload_time": "2023-08-31T21:37:28",
"upload_time_iso_8601": "2023-08-31T21:37:28.645757Z",
"url": "https://files.pythonhosted.org/packages/90/88/ad0e920604097ff649672d5b69737e69373e91a5ab302ce9cce4b961215d/spiceypy-6.0.0-py3-none-win_amd64.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "7721fa389a42cf2ab1425ef91007e549b7a3e58fe49c6834e687743609fe1386",
"md5": "47a62058a58655c48b0202aa9be5ad18",
"sha256": "ac27096a12b795898c3a6d1fa1f12a7e4485f480acd2e59fbd3a986cb0ade2be"
},
"downloads": -1,
"filename": "spiceypy-6.0.0.tar.gz",
"has_sig": false,
"md5_digest": "47a62058a58655c48b0202aa9be5ad18",
"packagetype": "sdist",
"python_version": "source",
"requires_python": "<4,>=3.6",
"size": 291180,
"upload_time": "2023-08-31T21:37:30",
"upload_time_iso_8601": "2023-08-31T21:37:30.468595Z",
"url": "https://files.pythonhosted.org/packages/77/21/fa389a42cf2ab1425ef91007e549b7a3e58fe49c6834e687743609fe1386/spiceypy-6.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2023-08-31 21:37:30",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "AndrewAnnex",
"github_project": "SpiceyPy",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"requirements": [],
"lcname": "spiceypy"
}
JSON
