ufs-community · jkbk2004 · Jul 7, 2022 · Mar 27, 2021 · Mar 27, 2021 · Mar 27, 2021
diff --git a/doc/UsersGuide/source/InputsOutputs.rst b/doc/UsersGuide/source/InputsOutputs.rst
@@ -649,6 +649,41 @@ The OUTPARS_WAV defines gridded output fields. The GOFILETYPE, POFILETYPE and RS
 
 No initial condition files are required for WW3.
 
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+Mesh generation
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+For coupled applications using the CMEPS mediator, an ESMF Mesh file describing the WW3 domain is required. For regional and sub-global domains, the mesh can be created using a two-step procedure.
+
+1. Generate a SCRIP format file for the domain
+2. Generate the ESMF Mesh.
+
+In each case, the SCRIP file needs to be checked that it contains the right start and end latitudes and longitudes to match the mod_def file being used.
+
+For the HAFS regional domain, the following commands can be used:
+
+.. code-block:: console
+
+   ncremap -g hafswav.SCRIP.nc -G latlon=441,901#snwe=1.45,45.55,-98.05,-7.95#lat_typ=uni#lat_drc=s2n
+   ESMF_Scrip2Unstruct hafswav.SCRIP.nc mesh.hafs.nc 0
+
+For the sub-global 1-deg domain extending from latitude 85.0S
+
+.. code-block:: console
+
+   ncremap -g glo_1deg.SCRIP.nc -G latlon=171,360#snwe=-85.5,85.5,-0.5,359.5#lat_typ=uni#lat_drc=s2n
+   ESMF_Scrip2Unstruct glo_1deg.SCRIP.nc mesh.glo_1deg.nc 0
+
+For the sub-global 1/2-deg domain extending from latitude 80.0S
+
+.. code-block:: console
+
+   ncremap -g gwes_30m.SCRIP.nc -G latlon=321,720#snwe=-80.25,80.25,-0.25,359.75#lat_typ=uni#lat_drc=s2n
+   ESMF_Scrip2Unstruct gwes_30m.SCRIP.nc mesh.gwes_30m.nc 0
+
+For the tripole grid, the mesh file is generated as part of the cpld_gridgen utility in
+`UFS_UTILS <https://ufs-community.github.io/UFS_UTILS/cpld_gridgen/index.html>`__.
+
 -------
 CDEPS
 -------
@@ -769,7 +804,7 @@ The static input files for GOCART configurations are listed and described in :nu
    * - GOCART2G_GridComp.rc
      - The basic properties of the GOCART2G Grid Components
    * - NI2G_instance_NI.rc
-     - Resource file for Nitrate parameters               
+     - Resource file for Nitrate parameters
    * - SS2G_instance_SS.rc
      - Resource file for Sea Salt parameters
    * - SU2G_instance_SU.rc
@@ -785,22 +820,22 @@ GOCART inputs defined in AERO_ExtData are listed and described in :numref:`Table
 
    * - Filename
      - Description
-   * - ExtData/dust 
+   * - ExtData/dust
      - FENGSHA input files
    * - ExtData/QFED
-     - QFED biomass burning emissions     
+     - QFED biomass burning emissions
    * - ExtData/CEDS
      - Anthropogenic emissions
    * - ExtData/MERRA2
      - DMS concentration
    * - ExtData/PIESA/sfc
      - Aviation emissions
    * - ExtData/PIESA/L127
-     - H2O2, OH and NO3 mixing ratios     
+     - H2O2, OH and NO3 mixing ratios
    * - ExtData/MEGAN_OFFLINE_BVOC
      - VOCs MEGAN biogenic emissions
    * - ExtData/monochromatic
-     - Aerosol monochromatic optics files 
+     - Aerosol monochromatic optics files
    * - ExtData/optics
      - Aerosol radiation bands optic files for RRTMG
    * - ExtData/volcanic
@@ -815,11 +850,11 @@ The static input files when using climatology (MERRA2) are listed and described
    :header-rows: 1
 
    * - Filename
-     - Description             
+     - Description
    * - merra2.aerclim.2003-2014.m$(month).nc
-     - MERRA2 aerosol climatology mixing ratio 
+     - MERRA2 aerosol climatology mixing ratio
    * - Optics_BC.dat
-     - BC optical look-up table for MERAA2 
+     - BC optical look-up table for MERAA2
    * - Optics_DU.dat
      - DUST optical look-up table for MERAA2
    * - Optics_OC.dat
@@ -833,7 +868,7 @@ The static input files when using climatology (MERRA2) are listed and described
 Grid description and initial condition files
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-Running GOCART in UFS does not require aerosol initial conditions, as aerosol models can always start from scratch (cold start), however, this approach does require more than two weeks of model spin-up to obtain reasonable aerosol simulation results. 
+Running GOCART in UFS does not require aerosol initial conditions, as aerosol models can always start from scratch (cold start), however, this approach does require more than two weeks of model spin-up to obtain reasonable aerosol simulation results.
 
 Therefore, the most popular method is to take previous aerosol simulation results. The result is not necessarily from the same model, it could be from a climatology result, such as MERAA2, or a different model but with the same aerosol species and bin/size distribution.
 
@@ -1854,7 +1889,7 @@ For the fully coupled S2S application that receives atmosphere-ocean fluxes from
           ProfileMemory = false
           OverwriteSlice = true
           mesh_ice = mesh.mx025.nc
-          stop_n = 840 
+          stop_n = 840
           stop_option = nhours
           stop_ymd = -999
         ::

diff --git a/doc/UsersGuide/source/Introduction.rst b/doc/UsersGuide/source/Introduction.rst
@@ -39,9 +39,9 @@ for those elements, are listed below:
 
 The UFS Weather Model is currently included in two UFS Application releases.  These UFS Apps also contain pre- and post-processing components, a comprehensive build system, and workflows for configuration and execution of the application.
 
-The UFS WM v2.0 is included as part of the UFS Short Range Weather App, and details can be found `here <https://ufs-srweather-app.readthedocs.io/en/ufs-v1.0.0>`_.
+The UFS WM v2.0 is included as part of the UFS Short Range Weather App, and details can be found `here <https://ufs-srweather-app.readthedocs.io/en/ufs-v1.0.0>`__.
 
