docs/data_processing/introduction.rst

changeset 37
4e3f530ac84e
child 41
c9ba4c828051
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/docs/data_processing/introduction.rst	Mon Mar 10 16:56:47 2014 +0200
@@ -0,0 +1,67 @@
+Overview
+========
+
+The "Data processing" section of the SCC is used to upload measurements 
+and ancillary files, monitor the processing progress, and view the output 
+results of the SCC.
+
+The data processing section consist of three subsections:
+
+* The procedures of submitting new data for processing are described 
+  in the :ref:`uploading_measurements` section.
+
+* The procedures of submitting ancillary files (i.e. sounding, overlap, 
+  and lidar ratio files) that are used in the processing are described 
+  in the :ref:`uploading_ancillary` section.
+  
+* The procedure to find and explore existing measurements and ancillary 
+  files are detailed in the :ref:`viewing_measurements` section.
+
+Quick start
+-----------
+
+.. note::
+
+   The following discussion assumed that you have already set-up the system 
+   settings in the "Admin" section (see :ref:`administration` for details).
+
+In order to start processing lidar data, you will need to upload them 
+on the SCC server. The files should be in netcdf format, following the 
+specific format described in :ref:`netcdf_file`. There is no restriction imposed
+in the filename, but we suggest to use the format <measurement_ID>.nc. You can 
+upload using the "Quick upload" link in the menu.
+
+When you submit the processed measurements in the quick upload form, you will 
+need to specify the system configuration that was used to perform the 
+measurement. The *channels* that are defined in the file should be the
+ones defined in the selected system. The uploading of ancillary files or the
+selection of categories for the measurement are optional.
+
+When the file is uploaded, it is checked if it conforms to the needed
+netcdf format. The check guarantees that the mandatory variables are present
+in the file and that they have the correct format. Note that the check is not 
+exhaustive, in the sense it does not guarantee that the file is able to be 
+correctly processed; the aim of this check is to detect as early as possible
+common problems in the file. If some errors are found, the file will be 
+deleted from the server.
+
+If ancillary files are needed for the processing two things should be done:
+
+#. The ancillary file names should be defined in the submitted netcdf file. In 
+   contrast to the measurement files, the file name of the ancillary files
+   should follow a specified format, described in :ref:`netcdf_file`. In brief,
+   a sounding file should have a name rs_YYYYMMDDccNN.nc, a overlap file a name
+   ov_YYYYMMDDccNN.nc, and a lidar ratio file a name lr_YYYYMMDDccNN.nc, where
+   YYYY is a year, MM is the month, DD is the day, cc is the earlinet station 
+   call sign and NN is a number.
+
+#. The ancillary files should be uploaded on the server. The uploading can be
+   done in the same form as before, or independently in the "Upload ancillary"
+   form. If an ancillary file required by a measurement is not present in the
+   database, this file will appear as "Missing" and the processing of the 
+   measurement will not start and will be marked as "pending". When the missing 
+   file is uploaded, its status will change to "OK" and the measurement will be 
+   processed.
+  
+
+

mercurial