docs/data_processing/viewing_measurements.rst

Fri, 19 Mar 2021 13:43:18 +0100

author
Giuseppe D'Amico <giuseppe.damico@imaa.cnr.it>
date
Fri, 19 Mar 2021 13:43:18 +0100
changeset 125
003aa42747f5
parent 49
815fe2598c15
permissions
-rw-r--r--

Update part concerning SCC data product file format description. Added also general section on basic lidar equations.

.. _viewing_measurements:

Browse uploaded measurements
============================


Search measurements
-------------------

You can browse already submitted measurements using the "Search Measurements" 
link in the data processing submenu. All the fields in the form are optional. 


Form fields
~~~~~~~~~~~

Station
   The EARLINET station call sign that performed measurement. 
   
System
   The system that was used to process the measurement.
   
Start date
   The search start date. All measurements before that date will be 
   filtered. The correct format is "YYYY-MM-DD HH:MM:SS".
    
Stop date
   The search stop date. All measurements after that date will be 
   filtered. The correct format is "YYYY-MM-DD HH:MM:SS".

Upload status
   The measurement upload status. Four choices are possible (0, 1, -127, 127).
   
Preprocessing status
   The measurement preprocessing status. Four choices are 
   possible (0, 1, -127, 127).
   
Optical processing status
   The measurement optical processing status. Four choices are 
   possible (0, 1, -127, 127).
   
Categories
   The measurement categories. Only measurements that belong to all categories 
   will be returned.
   

Results
~~~~~~~

You can filter the results of the list using the **Filter** box above the form.
The filter searches for matches in all columns of the table, i.e you can use it 
to filter the results by id, system, start time and duration. You can also 
filter by  status using a comma separated exit codes (ex. 127,127,-127).

The results can be sorted by clicking on the table labels.


View Measurement details
------------------------
In the measurement status page you can view more detailed information about 
the selected file. The following info are provided.

Measurement info
~~~~~~~~~~~~~~~~

System
   The system that was used to process the measurement. You can change the 
   system used in the processing of the measurement in the admin section 
   following the "Edit in admin" link in the File actions sub menu. If 
   you change the selected system, the measurement will be reprocessed 
   automatically, and all old output files will be deleted.

Start
   The start time of the measurement.
   
Stop
   The stop time of the measurement.
   
Sounding file
   The sounding file that will be used in processing the measurement. The 
   status of the file is also provided (see the :ref:`ancillary_details` section
   for further info).
    
Overlap file
   The overlap file file that will be used in processing the measurement. The 
   status of the file is also provided (see the :ref:`ancillary_details` section
   for further info).
    
Lidar ratio file
   The lidar ratio file that will be used in processing the measurement. The 
   status of the file is also provided (see the :ref:`ancillary_details` section
   for further info).
    
Categories
   The selected categories for this measurement. You can change the 
   selected categories in the admin section following the "Edit in admin" 
   link in the File actions sub menu.  
   
Created on
   The date and time that the file was first submitted on the SCC.
   
Last update
   The date and time that this file was last updated.
   
Comment
   User comments for this file. You can add / modify the comment in the admin 
   section following the "Edit in admin" link in the File actions sub menu.
   
   
The status of the measurement is represented by three icons. The icons have 
different colors depending on the status of each process.

Uploading (up arrow icon)
   It indicates if everything needed for processing is provided; practically
   this indicates if  the measurement file and all needed ancillary files have 
   been uploaded.

Preprocessing (gear icon)
   This indicates the progress of the preprocessor module.
    
Optical processing (graph icon)
   This indicates if progress of the optical processing module (ELDA).


These three indicators currently support four states:

Gray (Not started)
    A gray indicator means that the process did not start yet.

Orange (In progress)
    An orange indicator means that the process is currently performed.

Green (Success)
    A green indicator means that the process finished successfully.

Red (Fail)
    A red indicator means that the process failed.


File actions
~~~~~~~~~~~~

The following actions are available, depending on the state of the processing.

Reprocess
   The preprocessed and optical products will be recalculated. All previously 
   produced files will be deleted. 

Rerun optical module
   Only the optical products will be recalculated. All previously 
   produced optical files will be deleted.

Download pre-processed files
   Download all preprocessed files in a zip file. The action is available 
   only if the preprocessor finished successfully.
   
Download optical products
   Download all optical files in a zip file. The action is available 
   only if the optical module (ELDA) finished successfully.

Download plots
   Download all optical files plots in a zip file. The action is available 
   only if the optical module (ELDA) finished successfully.

mercurial