PlanetMapper

PlanetMapper: A Python package for visualising, navigating and mapping Solar System observations - Published in JOSS (2023)

https://github.com/ortk95/planetmapper

Science Score: 98.0%

This score indicates how likely this project is to be science-related based on various indicators:

  • CITATION.cff file
    Found CITATION.cff file
  • codemeta.json file
    Found codemeta.json file
  • .zenodo.json file
    Found .zenodo.json file
  • DOI references
    Found 8 DOI reference(s) in README and JOSS metadata
  • Academic publication links
    Links to: joss.theoj.org
  • Committers with academic emails
  • Institutional organization owner
  • JOSS paper metadata
    Published in Journal of Open Source Software

Keywords

astronomy ephemeris geometry physics planet-mapper planetary-science planetmapper python science solar-system space spice

Keywords from Contributors

mesh

Scientific Fields

Mathematics Computer Science - 84% confidence
Last synced: 4 months ago · JSON representation ·

Repository

PlanetMapper: An open source Python package for visualising, navigating and mapping Solar System observations

Basic Info
Statistics
  • Stars: 12
  • Watchers: 1
  • Forks: 2
  • Open Issues: 22
  • Releases: 79
Topics
astronomy ephemeris geometry physics planet-mapper planetary-science planetmapper python science solar-system space spice
Created about 3 years ago · Last pushed 4 months ago
Metadata Files
Readme Contributing License Code of conduct Citation Zenodo

README.md

PlanetMapper logo

PyPI Version Conda Version Publish Workflow Status Checks Workflow Status Documentation Status Coverage Status JOSS Paper DOI

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

Documentation

For full documentation, API reference, and installation instructions, visit planetmapper.readthedocs.io.

Installation

bash pip install planetmapper --upgrade

bash conda install -c conda-forge planetmapper

Requires Python 3.10+

Citing PlanetMapper

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

Citation BibTeX entry ```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} } ```

Key features

Fit and map astronomical observations using a full featured user interface

Screenshot of the PlanetMapper graphical user interface showing an observation of Europa being navigated

Easily visualise solar system observations with just a few lines of code

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

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

Image of Saturn generated with PlanetMapper showing the orientation of Saturn and its rings

Convert coordinates, generate backplanes and project maps of telescope observations

Plot of a mapped Jupiter observation, generated with PlanetMapper, showing observed and mapped versions of the Jupiter data

Contributing

If you spot a bug, or want to contribute code to PlanetMapper, check out the contributing guidelines.

Help and support

If you have any questions, suggestions or feedback, please visit our support page and get in touch!

Owner

  • Name: Oliver King
  • Login: ortk95
  • Kind: user
  • Company: University of Leicester

Planetary Scientist

JOSS Publication

PlanetMapper: A Python package for visualising, navigating and mapping Solar System observations
Published
October 10, 2023
Volume 8, Issue 90, Page 5728
Authors
Oliver R.t. King ORCID
School of Physics and Astronomy, University of Leicester, University Road, Leicester, LE1 7RH, United Kingdom
Leigh N. Fletcher ORCID
School of Physics and Astronomy, University of Leicester, University Road, Leicester, LE1 7RH, United Kingdom
Editor
Monica Bobra ORCID
Tags
astronomy

Citation (CITATION.bib)

@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}
}

GitHub Events

Total
  • Create event: 52
  • Release event: 5
  • Issues event: 42
  • Watch event: 2
  • Delete event: 40
  • Issue comment event: 72
  • Push event: 88
  • Pull request event: 102
Last Year
  • Create event: 52
  • Release event: 5
  • Issues event: 42
  • Watch event: 2
  • Delete event: 40
  • Issue comment event: 72
  • Push event: 88
  • Pull request event: 102

Committers

Last synced: 5 months ago

All Time
  • Total Commits: 1,155
  • Total Committers: 2
  • Avg Commits per committer: 577.5
  • Development Distribution Score (DDS): 0.025
