🪢 JUICE Planning Harmonisation System
juice-phs is a Python package that supports the Detailed Scenario Exercises during the Observation Plan, Pointing and Instrument Timeline Harmonisation processes. It also includes number of routines to calculate the geometry parameters that require spacecraft attitude information.
🛠️️ Prerequisites
- A computer based on a 64-bit Unix operating system: Linux or Mac
- Python 3.8 (or higher)
⎆ Python Installation
Install juice-phs with:
pip install [--upgrade] juice-phs
If you have a JUICE Git user, you can also install juice-phs locally from the repository:
git clone https://juigitlab.esac.esa.int/python/juice-phs
cd juice-phs
pip install .
Using the library
After installing the library can be used with the Python Shell or with its CLI.
Command line interface
The package has a number of CLI entry points:
opl2otlconvert Observation Plan (OPL) to Observation Timeline (OTL).opl2otcconvert Observation Plan (OPL) to Observation Timeline Coverage (OTC).
Usage examples are provided hereunder. Using the following input Observation Plan:
RIME_PRIME_OBSERVATION,2032-07-02T16:09:54.000Z,2032-07-02T16:31:31.000Z,RIME_EUROPA_FLYBY_02,RIME
RPWI_OBSERVATION,2032-07-02T16:08:54.000Z,2032-07-02T16:32:31.000Z,RPWI_In_situ_slow_Radio_Full,RPWI
RPWI_OBSERVATION,2032-07-02T06:52:25.000Z,2032-07-02T14:52:25.000Z,RPWI_In_situ_normal_Radio_Full,RPWI
JANUS_PRIME_OBSERVATION,2032-07-02T04:18:40.000Z,2032-07-02T04:32:00.000Z,SJS0004C50A_UVS_SAT_STELL_OCC_A,JANUS
with:
opl2otl -h
usage: opl2otl [-h] [-o OUTPUT] [-s SCENARIO] [-i ITERATION] [-u] csv
juice-itl: convert Observation Plan (OPL) to Observation Timeline (OTL).
positional arguments:
csv Observation Plan (OPL) CSV input file.
optional arguments:
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
Output directory (default: Current).
-s SCENARIO, --scenario SCENARIO
Scenario Identifier (default: E001).
-i ITERATION, --iteration ITERATION
Iteration reference (default: S01P00).
-u, --utc File times as UTC (default: Relative to events).
with the following arguments:
opl2otl opl_input.csv
generates the following directory structure:
.
|-- EVF_E001_01_SOC_S01P01.EVF
|-- EVF_E001_01_SOC_SXXPYY.EVF
|-- JANUS
| |-- OTL_E001_01_JAN_S01P01.ITL
| `-- OTL_E001_01_JAN_SXXPYY.ITL
|-- RIME
| |-- OTL_E001_01_RIM_S01P01.ITL
| `-- OTL_E001_01_RIM_SXXPYY.ITL
`-- RPWI
|-- OTL_E001_01_RPW_S01P01.ITL
`-- OTL_E001_01_RPW_SXXPYY.ITL
with the following content for OTL_E001_01_RPW_SXXPYY.ITL:
PTR_OBS_END (COUNT = 1) 02:20:25 RPWI OBS_START RPWI_In_situ_normal_Radio_Full
PTR_OBS_START (COUNT = 2) -01:17:29 RPWI OBS_END RPWI_In_situ_normal_Radio_Full
PTR_OBS_START (COUNT = 2) -00:01:00 RPWI OBS_START RPWI_In_situ_slow_Radio_Full
PTR_OBS_END (COUNT = 2) 00:01:00 RPWI OBS_END RPWI_In_situ_slow_Radio_Full
with :
opl2qlc -h
usage: opl2otc [-h] [-o OUTPUT] csv
juice-itl: convert Observation Plan (OPL) to Observation Timeline Coverage (OTC).
positional arguments:
csv Quick-Look Coverage input CSV input file.
optional arguments:
-h, --help show this help message and exit
-o OUTPUT, --output OUTPUT
Output file (default: qlc_output.csv at current directory).
with the following arguments:
opl2otc opl_input.csv -o otc_output.csv
generates the following output file:
RIME_EUROPA_FLYBY_02,2032-07-02T16:09:54.000Z,2032-07-02T16:31:31.000Z,0,RIME
RPWI_In_situ_slow_Radio_Full,2032-07-02T16:08:54.000Z,2032-07-02T16:32:31.000Z,0,RPWI
RPWI_In_situ_normal_Radio_Full,2032-07-02T06:52:25.000Z,2032-07-02T14:52:25.000Z,0,RPWI
SJS0004C50A_UVS_SAT_STELL_OCC_A,2032-07-02T04:18:40.000Z,2032-07-02T04:32:00.000Z,0,JANUS
Metadata
Release files for juice-phs 0.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| juice_phs-0.8.1-py3-none-any.whl | Python 3 | none | any | Details for juice_phs-0.8.1-py3-none-any.whl |
Release files / juice_phs-0.8.1-py3-none-any.whl
| Download URL | juice_phs-0.8.1-py3-none-any.whl |
|---|---|
| Size | 60.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
613f54729965a95a66c39862120ed9b52f6f6e9a2c23d3d346e215adc6e01d7d
|
|
BLAKE2b-256 checksum How to use checksums |
8398edd6bef00955e26cd3a8776c10229285efa4a72c432e15243a5cca326451
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/5.1.1 CPython/3.10.11
|
Security for juice-phs 0.8.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.