RPW FILe Maker (FILM): Plugin to make RPW L0, L1 and HK data files
Project description
FILM PLUGIN README
This directory contains the source files of the Rpw FILe Maker (FILM), a plugin of the ROC pipelines dedicated to the RPW L0, L1 and HK files production.
FILM has been developed with the POPPY framework.
Quickstart
Installation with pip
To install the plugin using pip:
pip install roc-film
Installation from the repository
First, retrieve the FILM
repository from the ROC gitlab server:
git clone https://gitlab.obspm.fr/ROC/Pipelines/Plugins/FILM.git
You will need a personal access token to reach the package registry in the ROC Gitlab server.
Then, install the package (here using (poetry)[https://python-poetry.org/]):
poetry install"
NOTES:
- It is also possible to clone the repository using SSH
- To install poetry: `pip install poetry`
Usage
The roc-film plugin is designed to be run in a POPPy-built pipeline. Nevertheless, it is still possible to import some classes and methods in Python files.
How to release a new version of the plugin?
-
Checkout to the git develop branch (and make pull to be sure to work from the latest commit in the gitlab server)
-
First update metadata (version, dependencies, etc.) in the plugin pyproject.toml file.
-
Then make sure the descriptor.json and poetry.lock files are also up-to-date.
To update the descriptor.json file, run the command:
python bump_descriptor.py -m <modification_message>
To update the poetry.lock file, enter:
poetry lock
N.B. poetry Python package must be installed (see https://python-poetry.org/).
- Commit the changes in the develop branch. Make sure to commit with a comprehensive enough message.
- Checkout to the master branch and merge the develop branch into master
- Create a new git tag
X.Y.Z
for the new version of the plugin (must be the same version than in the pyproject.toml file) - Push both the master branch and the tag to the gitlab server
- Do a rebase of develop onto the master branch
- Push the up-to-date develop branch to the gitlab server
N.B. This procedure only concerns the version release. It is assumed that any other changes in the code have been already validated previously.
CONTACT
- Xavier BONNIN xavier.bonnin@obspm.fr (author, maintainer)
- Florence HENRY florence.henry@obspm.fr (maintainer)
License
This project is licensed under CeCILL-C.
Acknowledgments
- Solar Orbiter / RPW Operation Centre (ROC) team
Project details
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 roc_film-1.13.5-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 236132945c529fc751f8f230a0df2a96f2c4a38c3b5c13d5dbe4ab5e684aefbb |
|
MD5 | 7bc2950c57fe04a4b51bfc4a2bdbeeb7 |
|
BLAKE2b-256 | 3718fc608423173de50ac1dac8a45232e32438527e9a362ea92b3371ae18c9bc |