add preliminary satmedmfvdifq documentation

physics/docs/ccpp_doxyfile

@@ -113,6 +113,7 @@ INPUT                  =  pdftxt/mainpage.txt     \
                           pdftxt/GFS_SFCSICE.txt  \
                           pdftxt/GFS_HEDMF.txt    \
                           pdftxt/GFS_SATMEDMF.txt    \
+                          pdftxt/GFS_SATMEDMFVDIFQ.txt \
                           pdftxt/GFS_GWDPS.txt    \
                           pdftxt/GFS_OZPHYS.txt   \
                           pdftxt/GFS_H2OPHYS.txt  \
@@ -189,6 +190,11 @@ INPUT                  =  pdftxt/mainpage.txt     \
                         ../mfpblt.f         \
                         ../mfscu.f          \
                         ../tridi.f          \
+### satmedmfvdifq
+                        ../satmedmfvdifq.F \
+                        ../mfpbltq.f         \
+                        ../mfscuq.f          \
+                        ../tridi.f          \
 ### Orographic Gravity Wave
                         ../gwdps.f \
 ### Rayleigh Dampling

physics/docs/pdftxt/GFS_SATMEDMFVDIFQ.txt

@@ -0,0 +1,35 @@
+/**
+\page GFS_SATMEDMFVDIFQ GFS Scale-aware TKE-based Moist Eddy-Diffusion Mass-Flux (EDMF) PBL and Free Atmospheric Turbulence Scheme
+\section des_satmedmfvdifq Description
+
+The current operational \ref GFS_HEDMF uses a hybrid EDMF parameterization for the convective PBL (Han et al. 2016 \cite Han_2016;
+Han et al. 2017 \cite han_et_al_2017), where the EDMF scheme is applied only for the strongly unstable PBL, while the eddy-diffusivity
+counter-gradient(EDCG) scheme is used for the weakly unstable PBL. The new TKE-EDMF is an extended version of \ref GFS_HEDMF  with below enhancement:
+
+-# Eddy diffusivity (K) is now a function of TKE which is prognostically predicted
+
+-# EDMF approach is applied for all the unstable PBL 
+
+-# EDMF approach is also applied to the stratocumulus-top-driven turbulence mixing
+
+-# It includes a moist-adiabatic process when updraft thermal becomes saturated
+
+-# Scale-aware capability
+
+-# It includes interaction between TKE and cumulus convection
+
+The CCPP-compliant subroutine satmedmfvdifq_run() computes subgrid vertical turbulence mixing using scale-aware
+TKE-based moist eddy-diffusion mass-flux paramterization (Han et al. 2019 \cite Han_2019)
+- For the convective boundary layer, the scheme adopts EDMF parameterization (Siebesma et al. (2007)\cite Siebesma_2007)
+to take into account nonlocal transport by large eddies(mfpbltq.f)
+- A new mass-flux paramterization for stratocumulus-top-induced turbulence mixing has been introduced (mfscuq.f; previously,
+it was an eddy diffusion form)
+- For local turbulence mixing, a TKE closure model is used.
+
+\section intra_satmedmfvdifq Intraphysics Communication
+\ref arg_table_satmedmfvdifq_run
+
+\section gen_pbl_satmedmfvdifq  General Algorithm
+\ref gen_satmedmfvdifq
+
+*/

physics/docs/pdftxt/all_shemes_list.txt

@@ -14,6 +14,7 @@ parameterizations in suites.
 - \b PBL \b and \b Turbulence
  - \subpage GFS_HEDMF
  - \subpage GFS_SATMEDMF
+ - \subpage GFS_SATMEDMFVDIFQ
  - \subpage GSD_MYNNEDMF
 
 - \b Land \b Surface \b Model

physics/mfpbltq.f

@@ -3,7 +3,7 @@
 !! updraft parcel properties for thermals driven by surface heating 
 !! for use in the TKE-EDMF PBL scheme (updated version).
 
-!>\ingroup satmedmfq
+!>\ingroup satmedmfvdifq
 !! This subroutine computes mass flux and updraft parcel properties for
 !! thermals driven by surface heating. 
 !!\section mfpbltq_gen GFS mfpblt General Algorithm 

physics/mfscuq.f

@@ -2,7 +2,7 @@
 !! This file contains the mass flux and downdraft parcel preperties
 !! parameterization for stratocumulus-top-driven turbulence (updated version).
 
-!>\ingroup satmedmfq
+!>\ingroup satmedmfvdifq
 !! This subroutine computes mass flux and downdraft parcel properties
 !! for stratocumulus-top-driven turbulence.
 !! \section mfscuq GFS mfscu General Algorithm