moon-coverage 0.11.0

Moon Coverage toolbox

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, LPG - Nantes Université, 2022. Version: 0.11.0, moon-coverage.univ-nantes.fr, swh:1:rel:8416d4a23e2d695ce68c35f22aace9281c25dbaa

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 [e-mail]

🎨 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:

1. 🍴 Fork this project

2. 🐑 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

3. ✍️ Make your edits and 🚧 write the tests.

4. 🚦 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

5. 🛠 Check that your tests succeed 👍 and you have a coverage of 100% ✨ :

pytest --cov moon_coverage tests/

6. 📖 Complete and ⚙️ build the documentation (if needed):

sphinx-build docs docs/_build --color -W -bhtml

7. 📤 Push your changes to your forked branch and 🚀 open a new merge request explaining what you changed 🙌 👏 💪.