Merge branch 'scidoc_v7' into scidoc_v7_gjf

Author: grantfirl

physics/GWD/drag_suite.F90

@@ -1,14 +1,12 @@
 !> \file drag_suite.F90
-!! This file is the  parameterization of orographic gravity wave
+!! This file is the  parameterization of orographic drag
 !! drag, mountain blocking, and form drag.
 
-!> This module contains the orographic gravity wave drag scheme
+!> This module contains the orographic drag scheme
       module drag_suite
 
       contains
 
-!> \brief This subroutine initializes the orographic gravity wave drag scheme.
-!!
 !> \section arg_table_drag_suite_init Argument Table
 !! \htmlinclude drag_suite_init.html
 !!
@@ -32,7 +30,7 @@ subroutine drag_suite_init(gwd_opt, errmsg, errflg)
       end if        
       end subroutine drag_suite_init
 
-!> \brief This subroutine includes orographic gravity wave drag, mountain
+!> This subroutine includes orographic drag, mountain
 !! blocking, and form drag.
 !!
 !> The time tendencies of zonal and meridional wind are altered to
@@ -43,7 +41,7 @@ end subroutine drag_suite_init
 !> \section arg_table_drag_suite_run Argument Table
 !! \htmlinclude drag_suite_run.html
 !!
-!> \section gen_drag_suite GFS Orographic GWD Scheme General Algorithm
+!> \section gen_drag_suite Orographic drag Scheme General Algorithm
 !! -# Calculate subgrid mountain blocking
 !! -# Calculate orographic wave drag
 !!

physics/docs/pdftxt/GFS_UGWPV1_ORO.txt

@@ -2,7 +2,7 @@
 \page GFS_drag_suite Orographic Drag Scheme
 \section des_drag  Description
 
-The  orographic drag suite, developed by NOAA's Global Systems Laboratory, Physical Sciences Laboratory and Environmental Modeling Center  is a set of subgrid-scale orographic drag parameterizations that calculate momentum tendencies due to the effects of unresolved topography.  The drag forces they represent are those due to: 1) meso-scale gravity (mountain) waves that propagate vertically and break in the free atmosphere of the troposphere, stratosphere and above; 2) low-level flow blocking; 3) turbulent orographic form drag (TOFD), which is generated by turbulent pressure perturbations that are correlated with the terrain slope. The distinction between the meso-scale and turbulent-scale gravity waves are that the former are generated by topography with horizontal scales on the order of 5 km and greater, which can support vertical propagation through the typical static stabilities found in the free atmosphere, while the latter are generated by topography with smaller horizontal scales down to about 1 km.
+The  orographic drag scheme, developed by NOAA's Global Systems Laboratory, Physical Sciences Laboratory and Environmental Modeling Center  is a set of subgrid-scale orographic drag parameterizations that calculate momentum tendencies due to the effects of unresolved topography.  The drag forces they represent are those due to: 1) meso-scale gravity (mountain) waves that propagate vertically and break in the free atmosphere of the troposphere, stratosphere and above; 2) low-level flow blocking; 3) turbulent orographic form drag (TOFD), which is generated by turbulent pressure perturbations that are correlated with the terrain slope. The distinction between the meso-scale and turbulent-scale gravity waves are that the former are generated by topography with horizontal scales on the order of 5 km and greater, which can support vertical propagation through the typical static stabilities found in the free atmosphere, while the latter are generated by topography with smaller horizontal scales down to about 1 km.
 
 The GWD and flow-blocking scheme is based on Kim and Doyle (2005) \cite kim_and_doyle_2005 and Choi and Hong (2015)\cite choi_and_hong_2015 and its code originated from the NCAR Weather Research and Forecasting (WRF) model that was implemented by S. Hong.  The TOFD scheme is adapted from Beljaars et al. (2004)\cite beljaars_et_al_2004.
 

physics/docs/pdftxt/GFS_drag_suite.txt

@@ -2,7 +2,7 @@
 \page GFS_drag_suite Orographic Drag Scheme
 \section des_drag  Description
 
