From cfd24971d8b8e16d456121a086837ce6fefc25ec Mon Sep 17 00:00:00 2001 From: Christina Holt Date: Fri, 26 Apr 2024 11:51:19 -0600 Subject: [PATCH 1/5] Adding docs for namelist. --- .../BuildingRunningTesting/InputsOutputs.rst | 158 +++++++++++++++--- 1 file changed, 135 insertions(+), 23 deletions(-) diff --git a/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst b/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst index 67a50c936..7d81b0fc5 100644 --- a/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst +++ b/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst @@ -44,32 +44,144 @@ UFS Unified Model Variables ITAG ---- -The file called ``itag`` is a text file that contains the fortran namelist ``&model_inputs`` as -well as the 2D decomposition specification in ``&nampgb``. It is read in by the ``upp.x`` executable -from standard input (stdin -- unit 5) and is generated automatically within the UFS application workflow or standalone run -script based on user-defined options. It should not be necessary to edit this file. For description purposes, -the namelists ``&model_inputs`` and ``&nampgb`` (in the ``itag`` file) contain the following lines for FV3: +The file called ``itag`` is a Fortran namelist file that contains two sections: ``&model_inputs`` describing the as well as the 2D decomposition specification in ``&nampgb``. It is read in by the ``upp.x`` executable from standard input (stdin -- unit 5) and is generated automatically within the UFS application workflow or standalone run script based on user-defined options. It should not be necessary to edit this file. For description purposes, the namelists ``&model_inputs`` and ``&nampgb`` (in the ``itag`` file) contain the following lines for FV3: :bolditalic:`&model_inputs` -#. ``fileName``: Name of the FV3 (pressure level) output file to be post-processed. - -#. ``IOFORM``: Format of FV3 model output (netcdfpara). - -#. ``grib``: Format of UPP output (grib2) - -#. ``DateStr``: Forecast valid time (not model start time) in YYYY-MM-DD_HH:00:00 format (the forecast time - desired to be post-processed). - -#. ``MODELNAME``: Model used (GFS, FV3R --- regional FV3, also known as the :term:`LAM`). - -#. ``fileNameFlux``: Name of the FV3 (surface) output file to be post-processed. - -#. ``fileNameFlat``: Name of configuration file (``postxconfig-NT.txt``) - -:bolditalic:`&nampgb` - -#. ``numx``: Number of subdomains in the x-direction used for 2D decomposition. +model_inputs +^^^^^^^^^^^^ + +The ``&model_inputs`` section parametrizes choices about the set of model output files that will be used for the UPP + +.. list-table:: *Description of the &model_inputs namelist section.* + :widths: 25 40 15 10 + :header-rows: 1 + + * - Variable Name + - Description + - Data Type + - Default Value + * - ``datestring`` + - Time stamp being processed (e.g., 2022-08-02_19:00:00). + - character(len=19) + - --- + * - ``fileName`` + - Name of input dynamics file; name of full 3-D model output file. + - character(len=256) + - --- + * - ``filenameflat`` + - Input configuration text file defining the requested fields. + - character(len=256) + - postxconfig-NT.txt + * - ``filenameflux`` + - Name of input physics file; name of 2-D model output file with physics and surface fields. + - character(len=256) + - --- + * -``grib`` + - Grib type (Note that UPP only supports Grib2 currently) + - character(5) + - grib2 + * - ``ioform`` + - Input file format. Choices: binary, binarympiio, binarynemsio, netcdf, netcdfpara + - character(len=20) + - --- + * - ``modelname`` + - Model name used by UPP internally (e.g., FV3R for LAM, GFS for GFS, NCAR for WRF) + - character(len=4) + - --- + +.. list-table:: *Description of the ``&nampgb`` namelist section.* + :widths: 25 40 15 10 + :header-rows: 1 + + * - ``aqf_on bool`` + - Turn on Air Quality Forecasting (CMAQ-based) + - logical + - .false. + * - ``d2d_chem`` + - Turn on option to process the 2D aerosol/chemical tracers + - logical + - .false. + * - ``d3d_on`` + - Turn on option to use dynamic 3D fields from GFS + - logical + - .false. + * - ``fileNameAERi`` string + - aerosols file name + - character(len=256) + - '''' + * - ``gccpp_on`` + - Turn on option to process the aerosol/chemical tracers related output from UFS-Chem (CCPP-Chem) model + - logical + - .false. + * - ``gocart_on`` + - Turn on option to process the aerosol/chemical tracers related output from GEFS-Aerosols model (GOCART) + - logical + - .false. + * - ``gtg_on`` + - Turn on GTG (Graphical Turbulence Guidance) + - logical + - .false. + * - ``hyb_sigp`` + - Not used + - logical + - .true. + * - ``kpo`` + - The number of pressure levels, if different than standard one specified by ``SPLDEF`` described below. + - integer + - 0 + * - ``kpv`` + - The number of output potential vorticity levels + - integer + - 8 + * - ``kth`` + - The number of output isentropic levels + - integer + - 6 + * - ``method_blsn`` + - Turn on blowing snow effect on visibility diagnostic (default=true) + - logical + - .true. + * - ``nasa_on`` + - Turn on option to process the aerosol/chemical tracers related output from UFS-Aerosols model (NASA GOCART) + - logical + - .false. + * - ``numx`` + - The number of i regions in a 2D decomposition; Each i row is distibuted to numx ranks; numx=1 is the special case of a 1D decomposition in Y only. + - integer + - 1 + * - ``po`` + - List indicating pressure levels in output + - real,dimension(70) + - 0 + * - ``popascal`` + - Switch to indicate if pressure levels are in pascals (multply by 100 if false) + - logical + - .false. + * - ``pv`` + - List indicating the potential vorticity level output + - real,dimension(70) + - (/0.5,-0.5,1.0,-1.0,1.5,-1.5,2.0,-2.0,(0.,k=kpv+1,70)/) + * - ``rdaod`` + - Turn on the option to process the AOD from the GFS scheme + - logical + - .false. + * - ``slrutah_on`` + - Calculate snow to liquid ratio (SLR) using method from University of Utah.(default=false) + - logical + - .false. + * - ``th`` + - List indicating isentropic level output + - real,dimension(70) + - (/310.,320.,350.,450.,550.,650.,(0.,k=kth+1,70)/) + * - ``vtimeunits string + - valid time units, default="", Choices: FMIN + - character(len=4) + - '''' + * - ``write_ifi_debug_files`` + - Write debug files for In-Flight Icing (IFI), a restricted option in UPP + - logical + - .false. .. _control-file: From 58143376b51b017458e924a0453c00af40d8558b Mon Sep 17 00:00:00 2001 From: Christina Holt Date: Fri, 26 Apr 2024 12:05:45 -0600 Subject: [PATCH 2/5] Reformat. --- .../BuildingRunningTesting/InputsOutputs.rst | 57 ++++++------------- 1 file changed, 16 insertions(+), 41 deletions(-) diff --git a/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst b/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst index 7d81b0fc5..8a4e0417f 100644 --- a/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst +++ b/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst @@ -31,9 +31,7 @@ Model Forecast The UPP ingests FV3 :term:`write component` files in parallel :term:`netCDF` format. -The table below is a list of the unified model variables available from the :term:`FV3` model core. Whether a -specific variable is able to be read by the UPP relies on dependencies such as physics options and choice of model. -This table does not include variables that are diagnosed when running the UPP. +The table below is a list of the unified model variables available from the :term:`FV3` model core. Whether a specific variable is able to be read by the UPP relies on dependencies such as physics options and choice of model. This table does not include variables that are diagnosed when running the UPP. UFS Unified Model Variables - :doc:`../tables/UFS_unified_variables_table` @@ -51,7 +49,7 @@ The file called ``itag`` is a Fortran namelist file that contains two sections: model_inputs ^^^^^^^^^^^^ -The ``&model_inputs`` section parametrizes choices about the set of model output files that will be used for the UPP +The ``&model_inputs`` section parameterizes choices about the set of model output files that will be used for the UPP .. list-table:: *Description of the &model_inputs namelist section.* :widths: 25 40 15 10 @@ -189,8 +187,7 @@ The ``&model_inputs`` section parametrizes choices about the set of model output Control File ------------ -The user interacts with the UPP through the control file to define what fields and levels to output. It -is composed of a header and a body. The header specifies the output file information. The body includes which fields and levels to process. +The user interacts with the UPP through the control file to define what fields and levels to output. It is composed of a header and a body. The header specifies the output file information. The body includes which fields and levels to process. A default control file, ``postxconfig-NT.txt``, is provided and read by the UPP. Users who wish to customize the control file to add or remove fields and/or levels may do so by modifying ``postcntrl.xml`` and then remaking the text file as described in the later section: :ref:`create_txt_file`. @@ -202,39 +199,28 @@ A default control file, ``postxconfig-NT.txt``, is provided and read by the UPP. Selecting Which Variables the UPP Outputs ------------------------------------------- -To output a field, the body of the control file needs to contain an entry for the appropriate variable. -If an entry for a particular field is not yet available in the control file, it may be added to the -control file with the appropriate entries for that field. For variables found on vertical levels (e.g., isobaric or height levels), the desired levels to be output must be listed (see next section: -:ref:`control_levels`). A list of available GRIB2 fields that can be output by UPP can be found in the -table :doc:`../tables/UPP_GRIB2_Table_byID`. Please note that some fields are dependent on model, physics, and other fields. +To output a field, the body of the control file needs to contain an entry for the appropriate variable. If an entry for a particular field is not yet available in the control file, it may be added to the control file with the appropriate entries for that field. For variables found on vertical levels (e.g., isobaric or height levels), the desired levels to be output must be listed (see next section: :ref:`control_levels`). A list of available GRIB2 fields that can be output by UPP can be found in the table :doc:`../tables/UPP_GRIB2_Table_byID`. Please note that some fields are dependent on model, physics, and other fields. .. _control_levels: Controlling which levels the UPP outputs ---------------------------------------- -The ```` tag in the ``postcntrl.xml`` file is used to list the desired levels for output. The following -levels are currently available for output: +The ```` tag in the ``postcntrl.xml`` file is used to list the desired levels for output. The following levels are currently available for output: + +- For isobaric output, 46 levels are possible, from 2 to 1000 hPa (*2, 5, 7, 10, 20, 30, 50, 70 mb and then every 25 mb from 75 to 1000 mb*). The complete list of levels is specified in ``sorc/ncep_post.fd/CTLBLK.f``. -- For isobaric output, 46 levels are possible, from 2 to 1000 hPa (*2, 5, 7, 10, 20, 30, 50, 70 mb and - then every 25 mb from 75 to 1000 mb*). The complete list of levels is specified in - ``sorc/ncep_post.fd/CTLBLK.f``. - - Modify specification of variable ``LSMDEF`` to change the number of pressure levels: LSMDEF=47 - Modify specification of ``SPLDEF`` array to change the values of pressure levels: (/200.,500.,700.,1000.,2000.,3000.,5000.,7000.,7500.,10000.,12500.,15000.,17500.,20000., …/) - + - For model-level output, all model levels are possible, from the highest to the lowest. - When using the Noah LSM, the soil layers are 0-10 cm, 10-40 cm, 40-100 cm, and 100-200 cm. -- When using the RUC LSM, the soil levels are 0 cm, 1 cm, 4 cm, 10 cm, 30 cm, 60 cm, 100 cm, 160 cm, - and 300 cm. (For the old RUC LSM, there are only 6 layers, and if using this, you will need to change - ``NSOIL`` for “RUC LSM” from 9 to 6 in the ``sorc/ncep_post.fd/WRFPOST.f`` routine.) +- When using the RUC LSM, the soil levels are 0 cm, 1 cm, 4 cm, 10 cm, 30 cm, 60 cm, 100 cm, 160 cm, and 300 cm. (For the old RUC LSM, there are only 6 layers, and if using this, you will need to change ``NSOIL`` for “RUC LSM” from 9 to 6 in the ``sorc/ncep_post.fd/WRFPOST.f`` routine.) - When using Pliem-Xiu LSM, there are two layers: 0-1 cm, 1-100 cm -- For low, mid, and high cloud layers, the layers are :math:`\geq`\ 642 hPa, :math:`\geq`\ 350 hPa, and - <350 hPa, respectively. +- For low, mid, and high cloud layers, the layers are :math:`\geq`\ 642 hPa, :math:`\geq`\ 350 hPa, and <350 hPa, respectively. - For PBL layer averages, the levels correspond to 6 layers with a thickness of 30 hPa each. -- For flight level, the levels are 30 m, 50 m, 80 m, 100 m, 305 m, 457 m, 610 m, 914 m, 1524 m, 1829 m, - 2134 m, 2743 m, 3658 m, 4572 m, 6000 m, 7010 m. +- For flight level, the levels are 30 m, 50 m, 80 m, 100 m, 305 m, 457 m, 610 m, 914 m, 1524 m, 1829 m, 2134 m, 2743 m, 3658 m, 4572 m, 6000 m, 7010 m. - For AGL radar reflectivity, the levels are 4000 and 1000 m. - For surface or shelter-level output, the ```` is not necessary. @@ -243,25 +229,16 @@ levels are currently available for output: Creating the Flat Text File --------------------------- -If the control file requires any modifications, a preprocessing step will be required by the user to -convert the modified XML file ``parm/postcntrl.xml`` to a flat text file -``parm/postxconfig-NT.txt``. The user will first need to edit the ``postcntrl.xml`` -file to declare which fields are to be output from the UPP. +If the control file requires any modifications, a preprocessing step will be required by the user to convert the modified XML file ``parm/postcntrl.xml`` to a flat text file ``parm/postxconfig-NT.txt``. The user will first need to edit the ``postcntrl.xml`` file to declare which fields are to be output from the UPP. -In order to ensure that the user-edited XML files are error free, XML stylesheets -(``parm/EMC_POST_CTRL_Schema.xsd`` and ``EMC_POST_Avblflds_Schema.xsd``) can -be used to validate both the ``postcntrl.xml`` and ``post_avblflds.xml`` files, -respectively. Confirmation of validation will be given (e.g., ``postcntrl.xml`` validates) or otherwise -return errors if it does not match the schema. This step is optional, but acts as a safeguard to avoid -run-time failures with the UPP. To run the validation: +In order to ensure that the user-edited XML files are error free, XML stylesheets (``parm/EMC_POST_CTRL_Schema.xsd`` and ``EMC_POST_Avblflds_Schema.xsd``) can be used to validate both the ``postcntrl.xml`` and ``post_avblflds.xml`` files respectively. Confirmation of validation will be given (e.g., ``postcntrl.xml`` validates) or otherwise return errors if it does not match the schema. This step is optional, but acts as a safeguard to avoid run-time failures with the UPP. To run the validation: .. code-block:: console xmllint --noout --schema EMC_POST_CTRL_Schema.xsd postcntrl.xml xmllint --noout --schema EMC_POST_Avblflds_Schema.xsd post_avblflds.xml -Once the XMLs are validated, the user will need to generate the flat file. The command below will run the -Perl program ``parm/PostXMLPreprocessor.pl`` to generate the post flat file: +Once the XMLs are validated, the user will need to generate the flat file. The command below will run the Perl program ``parm/PostXMLPreprocessor.pl`` to generate the post flat file: .. code-block:: console @@ -275,13 +252,11 @@ where ``your_user_defined_xml`` is your modified XML and ``your_user_defined_fla Output Files ============ -Upon a successful run, ``upp.x`` will generate GRIB2 output files in the post processor -working directory. These files will include all fields that were requested in the control file. +Upon a successful run, ``upp.x`` will generate GRIB2 output files in the post processor working directory. These files will include all fields that were requested in the control file. When running UPP standalone, the following GRIB2 output files will be generated: | **GFS Model**: ``GFSPRS.HHH`` | **LAM (Limited Area Model)**: ``NATLEV.HHH`` and ``PRSLEV.HHH`` -When executed with the provided run script, UPP provides log files in the post-processor working directory named -``upp.fHHH.out``, where ``HHH`` is the forecast hour. These log files may be consulted for further runtime information in the event of an error. +When executed with the provided run script, UPP provides log files in the post-processor working directory named ``upp.fHHH.out``, where ``HHH`` is the forecast hour. These log files may be consulted for further runtime information in the event of an error. From e2ccec6b80ecef7b7b653e3176a2937acfacc7ad Mon Sep 17 00:00:00 2001 From: Christina Holt Date: Fri, 26 Apr 2024 15:11:31 -0600 Subject: [PATCH 3/5] Fixes to compile docs. --- .../BuildingRunningTesting/InputsOutputs.rst | 41 +++++++++++-------- doc/UserGuide/Reference/Glossary.rst | 4 +- 2 files changed, 25 insertions(+), 20 deletions(-) diff --git a/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst b/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst index 8a4e0417f..4ade5b039 100644 --- a/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst +++ b/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst @@ -42,17 +42,14 @@ UFS Unified Model Variables ITAG ---- -The file called ``itag`` is a Fortran namelist file that contains two sections: ``&model_inputs`` describing the as well as the 2D decomposition specification in ``&nampgb``. It is read in by the ``upp.x`` executable from standard input (stdin -- unit 5) and is generated automatically within the UFS application workflow or standalone run script based on user-defined options. It should not be necessary to edit this file. For description purposes, the namelists ``&model_inputs`` and ``&nampgb`` (in the ``itag`` file) contain the following lines for FV3: +The file called ``itag`` is a Fortran namelist file that contains two sections: ``&model_inputs`` and ``&nampgb``. It is read in by the ``upp.x`` executable from standard input (stdin -- unit 5). Most UFS applications generate it automatically based on user-defined application-level options. All UPP namelist choices are described here. :bolditalic:`&model_inputs` -model_inputs -^^^^^^^^^^^^ - The ``&model_inputs`` section parameterizes choices about the set of model output files that will be used for the UPP .. list-table:: *Description of the &model_inputs namelist section.* - :widths: 25 40 15 10 + :widths: 15 40 20 20 :header-rows: 1 * - Variable Name @@ -62,11 +59,11 @@ The ``&model_inputs`` section parameterizes choices about the set of model outpu * - ``datestring`` - Time stamp being processed (e.g., 2022-08-02_19:00:00). - character(len=19) - - --- + - n/a * - ``fileName`` - Name of input dynamics file; name of full 3-D model output file. - character(len=256) - - --- + - n/a * - ``filenameflat`` - Input configuration text file defining the requested fields. - character(len=256) @@ -74,24 +71,32 @@ The ``&model_inputs`` section parameterizes choices about the set of model outpu * - ``filenameflux`` - Name of input physics file; name of 2-D model output file with physics and surface fields. - character(len=256) - - --- - * -``grib`` + - n/a + * - ``grib`` - Grib type (Note that UPP only supports Grib2 currently) - character(5) - grib2 * - ``ioform`` - Input file format. Choices: binary, binarympiio, binarynemsio, netcdf, netcdfpara - character(len=20) - - --- + - n/a * - ``modelname`` - Model name used by UPP internally (e.g., FV3R for LAM, GFS for GFS, NCAR for WRF) - character(len=4) - - --- + - n/a + +:bolditalic:`&nampgb` -.. list-table:: *Description of the ``&nampgb`` namelist section.* - :widths: 25 40 15 10 +The ``&nampgb`` section parameterizes choices concerning the processing done in UPP. + +.. list-table:: *Description of the &nampgb namelist section.* + :widths: 25 40 20 15 :header-rows: 1 + * - Variable Name + - Description + - Data Type + - Default Value * - ``aqf_on bool`` - Turn on Air Quality Forecasting (CMAQ-based) - logical @@ -104,10 +109,10 @@ The ``&model_inputs`` section parameterizes choices about the set of model outpu - Turn on option to use dynamic 3D fields from GFS - logical - .false. - * - ``fileNameAERi`` string + * - ``fileNameAER`` - aerosols file name - character(len=256) - - '''' + - "" * - ``gccpp_on`` - Turn on option to process the aerosol/chemical tracers related output from UFS-Chem (CCPP-Chem) model - logical @@ -172,10 +177,10 @@ The ``&model_inputs`` section parameterizes choices about the set of model outpu - List indicating isentropic level output - real,dimension(70) - (/310.,320.,350.,450.,550.,650.,(0.,k=kth+1,70)/) - * - ``vtimeunits string + * - ``vtimeunits`` - valid time units, default="", Choices: FMIN - character(len=4) - - '''' + - "" * - ``write_ifi_debug_files`` - Write debug files for In-Flight Icing (IFI), a restricted option in UPP - logical @@ -197,7 +202,7 @@ A default control file, ``postxconfig-NT.txt``, is provided and read by the UPP. .. _control-output: Selecting Which Variables the UPP Outputs -------------------------------------------- +----------------------------------------- To output a field, the body of the control file needs to contain an entry for the appropriate variable. If an entry for a particular field is not yet available in the control file, it may be added to the control file with the appropriate entries for that field. For variables found on vertical levels (e.g., isobaric or height levels), the desired levels to be output must be listed (see next section: :ref:`control_levels`). A list of available GRIB2 fields that can be output by UPP can be found in the table :doc:`../tables/UPP_GRIB2_Table_byID`. Please note that some fields are dependent on model, physics, and other fields. diff --git a/doc/UserGuide/Reference/Glossary.rst b/doc/UserGuide/Reference/Glossary.rst index 1c86e92df..491117679 100644 --- a/doc/UserGuide/Reference/Glossary.rst +++ b/doc/UserGuide/Reference/Glossary.rst @@ -42,7 +42,7 @@ Glossary The radar-indicated top of an area of precipitation. Specifically, it contains the height of the 18 dBZ reflectivity value. EMC - The `Environmental Modeling Center `__. + The `Environmental Modeling Center `__. EPIC The `Earth Prediction Innovation Center `__ seeks to accelerate scientific research and modeling contributions through continuous and sustained community engagement in order to produce the most accurate and reliable operational modeling system in the world. @@ -159,4 +159,4 @@ Glossary The sequence of steps required to run an experiment from start to finish. write component - The output files written by the UFS Weather Model use an Earth System Modeling Framework (ESMF) component, referred to as the write component because the UPP cannot directly process output on the native grid types (e.g., “GFDLgrid”, “ESGgrid”). Output fields are interpolated to a write component grid before writing them to an output file. \ No newline at end of file + The output files written by the UFS Weather Model use an Earth System Modeling Framework (ESMF) component, referred to as the write component because the UPP cannot directly process output on the native grid types (e.g., “GFDLgrid”, “ESGgrid”). Output fields are interpolated to a write component grid before writing them to an output file. From c12e1c61ecb1ecfdb559d910f40a68a60f5afc96 Mon Sep 17 00:00:00 2001 From: Christina Holt Date: Mon, 6 May 2024 12:53:32 -0600 Subject: [PATCH 4/5] Mods from review comments. --- .../BuildingRunningTesting/InputsOutputs.rst | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst b/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst index 4ade5b039..4f3a2074f 100644 --- a/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst +++ b/doc/UserGuide/BuildingRunningTesting/InputsOutputs.rst @@ -46,7 +46,7 @@ The file called ``itag`` is a Fortran namelist file that contains two sections: :bolditalic:`&model_inputs` -The ``&model_inputs`` section parameterizes choices about the set of model output files that will be used for the UPP +The ``&model_inputs`` section parameterizes choices about the set of model output files that will be used for the UPP. .. list-table:: *Description of the &model_inputs namelist section.* :widths: 15 40 20 20 @@ -56,11 +56,11 @@ The ``&model_inputs`` section parameterizes choices about the set of model outpu - Description - Data Type - Default Value - * - ``datestring`` + * - ``datestr`` - Time stamp being processed (e.g., 2022-08-02_19:00:00). - character(len=19) - n/a - * - ``fileName`` + * - ``filename`` - Name of input dynamics file; name of full 3-D model output file. - character(len=256) - n/a @@ -77,11 +77,11 @@ The ``&model_inputs`` section parameterizes choices about the set of model outpu - character(5) - grib2 * - ``ioform`` - - Input file format. Choices: binary, binarympiio, binarynemsio, netcdf, netcdfpara + - Input file format. Choices: binarynemsio or netcdf - character(len=20) - n/a * - ``modelname`` - - Model name used by UPP internally (e.g., FV3R for LAM, GFS for GFS, NCAR for WRF) + - Model name used by UPP internally (e.g., FV3R for RRFS, 3DRTMA, HAFS; GFS for GFS and GEFS; RAPR for RAP and HRRR; NMM for NAM) - character(len=4) - n/a @@ -97,7 +97,7 @@ The ``&nampgb`` section parameterizes choices concerning the processing done in - Description - Data Type - Default Value - * - ``aqf_on bool`` + * - ``aqf_on`` - Turn on Air Quality Forecasting (CMAQ-based) - logical - .false. @@ -109,7 +109,7 @@ The ``&nampgb`` section parameterizes choices concerning the processing done in - Turn on option to use dynamic 3D fields from GFS - logical - .false. - * - ``fileNameAER`` + * - ``filenameaer`` - aerosols file name - character(len=256) - "" From 72998516c22f7c18e19a3439c6d312a385b8ad61 Mon Sep 17 00:00:00 2001 From: Fernando Andrade - NOAA <121964418+FernandoAndrade-NOAA@users.noreply.github.com> Date: Tue, 7 May 2024 22:15:59 -0700 Subject: [PATCH 5/5] hera RTs passed --- tests/logs/rt.log.HERA | 112 ++++++++++++++++++++--------------------- 1 file changed, 56 insertions(+), 56 deletions(-) diff --git a/tests/logs/rt.log.HERA b/tests/logs/rt.log.HERA index ef6428ad1..e33aba15d 100644 --- a/tests/logs/rt.log.HERA +++ b/tests/logs/rt.log.HERA @@ -1,69 +1,69 @@ ===== Start of UPP Regression Testing Log ===== UPP Hash Tested: -297445ddce23dcd6cace15f89d777a5522b49d20 +f2d72f5e484ad8ba2a3e6bdba471d5a31eb3d64e Submodule hashes: -1ba8270870947b583cd51bc72ff8960f4c1fb36e sorc/libIFI.fd -567edcc94bc418d0dcd6cdaafed448eeb5aab570 sorc/ncep_post.fd/post_gtg.fd -Run directory: /scratch2/NAGAPE/epic/Fernando.Andrade-maldonado/regression-tests/upp/954/UPP/ci/rundir/upp-HERA +Run directory: /scratch2/NAGAPE/epic/Fernando.Andrade-maldonado/regression-tests/upp/940/UPP/ci/rundir/upp-HERA Baseline directory: /scratch2/NAGAPE/epic/UPP/test_suite -Total runtime: 00h:15m:30s -Test Date: 20240507 22:18:51 +Total runtime: 00h:14m:52s +Test Date: 20240508 04:54:12 Summary Results: -05/07 22:07:32Z -fv3r test: your new post executable generates bit-identical PRSLEV10.tm00 as the trunk -05/07 22:07:33Z -fv3gefs pe test: your new post executable generates bit-identical geaer.t00z.master.grb2f060 as the trunk -05/07 22:07:38Z -fv3r test: your new post executable generates bit-identical NATLEV10.tm00 as the trunk -05/07 22:07:42Z -rtma pe test: your new post executable generates bit-identical NATLEV00.tm00 as the trunk -05/07 22:07:45Z -rtma pe test: your new post executable generates bit-identical PRSLEV00.tm00 as the trunk -05/07 22:07:46Z -rtma pe test: your new post executable generates bit-identical IFIFIP00.tm00 as the trunk -05/07 22:07:51Z -rtma test: your new post executable generates bit-identical NATLEV00.tm00 as the trunk -05/07 22:07:57Z -rtma test: your new post executable generates bit-identical PRSLEV00.tm00 as the trunk -05/07 22:07:57Z -rtma test: your new post executable generates bit-identical IFIFIP00.tm00 as the trunk -05/07 22:08:22Z -fv3gefs test: your new post executable generates bit-identical geaer.t00z.master.grb2f060 as the trunk -05/07 22:08:24Z -hrrr test: your new post executable generates bit-identical WRFTWO.GrbF04 as the trunk -05/07 22:08:26Z -hrrr test: your new post executable generates bit-identical WRFPRS.GrbF04 as the trunk -05/07 22:08:26Z -fv3hafs test: your new post executable generates bit-identical HURPRS09.tm00 as the trunk -05/07 22:08:27Z -hrrr pe test: your new post executable generates bit-identical WRFTWO.GrbF04 as the trunk -05/07 22:08:28Z -hrrr test: your new post executable generates bit-identical WRFNAT.GrbF04 as the trunk -05/07 22:08:28Z -hrrr pe test: your new post executable generates bit-identical WRFPRS.GrbF04 as the trunk -05/07 22:08:30Z -hrrr pe test: your new post executable generates bit-identical WRFNAT.GrbF04 as the trunk -05/07 22:08:37Z -rap test: your new post executable generates bit-identical WRFPRS.GrbF16 as the trunk -05/07 22:08:39Z -rap test: your new post executable generates bit-identical WRFNAT.GrbF16 as the trunk -05/07 22:08:42Z -fv3hafs pe test: your new post executable generates bit-identical HURPRS09.tm00 as the trunk -05/07 22:09:17Z -fv3r pe test: your new post executable generates bit-identical PRSLEV10.tm00 as the trunk -05/07 22:09:23Z -fv3r pe test: your new post executable generates bit-identical NATLEV10.tm00 as the trunk -05/07 22:09:38Z -rap pe test: your new post executable did generate changed results in WRFPRS.GrbF16 -05/07 22:09:39Z -rap pe test: your new post executable generates bit-identical WRFNAT.GrbF16 as the trunk -05/07 22:09:53Z -nmmb pe test: your new post executable generates bit-identical BGDAWP03.tm00.Grib2 as the trunk -05/07 22:09:55Z -nmmb pe test: your new post executable generates bit-identical BGRD3D03.tm00.Grib2 as the trunk -05/07 22:09:56Z -nmmb pe test: your new post executable generates bit-identical BGRDSF03.tm00.Grib2 as the trunk -05/07 22:09:57Z -nmmb test: your new post executable generates bit-identical BGDAWP03.tm00.Grib2 as the trunk -05/07 22:10:00Z -nmmb test: your new post executable generates bit-identical BGRD3D03.tm00.Grib2 as the trunk -05/07 22:10:00Z -nmmb test: your new post executable generates bit-identical BGRDSF03.tm00.Grib2 as the trunk -05/07 22:17:39Z gfs_post_00.24800-fv3gfs test: your new post executable generates bit-identical gfs.t00z.master.grb2f006 as the trunk -05/07 22:17:40Z gfs_post_00.24800-fv3gfs test: your new post executable generates bit-identical gfs.t00z.sfluxgrbf006.grib2 as the trunk -05/07 22:17:40Z gfs_post_00.24800-fv3gfs test: your new post executable generates bit-identical gfs.t00z.special.grb2f006 as the trunk -05/07 22:18:36Z gfs_post_00.70895-fv3gfs pe test: your new post executable generates bit-identical gfs.t00z.master.grb2f006 as the trunk -05/07 22:18:37Z gfs_post_00.70895-fv3gfs pe test: your new post executable generates bit-identical gfs.t00z.sfluxgrbf006.grib2 as the trunk -05/07 22:18:37Z gfs_post_00.70895-fv3gfs pe test: your new post executable generates bit-identical gfs.t00z.special.grb2f006 as the trunk -05/07 22:10:11Z -Runtime: nmmb_test 00:01:35 -- baseline 00:01:00 -05/07 22:10:12Z -Runtime: nmmb_pe_test 00:01:31 -- baseline 00:01:00 -05/07 22:10:12Z -Runtime: fv3gefs_test 00:00:22 -- baseline 00:40:00 -05/07 22:10:13Z -Runtime: fv3gefs_pe_test 00:00:32 -- baseline 00:40:00 -05/07 22:10:13Z -Runtime: rap_test 00:01:03 -- baseline 00:02:00 -05/07 22:10:13Z -Runtime: rap_pe_test 00:01:14 -- baseline 00:02:00 -05/07 22:10:14Z -Runtime: hrrr_test 00:02:32 -- baseline 00:02:00 -05/07 22:10:14Z -Runtime: hrrr_pe_test 00:01:52 -- baseline 00:02:00 -05/07 22:17:48Z -Runtime: fv3gfs_test 00:11:44 -- baseline 00:15:00 -05/07 22:18:49Z -Runtime: fv3gfs_pe_test 00:12:41 -- baseline 00:15:00 -05/07 22:18:49Z -Runtime: fv3r_test 00:01:42 -- baseline 00:03:00 -05/07 22:18:50Z -Runtime: fv3r_pe_test 00:01:43 -- baseline 00:03:00 -05/07 22:18:50Z -Runtime: fv3hafs_test 00:00:38 -- baseline 00:03:00 -05/07 22:18:50Z -Runtime: fv3hafs_pe_test 00:00:42 -- baseline 00:03:00 -05/07 22:18:51Z -Runtime: rtma_test 00:02:01 -- baseline 00:03:00 -05/07 22:18:51Z -Runtime: rtma_test_pe_test 00:01:50 -- baseline +05/08 04:42:43Z -fv3gefs pe test: your new post executable generates bit-identical geaer.t00z.master.grb2f060 as the trunk +05/08 04:42:45Z -fv3hafs test: your new post executable generates bit-identical HURPRS09.tm00 as the trunk +05/08 04:42:54Z -fv3gefs test: your new post executable generates bit-identical geaer.t00z.master.grb2f060 as the trunk +05/08 04:42:54Z -fv3hafs pe test: your new post executable generates bit-identical HURPRS09.tm00 as the trunk +05/08 04:43:19Z -rap test: your new post executable generates bit-identical WRFPRS.GrbF16 as the trunk +05/08 04:43:20Z -rap test: your new post executable generates bit-identical WRFNAT.GrbF16 as the trunk +05/08 04:43:47Z -fv3r test: your new post executable generates bit-identical PRSLEV10.tm00 as the trunk +05/08 04:43:49Z -rap pe test: your new post executable did generate changed results in WRFPRS.GrbF16 +05/08 04:43:50Z -rap pe test: your new post executable generates bit-identical WRFNAT.GrbF16 as the trunk +05/08 04:43:53Z -fv3r test: your new post executable generates bit-identical NATLEV10.tm00 as the trunk +05/08 04:43:54Z -fv3r pe test: your new post executable generates bit-identical PRSLEV10.tm00 as the trunk +05/08 04:43:56Z -rtma pe test: your new post executable generates bit-identical NATLEV00.tm00 as the trunk +05/08 04:43:59Z -nmmb pe test: your new post executable generates bit-identical BGDAWP03.tm00.Grib2 as the trunk +05/08 04:43:59Z -fv3r pe test: your new post executable generates bit-identical NATLEV10.tm00 as the trunk +05/08 04:44:00Z -rtma pe test: your new post executable generates bit-identical PRSLEV00.tm00 as the trunk +05/08 04:44:00Z -rtma pe test: your new post executable generates bit-identical IFIFIP00.tm00 as the trunk +05/08 04:44:01Z -nmmb pe test: your new post executable generates bit-identical BGRD3D03.tm00.Grib2 as the trunk +05/08 04:44:01Z -rtma test: your new post executable generates bit-identical NATLEV00.tm00 as the trunk +05/08 04:44:01Z -nmmb pe test: your new post executable generates bit-identical BGRDSF03.tm00.Grib2 as the trunk +05/08 04:44:02Z -hrrr pe test: your new post executable generates bit-identical WRFTWO.GrbF04 as the trunk +05/08 04:44:03Z -nmmb test: your new post executable generates bit-identical BGDAWP03.tm00.Grib2 as the trunk +05/08 04:44:03Z -hrrr pe test: your new post executable generates bit-identical WRFPRS.GrbF04 as the trunk +05/08 04:44:04Z -rtma test: your new post executable generates bit-identical PRSLEV00.tm00 as the trunk +05/08 04:44:05Z -rtma test: your new post executable generates bit-identical IFIFIP00.tm00 as the trunk +05/08 04:44:05Z -nmmb test: your new post executable generates bit-identical BGRD3D03.tm00.Grib2 as the trunk +05/08 04:44:05Z -nmmb test: your new post executable generates bit-identical BGRDSF03.tm00.Grib2 as the trunk +05/08 04:44:06Z -hrrr pe test: your new post executable generates bit-identical WRFNAT.GrbF04 as the trunk +05/08 04:44:32Z -hrrr test: your new post executable generates bit-identical WRFTWO.GrbF04 as the trunk +05/08 04:44:33Z -hrrr test: your new post executable generates bit-identical WRFPRS.GrbF04 as the trunk +05/08 04:44:35Z -hrrr test: your new post executable generates bit-identical WRFNAT.GrbF04 as the trunk +05/08 04:53:35Z gfs_post_00.139644-fv3gfs test: your new post executable generates bit-identical gfs.t00z.master.grb2f006 as the trunk +05/08 04:53:36Z gfs_post_00.139644-fv3gfs test: your new post executable generates bit-identical gfs.t00z.sfluxgrbf006.grib2 as the trunk +05/08 04:53:36Z gfs_post_00.139644-fv3gfs test: your new post executable generates bit-identical gfs.t00z.special.grb2f006 as the trunk +05/08 04:54:02Z gfs_post_00.230422-fv3gfs pe test: your new post executable generates bit-identical gfs.t00z.master.grb2f006 as the trunk +05/08 04:54:02Z gfs_post_00.230422-fv3gfs pe test: your new post executable generates bit-identical gfs.t00z.sfluxgrbf006.grib2 as the trunk +05/08 04:54:02Z gfs_post_00.230422-fv3gfs pe test: your new post executable generates bit-identical gfs.t00z.special.grb2f006 as the trunk +05/08 04:44:19Z -Runtime: nmmb_test 00:01:28 -- baseline 00:01:00 +05/08 04:44:19Z -Runtime: nmmb_pe_test 00:01:24 -- baseline 00:01:00 +05/08 04:44:19Z -Runtime: fv3gefs_test 00:00:17 -- baseline 00:40:00 +05/08 04:44:19Z -Runtime: fv3gefs_pe_test 00:00:30 -- baseline 00:40:00 +05/08 04:44:20Z -Runtime: rap_test 00:01:07 -- baseline 00:02:00 +05/08 04:44:20Z -Runtime: rap_pe_test 00:01:13 -- baseline 00:02:00 +05/08 04:44:35Z -Runtime: hrrr_test 00:02:22 -- baseline 00:02:00 +05/08 04:44:36Z -Runtime: hrrr_pe_test 00:02:17 -- baseline 00:02:00 +05/08 04:53:40Z -Runtime: fv3gfs_test 00:11:47 -- baseline 00:15:00 +05/08 04:54:10Z -Runtime: fv3gfs_pe_test 00:12:13 -- baseline 00:15:00 +05/08 04:54:11Z -Runtime: fv3r_test 00:02:00 -- baseline 00:03:00 +05/08 04:54:11Z -Runtime: fv3r_pe_test 00:01:51 -- baseline 00:03:00 +05/08 04:54:11Z -Runtime: fv3hafs_test 00:00:52 -- baseline 00:03:00 +05/08 04:54:12Z -Runtime: fv3hafs_pe_test 00:00:41 -- baseline 00:03:00 +05/08 04:54:12Z -Runtime: rtma_test 00:01:52 -- baseline 00:03:00 +05/08 04:54:12Z -Runtime: rtma_test_pe_test 00:02:07 -- baseline No changes in test results detected. ===== End of UPP Regression Testing Log =====