From 7d1f17c1400b08b4fedb6ab35e48d8d614f4410a Mon Sep 17 00:00:00 2001 From: Man Zhang Date: Fri, 24 Aug 2018 09:23:59 -0600 Subject: [PATCH 1/3] doc updates --- physics/docs/pdftxt/mainpage.txt | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/physics/docs/pdftxt/mainpage.txt b/physics/docs/pdftxt/mainpage.txt index 00c5f3921..71fb9ae0b 100644 --- a/physics/docs/pdftxt/mainpage.txt +++ b/physics/docs/pdftxt/mainpage.txt @@ -3,9 +3,9 @@ Welcome to the GMTB Common Community Physics Package (CCPP) v2.0 scientific documentation. This release of the CCPP contains two parts: CCPP-Physics (a collection of physical parameterizations) and -CCPP-framework (the infrastructure that connects the CCPP-Physics to host models). +CCPP-Framework (the infrastructure that connects the CCPP-Physics to host models). -The CCPP-physics is envisioned to contain parameterizations used by NOAA operational models for weather through +The CCPP-Physics is envisioned to contain parameterizations used by NOAA operational models for weather through seasonal prediction timescales, as well as developmental schemes under consideration for upcoming operational implementations. This version contains the parameterizations of the default physics suite of FV3GFS as of August 2018, along with the microphysics scheme that is used in the operational From 28d0c6e2e89aa09c1b2ba3205887cac2973b6987 Mon Sep 17 00:00:00 2001 From: Man Zhang Date: Fri, 24 Aug 2018 10:05:12 -0600 Subject: [PATCH 2/3] doc updates --- physics/GFS_MP_generic.F90 | 5 +++-- physics/docs/pdftxt/GFS_CALPRECIPTYPE.txt | 6 ++++-- 2 files changed, 7 insertions(+), 4 deletions(-) diff --git a/physics/GFS_MP_generic.F90 b/physics/GFS_MP_generic.F90 index 5f8890fb9..9e8c1592f 100644 --- a/physics/GFS_MP_generic.F90 +++ b/physics/GFS_MP_generic.F90 @@ -301,8 +301,9 @@ subroutine GFS_MP_generic_post_run(im, ix, levs, kdt, nrcm, ncld, nncl, ntcw, nt enddo enddo -!> - For GFDL cloud MP scheme, determine convective rain/snow by surface temperature; -!! and determine explicit rain/snow by rain/snow coming out directly from MP. +!> - For GFDL cloud MP scheme, determine convective snow by surface temperature; +!! and determine explicit rain/snow by snow/ice/graupel coming out directly from MP +!! and convective snow from the cumulus scheme. if (imp_physics == imp_physics_gfdl) then ! determine convective rain/snow by surface temperature ! determine large-scale rain/snow by rain/snow coming out directly from MP diff --git a/physics/docs/pdftxt/GFS_CALPRECIPTYPE.txt b/physics/docs/pdftxt/GFS_CALPRECIPTYPE.txt index e777f9923..973ceed3e 100644 --- a/physics/docs/pdftxt/GFS_CALPRECIPTYPE.txt +++ b/physics/docs/pdftxt/GFS_CALPRECIPTYPE.txt @@ -44,8 +44,10 @@ the melting and freezing energies. If the Zhao-Carr MP scheme is called, calwxt_dominant() takes the precipitation type solution from different algorithms (calwxt(), calwxt_ramer(), calwxt_revised(), and calwxt_bourg())and uses them up to output a dominant type. -If the GFDL MP scheme is called, the precipitation type at the surface is directly diagnosed from the microphysics species -predicted by the scheme. +GFDL MP scheme permits the prognostic surface precipitation to simultaneously consist of ice, snow and graupel at the +same location. Hence if the GFDL MP scheme is called, the precipitation type at the surface is +directly diagnosed from the explicit surface precipitation (i.e. ice, snow and graupel) +predicted by the scheme and convective rainfall predicted by the cumulus scheme if surface temperature is below \f$0^oC\f$ . \section intra_calprecip Intraphysics Communication From 2145c83486c697df536e331bdb6940d5e76a0f06 Mon Sep 17 00:00:00 2001 From: Man Zhang Date: Fri, 24 Aug 2018 10:21:31 -0600 Subject: [PATCH 3/3] doc updates --- physics/GFS_MP_generic.F90 | 3 ++- physics/docs/pdftxt/code_overview.txt | 3 ++- 2 files changed, 4 insertions(+), 2 deletions(-) diff --git a/physics/GFS_MP_generic.F90 b/physics/GFS_MP_generic.F90 index 62e925669..57a6aa686 100644 --- a/physics/GFS_MP_generic.F90 +++ b/physics/GFS_MP_generic.F90 @@ -316,7 +316,8 @@ subroutine GFS_MP_generic_post_run(im, ix, levs, kdt, nrcm, ncld, nncl, ntcw, nt !> - For GFDL cloud MP scheme, determine convective snow by surface temperature; !! and determine explicit rain/snow by snow/ice/graupel coming out directly from MP -!! and convective snow from the cumulus scheme. +!! and convective rainfall from the cumulus scheme if the surface temperature is below +!! \f$0^oC\f$. if (imp_physics == imp_physics_gfdl) then ! determine convective rain/snow by surface temperature ! determine large-scale rain/snow by rain/snow coming out directly from MP diff --git a/physics/docs/pdftxt/code_overview.txt b/physics/docs/pdftxt/code_overview.txt index eeb2df90a..893449209 100644 --- a/physics/docs/pdftxt/code_overview.txt +++ b/physics/docs/pdftxt/code_overview.txt @@ -6,7 +6,8 @@ code maintenance. While some individual parameterization can be invoked for GMTB parameterizations in suites. The parameterizations contained in CCPP-Physics v2 can be used to run two suites: FV3GFS default (with GFDL cloud microphysics) and FV3GFS with Zhao-Carr microphysics. -The FV3GFS physics suite uses the parameterizations in the following order, as defined in \c suite_SCM_GFS_operational_2017.xml file: +The FV3GFS physics suite uses the parameterizations in the following order, as defined in \c suite_SCM_GFS_2017_updated.xml and +\c suite_SCM_GFS_2018_updated.xml: + @ref GFS_RRTMG + @ref GFS_SFCLYR + @ref GFS_NSST