continue addressing reviews

physics/Interstitials/UFS_SCM_NEPTUNE/GFS_rrtmgp_cloud_mp.F90

@@ -28,11 +28,12 @@ module GFS_rrtmgp_cloud_mp
 
 contains  
 
-!> \section arg_table_GFS_rrtmgp_cloud_mp_run Argument Table
-!! \htmlinclude GFS_rrtmgp_cloud_mp_run_html
-!! Here the cloud-radiative properties (optical-path, particle-size and sometimes cloud-
+!> Here the cloud-radiative properties (optical-path, particle-size and sometimes cloud-
 !! fraction) are computed for cloud producing physics schemes (e.g GFDL-MP, Thompson-MP,
 !! MYNN-EDMF-pbl, GF-convective, and SAMF-convective clouds).
+!> \section arg_table_GFS_rrtmgp_cloud_mp_run Argument Table
+!! \htmlinclude GFS_rrtmgp_cloud_mp_run.html
+!!
   subroutine GFS_rrtmgp_cloud_mp_run(nCol, nLev, nTracers, ncnd, i_cldliq, i_cldice,     &
        i_cldrain, i_cldsnow, i_cldgrpl, i_cldtot, i_cldliq_nc, i_cldice_nc, i_twa, kdt,  &
        imfdeepcnv, imfdeepcnv_gf, imfdeepcnv_samf, doSWrad, doLWrad, effr_in, lmfshal,   &

physics/docs/pdftxt/GFS_RRTMGP.txt

@@ -1,5 +1,5 @@
 /**
-\page GFS_RRTMGP_page GFS RRTMGP Shortwave/Longwave Radiation Scheme
+\page GFS_RRTMGP_page RRTMGP Shortwave/Longwave Radiation Scheme
 
 \section des_rte_rrtmgp Description
 

physics/docs/pdftxt/all_schemes_list.txt

@@ -20,11 +20,9 @@ which facilitates model development and code maintenance. While some individual
  - \subpage GFS_NOAH 
  - \subpage RUCLSM 
  - \subpage NoahMP 
- - \subpage CLM_LAKE_model
 
 \b Cumulus \b Parameterizations
  - \subpage GFS_SAMFdeep 
- - \subpage cellular_automata
  - \subpage GFS_SAMFshal 
  - \subpage CU_GF 
 
@@ -54,7 +52,7 @@ which facilitates model development and code maintenance. While some individual
  - \subpage GFS_SFCSICE 
 
 \b Others
- - \subpage GFS_SPP
+ - \subpage CLM_LAKE_mode
 
 The input information for the parameterizations includes the values of the gridbox mean prognostic variables (wind components, temperature,
 specific humidity, cloud fraction, water contents for cloud liquid, cloud ice, rain, snow, graupel, and ozone concentration), the provisional
@@ -75,7 +73,7 @@ to the parameterization.
 
 \section allsuite_overview Physics Suites
 
-The publicly supported host model that use CCPP v7.0.0 is the UFS Weather Model and the CCPP Single Column Model (CCPP-SCM). 
+The obly publicly supported host model for CCPP v7.0.0 is the CCPP Single Column Model (CCPP-SCM). 
 The forcing datasets included in the CCPP-SCM v7.0.0 public release were created by averaging observations and large-eddy simulations over areas that are
 too coarse to resolve convection. Therefore, best results will be obtained with the CCPP-SCM v7.0.0 when using suites that include parameterized
 convection.

physics/docs/pdftxt/ccppv7_phy_updates.txt

@@ -1,31 +1,34 @@
 /**
 \page ccppv7_phy Physics Update Summary
 
+This page provides an overview of the major updates in CCPP Physics v7.0.0.
+
 \b General \b Changes:
- Add GFS_v17, GFS_v16_RRTMGP, and RRFS_v1 suites as new supported suite
-- New the Community Lake Model \ref CLM_LAKE_model in RRFS_v1 suite
-- New \ref GFS_ugwpv1_gsldrag in GFS_v17 suite combines the \ref GFS_drag_suite with the version 1 UGWP non-stationary gravity wave drag (NGW) scheme of  Yudin et al. (2020)\cite yudin_et_al_2020 
+- New supported suites: GFS_v17_p8_ugwpv1, GFS_v16_RRTMGP, and HRRR_gf suites 
+- New the Community Lake Model \ref CLM_LAKE_model in HRRR_gf suite
+- New \ref GFS_ugwpv1_gsldrag in GFS_v17_p8_ugwpv1 suite combines the \ref GFS_drag_suite with the version 1 UGWP non-stationary gravity wave drag (NGW) scheme of  Yudin et al. (2020)\cite yudin_et_al_2020 
 - New \ref GFS_RRTMGP_page in GFS_v16_RRTMGP suite
-- New RRFS smoke/dust scheme in RRFS_v1 suite
+- New RRFS smoke/dust scheme in HRRR_gf suite
+
+GFS_v17_p8, HRRR, RRFS_v1beta, RAP suites in CCPP v6.0.0 are no longer supported.
+
 
 \b GFS  \b Scale-aware \b SAS  \b Cumulus \b Schemes:
 
-The updates between GFSv16 and GFSv17 are carefully outlined in Bengtsson and Han (2004)(submitted to WAF). The main updates include:
+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 \ref cellular_automata (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)
-- 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)
+- 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)
 
 \b GFS \b Scale-aware \b TKE-EDMF \b PBL \b Scheme:
-- To reduce the negative hurricane intensity biases, a parameterization for environmental wind shear effect
-is included in the GFS TKE-EDMF PBL and cumulus schemes. In addition, the entrainment rates are enhanced
-proportional to the sub-cloud or PBL mean TKE (turbulent kinetic energy) when TKE is larger than a threshold
-value.
-- To enhance the underestimated CAPE forecasts in the GFS, the entrainment rate in the TKE-EDMF PBL scheme is
-increased as a function of vegetation fraction and surface roughness length.
+- Implementation of a parameterization for environmental wind shear effect in the GFS TKE-EDMF PBL and cumulus schemes to reduce 
+the negative hurricane intensity biases. In addition, the entrainment rates are enhanced
+proportionally to the sub-cloud or PBL mean TKE (turbulent kinetic energy) when TKE is larger than a threshold value
+- Increased entrainment rate as a function of vegetation fraction and surface roughness length to enhance the underestimated CAPE forecasts in the GFS
 
 \sa Han et al.(2024) \cite Han_2024
 
@@ -37,8 +40,8 @@ ocean reduced to a smaller number (50/L) from its previous default (100/L). Both
 excessive surface downward shortwave radiative flux off coastal regions including the Southeast Pacific
 - Small fixes to the minimum size of snow and collision constants
 
-\note The above improvements were tested with the non-aerosol option (in GFS_v17 suite), so results with the aerosol-aware
-Thompson (in RRFS_v1 suite) may vary.
+\note The above improvements were tested with the non-aerosol option (in GFS_v17_p8_ugwpv1 suite), so results with the aerosol-aware
+Thompson (in HRRR_gf suite) may vary.
 
 \b NoahMP \b Land \b Surface \b Model:
 - Option for using the unified frozen precipitation fraction in NoahMP
@@ -74,7 +77,7 @@ Thompson (in RRFS_v1 suite) may vary.
 - Reintroduce friction velocity averaging over water to reduce noise in 10-m winds in the hurricane regime
 
 \b Grell-Freitas \b Scale \b and \b Aerosol \b Aware \b Convection \b Scheme:
-- Update for aerosol-awareness (experimental)
+- Update for aerosol-awareness (experimental and not supported)
 - Scale-awareness turned off when explicit microphysics is not active anywhere in the column
 - Convection is completely suppressed at grid points where the MYNN PBL sheme produces shallow convection
 - Radar reflectivity considers mass flux PDF as well as whether scale-awareness is turned on at the gird point in equation
@@ -83,11 +86,11 @@ Thompson (in RRFS_v1 suite) may vary.
 \todo UGWP updates for HR4 
 
 \b NSSL \b Cloud \b Microphysics \b Scheme:
-- Update NSSL microphysics with 3-moment option
+- Updated with 3-moment option
 
 \b Radiation
 - Coupling of GOCART aerosols with radiation (iaer=2011)
-- Add the convective cloud water (liquid water + ice water) in the calculations of cloud water path and ice water path for radiation cloud properties
+- Convective cloud water (liquid water + ice water) added to the calculations of cloud water path and ice water path for radiation cloud properties
 
 
 */

physics/docs/pdftxt/mainpage.txt

@@ -11,8 +11,9 @@ developmental schemes under consideration for upcoming operational implementatio
 applications, including the UFS Short-Range Weather (SRW) Application (available through https://github.com/ufs-community/ufs-srweather-app/), 
 which targets predictions of atmospheric behavior on a 
 limited spatial domain and on time scales from less than an hour out to several days, and the UFS Medium-Range Weather (MRW) 
-Application (available through https://github.com/ufs-community/ufs-mrweather-app/), which  targets predictions of global atmospheric 
-behavior out to about two weeks.
+Application (available through https://github.com/ufs-community/ufs-mrweather-app/)(which targets predictions of global atmospheric 
+behavior out to about two weeks), the Subseasonal-to-Seasonal (S2S) Application (which predicts the Earth System out to several months), and the
+Hurricane Application (which predicts tropical cyclones).
 
 
 The CCPP parameterizations are aggregated in suites by the host models. In this release, the CCPP Single Column Model (SCM), developed 
@@ -37,20 +38,17 @@ CCPP team would like to express our deepest gratitude for UFS physics developers
 development of CCPP-Physics. 
 \n We would also like to give special thanks to:    
 
+- \b NOAA \b NWS \b Environmental \b Modeling \b Center
 - \b NOAA \b OAR \b Global \b Systems \b Laboratory 
 - \b NOAA \b OAR \b Physical \b Sciences \b Laboratory 
 - \b NOAA \b OAR \b National \b Severe \b Storms \b Laboratory 
 - \b NOAA \b OAR \b Atlantic \b Oceanographic \b & \b Meteorological \b Laboratory
-- \b NOAA \b NWS \b Environmental \b Modeling \b Center 
 - \b NOAA \b OAR \b Atlantic \b Oceanographic \b & \b Meteorological \b Laboratory
 - \b Atmospheric \b and \b Environmental \b Research, \b Inc. 
 - \b Joint \b Center \b for \b Satellite \b Data \b Assimilation 
 - \b NASA \b Goddard \b Space \b Flight \b Center
 
 for their support and contribution for this CCPP scientific documentation (SciDoc).
-
-
-\b CCPP \b SciDoc \b Team: 
-\n Developmental Testbed Center
+\n Thanks also to the CCPP SciDoc Team at the Developmental Testbed Center.
 
 */