Past Year
  • Commits: 132
  • Committers: 2
  • Avg Commits per committer: 66.0
  • Development Distribution Score (DDS): 0.22
Top Committers
Name Email Commits
Oliver King o****5@g****m 1,126
dependabot[bot] 4****] 29

Issues and Pull Requests

Last synced: 4 months ago

All Time
  • Total issues: 138
  • Total pull requests: 326
  • Average time to close issues: 27 days
  • Average time to close pull requests: about 17 hours
  • Total issue authors: 5
  • Total pull request authors: 2
  • Average comments per issue: 0.64
  • Average comments per pull request: 0.67
  • Merged pull requests: 290
  • Bot issues: 0
  • Bot pull requests: 63
Past Year
  • Issues: 39
  • Pull requests: 128
  • Average time to close issues: 19 days
  • Average time to close pull requests: 1 day
  • Issue authors: 2
  • Pull request authors: 2
  • Average comments per issue: 0.26
  • Average comments per pull request: 0.91
  • Merged pull requests: 96
  • Bot issues: 0
  • Bot pull requests: 63
Top Authors
Issue Authors
  • ortk95 (132)
  • steo85it (3)
  • tedjohnson12 (1)
  • goatsneez (1)
  • Caraffa-git (1)
Pull Request Authors
  • ortk95 (263)
  • dependabot[bot] (63)
Top Labels
Issue Labels
api (49) enhancement (45) polish (31) gui (26) backend (17) documentation (16) idea (13) possible bug (12) bug (11) backplane (9) logistics (8) tests (5) upstream (4) partially fixed (4) optimization (4) dependencies (4) question (1)
Pull Request Labels
dependencies (64) python (21) enhancement (10) gui (10) logistics (8) api (8) polish (5) possible bug (4) documentation (3) backplane (3) tests (2) optimization (1) bug (1)

Packages

  • Total packages: 1
  • Total downloads:
    • pypi 499 last-month
  • Total dependent packages: 0
  • Total dependent repositories: 1
  • Total versions: 79
  • Total maintainers: 1
pypi.org: planetmapper

PlanetMapper: A Python package for visualising, navigating and mapping Solar System observations

  • Versions: 79
  • Dependent Packages: 0
  • Dependent Repositories: 1
  • Downloads: 499 Last month
Rankings
Dependent packages count: 10.1%
Downloads: 10.2%
Stargazers count: 17.7%
Average: 17.9%
Dependent repos count: 21.6%
Forks count: 29.8%
Maintainers (1)
Last synced: 4 months ago

Dependencies

requirements.txt pypi
  • Pillow *
  • astropy *
  • matplotlib *
  • numpy *
  • photutils *
  • scipy *
  • spiceypy *
.github/workflows/codeql.yml actions
  • actions/checkout v3 composite
  • github/codeql-action/analyze v2 composite
  • github/codeql-action/autobuild v2 composite
  • github/codeql-action/init v2 composite
.github/workflows/dependency-review.yml actions
  • actions/checkout v3 composite
  • actions/dependency-review-action v2 composite
.github/workflows/python-publish.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v3 composite
  • pypa/gh-action-pypi-publish 27b31702a0e7fc50959f5ad993c78deac1bdfc29 composite
docs/requirements.txt pypi
  • sphinx *
  • sphinx_rtd_theme *
setup.py pypi
  • Pillow *
  • astropy *
  • matplotlib *
  • numpy *
  • photutils *
  • scipy *
  • spiceypy *
  • tqdm *
.github/workflows/checks.yml actions
  • actions/checkout v3 composite
  • actions/setup-python v4 composite
  • actions/setup-python v3 composite
  • isort/isort-action v1 composite
  • psf/black stable composite
pyproject.toml pypi
.github/workflows/check-branch.yml actions
dev_requirements.txt pypi
  • black * development
  • coverage * development
  • isort * development
  • pylint * development
  • pyright * development