Moon Coverage toolbox
Project description
ESA Moon Coverage Toolbox
The moon-coverage python package is a toolbox to perform surface coverage analysis based on orbital trajectory configuration. Its main intent is to provide an easy way to compute observation opportunities of specific region of interest above the Galilean satellites for the ESA-JUICE mission but could be extended in the future to other space mission.
It is actively developed by the Laboratory of Planetology and Geosciences (CNRS-UMR 6112) at Nantes University (France), under ESA-JUICE founding support.
📦 Installation
The package is available on PyPI and can be installed very easily:
- If you are in a
Jupyter environnement
, you can use the magic command%pip
in a notebook cell and ▶️Run
it:
%pip install --upgrade moon-coverage
- or, if you are using a
terminal environment
, you can do:
pip install --upgrade moon-coverage
✏️ How to cite this package
If you use this package for your analyses, please consider using the following citation:
Seignovert, Benoît, Gabriel Tobie, Rozenn Robidel, Claire Vallat, Inès Belgacem, and Nicolas Altobelli. Python Moon-Coverage Toolbox (0.10.0) LPG - Nantes Université, 2022; moon-coverage.readthedocs.io; swh:1:rel:4f106164c660db1d505274851217bd1e1a00edea
or can use this 📙 bibtex file.
⚡️ Issues and 💬 feedback
If you have any issue with this package, we highly recommend to take a look at:
- 📚 our extended documentation online.
- 📓 the collection of notebook examples.
If you did not find a solution there, feel free to:
- 📝 open an issue (if you have an account on the JUICE Gitlab).
- ✉️ send us an email at moon-coverage@univ-nantes.fr
🎨 Contribution and 🐛 fix bugs
Contributions are always welcome and appreciated. An account on the JUICE Giltab is required.
Here is the steps to suggest a change:
-
🐑 Clone and 📦 install the repository locally:
git clone https://juigitlab.esac.esa.int/<YOUR_USERNAME>/moon-coverage
cd moon-coverage
pip install -e .
pip install -r tests/requirements.txt -r docs/requirements.txt
-
✍️ Make your edits and 🚧 write the tests.
-
🚦 Double-check that the linters are happy 😱 🤔 😃 :
flake8 moon_coverage/ tests/ setup.py docs/conf.py
pylint --rcfile=setup.cfg moon_coverage/ tests/*/*.py setup.py
- 🛠 Check that your tests succeed 👍 and you have a coverage of 100% ✨ :
pytest --cov moon_coverage tests/
- 📖 Complete and ⚙️ build the documentation (if needed):
sphinx-build docs docs/_build --color -W -bhtml
- 📤 Push your changes to your forked branch and 🚀 open a new merge request explaining what you changed 🙌 👏 💪.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for moon_coverage-0.10.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 40995723902ec58af2e6416b5c74cee3a8a6e0a4fbd2124d96c11652b91d7b0b |
|
MD5 | 88cb0907d75cb5b2e9a9cf03343af629 |
|
BLAKE2b-256 | 029efd8e983b317034eb4b20db91463d6af210e86d59d7601a4b32525bb16e87 |