-The UFS WM v1.1 and v1.0 is included as part of the UFS Medium Range Weather App, and details can be found `here <https://ufs-mrweather-app.readthedocs.io/en/ufs-v1.1.0>`_.
+The UFS WM v1.1 and v1.0 is included as part of the UFS Medium Range Weather App, and details can be found `here <https://ufs-mrweather-app.readthedocs.io/en/ufs-v1.1.0>`__.
 
 The UFS WM v2 code is portable and can be used with Linux and Mac operating systems with Intel and GNU compilers. It has been tested in a variety of platforms widely used by atmospheric scientists, such as the NOAA research Hera system, the National Center for Atmospheric Research (NCAR) Cheyenne system, the National Science Foundation Stampede system, and Mac laptops.
 

diff --git a/tests/OpnReqTests_cpld_bmark_p8_hera.intel.log b/tests/OpnReqTests_cpld_bmark_p8_hera.intel.log
@@ -1,10 +1,10 @@
-Thu May 26 16:42:22 UTC 2022
+Tue Jun 28 15:16:53 UTC 2022
 Start Operation Requirement Test
 
-Compile std elapsed time 549 seconds. -DAPP=S2SWA -DCCPP_SUITES=FV3_GFS_v17_coupled_p8 -DMPI=ON -DCMAKE_BUILD_TYPE=Release -DMOM6SOLO=ON
+Compile std elapsed time 574 seconds. -DAPP=S2SWA -DCCPP_SUITES=FV3_GFS_v17_coupled_p8,FV3_GFS_cpld_rasmgshocnsstnoahmp_ugwp -DMPI=ON -DCMAKE_BUILD_TYPE=Release -DMOM6SOLO=ON
 
-baseline dir = /scratch1/NCEPDEV/stmp4/Minsuk.Ji/FV3_OPNREQ_TEST/OPNREQ_TEST/cpld_bmark_p8_std_base
-working dir  = /scratch1/NCEPDEV/stmp2/Minsuk.Ji/FV3_OPNREQ_TEST/opnReqTest_11070/cpld_bmark_p8_dcp
+baseline dir = /scratch1/NCEPDEV/stmp4/Denise.Worthen/FV3_OPNREQ_TEST/OPNREQ_TEST/cpld_bmark_p8_std_base
+working dir  = /scratch1/NCEPDEV/stmp2/Denise.Worthen/FV3_OPNREQ_TEST/opnReqTest_20914/cpld_bmark_p8_dcp
 Checking test dcp cpld_bmark_p8 results ....
  Comparing sfcf006.nc .........OK
  Comparing atmf006.nc .........OK
@@ -50,14 +50,14 @@ Checking test dcp cpld_bmark_p8 results ....
  Comparing 20130401.060000.out_pnt.ww3 .........OK
  Comparing 20130401.060000.out_grd.ww3 .........OK
 
-  0: The total amount of wall time                        = 1212.457555
-  0: The maximum resident set size (KB)                   = 5658120
+  0: The total amount of wall time                        = 1201.895177
+  0: The maximum resident set size (KB)                   = 5665940
 
 Test dcp cpld_bmark_p8 PASS
 
 
