diff -r bda5e7160bf6 -r c37ebdf6d03f docs/data_processing/uploading_measurements.rst --- a/docs/data_processing/uploading_measurements.rst Wed Mar 12 11:02:18 2014 +0200 +++ b/docs/data_processing/uploading_measurements.rst Wed Mar 12 11:43:36 2014 +0200 @@ -22,7 +22,7 @@ Sounding file (Optional) In this optional field you can submit a sounding file that will be used - by your measurements in the processing. The file needs to follow the netcdf + by your measurements in the processing. The file needs to follow the netCDF file format specified in the pdf file found in the :ref:`netcdf_file` section. The file you submit will not be necessarily connected with the submitted measurement; which sounding file will be used in the processing of @@ -31,7 +31,7 @@ Overlap file (Optional) In this optional field you can submit a overlap file that will be used - by your measurements in the processing. The file needs to follow the netcdf + by your measurements in the processing. The file needs to follow the netCDF file format specified in the pdf file found in the :ref:`netcdf_file` section. The file you submit will not be necessarily connected with the submitted measurement; which overlap file will be used in the processing of @@ -40,7 +40,7 @@ Lidar ratio file (Optional) In this optional field you can submit a lidar ratio file that will be used - by your measurements in the processing. The file needs to follow the netcdf + by your measurements in the processing. The file needs to follow the netCDF file format specified in the pdf file found in the :ref:`netcdf_file` section. The file you submit will not be necessarily connected with the submitted measurement; which lidar ratio file will be used in the processing @@ -53,11 +53,6 @@ section of the site. You can select multiple categories by holding down the "Control" key (PC) or "Command" key (MAC) while selecting. - -Form Validation ---------------- - - .. note:: Uploading the measurement file can take considerable time, depending on @@ -74,3 +69,56 @@ IE 9- No progress bar is available (as far as we know). + +Form Validation +--------------- + +The data you submit in the form are check in two stages. + +Before you submit the form +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Before you submit the form the following checks are performed: + +* All the necessary fields (i.e. "system" and "data file") need to be submitted. + +* The ancillary file names have to be in the appropriate 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. + + +After you submit the form +~~~~~~~~~~~~~~~~~~~~~~~~~~ + +After you submit the form: + +* The uploaded **data file** needs to have a unique name. + +* The **measurement id** defined in the file should *not* exist in the SCC. + +* All channels declared in the measurement file should correspond to declared + channels in the SCC. + +* The submitted measurement file should have the correct netCDF format. All + mandatory variables and attributes should be present in the file. All + variables and attributes should have the correct type (float, integer, etc). + This check is not exhaustive, and it is possible that some errors are **not** + detected. For example "conditionally" mandatory variables are not checked + (as, for example "LR_Input", that is mandatory if elastic backscatter retrievals + have to be done). + +If ancillary files are submitted +~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ + +Additionally, if ancillary files are also uploaded, the following checks are +performed: + +* The submitted measurement file should have the correct netCDF format. All + mandatory variables and attributes should be present in the file. All + variables and attributes should have the correct type (float, integer, etc). + +* A file with the same filename should not exist in the SCC or, if it exists, + it should have status "Missing" or "Error". If a file with the same filename + exists, and its status is "OK" the submitted file is regected.