From fda5969a6dbcdb9e339e0bf5d8856f9dfc8a84cb Mon Sep 17 00:00:00 2001
From: Roberto <roberto.susino@inaf.it>
Date: Sat, 17 Feb 2024 12:44:57 +0100
Subject: [PATCH] Update README.md and CHANGELOG.md
---
CHANGELOG.md | 80 ++++++---
README.md | 464 +++++++++++++++++----------------------------------
schema.png | Bin 0 -> 89880 bytes
3 files changed, 212 insertions(+), 332 deletions(-)
create mode 100644 schema.png
diff --git a/CHANGELOG.md b/CHANGELOG.md
index 3606919..3908c1d 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,68 +1,100 @@
# CHANGELOG
+
All changes to the Metis L1 pipeline are documented in this file.
-## 3.1 - 2022-01-27
+## Version 3.2.1 (2024-02-14)
+
+• Fixed a bug that caused wrong values of the keywords CHECKSUM and DATASUM.
+• Introduce new values of the keywords OBJECT (= ‘Sun’) and TARGET (= ‘Corona’) whose use was still TBD.
+• Include some code optimisations.
+
+## Version 3.2.0 (2023-05-23)
+
+- Update the management of the keywords SOOPTYPE, SOOPNAME, OBS_ID, OBS_MODE, and OBS_TYPE, according to RD-2.
+
+## Version 3.1.2 (2022-09-05)
+
+- Include a patch to add the keyword SEQ_NUM where missing (polarimetric images processed with the python version of the L0 pipeline).
+
+## Version 3.1.1 (2022-06-09)
+
+- Fix a typo in the interpol_param.pro routine that caused the pipeline exit with a wrong error code in some cases.
+- Update the management of the FITS versioning (version increment is now performed by the infrastructure).
+- Include some code optimisations.
+
+## Version 3.1.0 (2022-01-27)
+
- Manage the new format of the VL bad-pixel map which now includes the detector reference rows.
- Fix a bug that caused wrong values in the WCS keywords CTYPE1 and CTYPE2 of UV images.
- Add management of errors originating from the lack of a mandatory parameter in the input HK table: the pipeline now exits with a non-zero error code.
- Add management of the predictive Solar Orbiter’s SPICE meta-kernel.
- Duplicate some Metis specific WCS keywords in the FITS header using more user-friendly names:
- - SUNPIX1 = SUN_XCEN and SUNPIX2 = SUN_YCEN
- - SCPIX1 = SC_XCEN and SCPIX2 = SC_YCEN
- - IOPIX1 = IO_XCEN and IOPIX2 = IO_YCEN
- - FSPIX1 = FS_XCEN and FSPIX2 = FS_YCEN
+- SUNPIX1 = SUN_XCEN and SUNPIX2 = SUN_YCEN
+- SCPIX1 = SC_XCEN and SCPIX2 = SC_YCEN
+- IOPIX1 = IO_XCEN and IOPIX2 = IO_YCEN
+- FSPIX1 = FS_XCEN and FSPIX2 = FS_YCEN
- Optimize the solo_get_pointing.pro routine in order to also provide coordinates of the spacecraft in the celestial J2000 coordinate frame.
- Fix a potential bug in the make_bin_table.pro routine.
-- Make changes to better handle the L0 FITS files generated from the new version of Metis OBSW 2.2.0.
+- Make changes to handle the L0 FITS files generated from the new version of Metis OBSW 2.2.0.
-## 3.0 - 2021-07-19
-- Modify the pipeline to manage the new input I/F which includes the full set of Solar Orbiter SPICE kernels and the Metis Calibration Package. In the input file contents.json, the two fields TLS_FILE_NAME and TSC_FILE_NAME are now replaced by the field SPICE_KERNELS providing the path of the Solar Orbiter SPICE kernels folder. The field CAL_PACK_PATH is added to provide the path of the Metis Calibration Package folder.
+## Version 3.0.0 (2021-07-19)
+
+- Modify the pipeline to manage the new input I/F which includes the full set of Solar Orbiter’s SPICE kernels and the Metis calibration package. In the input file contents.json, the two fields TLS_FILE_NAME and TSC_FILE_NAME are now replaced by the field SPICE_KERNELS providing the path of the Solar Orbiter’s SPICE kernels folder. The field CAL_PACK_PATH is added to provide the path of the Metis calibration package folder.
- Add the WCS (World Coordinate System) keywords to the FITS header and a set of routines to perform calculation of the instrument boresight parameters and S/C coordinates.
- Add the derivation of the quality matrix which is now included in an extension to the L1 FITS file.
-- Include several code optimisations.
+- Include several code optimizations.
+
+## Version 2.3.1 (21-04-19)
-## 2.3.1 - 2021-04-19
- Fix a bug that caused an incorrect FITS file format: images with unsigned or long integer data type were saved as signed integers with the wrong BSCALE and BZERO scale keywords.
-## 2.3 - 2021-03-10
+## Version 2.3.0 (2021-03-10)
+
- Fix a bug that caused incorrect pixel counts in re-binned images. Pixel counts are now correctly multiplied by the square of the binning factor after re-binning.
- Introduce the correction for the total effective exposure time: pixel counts are now multiplied by the number of frames that were averaged during the acquisition, so as not to change the real signal-to-noise statistics in each pixel, related to counts integrated over the total effective exposure time. The XPOSURE and NSUMEXP keywords of the FITS, which are affected, are properly updated using parameters DIT, NDIT, NDIT1, and NDIT2.
- Add the HV_TEMP keyword in the FITS header of UV images.
- Fix a bug that caused some keywords in the FITS header of light curves to be incorrectly ordered.
-## 2.2.1 – 2021-02-23
-- Minor changes and optimisations.
+## Version 2.2.1 (2021-02-23)
+
+- Minor changes and optimizations.
+
+## Version 2.2.0 (2020-11-25)
-## 2.2 – 2020-11-25
- Change the way how the house-keeping parameters are saved into the FITS binary table, in order to prevent very long computation times when the house-keeping parameter table is large in data volume.
- Modify the decode_obt.pro routine to fix a bug that caused the OBT_BEG and OBT_END keyword values to be converted from double to long.
-- Optimise some keyword description texts in the FITS header.
+- Optimize some keyword description texts in the FITS header.
- Add the make_bin_table.pro routine.
- Remove the strreplace.pro routine.
-## 2.1 – 2020-11-13
+## Version 2.1.0 (2020-11-13)
+
- Fix a bug that triggered the re-binning of VL images even when not necessary.
- Fix a bug that caused an error in writing the log file for data products that are not images (e.g., light curves).
-## 2.0 – 2020-10-06
+## Version 2.0.0 (2020-10-06)
+
- Include the re-binning of images that had been acquired with binning enabled, so that the size of the data in the FITS is consistent with the commanded binning.
- Modify the interpolation method of house-keeping parameters to manage cases in which interpolation fails, avoiding output values such as “NaN” or “Inf”.
- Add conversion to string for all the keywords of the scientific header that are boolean type.
- Include the generation of a log file with information on the processing and errors, useful for debugging.
-## 1.1 – 2020-04-21
+## Version 1.1.0 (2020-04-21)
+
- Modify the interpolation method of house-keeping parameters to take into account:
- - the possible lack of a parameter;
- - the possible presence of an uncalibrated parameter (whose engineering value is flagged with “N/A”);
- - the fact that the GEN_TIME keyword is provided in UTC rather than OBT.
+- the possible lack of a parameter;
+- the possible presence of an uncalibrated parameter (whose engineering value is flagged with “N/A”);
+- the fact that the GEN_TIME keyword is provided in UTC rather than OBT.
- Fix a bug that prevented the correct update of some keywords of the FITS header, in particular those related to sensor temperatures, whose values are interpolated using the input house-keeping parameter table.
- Add correct computation of the TELAPSE and XPOSURE keywords.
- Include the EMPTY_PARAMS field in the output auxiliary JSON file, containing the list of house-keeping parameters in the input table that are not calibrated but which have been interpolated to correct the value of some of the FITS header keywords.
- Revise the structure of the binary table containing the house-keeping parameters to make it more user-friendly.
-## 1.0 – 2020-03-06
+## Version 1.0.0 (2020-03-06)
+
- Add the decode_obt.pro routine.
-- Include several code optimisations.
+- Include several code optimizations.
+
+## Version 0.0.0 (2020-01-16)
-## 0.0 – 2020-01-16
Prototype version of the L1 pipeline.
diff --git a/README.md b/README.md
index 774b168..b4fae82 100644
--- a/README.md
+++ b/README.md
@@ -1,330 +1,178 @@
-# README
+# Metis L1 pipeline
This file describes the structure of the Metis L1 pipeline. The pipeline source code is written using the Interactive Data Language (IDL). The present version has been developed and tested using IDL 8.7 and higher versions.
-## metis_l1_prep.pro
-Main pipeline program.
-
-### Call
-The main program can be launched from outside IDL with the following command:
-
- idl -e metis_l1_prep
-
-The main program must be launched from a working directory containing two folders, *input* and *output*, where the data files used and generated by the pipeline are respectively located.
-
-### Framework setup
-IDL must include the NASA IDL Astronomy Users's Library, which can be downloaded at the following link: https://idlastro.gsfc.nasa.gov.
-In addition, the SPICE toolkit for IDL provided by the NASA's Navigation and Ancillary Information Facility (NAIF; https://naif.jpl.nasa.gov/naif) must be installed.
-
-### Operations
-The pipeline performs the following specific operations:
-+ **saturation and quality classification** (applied only to image data products): a quality matrix with same size of the input image is created, containing classification of the quality of each pixel
-+ **image rebinning** (applied only to image data products): image is rebinned according to the commanded binning, and pixel values are multiplied by the relevant binning factor (4.0 for 2×2 binning and 16.0 for 4×4 binning)
-+ **exposure time correction** (applied only to visible-light and UV image data products): pixel values are multiplied by the total number of frames averaged by the Metis on-board software
-+ **bad-pixel flagging** (applied only to image data products): the quality matrix is updated to take into account and to provide indication of known corrupted/unreliable detector pixels; the values of the pixels (or bins) in the quality matrix corresponding to (or associated with) a bad pixel are set to zero, according to the convention used for the saturation and quality classification
-+ **time conversions**:all times (begin and end of acquisition) are converted from on-board time units to UTC using the last released version of the Solar Orbiter's SPICE kernel dataset
-+ **determination of the World Coordinate System (WCS) parameters and spacecraft coordinates**: WCS keywords and spacecraft coordinates are computed using the boresight parameters given in the Metis calibration package and the last released version of the Solar Orbiter's SPICE ephemeris and attitude kernels, and are added to the FITS header
-
-### Input
-The pipeline input data are listed in a JSON file located in the *input* folder. The file must be named *contents.json* and formatted according to the following structure:
-
- {
- "file_name": "",
- "spice_kernels": "",
- "sk_arc_version": "",
- "cal_pack_path": "",
- "planning_file_name": "",
- "hk_file_name": "",
- "sw_version": "",
- "obsw_version": "",
- "idb_version": "",
- "hdr_version": "",
- "l1_version": 0
- }
-
-where all fields are defined as follows:
-
-+ **file_name**: a string scalar containing the full pathname of the L0 FITS file to be processed
-+ **spice_kernels**: a string scalar containing the full path of the last released version of the Solar Orbiter's SPICE ephemeris and attitude kernels
-+ **sk_arc_version**: a string scalar containing the three-digit version identifier of the SPICE kernels
-+ **cal_pack_path**: a string scalar containing the full path of the applicable version of the Metis calibration package
-+ **planning_file_name**: a string scalar containing the full pathname of a JSON file containing the planning metadata associated with the input L0 FITS file
-+ **hk_file_name**: a string scalar containing the full pathname of a JSON file containing the set of Metis house-keeping parameters associated with the input L0 data
-+ **sw_version**: a string scalar containing the version identifier of the processor used for generating the final pipeline product, i.e. the L1 FITS file
-+ **obsw_version**: a string scalar containing the version identifier of the Metis on-board software used for the acquisition of the input data
-+ **idb_version**: a string scalar containing the version identifier of the current instrument database used for the processing of the input data
-+ **hdr_version**: a string scalar containing the version identifier of the scientific header structure associated with the input data
-+ **l1_version**: an integer scalar corresponding to the incremental number version of the last L1 FITS file generated from the same input L0 FITS file
-
-> ***Note***: all input files listed in the *contents.json* file must be located in the *input* folder and their pathname must be relative to the main working directory
-
-### Additional input
-#### Planning metadata
-The planning metadata JSON file has the following structure:
-
- {
- "mission_ltp": 0,
- "obs_id": "",
- "soop_name": "",
- "obs_mode": ""
- }
-
-where all fields are defined as follows:
-+ **mission_ltp**: an integer scalar corresponding to the LTP period number which the observation belongs to
-+ **obs_id**: a string scalar containing the value of the *socIds* key associated with the observation which the data belongs to, contained in the Observation Timeline Export JSON file provided by the Solar Orbiter SOC
-> ***Note***: this field must be formatted as `smet_xxxx_xxx_xxx_xxxx_xxx`, where `x` can be either a character or a digit
-+ **obs_mode**: a string scalar containing the value of the *name* key that is associated with the observation which the data belongs to, contained in the Observation Timeline Export JSON file
-+ **soop_name**: a string scalar containing the value of the *soopType* key that is associated with the SOOP which the observation belongs to, contained in the Observation Timeline Export JSON file
-
-#### House-keeping parameters
-The JSON file containing the house-keeping parameters associated with the L0 data has the following structure:
-
- {
- "par_name": [""],
- "packet": [""],
- "rec_time": [""],
- "gen_time": [""],
- "raw_val": [""],
- "eng_val": [""],
- "unit": [""],
- "desc": [""]
- }
-where all fields are defined as follows:
-+ **par_name**: a one-dimensional string array containing the names of the house-keeping parameters
-+ **packet**: a one-dimensional string array containing the names of the telemetry packets which the parameters belong to
-+ **rec_time**: a one-dimensional string array containing the UTC packet creation times in ISO8601 format
-> ***Note***: this is the time at which the SCOS-2000 packet was created, which is also approximately the time at which the packet was received by the MCS and stored
-+ **gen_time**: a one-dimensional string array containing the UTC spacecraft times in ISO8601 format
-> ***Note***: this is the time at which the CCSDS packet was created on baord, contained in the packet data field header and converted from on-board time units to UTC on ground
-+ **raw_val**: a one-dimensional string array containing the raw values of the parameters
-+ **eng_val**: a one-dimensional string array containing the calibrated values of the parameters
-> ***Note***: if calibration is not available for a parameter, the corresponding *eng_val* field has the value "N/A"
-+ **unit**: a one-dimensional string array containing the physical units of the calibrated values
-+ **desc**: a one-dimensional string array containing descriptions of the parameter content as per instrument database definition
-> ***Note***: for each house-keeping parameter, the JSON file must contain at least two values: the last value measured before the start of the observation which the data belongs to, and the first value measured after the end of the observation
-
-### Output
-The output data files generated by the pipeline are saved into the *output* folder. They are listed in a JSON file named *contents.json* having the following structure:
-
- {
- "file_name": "",
- "l0_file_name": "",
- "log_file_name": "",
- "empty_params": [""]
- }
-
-where all fields are defined as follows:
-
-+ **file_name**: a string scalar containing the pathname of the generated L1 FITS file
-
-> ***Note***: the FITS file is named according to the convention: `solo_L1_metis-[datatype]_[date-time]_V[version].fits`, where `[datatype]` identifies the Metis data product type, `[date-time]` is the 15-character date of observation, formatted as `yyyymmddThhmmss`, and `[version]` is the 2-digit, zero-padded incremental version number of the FITS file
-
-+ **l0_file_name**: a string scalar containing the full pathname of the input L0 FITS file that has been processed
-+ **log_file_name**: a string scalar containing the full pathname of an ASCII text file containing a log of the pipeline processing
-+ **empty_params**: a string array containing the list of the house-keeping parameters for which raw values were used instead of calibrated values in generating the house-keeping extension of the output L1 file
-
-## check_quality.pro
-Makes a classification of the quality of the input image creating a matrix providing, pixel by pixel, a quality index.
-
-### Call
- result = check_quality(image, cal_pack[, filter])
-
-### Input
-+ **image**: a two-dimensional 16-bit unsigned-integer array containing a raw Metis image
-+ **cal_pack**: an IDL structure variable containing the applicable Metis calibration package
+## Schema and description
+
+
+
+### Inputs
-### Output
-+ **result**: a two-dimensional floating-point array with same size as the input image containing the quality index values
+| Name | Description |
+| ------------------- | -------------------------------------------------------------------------------------------------------- |
+| L0 FITS file | Metis L0 FITS file to be processed |
+| Calibration package | Folder containing the applicable Metis calibration package |
+| SPICE kernels | Folder containing the latest version of the Solar Orbiter's SPICE ephemeris and attitude kernels |
+| HK parameters | JSON file listing values of specific Solar Orbiter and Metis HK parameters relevant to the input L0 file |
+| Planning info | JSON file listing planning information relevant to the input L0 file |
+| Auxiliary info | JSON file listing the relative pathnames of the input files and folders |
+
+The input files shall be collected in the working directory. The working directory must also contain two folders with names `input` and `output`. The input folder must contain the auxiliary info JSON file named contents.json. The structure of this file is described below.
-> ***Note***: possible values of the quality index are: *NaN*, for all saturated pixel or pixels having a value well below the average detector bias level; 1 for all pixels whose values are within the detector linearity range; 0 for all remaining pixels.
+#### Calibration package
-### Optional input
-+ **filter**: a string scalar indicating which Metis channel has acquired the input image. If not provided, the VL channel is assumed
+The applicable Metis calibration package is the L1 calibration package called `LTP00`.
-## decode_obt.pro
-See the documentation of the Metis L0 pipeline.
+#### SPICE kernels
-## fits_hdr2struct.pro
-Converts a FITS header string array into an IDL data structure.
+The latest version of Solar Orbiter’s SPICE kernels can be retrieved from the repository at the following URL:
+https://s2e2.cosmos.esa.int/bitbucket/scm/spice_kernels/solar-orbiter.git
-### Call
- result = fits_hdr2struct(string_header)
+#### HK parameters
-### Input
-+ **string_header**: a one-dimensional string array containing a valid FITS header as obtained, e.g., from *fitsread*.*pro* or *mrdfits*.*pro*
+The HK parameter JSON file shall contain the following fields.
-### Output
-+ **result**: an IDL structure variable containing the converted header
+| Name | Description | Type |
+| ------------ | ---------------------------------------------- | ------------ |
+| **PAR_NAME** | Parameter name | String array |
+| **PACKET** | Name of the TM packet the parameter belongs to | String array |
+| **GEN_TIME** | Packet generation time in UTC | String array |
+| **REC_TIME** | Packet reception time in UTC (not used) | String array |
+| **RAW_VAL** | Parameter raw (uncalibrated) value | String array |
+| **ENG_VAL** | Parameter engineering (calibrated) value | String array |
+| **UNIT** | Calibration unit (if applicable) | String array |
+| **DESC** | Description | String array |
-## get_light_time.pro
-Computes the light time of a target body relative to an observer for the given date, and optionally returns its velocity vector.
+##### Mandatory HK parameters
-### Call
- result = get_light_time(utc, target, observer[, rad_velocity = rad_velocity])
-> ***Note***: a valid set of SPICE ephemeris and attitude kernels for the specified target body and observer must be loaded before calling this routine
+The HK parameter JSON file shall contain values for the following mandatory parameters.
-### Input
-+ **utc**: a string scalar containing the UTC date in ISO8601 format at which the light time is to be computed
-+ **target**: a string scalar containing the name or SPICE ID code of the target body
-+ **observer**: a string scalar containing the name or SPICE ID code of the observing body
+| Name | Description | Applicable data types |
+| ------------ | ----------------------------- | --------------------- |
+| **NIT0E050** | UVDA temperature | 1, 4, 6 |
+| **NIT0E070** | HVU Screen commanded voltage | 1, 4, 6 |
+| **NIT0E071** | HVU MCP commanded voltage | 1, 4, 6 |
+| **NIT0E0B5** | HVU temperature | 1, 4, 6 |
+| **NIT0E0B6** | HVU MCP read voltage | 1, 4, 6 |
+| **NIT0E0B7** | HVU Screen + MCP read voltage | 1, 4, 6 |
+| **NIT0E0BF** | HVU MCP read current | 1, 4, 6 |
+| **NIT0E0E0** | VLDA temperature | 0, 3, 5 |
+| **NIT0L00D** | PMP temperature | 0, 3, 5 |
-### Output
-+ **result**: a double-precision floating-point scalar with the one-way light time between the target body and the observer in seconds
+#### Planning info
+
+The planning info JSON file shall contain the following fields.
+
+| Name | Description | Type | Default |
+| ------------------ | ------------------------------------------------------------------------------------------- | ------- | ------------------- |
+| **MISSION_LTP** | Number of the mission LTP the data belongs to | Integer | N/A |
+| **MISSION_STP** | Number of the mission STP the data belongs to | Integer | N/A |
+| **IOR_NUMBER** | ID of the IOR file the observation belongs to (not used) | Integer | N/A |
+| **IOR_VERSION** | Version ID of the IOR file the observation belongs to (not used) | Integer | N/A |
+| **SOOP_NAME** | Name of the SOOP the data belongs to, if applicable | String | “none” |
+| **SESSION_NUMBER** | Acquisition session number | String | N/A |
+| **SEQUENCE_NAME** | Name of the start-acquisition sequence that generated the data (not used) | String | N/A |
+| **OBS_ID** | Observation ID | String | “none” |
+| **OBS_MODE** | Observation mode | String | “METIS_GENERIC_OBS” |
+| **UNIQUE_ID** | Unique ID associated with the start-acquisition sequence that generated the data (not used) | String | N/A |
+| **ACTION_TIME** | Action time of the start-acquisition sequence that generated the data (not used) | String | N/A |
+| **PARAM_COUNT** | Number of parameters of the start-acquisition sequence that generated the data (not used) | Integer | N/A |
-### Optional output
-+ **rad_velocity**: a named variable that will receive the double-precision floating-point scalar with the radial component of the target body velocity relative to the observer in km/s
+#### Auxiliary info
-## interpol_param.pro
-Interpolates the table of Metis house-keeping parameters to get the value of a specified parameter at the given date. Calibrated values of the specified parameter are used by default for the interpolation; if they are not available in the input table, raw values are used instead.
+The auxiliary info JSON file shall contain the following fields.
-### Call
+| Name | Description | Type |
+| ---------------------- | ---------------------------------------------------------------------------------------------- | ------- |
+| **FILE_NAME** | Pathname of the L0 FITS file to be processed | String |
+| **CAL_PACK_PATH** | Pathname of the calibration package folder | String |
+| **SPICE_KERNELS** | Pathname of the Solar Orbiter’s SPICE kernel folder | String |
+| **HK_FILE_NAME** | Pathname of the HK parameter JSON file | String |
+| **PLANNING_FILE_NAME** | Pathname of the planning info JSON file | String |
+| **L1_VERSION** | Highest number version of existing L1 FITS files generated from the same L0 FITS file in input | Integer |
+| **HDR_VERSION** | Version of the scientific header | String |
+| **SW_VERSION** | Version of environment and pipeline software | String |
+| **IDB_VERSION** | Version of Metis IDB | String |
+| **OBSW_VERSION** | Version of Metis on-board software | String |
+| **SK_ARC_VERSION** | Version of Solar Orbiter’s SPICE kernels (not used) | String |
- result = interpol_param(hk_table, par_name, date[, empty_params = empty_params])
+All pathnames listed in the auxiliary info JSON file shall be relative to the working directory.
-### Input
-+ **hk_table**: an IDL structure variable containing the Metis house-keeping parameter table provided as input to the L1 pipeline
-+ **par_name**: a string scalar containing the name of the parameter for which interpolation is to be done
-+ **date**: a string scalar containing the UTC date in ISO8601 format at which interpolation of the specified parameter is to be done
+### Outputs
-### Output
-+ **result**: a floating-point scalar with the value resulting from the linear interpolation of the table values
-> ***Note***: if the specified date is outside the range of dates for which values are given in the input table, or if no values are given for the specified parameter, a null value is returned
+| Name | Description |
+| -------------- | ------------------------------------------------------------- |
+| L1 FITS file | Generated L1 FITS file |
+| Log | Plain-text file with information about the pipeline execution |
+| Auxiliary info | JSON file listing the relative pathnames of the output files |
+
+The output files will be saved into the output folder contained in the working directory. The auxiliary info JSON file will have name `contents.json`.
+
+#### Auxiliary info
+
+The auxiliary info JSON file shall contain the following fields.
+
+| Name | Description | Type |
+| ----------------- | ----------------------------------------------------------------------------------------------- | ------------ |
+| **FILE_NAME** | Pathname of the generated L1 FITS file | String |
+| **L0_FILE_NAME** | Pathname of the input L0 FITS file | String |
+| **LOG_FILE_NAME** | Pathname off the log file | String |
+| **EMPTY_PARAMS** | List of parameters in the HK parameter JSON file for which calibrated values were not available | String array |
+
+### Exit codes
+
+The following codes are returned.
+
+| Code | Description | Type |
+| ---- | -------------------------------------------------------------- | ------- |
+| 0 | Successful execution | Success |
+| 1 | Parameter not found in house-keeping table | Error |
+| 2 | Insufficient number of parameter values in house-keeping table | Error |
+| 3 | Interpolation of HK parameter failed | Error |
+
+## Deploy and execution
+
+### Build and Deploy Environment
+
+Below is a list of the specific tools that shall be used for the build and deploy of the release.
+
+| Tool/Software | Version |
+| ------------- | -------------- |
+| IDL | 8.7.2 or later |
+
+### Dependencies
+
+| Tool/Software | Version | Comments |
+| -------------------------- | ------- | ----------------------------------------------- |
+| NASA Astronomy Libraries | Latest | See https://idlastro.gsfc.nasa.gov |
+| NAIF SPICE Toolkit for IDL | Latest | See https://naif.jpl.nasa.gov/naif/toolkit.html |
+
+### Procedures
+
+- check_quality.pro
+- decode_obt.pro
+- fits_hdr2struct.pro
+- fix_fits_header.pro
+- get_light_time.pro
+- interpol_param.pro
+- json_write.pro
+- load_spice_kernels.pro
+- make_bin_table.pro
+- metis_l1_prep.pro (main program)
+- metis_rectify.pro
+- metis_wcs.pro
+- solo_get_carringrot.pro
+- solo_get_coords.pro
+- solo_get_ephemeris.pro
+- solo_get_pointing.pro
+- solo_get_solar_angles.pro
+- solo_obt2utc.pro
+- solo_utc2obt.pro
+
+### Execution
+
+The main program shall be executed with the following command:
+
+ idl -e metis_l1_prep
-### Optional output
-+ **empty_params**: a named string scalar or string array variable to which the string scalar with the name of the specified parameter is appended if calibrated values are not available for that parameter in the input table
-
-## json_write.pro
-See the documentation of the Metis L0 pipeline.
-
-## load_spice_kernels.pro
-Load or unload the Solar Orbiter's SPICE ephemeris and attitude kernels.
-
-### Call
-
- load_spice_kernels, path[, unload = unload][, kernel_list = kernel_list][, kernel_version = kernel_version]
-
-### Input
-+ **path**: a string scalar containing the full path of the Solar Orbiter's SPICE kernels folder
-
-### Output
-None.
-
-### Optional input
-+ **unload**: set this keyword to unload the kernels
-> ***Note***: if this keyword is set, the list of loaded kernels must be passed through the *kernel_list* argument
-
-### Optional output
-+ **kernel_list**: a named variable that will receive the string array with the full pathnames of the kernel files that have been loaded
-+ **kernel_version**: a named variable that will receive the string scalar with the version identifier of the kernel dataset that has been loaded
-
-## make_bin_table.pro
-Returns an IDL structure variable containing a copy of the Metis house-keeping parameter table with the proper format to be saved as a binary table in an L1 FITS file extension.
-
-### Call
-
- result = make_bin_table(hk_table)
-
-### Input
-+ **hk_table**: an IDL structure variable containing the Metis house-keeping parameter table provided as input to the L1 pipeline
-
-### Output
-+ **result**: an IDL structure variable containing the reformatted table
-
-## metis_rectify.pro
-Applies the proper transformation to bring the input image from Metis detector reference frame to the Sun-oriented detector reference frame
-
-> ***Note***: the Sun-oriented detector reference frame is defined as the reference frame with both axes parallel to the detector sides, axis 1 (X) pointing towards the solar West, and axis 2 (Y) pointing to the solar North in the case the spacecraft roll is zero
-
-### Call
-
- result = metis_rectify(image[, filter])
-
-### Input
-+ **image**: a two-dimensional array containing the detector-oriented Metis image
-
-### Output:
-+ **result**: a two-dimensional array with same size as the input image containing the Sun-oriented image
-
-### Optional input
-+ **filter**: a string scalar indicating which Metis channel has acquired the input image. If not provided, the VL channel is assumed
-
-## metis_wcs.pro
-Returns an IDL list variable containing the full set of FITS header keywords compliant with the World Coordinate System (WCS) standard. Information for the calculation of the WCS keywords are taken from the image FITS header, Solar Orbiter's SPICE attitude kernels, and applicable Metis calibration package.
-
-### Call
-
- result = metis_wcs(header, cal_pack[, ref_detector = ref_detector])
-> ***Note***: a valid set of Solar Orbiter's SPICE ephemeris and attitude kernels must be loaded before calling this routine
-
-### Input
-+ **header**: an IDL structure variable containing a valid Metis FITS header
-> ***Note***: this routine will not work with a Metis L0 FITS header, since some relevant keyword values are computed only at level L1
-+ **cal_pack**: an IDL structure variable containing the applicable Metis calibration package
-
-### Output
-+ **result**: an IDL list variable containing the full set of WCS keywords:
-
- WCSNAME Name of coordinate system
- PCi_j Transformation matrix (i, j = 1, 2)
- CRPIX1, CRPIX2 Reference pixel coordinates
- CDELT1, CDELT2 Pixel scales
- CRVAL1, CRVAL2 Values for reference pixel
- CTYPE1, CTYPE1 System projection types
- CUNIT1, CUNIT2 Units
- CROTA Rotation angle (deprecated)
- plus other Metis-specific keywords
-
-### Optional input
-+ **ref_detector**: set this keyword to force the calculation of the WCS keywords for the detector-oriented image. The default is to compute them for the Sun-oriented image
-
-## solo_get_carringrot.pro
-Returns the decimal Carrington rotation number of Sun's disk center as seen by Solar Orbiter for the given date.
-
-### Call
-
- result = solo_get_carringrot(utc)
-> ***Note***: a valid set of Solar Orbiter's SPICE ephemeris and attitude kernels must be loaded before calling this routine
-
-### Input
-+ **utc**: a string scalar containing the UTC date in ISO8601 format at which the Carrington rotation number is to be computed
-
-### Output
-+ **result**: a floating-point scalar with the decimal Carrington rotation number
-
-## solo_get_coords.pro
-Returns the orbital state vector of Solar Orbiter in the specified reference frame relative to an observer for the given date.
-
-### Call
-
- result = solo_get_coords(utc, frame, observer[, spherical = spherical][, degrees = degrees][, velocity = velocity])
-> ***Note***: a valid set of Solar Orbiter's SPICE ephemeris and attitude kernels must be loaded before calling this routine
-
-### Input
-+ **utc**: a string scalar containing the UTC date in ISO8601 format at which the Solar Orbiter state is to be calculated
-+ **frame**: a string scalar containing the name of one of the following standard coordinate systems:
-
- RTN Radial-Tangential-Normal
- HEE Heliocentric Earth Ecliptic
- HCI Heliocentric Inertial
- HAE Heliocentric Aries Ecliptic
- HEQ Heliocentric Earth Equatorial
- GSE Geocentric Solar Ecliptic
- GEI Geocentric Equatorial Inertial
- CARRINGTON Carrington system (can be abbreviated)
-+ **observer**: a string scalar containing the name or SPICE ID code of the observing body
-
-### Output
-+ **result**: a double-precision floating-point array with the three Cartesian (default, in km) or spherical (either in radians or degrees) coordinates of Solar Orbiter in the specified reference frame
-
-### Optional input
-+ **spherical**: set this keyword to return spherical coordinates (distance in km, longitude and latitude in radians) instead of Cartesian coordinates
-+ **degrees**: set this keyword to return longitude and latitude in degrees instead of radians
-
-### Optional output
-+ **velocity**: a named variable that will receive the double-precision floating-point array with the three Cartesian components of Solar Orbiter's velocity relative to the observer in km/s
-
-## solo_get_ephemeris.pro
-
-### Call
-### Input
-### Output
\ No newline at end of file
+This command shall be run from a working directory containing the input and output folders and the input data files as described in the previous sections.
diff --git a/schema.png b/schema.png
new file mode 100644
index 0000000000000000000000000000000000000000..f44f3462682e02d4ea4abd9d019bbd155adb9bec
GIT binary patch
literal 89880
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
literal 0
HcmV?d00001
--
GitLab