-baseline dir = /scratch1/NCEPDEV/stmp4/Minsuk.Ji/FV3_OPNREQ_TEST/OPNREQ_TEST/cpld_bmark_p8_std_base
-working dir  = /scratch1/NCEPDEV/stmp2/Minsuk.Ji/FV3_OPNREQ_TEST/opnReqTest_11070/cpld_bmark_p8_rst
+baseline dir = /scratch1/NCEPDEV/stmp4/Denise.Worthen/FV3_OPNREQ_TEST/OPNREQ_TEST/cpld_bmark_p8_std_base
+working dir  = /scratch1/NCEPDEV/stmp2/Denise.Worthen/FV3_OPNREQ_TEST/opnReqTest_20914/cpld_bmark_p8_rst
 Checking test rst cpld_bmark_p8 results ....
  Comparing 20130401.060000.out_grd.ww3 .........OK
  Comparing 20130401.060000.out_pnt.ww3 .........OK
@@ -103,14 +103,14 @@ Checking test rst cpld_bmark_p8 results ....
  Comparing RESTART/ufs.cpld.cpl.r.2013-04-01-21600.nc .........OK
  Comparing sfcf006.nc .........OK
 
-  0: The total amount of wall time                        = 757.420850
-  0: The maximum resident set size (KB)                   = 5615572
+  0: The total amount of wall time                        = 754.342600
+  0: The maximum resident set size (KB)                   = 5607952
 
 Test rst cpld_bmark_p8 PASS
 
 
-baseline dir = /scratch1/NCEPDEV/stmp4/Minsuk.Ji/FV3_OPNREQ_TEST/OPNREQ_TEST/cpld_bmark_p8_std_base
-working dir  = /scratch1/NCEPDEV/stmp2/Minsuk.Ji/FV3_OPNREQ_TEST/opnReqTest_11070/cpld_bmark_p8_std_base
+baseline dir = /scratch1/NCEPDEV/stmp4/Denise.Worthen/FV3_OPNREQ_TEST/OPNREQ_TEST/cpld_bmark_p8_std_base
+working dir  = /scratch1/NCEPDEV/stmp2/Denise.Worthen/FV3_OPNREQ_TEST/opnReqTest_20914/cpld_bmark_p8_std_base
 Checking test std_base cpld_bmark_p8 results ....
 Moving baseline std_base cpld_bmark_p8 files ....
  Moving sfcf006.nc .........OK
@@ -157,14 +157,14 @@ Moving baseline std_base cpld_bmark_p8 files ....
  Moving 20130401.060000.out_pnt.ww3 .........OK
  Moving 20130401.060000.out_grd.ww3 .........OK
 
-  0: The total amount of wall time                        = 1206.188040
-  0: The maximum resident set size (KB)                   = 5654532
+  0: The total amount of wall time                        = 1196.638854
+  0: The maximum resident set size (KB)                   = 5653276
 
 Test std_base cpld_bmark_p8 PASS
 
 
-baseline dir = /scratch1/NCEPDEV/stmp4/Minsuk.Ji/FV3_OPNREQ_TEST/OPNREQ_TEST/cpld_bmark_p8_std_base
-working dir  = /scratch1/NCEPDEV/stmp2/Minsuk.Ji/FV3_OPNREQ_TEST/opnReqTest_11070/cpld_bmark_p8_thr
+baseline dir = /scratch1/NCEPDEV/stmp4/Denise.Worthen/FV3_OPNREQ_TEST/OPNREQ_TEST/cpld_bmark_p8_std_base
+working dir  = /scratch1/NCEPDEV/stmp2/Denise.Worthen/FV3_OPNREQ_TEST/opnReqTest_20914/cpld_bmark_p8_thr
 Checking test thr cpld_bmark_p8 results ....
  Comparing sfcf006.nc .........OK
  Comparing atmf006.nc .........OK
@@ -210,11 +210,11 @@ Checking test thr cpld_bmark_p8 results ....
  Comparing 20130401.060000.out_pnt.ww3 .........OK
  Comparing 20130401.060000.out_grd.ww3 .........OK
 
-  0: The total amount of wall time                        = 1140.976795
-  0: The maximum resident set size (KB)                   = 5940432
+  0: The total amount of wall time                        = 1141.177047
+  0: The maximum resident set size (KB)                   = 5936356
 
 Test thr cpld_bmark_p8 PASS
 
 OPERATION REQUIREMENT TEST WAS SUCCESSFUL
-Thu May 26 18:03:46 UTC 2022
-Elapsed time: 01h:21m:25s. Have a nice day!
+Tue Jun 28 16:30:34 UTC 2022
+Elapsed time: 01h:13m:41s. Have a nice day!