# HG changeset patch
# User Giuseppe D'Amico <giuseppe.damico@imaa.cnr.it>
# Date 1623931757 -7200
# Node ID 6757f7d0af2af1e6c885bf94279320568e0b07e5
# Parent  88d912df10738dde11f0d6c30b9add8164cb6788
Updated documetation: new options for Molecular_Calc have been described

diff -r 88d912df1073 -r 6757f7d0af2a docs/file_formats/netcdf_file.rst
--- a/docs/file_formats/netcdf_file.rst	Tue Apr 27 12:16:14 2021 +0200
+++ b/docs/file_formats/netcdf_file.rst	Thu Jun 17 14:09:17 2021 +0200
@@ -3,7 +3,7 @@
 The SCC input netCDF file format
 ================================
 
-A more detailed version of this document can be found in this :download:`pdf file <../files/NetCDF_input_file_v3_3.pdf>`.
+A more detailed version of this document can be found in this :download:`pdf file <../files/NetCDF_input_file_v3_4.pdf>`.
 
 .. note::
 
@@ -59,7 +59,7 @@
 file is of course mandatory and the *Sounding Data*, *Overlap* and
 *Lidar Ratio* files are optional. If *Sounding Data* file is not
 submitted by the user, the molecular density will be calculated by the
-SCC using the "US Standard Atmosphere 1976". If the *Overlap* file is
+SCC using model forecast/re-analysis or in case these are not available using the "US Standard Atmosphere 1976". If the *Overlap* file is
 not submitted by the user, the SCC will get the full overlap height from
 SCC\_DB and it will produce optical results starting from this height.
 If *Lidar Ratio* file is not submitted by the user, the SCC will
@@ -723,17 +723,32 @@
 
 -  | ``Molecular_Calc``
    | This mandatory variable defines the way used by SCC to calculate
-     the molecular density profile. At the moment two options are
+     the molecular density profile. The following options are
      available:
 
+   #. Automatic. In this case the value of this variable has to be 0.
+      First the availablity of model forecast/re-analysis on Cloudnet data portal (https://cloudnet.fmi.fi/) is checked.
+      In case no model data are found US Standard Atmosphere 1976 is used. 
+
+   #. Radiosounding. In this case the value of this variable has to be 1 
+
+   #. Model forecast/re-analysis. In this case the value of this variable has to be 2.
+      Model data are made available by Cloudnet data portal (https://cloudnet.fmi.fi/). 
+
    #. US Standard Atmosphere 1976. In this case the value of this
-      variable has to be 0
+      variable has to be 4
 
-   #. Radiosounding. In this case the value of this variable has to be 1
 
-   If we decide to use the option 1. we have to provide also the
-   measured pressure and temperature at lidar station level. Indeed if
-   we decide to use the option 2. a radiosounding file has to be
+   If we decide to use the option 1. or option 4. we have to provide also the
+   measured pressure and temperature at lidar station level. 
+   Option 1. is available only for the stations registered to Cloudnet data portal for 
+   the delivery of the required model data. 
+   The Cloudnet station registration status can be checked by looking at the field 'Cloudnet Station ID' 
+   in the station settings. If this field is filled the corresponding station is registered otherwise it is not. 
+   In case the station is not registered you can ask to be registered by contacting SCC responsible.
+   Usually model data are made available with a delay of 24h.
+
+   For the option 2. a radiosounding file has to be
    submitted separately in NetCDF format (the structure of this file is
    summarized in table 2 of the pdf file). Let’s suppose we want to use the
    option 1. so:
@@ -743,18 +758,16 @@
        Molecular_Calc = 0 ;
 
 -  | ``Pressure_at_Lidar_Station``
-   | Because we have chosen the US Standard Atmosphere for calculation
-     of the molecular density profile we have to give the pressure in
-     hPa at lidar station level:
+   | Because we have chosen the automatic calculation mode to compute the molecular density profile we need to provide
+     the pressure in hPa at lidar station level (in case model data are not available). 
 
    ::
 
        Pressure_at_Lidar_Station = 1010 ;
 
 -  | ``Temperature_at_Lidar_Station``
-   | Because we have chosen the US Standard Atmosphere for calculation
-     of the molecular density profile we have to give the temperature in
-     C at lidar station level:
+   | Because we have chosen the automatic calculation mode to compute the molecular density profile we need to provide
+     the temperature in C at lidar station level (in case model data are not available).
 
    ::
 
diff -r 88d912df1073 -r 6757f7d0af2a docs/files/NetCDF_input_file_v3_4.pdf
Binary file docs/files/NetCDF_input_file_v3_4.pdf has changed