[](https://github.com/SIMBIO-SYS/SimbioReader/actions/workflows/python-publish.yml)
[](https://github.com/SIMBIO-SYS/SimbioReader/actions/workflows/test.yml)
# SimbioReader
SimbioReader is the official Python reader for the data of the Spectrometer And Imagers For Mpo Bepicolombo Integrated Observatory System on board the ESA mission BepiColombo.
For more information about SIMBIO-SYS you can visit the official [ESA SIMBIO-SYS webpage](https://www.cosmos.esa.int/web/bepicolombo/simbio-sys)
## Installation
To install the reader you can use the command:
```console
$ python3 -m pip install SimbioReader
```
## Usage
The package contain a class that read and decode the SIMBIO-SYS image
```python
from SimbioReader import SimbioReader as SR
dat = SimbioReader("sim_raw_sc_vihi_internal_cruise_ico4_2020-12-14_001.dat")
```
## Command line tools
In the package are included two command line tools:
+ **simbioReader** show the info of a specific SIMBIO-SYS data product;
+ **simbioInfo** show the information about phases, subphases and test of SIMBIO-SYS;
### simbioReader
```console
simbioReader sim_raw_sc_vihi_internal_cruise_ico6_2021-11-22_001.dat
```
will show the main information about the product.
Are avalaible some options:
- **--all** will display all the avilable information
- **--hk** wil display also the housekeeping
- **--detector** will display all the detector information
- **--data-structure** will display the data structure of the file
- **--filter** will display the information about the used filter if the data come from HRIC or STC, otherwise the option will be ignored
For any details you can use the option **--help**.
Using the option **--version** will be shown the software version and the datamodel version implemented in it.
### simbioInfo
***simbioInfo*** tool is a command line interface (cli) wiith three subcommands:
- **filters** Show the definition of filter(s) of a specific channel
- **phases** Show the past mission phase(s);
- **subphases** Show the past mission subphase(s);
- **tests** Show the past SIMBIO-SYS performed test(s)
#### filters
The subcommand **filter** has an argument, the channel and an option ***--name***.
If the user provides only the channel, all the filters specific to that channel will be shown.
If the user adds the -name option, only the selected filter will be displayed, if found.
A description of argument and options coul be required using the option ***--help***
##### Examples
```console
simbioInfo filters hric
```
will show all the filters of the channel HRIC
```console
simbioInfo flters hric -n pan-l
```
will show the *HRIC* filter with the name *PAN-L*
#### phases
The subcommand **phases** will display a table of all or filtered past mission phases.
The options are:
- **--all** Show all the past mission phases;
- **--date** Show all the phases for the given date;
- **--name** Show the phase with the given name.
##### Examples
```console
simbioInfo phases --all
```
will show all the past mission phases.
```console
simbioInfo phases --date 2024-04-08
```
will show the phase that include the day *2024-04-08*
```console
simbioInfo phases --name necp
```
will show the phase with the name *necp*
#### subphases
The subcommand **subphases** will display a table of all or filtered past mission subphases.
The options are:
- **--all** Show all the past mission subphases;
- **--date** Show all the subphases for the given date;
- **--name** Show the subphase with the given name.
##### Examples
```console
simbioInfo subphases --all
```
will show all the past mission subphases.
```console
simbioInfo subphases --date 2024-04-08
```
will show the subphase that include the day *2024-04-08*, the **ico11**.
```console
simbioInfo subphases --name ico9
```
will show the phase with the name *ico9*
#### tests
The subcommand **tests** will display a table of all or filtered SIMBIO-SYS tests.
The options are:
- **--all** Show all the past SIMBIO-SYS tests;
- **--date** Show all the SIMBIO-SYS tests for the given date;
- **--name** Show the SIMBIO-SYS tests with the given name;
- **--phase** Show the SIMBIO-SYS tests for the specific phase;
- **--subphase** Show the SIMBIO-SYS tests for the specific subphase.
> [!NOTE]
> The tests name are not unique. Please use the option **--subphase** togeter the option **--name**
##### Examples
```console
simbioInfo tests --all
```
will show all the SIMBIO-SYS tests.
```console
simbioInfo tests -d 2024-04-08\ 2:00:00
````
will show the test that SIMBIO-SYS was performing at 2:00:00 on 2024-04-08, the *Interference Test* in the subphase *ico11*
```console
simbioInfo tests --name hric\ functional --subphase ico9
```
will show the test with the name that contain the string *hric functional* performed during the subphase *ico9*
## Class Description
### Methods
+ **Show()** display the main information related to the data file
```python
dat.Show()
```
Raw data
{
"_id": null,
"home_page": null,
"name": "SimbioReader",
"maintainer": null,
"docs_url": null,
"requires_python": null,
"maintainer_email": null,
"keywords": "data reader, Space Mission, BepiColombo, SIMBIO-SYS",
"author": null,
"author_email": "Romolo Politi <Romolo.Politi@inaf.it>",
"download_url": "https://files.pythonhosted.org/packages/9d/46/f8d6f8460b1f793d0529a281f05affe77fd1888df297acb1e0ea688a4bdf/simbioreader-0.2.2.tar.gz",
"platform": null,
"description": "\n\n\n[](https://github.com/SIMBIO-SYS/SimbioReader/actions/workflows/python-publish.yml)\n[](https://github.com/SIMBIO-SYS/SimbioReader/actions/workflows/test.yml)\n\n# SimbioReader\n\n\nSimbioReader is the official Python reader for the data of the Spectrometer And Imagers For Mpo Bepicolombo Integrated Observatory System on board the ESA mission BepiColombo.\n\nFor more information about SIMBIO-SYS you can visit the official [ESA SIMBIO-SYS webpage](https://www.cosmos.esa.int/web/bepicolombo/simbio-sys)\n\n## Installation\n\nTo install the reader you can use the command:\n\n```console\n$ python3 -m pip install SimbioReader\n```\n\n## Usage\n\nThe package contain a class that read and decode the SIMBIO-SYS image\n\n```python\nfrom SimbioReader import SimbioReader as SR\n\ndat = SimbioReader(\"sim_raw_sc_vihi_internal_cruise_ico4_2020-12-14_001.dat\")\n```\n\n## Command line tools\n\nIn the package are included two command line tools:\n\n+ **simbioReader** show the info of a specific SIMBIO-SYS data product;\n+ **simbioInfo** show the information about phases, subphases and test of SIMBIO-SYS;\n\n### simbioReader\n\n```console\nsimbioReader sim_raw_sc_vihi_internal_cruise_ico6_2021-11-22_001.dat\n```\n\nwill show the main information about the product.\n\nAre avalaible some options:\n\n- **--all** will display all the avilable information\n- **--hk** wil display also the housekeeping\n- **--detector** will display all the detector information\n- **--data-structure** will display the data structure of the file\n- **--filter** will display the information about the used filter if the data come from HRIC or STC, otherwise the option will be ignored\n\nFor any details you can use the option **--help**.\n\nUsing the option **--version** will be shown the software version and the datamodel version implemented in it.\n\n### simbioInfo\n\n***simbioInfo*** tool is a command line interface (cli) wiith three subcommands:\n\n- **filters** Show the definition of filter(s) of a specific channel\n- **phases** Show the past mission phase(s);\n- **subphases** Show the past mission subphase(s);\n- **tests** Show the past SIMBIO-SYS performed test(s)\n\n#### filters\n\nThe subcommand **filter** has an argument, the channel and an option ***--name***.\n\nIf the user provides only the channel, all the filters specific to that channel will be shown. \nIf the user adds the -name option, only the selected filter will be displayed, if found.\n\nA description of argument and options coul be required using the option ***--help***\n\n##### Examples\n\n```console\nsimbioInfo filters hric\n```\n\nwill show all the filters of the channel HRIC\n\n```console\nsimbioInfo flters hric -n pan-l\n```\n\nwill show the *HRIC* filter with the name *PAN-L*\n\n\n\n#### phases\n\nThe subcommand **phases** will display a table of all or filtered past mission phases.\n\nThe options are:\n\n- **--all** Show all the past mission phases;\n- **--date** Show all the phases for the given date;\n- **--name** Show the phase with the given name.\n\n##### Examples\n\n```console\nsimbioInfo phases --all\n```\nwill show all the past mission phases.\n\n\n```console\nsimbioInfo phases --date 2024-04-08\n```\n\nwill show the phase that include the day *2024-04-08*\n\n```console\nsimbioInfo phases --name necp\n```\nwill show the phase with the name *necp*\n\n#### subphases\n\nThe subcommand **subphases** will display a table of all or filtered past mission subphases.\n\nThe options are:\n\n- **--all** Show all the past mission subphases;\n- **--date** Show all the subphases for the given date;\n- **--name** Show the subphase with the given name.\n\n##### Examples\n\n```console\nsimbioInfo subphases --all\n```\nwill show all the past mission subphases.\n\n```console\nsimbioInfo subphases --date 2024-04-08\n```\n\nwill show the subphase that include the day *2024-04-08*, the **ico11**.\n\n```console\nsimbioInfo subphases --name ico9\n```\nwill show the phase with the name *ico9*\n\n#### tests\n\nThe subcommand **tests** will display a table of all or filtered SIMBIO-SYS tests.\n\nThe options are:\n\n- **--all** Show all the past SIMBIO-SYS tests;\n- **--date** Show all the SIMBIO-SYS tests for the given date;\n- **--name** Show the SIMBIO-SYS tests with the given name;\n- **--phase** Show the SIMBIO-SYS tests for the specific phase;\n- **--subphase** Show the SIMBIO-SYS tests for the specific subphase.\n\n> [!NOTE] \n> The tests name are not unique. Please use the option **--subphase** togeter the option **--name**\n\n##### Examples\n\n```console\nsimbioInfo tests --all\n```\n\nwill show all the SIMBIO-SYS tests.\n\n```console\nsimbioInfo tests -d 2024-04-08\\ 2:00:00 \n````\n\nwill show the test that SIMBIO-SYS was performing at 2:00:00 on 2024-04-08, the *Interference Test* in the subphase *ico11*\n\n```console\nsimbioInfo tests --name hric\\ functional --subphase ico9\n```\nwill show the test with the name that contain the string *hric functional* performed during the subphase *ico9*\n\n\n## Class Description\n\n### Methods\n\n+ **Show()** display the main information related to the data file\n\n```python\ndat.Show()\n```\n",
"bugtrack_url": null,
"license": "GNU GPL ver3",
"summary": "Python Reader for the data from SIMBIO-SYS instrument suite on-board the ESA mission BepiColombo",
"version": "0.2.2",
"project_urls": {
"Repository": "https://github.com/SIMBIO-SYS/SimbioReader"
},
"split_keywords": [
"data reader",
" space mission",
" bepicolombo",
" simbio-sys"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "0ead44c5e829cfab28a71177c3ea9c8735f6b36e8d822fdd9238f903c941ff03",
"md5": "828597889a41205accae34714e422ba7",
"sha256": "b9ce7689e36e98145e2fb6139e7106b27b157a2ca7a8c35b7a6c182d3675d189"
},
"downloads": -1,
"filename": "SimbioReader-0.2.2-py3-none-any.whl",
"has_sig": false,
"md5_digest": "828597889a41205accae34714e422ba7",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": null,
"size": 37434,
"upload_time": "2024-09-02T23:19:24",
"upload_time_iso_8601": "2024-09-02T23:19:24.796154Z",
"url": "https://files.pythonhosted.org/packages/0e/ad/44c5e829cfab28a71177c3ea9c8735f6b36e8d822fdd9238f903c941ff03/SimbioReader-0.2.2-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "9d46f8d6f8460b1f793d0529a281f05affe77fd1888df297acb1e0ea688a4bdf",
"md5": "fbacbbf05152816373ecec70460f38a7",
"sha256": "3a6adf6a26a3895b3f2a2e76475aac5591030f5205ee65d09a7545003e0ed800"
},
"downloads": -1,
"filename": "simbioreader-0.2.2.tar.gz",
"has_sig": false,
"md5_digest": "fbacbbf05152816373ecec70460f38a7",
"packagetype": "sdist",
"python_version": "source",
"requires_python": null,
"size": 36354,
"upload_time": "2024-09-02T23:19:25",
"upload_time_iso_8601": "2024-09-02T23:19:25.748925Z",
"url": "https://files.pythonhosted.org/packages/9d/46/f8d6f8460b1f793d0529a281f05affe77fd1888df297acb1e0ea688a4bdf/simbioreader-0.2.2.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-09-02 23:19:25",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "SIMBIO-SYS",
"github_project": "SimbioReader",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "simbioreader"
}
JSON
