planetmapper


Nameplanetmapper JSON
Version 1.13.2 PyPI version JSON
download
home_pagehttps://github.com/ortk95/planetmapper
SummaryPlanetMapper: A Python package for visualising, navigating and mapping Solar System observations
upload_time2025-08-27 13:49:48
maintainerNone
docs_urlNone
authorOliver King
requires_python>=3.10.0
licenseMIT
keywords planetmapper astronomy space science spice ephemeris planetary-science geometry
VCS
bugtrack_url
requirements astropy matplotlib numpy Pillow spiceypy scipy photutils tqdm pyproj typing-extensions
Travis-CI No Travis.
coveralls test coverage No coveralls. 
            # ![PlanetMapper logo](https://raw.githubusercontent.com/ortk95/planetmapper/main/docs/images/logo_wide_transparent.png)

[![PyPI Version](https://img.shields.io/pypi/v/planetmapper?label=PyPI)](https://pypi.org/project/planetmapper/)
[![Conda Version](https://img.shields.io/conda/vn/conda-forge/planetmapper?label=conda)](https://anaconda.org/conda-forge/planetmapper)
[![Publish Workflow Status](https://github.com/ortk95/planetmapper/actions/workflows/python-publish.yml/badge.svg)](https://github.com/ortk95/planetmapper/actions/workflows/python-publish.yml)
[![Checks Workflow Status](https://github.com/ortk95/planetmapper/actions/workflows/checks.yml/badge.svg?branch=main)](https://github.com/ortk95/planetmapper/actions/workflows/checks.yml)
[![Documentation Status](https://readthedocs.org/projects/planetmapper/badge/?version=latest)](https://planetmapper.readthedocs.io/en/latest/?badge=latest)
[![Coverage Status](https://coveralls.io/repos/github/ortk95/planetmapper/badge.svg?branch=main)](https://coveralls.io/github/ortk95/planetmapper?branch=main)
[![JOSS Paper DOI](https://joss.theoj.org/papers/10.21105/joss.05728/status.svg)](https://doi.org/10.21105/joss.05728)

PlanetMapper is an open source Python package for visualising, navigating and mapping Solar System observations.

## [Documentation](https://planetmapper.readthedocs.io)
For full documentation, [API reference](https://planetmapper.readthedocs.io/en/latest/documentation.html), and [installation instructions](https://planetmapper.readthedocs.io/en/latest/installation.html), visit [planetmapper.readthedocs.io](https://planetmapper.readthedocs.io/en/latest/index.html).


## [Installation](https://planetmapper.readthedocs.io/en/latest/installation.html)
```bash
pip install planetmapper --upgrade
```

```bash
conda install -c conda-forge planetmapper
```

_Requires Python 3.10+_


## [Citing PlanetMapper](https://planetmapper.readthedocs.io/en/latest/citation.html)
If you use PlanetMapper in your research, please cite the following paper:

> King et al., (2023). PlanetMapper: A Python package for visualising, navigating and mapping Solar System observations. Journal of Open Source Software, 8(90), 5728, https://doi.org/10.21105/joss.05728

<details>
<summary>Citation BibTeX entry</summary>

```bibtex
@article{king_2023_planetmapper,
  author  = {King, Oliver R. T. and Fletcher, Leigh N.},
  doi     = {10.21105/joss.05728},
  journal = {Journal of Open Source Software},
  month   = oct,
  number  = {90},
  pages   = {5728},
  title   = {{PlanetMapper: A Python package for visualising, navigating and mapping Solar System observations}},
  url     = {https://joss.theoj.org/papers/10.21105/joss.05728},
  volume  = {8},
  year    = {2023}
}
```

</details>


## Key features
### [Fit and map astronomical observations using a full featured user interface](https://planetmapper.readthedocs.io/en/latest/user_interface.html)
[![Screenshot of the PlanetMapper graphical user interface showing an observation of Europa being navigated](https://raw.githubusercontent.com/ortk95/planetmapper/main/docs/images/gui_fitting.png)](https://planetmapper.readthedocs.io/en/latest/user_interface.html)

### [Easily visualise solar system observations with just a few lines of code](https://planetmapper.readthedocs.io/en/latest/general_python_api.html#wireframe-plots)

```python
import planetmapper
import matplotlib.pyplot as plt

body = planetmapper.Body('saturn', '2020-01-01')
body.plot_wireframe_radec()
plt.show()
```

[![Image of Saturn generated with PlanetMapper showing the orientation of Saturn and its rings](https://raw.githubusercontent.com/ortk95/planetmapper/main/docs/images/saturn_wireframe_radec.png)](https://planetmapper.readthedocs.io/en/latest/general_python_api.html#wireframe-plots)

### [Convert coordinates, generate backplanes and project maps of telescope observations](https://planetmapper.readthedocs.io/en/latest/general_python_api.html)
[![Plot of a mapped Jupiter observation, generated with PlanetMapper, showing observed and mapped versions of the Jupiter data](https://raw.githubusercontent.com/ortk95/planetmapper/main/docs/images/jupiter_mapped.png)](https://planetmapper.readthedocs.io/en/latest/general_python_api.html)


## Contributing

If you spot a bug, or want to contribute code to PlanetMapper, check out the [contributing guidelines](https://github.com/ortk95/planetmapper/blob/main/CONTRIBUTING.md).

## Help and support

If you have any questions, suggestions or feedback, please [visit our support page and get in touch](https://planetmapper.readthedocs.io/en/latest/help.html)!

Raw data

            {
    "_id": null,
    "home_page": "https://github.com/ortk95/planetmapper",
    "name": "planetmapper",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10.0",
    "maintainer_email": null,
    "keywords": "planetmapper, astronomy, space, science, spice, ephemeris, planetary-science, geometry",
    "author": "Oliver King",
    "author_email": "oliver.king95@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/d0/67/e927c4e2e98789c09e4435713c2a2b27adab89d9fce6d84f604164add8ce/planetmapper-1.13.2.tar.gz",
    "platform": null,
    "description": "# ![PlanetMapper logo](https://raw.githubusercontent.com/ortk95/planetmapper/main/docs/images/logo_wide_transparent.png)\n\n[![PyPI Version](https://img.shields.io/pypi/v/planetmapper?label=PyPI)](https://pypi.org/project/planetmapper/)\n[![Conda Version](https://img.shields.io/conda/vn/conda-forge/planetmapper?label=conda)](https://anaconda.org/conda-forge/planetmapper)\n[![Publish Workflow Status](https://github.com/ortk95/planetmapper/actions/workflows/python-publish.yml/badge.svg)](https://github.com/ortk95/planetmapper/actions/workflows/python-publish.yml)\n[![Checks Workflow Status](https://github.com/ortk95/planetmapper/actions/workflows/checks.yml/badge.svg?branch=main)](https://github.com/ortk95/planetmapper/actions/workflows/checks.yml)\n[![Documentation Status](https://readthedocs.org/projects/planetmapper/badge/?version=latest)](https://planetmapper.readthedocs.io/en/latest/?badge=latest)\n[![Coverage Status](https://coveralls.io/repos/github/ortk95/planetmapper/badge.svg?branch=main)](https://coveralls.io/github/ortk95/planetmapper?branch=main)\n[![JOSS Paper DOI](https://joss.theoj.org/papers/10.21105/joss.05728/status.svg)](https://doi.org/10.21105/joss.05728)\n\nPlanetMapper is an open source Python package for visualising, navigating and mapping Solar System observations.\n\n## [Documentation](https://planetmapper.readthedocs.io)\nFor full documentation, [API reference](https://planetmapper.readthedocs.io/en/latest/documentation.html), and [installation instructions](https://planetmapper.readthedocs.io/en/latest/installation.html), visit [planetmapper.readthedocs.io](https://planetmapper.readthedocs.io/en/latest/index.html).\n\n\n## [Installation](https://planetmapper.readthedocs.io/en/latest/installation.html)\n```bash\npip install planetmapper --upgrade\n```\n\n```bash\nconda install -c conda-forge planetmapper\n```\n\n_Requires Python 3.10+_\n\n\n## [Citing PlanetMapper](https://planetmapper.readthedocs.io/en/latest/citation.html)\nIf you use PlanetMapper in your research, please cite the following paper:\n\n> King et al., (2023). PlanetMapper: A Python package for visualising, navigating and mapping Solar System observations. Journal of Open Source Software, 8(90), 5728, https://doi.org/10.21105/joss.05728\n\n<details>\n<summary>Citation BibTeX entry</summary>\n\n```bibtex\n@article{king_2023_planetmapper,\n  author  = {King, Oliver R. T. and Fletcher, Leigh N.},\n  doi     = {10.21105/joss.05728},\n  journal = {Journal of Open Source Software},\n  month   = oct,\n  number  = {90},\n  pages   = {5728},\n  title   = {{PlanetMapper: A Python package for visualising, navigating and mapping Solar System observations}},\n  url     = {https://joss.theoj.org/papers/10.21105/joss.05728},\n  volume  = {8},\n  year    = {2023}\n}\n```\n\n</details>\n\n\n## Key features\n### [Fit and map astronomical observations using a full featured user interface](https://planetmapper.readthedocs.io/en/latest/user_interface.html)\n[![Screenshot of the PlanetMapper graphical user interface showing an observation of Europa being navigated](https://raw.githubusercontent.com/ortk95/planetmapper/main/docs/images/gui_fitting.png)](https://planetmapper.readthedocs.io/en/latest/user_interface.html)\n\n### [Easily visualise solar system observations with just a few lines of code](https://planetmapper.readthedocs.io/en/latest/general_python_api.html#wireframe-plots)\n\n```python\nimport planetmapper\nimport matplotlib.pyplot as plt\n\nbody = planetmapper.Body('saturn', '2020-01-01')\nbody.plot_wireframe_radec()\nplt.show()\n```\n\n[![Image of Saturn generated with PlanetMapper showing the orientation of Saturn and its rings](https://raw.githubusercontent.com/ortk95/planetmapper/main/docs/images/saturn_wireframe_radec.png)](https://planetmapper.readthedocs.io/en/latest/general_python_api.html#wireframe-plots)\n\n### [Convert coordinates, generate backplanes and project maps of telescope observations](https://planetmapper.readthedocs.io/en/latest/general_python_api.html)\n[![Plot of a mapped Jupiter observation, generated with PlanetMapper, showing observed and mapped versions of the Jupiter data](https://raw.githubusercontent.com/ortk95/planetmapper/main/docs/images/jupiter_mapped.png)](https://planetmapper.readthedocs.io/en/latest/general_python_api.html)\n\n\n## Contributing\n\nIf you spot a bug, or want to contribute code to PlanetMapper, check out the [contributing guidelines](https://github.com/ortk95/planetmapper/blob/main/CONTRIBUTING.md).\n\n## Help and support\n\nIf you have any questions, suggestions or feedback, please [visit our support page and get in touch](https://planetmapper.readthedocs.io/en/latest/help.html)!\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "PlanetMapper: A Python package for visualising, navigating and mapping Solar System observations",
    "version": "1.13.2",
    "project_urls": {
        "Changelog": "https://github.com/ortk95/planetmapper/releases",
        "Documentation": "https://planetmapper.readthedocs.io/",
        "Download": "https://pypi.org/project/planetmapper/",
        "GitHub": "https://github.com/ortk95/planetmapper",
        "Homepage": "https://github.com/ortk95/planetmapper",
        "Paper": "https://doi.org/10.21105/joss.05728",
        "conda-forge": "https://anaconda.org/conda-forge/planetmapper"
    },
    "split_keywords": [
        "planetmapper",
        " astronomy",
        " space",
        " science",
        " spice",
        " ephemeris",
        " planetary-science",
        " geometry"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "6ef6beadfd2f4275ac6a91b4adb57e0b7c1a0fb821027b457676e28c66a34956",
                "md5": "88084d1c52fa94f3b6d562cbb4dba416",
                "sha256": "e89842acb37bebd8cd12b9ec5675a3057921166d14e8f88d2fcd1eac8eb0a7ac"
            },
            "downloads": -1,
            "filename": "planetmapper-1.13.2-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "88084d1c52fa94f3b6d562cbb4dba416",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10.0",
            "size": 163750,
            "upload_time": "2025-08-27T13:49:46",
            "upload_time_iso_8601": "2025-08-27T13:49:46.219834Z",
            "url": "https://files.pythonhosted.org/packages/6e/f6/beadfd2f4275ac6a91b4adb57e0b7c1a0fb821027b457676e28c66a34956/planetmapper-1.13.2-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "d067e927c4e2e98789c09e4435713c2a2b27adab89d9fce6d84f604164add8ce",
                "md5": "a1cf4ec0075bb4e31e7b5356a97f16f4",
                "sha256": "0d3270dea02910c276b8fd8941588a5060c3fa720bfc29f826d9fe5e6b54132a"
            },
            "downloads": -1,
            "filename": "planetmapper-1.13.2.tar.gz",
            "has_sig": false,
            "md5_digest": "a1cf4ec0075bb4e31e7b5356a97f16f4",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10.0",
            "size": 209608,
            "upload_time": "2025-08-27T13:49:48",
            "upload_time_iso_8601": "2025-08-27T13:49:48.709961Z",
            "url": "https://files.pythonhosted.org/packages/d0/67/e927c4e2e98789c09e4435713c2a2b27adab89d9fce6d84f604164add8ce/planetmapper-1.13.2.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-08-27 13:49:48",
    "github": true,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "github_user": "ortk95",
    "github_project": "planetmapper",
    "travis_ci": false,
    "coveralls": false,
    "github_actions": true,
    "requirements": [
        {
            "name": "astropy",
            "specs": [
                [
                    "<=",
                    "7.0.1"
                ]
            ]
        },
        {
            "name": "matplotlib",
            "specs": [
                [
                    "<=",
                    "3.10.5"
                ]
            ]
        },
        {
            "name": "numpy",
            "specs": [
                [
                    "<=",
                    "2.2.6"
                ]
            ]
        },
        {
            "name": "Pillow",
            "specs": [
                [
                    "<=",
                    "11.3.0"
                ]
            ]
        },
        {
            "name": "spiceypy",
            "specs": [
                [
                    "<=",
                    "6.0.3"
                ]
            ]
        },
        {
            "name": "scipy",
            "specs": [
                [
                    "<=",
                    "1.15.3"
                ]
            ]
        },
        {
            "name": "photutils",
            "specs": [
                [
                    "<=",
                    "2.2.0"
                ]
            ]
        },
        {
            "name": "tqdm",
            "specs": [
                [
                    "<=",
                    "4.67.1"
                ]
            ]
        },
        {
            "name": "pyproj",
            "specs": [
                [
                    "<=",
                    "3.7.1"
                ]
            ]
        },
        {
            "name": "typing-extensions",
            "specs": [
                [
                    "<=",
                    "4.14.1"
                ]
            ]
        }
    ],
    "lcname": "planetmapper"
}
Oliver King
Elapsed time: 0.80428s