comparison: docs/file_formats/netcdf_file.rst
docs/file_formats/netcdf_file.rst
- changeset 128
- 6757f7d0af2a
- parent 124
- becb9de86607
- child 130
- 58bd0b5b6632
equal
deleted
inserted
replaced
| 127:88d912df1073 | 128:6757f7d0af2a |
|---|---|
| 1 .. _netcdf_file: | 1 .. _netcdf_file: |
| 2 | 2 |
| 3 The SCC input netCDF file format | 3 The SCC input netCDF file format |
| 4 ================================ | 4 ================================ |
| 5 | 5 |
| 6 A more detailed version of this document can be found in this :download:`pdf file <../files/NetCDF_input_file_v3_3.pdf>`. | 6 A more detailed version of this document can be found in this :download:`pdf file <../files/NetCDF_input_file_v3_4.pdf>`. |
| 7 | 7 |
| 8 .. note:: | 8 .. note:: |
| 9 | 9 |
| 10 You can check the format of the files you create using the linked `script <https://gitlab.com/ioannis_binietoglou/scc-netcdf-checker>`_ . | 10 You can check the format of the files you create using the linked `script <https://gitlab.com/ioannis_binietoglou/scc-netcdf-checker>`_ . |
| 11 | 11 |
| 57 measured overlap function. The *Lidar Ratio* file contains a lidar ratio | 57 measured overlap function. The *Lidar Ratio* file contains a lidar ratio |
| 58 profile to use in elastic backscatter retrievals. The *Raw Lidar Data* | 58 profile to use in elastic backscatter retrievals. The *Raw Lidar Data* |
| 59 file is of course mandatory and the *Sounding Data*, *Overlap* and | 59 file is of course mandatory and the *Sounding Data*, *Overlap* and |
| 60 *Lidar Ratio* files are optional. If *Sounding Data* file is not | 60 *Lidar Ratio* files are optional. If *Sounding Data* file is not |
| 61 submitted by the user, the molecular density will be calculated by the | 61 submitted by the user, the molecular density will be calculated by the |
| 62 SCC using the "US Standard Atmosphere 1976". If the *Overlap* file is | 62 SCC using model forecast/re-analysis or in case these are not available using the "US Standard Atmosphere 1976". If the *Overlap* file is |
| 63 not submitted by the user, the SCC will get the full overlap height from | 63 not submitted by the user, the SCC will get the full overlap height from |
| 64 SCC\_DB and it will produce optical results starting from this height. | 64 SCC\_DB and it will produce optical results starting from this height. |
| 65 If *Lidar Ratio* file is not submitted by the user, the SCC will | 65 If *Lidar Ratio* file is not submitted by the user, the SCC will |
| 66 consider a fixed value for lidar ratio got from SCC\_DB. | 66 consider a fixed value for lidar ratio got from SCC\_DB. |
| 67 | 67 |
| 721 | 721 |
| 722 Background_High = 500, 50000, 50000, 50000 ; | 722 Background_High = 500, 50000, 50000, 50000 ; |
| 723 | 723 |
| 724 - | ``Molecular_Calc`` | 724 - | ``Molecular_Calc`` |
| 725 | This mandatory variable defines the way used by SCC to calculate | 725 | This mandatory variable defines the way used by SCC to calculate |
| 726 the molecular density profile. At the moment two options are | 726 the molecular density profile. The following options are |
| 727 available: | 727 available: |
| 728 | 728 |
| 729 #. Automatic. In this case the value of this variable has to be 0. | |
| 730 First the availablity of model forecast/re-analysis on Cloudnet data portal (https://cloudnet.fmi.fi/) is checked. | |
| 731 In case no model data are found US Standard Atmosphere 1976 is used. | |
| 732 | |
| 733 #. Radiosounding. In this case the value of this variable has to be 1 | |
| 734 | |
| 735 #. Model forecast/re-analysis. In this case the value of this variable has to be 2. | |
| 736 Model data are made available by Cloudnet data portal (https://cloudnet.fmi.fi/). | |
| 737 | |
| 729 #. US Standard Atmosphere 1976. In this case the value of this | 738 #. US Standard Atmosphere 1976. In this case the value of this |
| 730 variable has to be 0 | 739 variable has to be 4 |
| 731 | 740 |
| 732 #. Radiosounding. In this case the value of this variable has to be 1 | 741 |
| 733 | 742 If we decide to use the option 1. or option 4. we have to provide also the |
| 734 If we decide to use the option 1. we have to provide also the | 743 measured pressure and temperature at lidar station level. |
| 735 measured pressure and temperature at lidar station level. Indeed if | 744 Option 1. is available only for the stations registered to Cloudnet data portal for |
| 736 we decide to use the option 2. a radiosounding file has to be | 745 the delivery of the required model data. |
| 746 The Cloudnet station registration status can be checked by looking at the field 'Cloudnet Station ID' | |
| 747 in the station settings. If this field is filled the corresponding station is registered otherwise it is not. | |
| 748 In case the station is not registered you can ask to be registered by contacting SCC responsible. | |
| 749 Usually model data are made available with a delay of 24h. | |
| 750 | |
| 751 For the option 2. a radiosounding file has to be | |
| 737 submitted separately in NetCDF format (the structure of this file is | 752 submitted separately in NetCDF format (the structure of this file is |
| 738 summarized in table 2 of the pdf file). Let’s suppose we want to use the | 753 summarized in table 2 of the pdf file). Let’s suppose we want to use the |
| 739 option 1. so: | 754 option 1. so: |
| 740 | 755 |
| 741 :: | 756 :: |
| 742 | 757 |
| 743 Molecular_Calc = 0 ; | 758 Molecular_Calc = 0 ; |
| 744 | 759 |
| 745 - | ``Pressure_at_Lidar_Station`` | 760 - | ``Pressure_at_Lidar_Station`` |
| 746 | Because we have chosen the US Standard Atmosphere for calculation | 761 | Because we have chosen the automatic calculation mode to compute the molecular density profile we need to provide |
| 747 of the molecular density profile we have to give the pressure in | 762 the pressure in hPa at lidar station level (in case model data are not available). |
| 748 hPa at lidar station level: | |
| 749 | 763 |
| 750 :: | 764 :: |
| 751 | 765 |
| 752 Pressure_at_Lidar_Station = 1010 ; | 766 Pressure_at_Lidar_Station = 1010 ; |
| 753 | 767 |
| 754 - | ``Temperature_at_Lidar_Station`` | 768 - | ``Temperature_at_Lidar_Station`` |
| 755 | Because we have chosen the US Standard Atmosphere for calculation | 769 | Because we have chosen the automatic calculation mode to compute the molecular density profile we need to provide |
| 756 of the molecular density profile we have to give the temperature in | 770 the temperature in C at lidar station level (in case model data are not available). |
| 757 C at lidar station level: | |
| 758 | 771 |
| 759 :: | 772 :: |
| 760 | 773 |
| 761 Temperature_at_Lidar_Station = 19.8 ; | 774 Temperature_at_Lidar_Station = 19.8 ; |
| 762 | 775 |
