A Pointing Tool simphony wrapper

These details have not been verified by PyPI

Project links

Project description

Pointing Tool Wrapper

A JUICE SOC Pointing Tool wrapper for LINUX and MACOSX for use in a local computer.

Allows to simulate a Pointing Timeline Request (PTR) and to generate the corresponding SPICE CK, resolved PTR, available Power, and quaternions dump file.

Documentation

The documentation is automatically generated from the content of the docs directory and from the docstrings of the public signatures of the source code.

Additional documentation is available at the JUICE SOC Toolkit Help.

Installation

Users of Nexus scidockreg repository

pip install ptwrapper

Other Users

git clone https://juigitlab.esac.esa.int/core-system/uplink/auxiliary-tools/ptwrapper
cd ptwrapper
pip install .

Development and testing

Clone this repository
Requirements:
- Poetry
- Python 3.7+
Create a virtual environment and install the dependencies

Install the package and its dependencies:

poetry install

Then, after your edits, check that flake8 us happy:

poetry run flake8

and all the tests passed:

poetry run pytest -s

Using the library

After installing the library can be used with the Python Shell or with its CLI.

Python Shell

A basic test of the library contents can be done as follows:

from ptwrapper.simphony import SimphonyWrapper
sw = SimphonyWrapper()
version = sw.get_app_version()
print(version)

The next sample shows a more complex one, a PTR processing. The sample creates in the working directory a structure folder to invoke simphony and dumps inside the OUTPUT folder the expected products (SPICE CK, resolved PTR, available Power, and quaternions CSV)

import os

from ptwrapper.simphony import SimphonyWrapper
from ptwrapper.simphony import create_structure

ptr_content = """<prm>
   <body>
      <segment>
         <data>
            <timeline frame="SC">
               <block ref="OBS">
                  <startTime>2030-10-15T03:40:00</startTime>
                  <endTime>2030-10-15T04:15:00</endTime>
                  <attitude ref="track">
                     <boresight ref="SC_Zaxis"/>
                     <target ref="Jupiter"/>
                     <phaseAngle ref="powerOptimised">
                        <yDir>false</yDir>
                     </phaseAngle>
                     </attitude>
                     <metadata>
                        <comment>Track Power Optimised C3.0</comment>
                     </metadata>
               </block>
            </timeline>
         </data>
     </segment>
   </body>
</prm>
"""
mk_path = 'metakernel.tm'
session_file_path = create_structure('.', mk_path, ptr_content)
sw = SimphonyWrapper()
result = sw.get_attitude(os.path.dirname(session_file_path), session_file_path)
print(result)

Command line interface

The package has a CLI entry point:

ptwrapper -h

usage: ptwrapper [-h] [-s SESSION_FILE] [-m META_KERNEL] [-p PTR] [-w WORKING_DIR] [-o OUTPUT_DIR]

Simulate a PTR and generate the corresponding SPICE CK, resolved PTR, available Power, and quaternions dump file.

optional arguments:
  -h, --help            show this help message and exit
  -s SESSION_FILE, --session-file SESSION_FILE
                        Path to the session file. If provided the other arguments are ignored.
  -m META_KERNEL, --meta-kernel META_KERNEL
                        Path to the meta-kernel file.
  -p PTR, --ptr PTR     Path to the PTR/PTX file.
  -w WORKING_DIR, --working-dir WORKING_DIR
                        Path to the working directory. Default is the current directory.
  -o OUTPUT_DIR, --output-dir OUTPUT_DIR
                        Path to the output directory. Overwrites default output file names. Default is the structure of
                        the built-in session file.

You can either run the CLI using an OSVE configuration file (SESSION_FILE) or by specifying a number of inputs and assume the rest of parameters as provided by the default configuration file included in the package.

In addition, if you do not specify an output directory (OUTPUT_DIR), the package will replicate the canonical output directory and file structure and will also generate a SESSION_FILE that can be reused. Contrarily, if you specify an OUTPUT_DIR the output will be simplified and provided in that directory; additionally the output files will inherit the name of the input PTR file.

WARNING: Remember that the input META_KERNEL needs to have an adequate relative or absolute path for its PATH_VALUES variable value.

A couple of examples are provided hereunder. First specifying the output directory:

ptwrapper -m kernels/juice_mini_local.tm -p ptr_simphony.xml -o . 

