[!warning] This project is depreciated, use ptr-editor instead.

ESA Planning Timeline Request (PTR) Python package

Since the Rosetta mission, ESA developed an XML-like syntax to create Planning Timeline Request (PTR) files. These files allow the mission team member to design custom attitude spacecraft pointing. It is readable by AGM and MAPPS softwares to detect spacecraft constrains violations, power conception and surface coverage. It can also be used to compute custom spacecraft attitude: quaterions, camera kernels (ck) and resolved PTR. This format is used for the JUICE mission, and can be tested on the JUICE pointing tool.

This python package implements an object oriented approach to help the creation and parsing of PTR files for the user, as well an interface to check JUICE PTR validity with AGM.

🚧 Disclaimer: This package is in beta stage and does not support all PTR implementations. Please, open an issue to report any issue you may accounter. ⚠️ Currently this tool in beta stage, do not use it in critical environments.

📚 Documentation

A detailed documentation can be found here: esa-ptr.readthedocs.io

🐍 Installation

This package is available on PyPI and could be installed with the python package manager pip:

python -m pip install esa-ptr

Even if this tool does not have any external dependencies, we recommend to use it in an isolated virtual environment (venv or conda env).

🐛 Development and testing

If you want to contribute to the development and tests your changes before submitting a merge request, you need to install Poetry and clone this repository:

git clone https://gitlab.esa.int/juice-soc-public/python/esa-ptr.git esa-ptr ;
cd esa-ptr/

Install the package and its dependencies:

poetry install

Then, after your edits, you need to check that both linters are happy:

poetry run flake8
poetry run pylint src tests

and all the tests passed:

poetry run pytest

🎓 Resources

• Rosetta Flight Dynamics: RO-ESC-IF-5501_i3r4_RSGS_FD_ICD-2.pdf