-The  orographic drag suite, developed by NOAA's Global Systems Laboratory, Physical Sciences Laboratory and Environmental Modeling Center  is a set of subgrid-scale orographic drag parameterizations that calculate momentum tendencies due to the effects of unresolved topography.  The drag forces they represent are those due to: 1) large-scale gravity (mountain) waves that propagate vertically and break in the free atmosphere of the troposphere, stratosphere and above; 2) low-level flow blocking; 3) small-scale gravity wave drag (GWD) due to mountain waves generated in stable planetary boundary layer (PBL) conditions, typically at nighttime, which break at or near the PBL top; and 4) turbulent orographic form drag (TOFD), which is generated by turbulent pressure perturbations that are correlated with the terrain slope.  The distinction between the large-scale and small-scale gravity waves are that the former are generated by topography with horizontal scales on the order of 5 km and greater, which can support vertical propagation through the typical static stabilities found in the free atmosphere, while the latter are generated by topography with smaller horizontal scales down to about 1 km, which can support vertical propagation only in very stable conditions, typically found in nocturnal PBLs.
+The  orographic drag scheme, developed by NOAA's Global Systems Laboratory, Physical Sciences Laboratory and Environmental Modeling Center  is a set of subgrid-scale orographic drag parameterizations that calculate momentum tendencies due to the effects of unresolved topography.  The drag forces they represent are those due to: 1) large-scale gravity (mountain) waves that propagate vertically and break in the free atmosphere of the troposphere, stratosphere and above; 2) low-level flow blocking; 3) small-scale gravity wave drag (GWD) due to mountain waves generated in stable planetary boundary layer (PBL) conditions, typically at nighttime, which break at or near the PBL top; and 4) turbulent orographic form drag (TOFD), which is generated by turbulent pressure perturbations that are correlated with the terrain slope.  The distinction between the large-scale and small-scale gravity waves are that the former are generated by topography with horizontal scales on the order of 5 km and greater, which can support vertical propagation through the typical static stabilities found in the free atmosphere, while the latter are generated by topography with smaller horizontal scales down to about 1 km, which can support vertical propagation only in very stable conditions, typically found in nocturnal PBLs.
 
 The large-scale GWD scheme is based on Kim and Doyle (2005) \cite kim_and_doyle_2005 and Choi and Hong (2015)\cite choi_and_hong_2015 and the code originated from the NCAR Weather Research and Forecasting (WRF) model and NOAA RAP/HRRR.  The low-level blocking scheme is adapted from Kim and Doyle (2005)\cite kim_and_doyle_2005, with the code also originating from the WRF and RAP/HRRR.  The small-scale orographic GWD scheme is based on Steeneveld et al.(2008)\cite steeneveld_et_al_2008 and Tsiringakis et al. (2017) \cite tsiringakis_et_al_2017, and the TOFD scheme is adapted from Beljaars et al. (2004)\cite beljaars_et_al_2004.
 

physics/docs/pdftxt/ccppv7_phy_updates.txt

@@ -17,7 +17,7 @@ Suites GFS_v17_p8, HRRR, RRFS_v1beta, and RAP, which were supported with CCPP v6
 The updates between GFSv16 and GFSv17 are carefully outlined in Bengtsson and Han (2024)(submitted to \a Weather \a and \a Forecasting). The main updates include:
 - Implementation of a positive definition mass-flux scheme and a method for removing the negative tracers (Han et al. 2022 \cite Han_et_al_2022)
 - Introduction of a new closure based on a prognostic evolution of the convective updraft area fraction in both shallow and deep convection (Bengtsson et al. 2022 \cite Bengtsson_2022)
-- Introduction of 3D effects of cold-pool dynamics and stochastic initiation using self-organizing cellular automata stochastic convective organization scheme (not supported; Bengtsson et al. 2021 \cite bengtsson_et_al_2021)
+- Introduction of 3D effects of cold-pool dynamics and stochastic initiation using self-organizing cellular automata stochastic convective organization scheme (not supported in SCM; Bengtsson et al. 2021 \cite bengtsson_et_al_2021)
 - Introduction of environmental wind shear effect and subgrid TKE dependence in convection, to seek improvements in hurricane forecast prediction (Han et al. 2024 \cite Han_2024)
 - Introduction of stricter convective initiation criteria to allow for more CAPE to build up to address a low CAPE bias in GFSv16 (Han et al. 2021 \cite han_2021)
 - Reduction of convective rain evaporation rate to address a systematic cold bias near the surface in GFSv16 (Han et al. 2021 \cite han_2021)

physics/docs/pdftxt/suite_input.nml.txt

@@ -495,6 +495,7 @@ show some variables in the namelist that must match the SDF.
 <tr><td>knob_ugwp_effac   <td>cires_ugwp                 <td>four-dimensional array that control efficiency of GWs triggerd by four types of physics-based sources. \n
                                                              Default values: 1.,1.,1.,1. - reflect that calculated GW-tendencies will be applied for the model state.
                                                          <td>1.,1.,1.,1.
+<tr><td>knob_ugwp_tauamp  <td>ugwpv1_gsldrag                <td>amplitude for GEOS-5/MERRA-2    <td>7.75e-3
 <tr><td>launch_level      <td>cires_ugwp                 <td>parameter has been introduced by EMC during implementation. It defines the interface model level from the surface at which NGWs are launched. \n
                                                              Default value for FV3GFS-64L, launch_level=25 and for FV3GFS-128L, launch_level=52.
                                                          <td>55