--- a/docs/data_processing/viewing_measurements.rst Thu Mar 13 12:11:56 2014 +0200
+++ b/docs/data_processing/viewing_measurements.rst Thu Mar 13 15:51:48 2014 +0200
@@ -1,6 +1,164 @@
.. _viewing_measurements:
-View existing measurements and files
-====================================
+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.
-123
+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.
+
