address Ligia's review

physics/GWD/ugwpv1_gsldrag.F90

@@ -288,18 +288,14 @@ end subroutine ugwpv1_gsldrag_finalize
 ! -----------------------------------------------------------------------
 !  order = dry-adj=>conv=mp-aero=>radiation -sfc/land- chem -> vertdiff-> [rf-gws]=> ion-re
 ! -----------------------------------------------------------------------
-!>@brief These subroutines and modules execute the CIRES UGWP Version 0
-!>\defgroup ugwpv1_gsldrag_run Unified Gravity Wave Physics General Algorithm
-!> @{
+!>\section gen_ugwpv1_gsldrag_run Unified Gravity Wave Physics General Algorithm
 !! The physics of NGWs in the UGWP framework (Yudin et al. 2018 \cite yudin_et_al_2018) is represented by four GW-solvers, which is introduced in Lindzen (1981) \cite lindzen_1981, Hines (1997) \cite hines_1997, Alexander and Dunkerton (1999) \cite alexander_and_dunkerton_1999, and Scinocca (2003) \cite scinocca_2003. The major modification of these GW solvers is represented by the addition of the background dissipation of temperature and winds to the saturation criteria for wave breaking. This feature is important in the mesosphere and thermosphere for WAM applications and it considers appropriate scale-dependent dissipation of waves near the model top lid providing the momentum and energy conservation in the vertical column physics (Shaw and Shepherd 2009 \cite shaw_and_shepherd_2009). In the UGWP-v0, the modification of Scinocca (2003) \cite scinocca_2003 scheme for NGWs with non-hydrostatic and rotational effects for GW propagations and background dissipation is represented by the subroutine fv3_ugwp_solv2_v0. In the next release of UGWP, additional GW-solvers will be implemented along with physics-based triggering of waves and stochastic approaches for selection of GW modes characterized by horizontal phase velocities, azimuthal directions and magnitude of the vertical momentum flux (VMF).
 !!
 !! In UGWP-v0, the specification for the VMF function is adopted from the GEOS-5 global atmosphere model of GMAO NASA/GSFC, as described in Molod et al. (2015) \cite molod_et_al_2015 and employed in the MERRRA-2 reanalysis (Gelaro et al., 2017 \cite gelaro_et_al_2017). The Fortran subroutine \ref slat_geos5_tamp describes the latitudinal shape of VMF-function as displayed in Figure 3 of Molod et al. (2015) \cite molod_et_al_2015. It shows that the enhanced values of VMF in the equatorial region gives opportunity to simulate the QBO-like oscillations in the equatorial zonal winds and lead to more realistic simulations of the equatorial dynamics in GEOS-5 operational and MERRA-2 reanalysis products. For the first vertically extended version of FV3GFS in the stratosphere and mesosphere, this simplified function of VMF allows us to tune the model climate and to evaluate multi-year simulations of FV3GFS with the MERRA-2 and ERA-5 reanalysis products, along with temperature, ozone, and water vapor observations of current satellite missions. After delivery of the UGWP-code, the EMC group developed and tested approach to modulate the zonal mean NGW forcing by 3D-distributions of the total precipitation as a proxy for the excitation of NGWs by convection and the vertically-integrated  (surface - tropopause) Turbulent Kinetic Energy (TKE). The verification scores with updated NGW forcing, as reported elsewhere by EMC researchers, display noticeable improvements in the forecast scores produced by FV3GFS configuration extended into the mesosphere.
 !!
 !> \section arg_table_ugwpv1_gsldrag_run Argument Table
 !! \htmlinclude ugwpv1_gsldrag_run.html
 !!
-!> \section gen_ugwpv1_gsldrag CIRES UGWP Scheme General Algorithm
-!! @{
      subroutine ugwpv1_gsldrag_run(me, master, im, levs, ak, bk, ntrac, lonr, dtp,      &
           fhzero, kdt, ldiag3d, lssav, flag_for_gwd_generic_tend, do_gsl_drag_ls_bl,    &
           do_gsl_drag_ss, do_gsl_drag_tofd, do_ugwp_v1, do_ugwp_v1_orog_only,           &
@@ -731,6 +727,4 @@ subroutine ugwpv1_gsldrag_run(me, master, im, levs, ak, bk, ntrac, lonr, dtp,
      dtdt  = dtdt  + dtdt_gw
 
     end subroutine ugwpv1_gsldrag_run
-!! @}
-!>@}
 end module ugwpv1_gsldrag

physics/MP/Morrison_Gettelman/micro_mg3_0.F90

@@ -4,7 +4,6 @@
 
 !>\ingroup mg2mg3
 !>\defgroup mg3_mp Morrison-Gettelman MP version 3.0
-!> @{
 !!---------------------------------------------------------------------------------
 !! Purpose:
 !!   MG microphysics version 3.0 - Update of MG microphysics with
@@ -4528,4 +4527,3 @@ end subroutine calc_rercld
 !========================================================================
 
 end module micro_mg3_0
-!>@}

physics/docs/ccpp_doxyfile

@@ -962,8 +962,7 @@ INPUT                  = pdftxt/mainpage.txt \
                          pdftxt/GFS_SATMEDMFVDIFQ.txt \
                          pdftxt/GFS_NOAHMP.txt \
                          pdftxt/GFS_UGWPv0.txt \
-                         pdftxt/GFS_unified_ugwp.txt \
-                         pdftxt/GFS_ugwpv1_gsldrag.txt \
+                         pdftxt/GFS_ugwpv1.txt \
                          pdftxt/GFS_drag_suite.txt \
                          pdftxt/GFS_GWDPS.txt \
                          pdftxt/GFS_OZPHYS.txt \

physics/docs/pdftxt/GFS_RRTMGP.txt

@@ -82,11 +82,5 @@
  + \b GFS RRTMGP-Shortwave radiation driver: \ref arg_table_rrtmgp_sw_main_run
  + \b GFS RRTMGP post-processing, for both Longwave and Shortwave: \ref arg_table_GFS_rrtmgp_post_run
 
-\section  gen_al_rrtmgp General Algorithm
- + \ref gen_rrtmgp_lw
- + \ref gen_rrtmgp_sw
-
-\section rrtmgp_enh CCPP Physics Updates
-\version CCPP v7.0.0
 
 */

physics/docs/pdftxt/GFS_UGWPv0.txt

@@ -1,5 +1,5 @@
 /**
-\page GFS_UGWP_v0 Unified Gravity Wave Physics Scheme - Version 0 
+\page GFS_UGWP_v0 GFS Unified Gravity Wave Physics (GWP) Scheme - Version 0 
 \section des_UGWP Description
 
 Gravity waves (GWs) are generated by a variety of sources in the atmosphere 

physics/docs/pdftxt/GFS_ugwpv1_gsldrag.txt → physics/docs/pdftxt/GFS_ugwpv1.txt

@@ -1,8 +1,8 @@
 /**
-\page GFS_ugwpv1_gsldrag GFS Unified UGWP Version 1 Scheme
+\page GFS_ugwpv1_gsldrag GFS Unified Gravity Wave Physics (GWP) Version 1 Scheme
 
 \section des_ugwpv1 Description
-The GFS Unified UGWP version 1 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.
+The GFS Unified GWP version 1 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.
 
 The NGW physics scheme parameterizes the effects of non-stationary  waves 
 unresolved by dynamical cores. These non-stationary oscillations with periods 
@@ -45,4 +45,10 @@ the effects of unresolved GWs in global forecast models, the representation of
 subgrid OGWs and NGWs has been implemented in the self-consistent manner using the 
 UGWP framework.
 
+\section intra_UGWPv1 Intraphysics Communication
+- \ref arg_table_ugwpv1_gsldrag_run
+
+\section gen_al_ugwpv1 General Algorithm
+- \ref gen_ugwpv1_gsldrag_run
+
 */

physics/docs/pdftxt/GFS_v17_p8_ugwpv1_suite.txt

@@ -3,8 +3,8 @@
 
 \section gfsv_17_suite_overview Overview
 
-Version 17 of the Global Forecast System (GFS) is scheduled for operational implementation by the NOAA
-National Centers for Environmental Prediction (NCEP) in 2024. The GFS_v17_p8_ugwpv1 suite is a prototype of 
+
+The GFS_v17_p8_ugwpv1 suite is a prototype of 
 the GFS_v17 suite, and is expected to evolve before the implementation. It is available for use 
 with the CCPP SCM.  The primary differences between the GFS_v16 and GFS_v17 suites are: 
 - \b Microphysics: The replacement of \ref GFDL_cloud with \ref THOMPSON