ptwrapper session execution
AGM version:  9.3.0.p1
OSVE version: 1.6.0
[INFO]    <AGE>  Attitude Generation Module initialization started
[INFO]    <AGE>  AGE module setup started
[INFO]    <AGE>  AGE module setup successfully completed
[INFO]    <AGE>  Attitude Generation Module initialization completed
[INFO]    <AGE>  Loading Attitude Timeline
[INFO]    <AGE>  Checking Attitude Timeline
[INFO]    <AGE>  Initializing Attitude Timeline
[INFO]    <AGE>   TOTAL ENERGY for POINTING block from 2030-10-15T03:40:00Z to 2030-10-15T04:15:00Z
[INFO]    <AGE>   Attitude from actual PTR: 812.096753 Wh (812.096753 Wh)
[INFO]    <AGE>   Attitude from loaded CK:  812.096096 Wh (812.096096 Wh)
[INFO]    <PIF>  XML PTR file: "ptr_resolved.ptx" generated
[INFO]    <PIF>  Generating CK file with the following USER DEFINED parameters:
[INFO]    <PIF>  CK frame ID:  -28001
[INFO]    <PIF>  CK time step: 5 s
[INFO]    <AGE>  Writing Attitude Spice CK File: juice_sc_ptr.bc
[INFO]    <PIF>  CK file: "juice_sc_ptr.bc" generated
[INFO]    <AGE>  Writing Attitude Text File
[INFO]    <PIF>  POWER CSV file: "power.csv" generated
Renaming quaternions.csv to ptr_simphony_quaternions.csv
Renaming power.csv to ptr_simphony_power.csv
Renaming ptr_resolved.ptx to ptr_simphony_resolved.ptx
Renaming juice_sc_ptr.bc to ptr_simphony.bc
Cleaning up OSVE execution files and directories

This will generate the following output files.

.
|-- ptr_simphony.bc
|-- ptr_simphony.csv
|-- ptr_simphony.xml
|-- ptr_simphony_log.json
`-- ptr_simphony_resolved.ptx

The same run without specifying the OUTPUT_DIRECTORY yields the following directory structure:

.
|-- config
|   |-- age
|   |   |-- AGMConfig.xml
|   |   |-- CFG_AGM_JUI_MULTIBODY_EVENT_DEFINITIONS.xml
|   |   |-- CFG_AGM_JUI_MULTIBODY_FIXED_DEFINITIONS.xml
|   |   `-- CFG_AGM_JUI_MULTIBODY_PREDEFINED_BLOCK.xml
|   `-- ise
|       |-- BRF_MAL_SGICD_2_1_300101_351005.brf
|       |-- RES_C50_SA_CELLS_EFFICIENCY_310101_351003.csv
|       |-- eps.cfg
|       |-- events.juice.def
|       |-- phs_com_res_sa_cells_count.asc
|       `-- units.def
|-- kernel
|   `-- juice_mini_local.tm
|-- output
|   |-- juice_sc_ptr.bc
|   |-- power.csv
|   |-- ptr_resolved.ptx
|   |-- log.json
|   `-- quaternions.csv
|-- ptr
|   `-- PTR_PT_V1.ptx
`-- session_file.json

Project details

These details have not been verified by PyPI

Project links

Release history Release notifications | RSS feed

2.5.1

Nov 8, 2024

2.5.0

Oct 23, 2024

2.4.5

Sep 26, 2024

2.4.0

Sep 26, 2024

2.3.0

Feb 20, 2024

2.2.1

Feb 9, 2024

2.2.0

Jan 31, 2024

2.1.3

Dec 12, 2023

2.1.2

Nov 28, 2023

2.1.1

Nov 28, 2023

2.1.0

Nov 27, 2023

2.0.2

Nov 6, 2023

2.0.1

Oct 10, 2023

2.0.0

Sep 25, 2023

This version

1.1.0

Aug 24, 2023

1.0.0

Aug 2, 2023

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ptwrapper-1.1.0.tar.gz (19.3 MB view details)

Uploaded Aug 24, 2023 Source

Built Distribution

ptwrapper-1.1.0-py3-none-any.whl (19.3 MB view details)

Uploaded Aug 24, 2023 Python 3

File details

Details for the file ptwrapper-1.1.0.tar.gz.

File metadata

Download URL: ptwrapper-1.1.0.tar.gz
Upload date: Aug 24, 2023
Size: 19.3 MB
Tags: Source
Uploaded using Trusted Publishing? No
Uploaded via: poetry/1.5.0 CPython/3.9.13 Darwin/22.4.0

File hashes

Hashes for ptwrapper-1.1.0.tar.gz
Algorithm	Hash digest
SHA256	`c93617719cdbb28f03bbe752648344220ebcb5d078c17d523e09d6ce9eca8445`
MD5	`bff60e064f771ac4e4bbddd7937f2125`
BLAKE2b-256	`a9a7b041799051d01c16fca13cc7d1c05bdfca52f007c3c658e25961927198c3`

See more details on using hashes here.

File details

Details for the file ptwrapper-1.1.0-py3-none-any.whl.

File metadata

Download URL: ptwrapper-1.1.0-py3-none-any.whl
Upload date: Aug 24, 2023
Size: 19.3 MB
Tags: Python 3
Uploaded using Trusted Publishing? No
Uploaded via: poetry/1.5.0 CPython/3.9.13 Darwin/22.4.0

File hashes

Hashes for ptwrapper-1.1.0-py3-none-any.whl
Algorithm	Hash digest
SHA256	`686a5dc29deeea6c34018d9be65b9f0e14d86dd4ed1f982c740fcc20258dac48`
MD5	`af933b412eea38e9d94ab709a0280810`
BLAKE2b-256	`9946af28bc212553ef895c5ec11111e016103896cf8bc442f36521d27e317651`