diff --git a/physics/GFS_DCNV_generic_post.F90 b/physics/GFS_DCNV_generic_post.F90 index 96901a568..7de8414f8 100644 --- a/physics/GFS_DCNV_generic_post.F90 +++ b/physics/GFS_DCNV_generic_post.F90 @@ -148,5 +148,4 @@ subroutine GFS_DCNV_generic_post_run (im, levs, lssav, ldiag3d, qdiag3d, ras, & endif ! if (lssav) end subroutine GFS_DCNV_generic_post_run - end module GFS_DCNV_generic_post diff --git a/physics/GFS_GWD_generic_pre.F90 b/physics/GFS_GWD_generic_pre.F90 index 1c355cc06..51a76c989 100644 --- a/physics/GFS_GWD_generic_pre.F90 +++ b/physics/GFS_GWD_generic_pre.F90 @@ -6,12 +6,10 @@ module GFS_GWD_generic_pre contains -!! \section arg_table_GFS_GWD_generic_pre_run Argument Table +!> \section arg_table_GFS_GWD_generic_pre_run Argument Table !! \htmlinclude GFS_GWD_generic_pre_run.html !! -!! \section general General Algorithm -!! \section detailed Detailed Algorithm -!! @{ +!! \section gfs_gwd_ge_pre_ga General Algorithm subroutine GFS_GWD_generic_pre_run( & & im, levs, nmtvr, mntvar, & & oc, oa4, clx, theta, & @@ -136,6 +134,5 @@ subroutine GFS_GWD_generic_pre_run( & endif end subroutine GFS_GWD_generic_pre_run -!> @} -end module GFS_GWD_generic_pre \ No newline at end of file +end module GFS_GWD_generic_pre diff --git a/physics/GFS_MP_generic_post.F90 b/physics/GFS_MP_generic_post.F90 index a7be0ab4c..da347e0b3 100644 --- a/physics/GFS_MP_generic_post.F90 +++ b/physics/GFS_MP_generic_post.F90 @@ -13,7 +13,7 @@ module GFS_MP_generic_post !! will be called. the tallies are then summed in calwxt_dominant(). 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. !! -!! \section arg_table_GFS_MP_generic_post_run Argument Table +!> \section arg_table_GFS_MP_generic_post_run Argument Table !! \htmlinclude GFS_MP_generic_post_run.html !! !> \section gfs_mp_gen GFS MP Generic Post General Algorithm diff --git a/physics/GFS_cloud_diagnostics.F90 b/physics/GFS_cloud_diagnostics.F90 index 5dd757a43..9a07a21a8 100644 --- a/physics/GFS_cloud_diagnostics.F90 +++ b/physics/GFS_cloud_diagnostics.F90 @@ -1,8 +1,6 @@ -! ######################################################################################## -! This module contains code to produce the UFS High/Mid/Low cloud-diagnostics. -! This was bundled together with the prognostic cloud modules within the RRTMG implementation. -! For the RRTMGP implementation we propose to keep these diagnostics independent. -! ######################################################################################## +!>\file GFS_cloud_diagnostics.F90 +!! + module GFS_cloud_diagnostics use machine, only: kind_phys use physparam, only: icldflg @@ -29,14 +27,13 @@ module GFS_cloud_diagnostics public GFS_cloud_diagnostics_run, GFS_cloud_diagnostics_init,& GFS_cloud_diagnostics_finalize, hml_cloud_diagnostics_init contains - ! ###################################################################################### - ! ###################################################################################### - subroutine GFS_cloud_diagnostics_init() - end subroutine GFS_cloud_diagnostics_init - - ! ###################################################################################### - ! ###################################################################################### -!! \section arg_table_GFS_cloud_diagnostics_run + +!>\defgroup gfs_cloud_diagnostics_mod GFS Cloud Diagnostics Module +!> This module contains code to produce the UFS High/Mid/Low cloud-diagnostics. +!! This was bundled together with the prognostic cloud modules within the RRTMG implementation. +!! For the RRTMGP implementation we propose to keep these diagnostics independent. +!> @{ +!> \section arg_table_GFS_cloud_diagnostics_run !! \htmlinclude GFS_cloud_diagnostics_run.html !! subroutine GFS_cloud_diagnostics_run(nCol, nLev, iovr_rand, iovr_maxrand, iovr_max, & @@ -118,13 +115,5 @@ subroutine GFS_cloud_diagnostics_run(nCol, nLev, iovr_rand, iovr_maxrand, iovr_m iovr_exprand, cldsa, mtopa, mbota) end subroutine GFS_cloud_diagnostics_run - - ! ###################################################################################### - ! ###################################################################################### - subroutine GFS_cloud_diagnostics_finalize() - end subroutine GFS_cloud_diagnostics_finalize - - ! ###################################################################################### - ! Subroutine hml_cloud_diagnostics_initialize is removed (refer to GFS_rrtmgp_setup.F90) - ! ###################################################################################### +!> @} end module GFS_cloud_diagnostics diff --git a/physics/GFS_phys_time_vary.fv3.F90 b/physics/GFS_phys_time_vary.fv3.F90 index d476c9211..43060e7a0 100644 --- a/physics/GFS_phys_time_vary.fv3.F90 +++ b/physics/GFS_phys_time_vary.fv3.F90 @@ -4,7 +4,6 @@ !>\defgroup mod_GFS_phys_time_vary GFS Physics Time Update !! This module contains GFS physics time vary subroutines including ozone, stratospheric water vapor, !! aerosol, IN&CCN and surface properties updates. -!> @{ module GFS_phys_time_vary #ifdef _OPENMP @@ -65,7 +64,7 @@ module GFS_phys_time_vary !! \htmlinclude GFS_phys_time_vary_init.html !! !>\section gen_GFS_phys_time_vary_init GFS_phys_time_vary_init General Algorithm -!! @{ +!> @{ subroutine GFS_phys_time_vary_init ( & me, master, ntoz, h2o_phys, iaerclm, iccn, iflip, im, nx, ny, idate, xlat_d, xlon_d, & jindx1_o3, jindx2_o3, ddy_o3, ozpl, jindx1_h, jindx2_h, ddy_h, h2opl,fhour, & @@ -705,13 +704,13 @@ function find_eq_smc(bexp, dwsat, dksat, ddz, smcmax) result(smc) end function find_eq_smc end subroutine GFS_phys_time_vary_init -!! @} +!> @} !> \section arg_table_GFS_phys_time_vary_timestep_init Argument Table !! \htmlinclude GFS_phys_time_vary_timestep_init.html !! !>\section gen_GFS_phys_time_vary_timestep_init GFS_phys_time_vary_timestep_init General Algorithm -!! @{ +!> @{ subroutine GFS_phys_time_vary_timestep_init ( & me, master, cnx, cny, isc, jsc, nrcm, im, levs, kdt, idate, nsswr, fhswr, lsswr, fhour, & imfdeepcnv, cal_pre, random_clds, nscyc, ntoz, h2o_phys, iaerclm, iccn, clstp, & @@ -910,13 +909,13 @@ subroutine GFS_phys_time_vary_timestep_init ( endif end subroutine GFS_phys_time_vary_timestep_init -!! @} +!> @} !> \section arg_table_GFS_phys_time_vary_timestep_finalize Argument Table !! \htmlinclude GFS_phys_time_vary_timestep_finalize.html !! !>\section gen_GFS_phys_time_vary_timestep_finalize GFS_phys_time_vary_timestep_finalize General Algorithm -!! @{ +!> @{ subroutine GFS_phys_time_vary_timestep_finalize (errmsg, errflg) implicit none @@ -930,7 +929,7 @@ subroutine GFS_phys_time_vary_timestep_finalize (errmsg, errflg) errflg = 0 end subroutine GFS_phys_time_vary_timestep_finalize -!! @} +!> @} !> \section arg_table_GFS_phys_time_vary_finalize Argument Table !! \htmlinclude GFS_phys_time_vary_finalize.html @@ -980,4 +979,3 @@ subroutine GFS_phys_time_vary_finalize(errmsg, errflg) end subroutine GFS_phys_time_vary_finalize end module GFS_phys_time_vary -!> @} diff --git a/physics/GFS_rad_time_vary.fv3.F90 b/physics/GFS_rad_time_vary.fv3.F90 index 8dd070b12..34c743244 100644 --- a/physics/GFS_rad_time_vary.fv3.F90 +++ b/physics/GFS_rad_time_vary.fv3.F90 @@ -1,5 +1,5 @@ !>\file GFS_rad_time_vary.fv3.F90 -!! Contains code related to GFS physics suite setup (radiation part of time_vary_step) +!! Contains code related to GFS radiation suite setup (radiation part of time_vary_step) module GFS_rad_time_vary implicit none @@ -11,6 +11,7 @@ module GFS_rad_time_vary contains !>\defgroup mod_GFS_rad_time_vary GFS Radiation Time Update +!! This module contains code related to GFS radiation setup. !> @{ !> \section arg_table_GFS_rad_time_vary_timestep_init Argument Table !! \htmlinclude GFS_rad_time_vary_timestep_init.html diff --git a/physics/GFS_radiation_surface.F90 b/physics/GFS_radiation_surface.F90 index 73de41282..ec7795c10 100644 --- a/physics/GFS_radiation_surface.F90 +++ b/physics/GFS_radiation_surface.F90 @@ -1,15 +1,19 @@ -!>\file GFS_radiation_surface.f90 +!>\file GFS_radiation_surface.F90 !! This file contains calls to module_radiation_surface::setemis() to set up !! surface emissivity for LW radiation and to module_radiation_surface::setalb() !! to set up surface albedo for SW radiation. + module GFS_radiation_surface use machine, only: kind_phys contains -!>\defgroup GFS_radiation_surface GFS radiation surface -!! @{ +!>\defgroup GFS_radiation_surface_mod GFS Radiation Surface Module +!! This module contains calls to module_radiation_surface::setemis() to set up +!! surface emissivity for LW radiation and to module_radiation_surface::setalb() +!! to set up surface albedo for SW radiation. +!> @{ !> \section arg_table_GFS_radiation_surface_init Argument Table !! \htmlinclude GFS_radiation_surface_init.html !! @@ -189,7 +193,5 @@ subroutine GFS_radiation_surface_run ( & end subroutine GFS_radiation_surface_run - subroutine GFS_radiation_surface_finalize () - end subroutine GFS_radiation_surface_finalize -!! @} +!> @} end module GFS_radiation_surface diff --git a/physics/GFS_rrtmg_post.F90 b/physics/GFS_rrtmg_post.F90 index 8584f8463..76ee18ec2 100644 --- a/physics/GFS_rrtmg_post.F90 +++ b/physics/GFS_rrtmg_post.F90 @@ -1,15 +1,20 @@ -!>\file GFS_rrtmg_post.f90 -!! This file contains +!>\file GFS_rrtmg_post.F90 +!! This file contains the calculation of time averaged output quantities (including total-sky and +!! clear-sky SW and LW fluxes at TOA and surface; conventional +!! 3-domain cloud amount, cloud top and base pressure, and cloud top +!! temperature; aerosols AOD, etc.), store computed results in +!! corresponding slots of array fluxr with appropriate time weights. -!>\defgroup GFS_rrtmg_post_mod GFS RRTMG Scheme Post module GFS_rrtmg_post contains -!> \section arg_table_GFS_rrtmg_post_init Argument Table -!! - subroutine GFS_rrtmg_post_init () - end subroutine GFS_rrtmg_post_init - +!>\defgroup GFS_rrtmg_post_mod GFS RRTMG Scheme Post +!! This module calculate time averaged output quantities (including total-sky and +!! clear-sky SW and LW fluxes at TOA and surface; conventional +!! 3-domain cloud amount, cloud top and base pressure, and cloud top +!! temperature; aerosols AOD, etc.), store computed results in +!! corresponding slots of array fluxr with appropriate time weights. +!> @{ !> \section arg_table_GFS_rrtmg_post_run Argument Table !! \htmlinclude GFS_rrtmg_post_run.html !! @@ -66,11 +71,11 @@ subroutine GFS_rrtmg_post_run (im, km, kmp1, lm, ltp, kt, kb, kd, nspc1, & if (.not. (lsswr .or. lslwr)) return -!> - For time averaged output quantities (including total-sky and -!! clear-sky SW and LW fluxes at TOA and surface; conventional -!! 3-domain cloud amount, cloud top and base pressure, and cloud top -!! temperature; aerosols AOD, etc.), store computed results in -!! corresponding slots of array fluxr with appropriate time weights. +! - For time averaged output quantities (including total-sky and +! clear-sky SW and LW fluxes at TOA and surface; conventional +! 3-domain cloud amount, cloud top and base pressure, and cloud top +! temperature; aerosols AOD, etc.), store computed results in +! corresponding slots of array fluxr with appropriate time weights. ! --- ... collect the fluxr data for wrtsfc @@ -205,8 +210,5 @@ subroutine GFS_rrtmg_post_run (im, km, kmp1, lm, ltp, kt, kb, kd, nspc1, & endif ! end subroutine GFS_rrtmg_post_run - - subroutine GFS_rrtmg_post_finalize () - end subroutine GFS_rrtmg_post_finalize - +!> @} end module GFS_rrtmg_post diff --git a/physics/GFS_rrtmg_pre.F90 b/physics/GFS_rrtmg_pre.F90 index 46649f7cc..ade64970d 100644 --- a/physics/GFS_rrtmg_pre.F90 +++ b/physics/GFS_rrtmg_pre.F90 @@ -1,21 +1,22 @@ -!> \file GFS_rrtmg_pre.f90 -!! This file contains +!> \file GFS_rrtmg_pre.F90 +!! This file contains cloud properties calcualtion for RRTMG. + module GFS_rrtmg_pre public GFS_rrtmg_pre_run contains -!> \defgroup GFS_rrtmg_pre GFS RRTMG Scheme Pre -!! @{ - subroutine GFS_rrtmg_pre_init () - end subroutine GFS_rrtmg_pre_init +!> \defgroup GFS_rrtmg_pre_mod GFS RRTMG Scheme Pre +!! This module contains cloud properties calculation for RRTMG. +!> @{ -!> \section arg_table_GFS_rrtmg_pre_run Argument Table -!! \htmlinclude GFS_rrtmg_pre_run.html -!! ! Attention - the output arguments lm, im, lmk, lmp must not be set ! in the CCPP version - they are defined in the interstitial_create routine +!> \section arg_table_GFS_rrtmg_pre_run Argument Table +!! \htmlinclude GFS_rrtmg_pre_run.html +!! +!>\section rrtmg_pre_gen General Algorithm subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & imfdeepcnv, imfdeepcnv_gf, me, ncnd, ntrac, num_p3d, npdf3d, ncnvcld3d,& ntqv, ntcw,ntiw, ntlnc, ntinc, ntrnc, ntsnc, ntccn, & @@ -304,7 +305,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & ! print *,' in grrad : raddt=',raddt -!> -# Setup surface ground temperature and ground/air skin temperature +!> - Setup surface ground temperature and ground/air skin temperature !! if required. if ( itsfc == 0 ) then ! use same sfc skin-air/ground temp @@ -320,7 +321,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & endif -!> -# Prepare atmospheric profiles for radiation input. +!> - Prepare atmospheric profiles for radiation input. ! lsk = 0 @@ -336,7 +337,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & tlyr(i,k1) = tgrs(i,k2) prslk1(i,k1) = prslk(i,k2) -!> - Compute relative humidity. +!> - Compute relative humidity. es = min( prsl(i,k2), fpvs( tgrs(i,k2) ) ) ! fpvs and prsl in pa qs = max( QMIN, con_eps * es / (prsl(i,k2) + epsm1*es) ) rhly(i,k1) = max( 0.0, min( 1.0, max(QMIN, qgrs(i,k2,ntqv))/qs ) ) @@ -344,7 +345,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & enddo enddo - !--- recast remaining all tracers (except sphum) forcing them all to be positive +!> - Recast remaining all tracers (except sphum) forcing them all to be positive. do j = 2, ntrac do k = 1, LM k1 = k + kd @@ -400,7 +401,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & endif -!> - Get layer ozone mass mixing ratio (if use ozone climatology data, +!> - Get layer ozone mass mixing ratio (if use ozone climatology data, !! call getozn()). if (ntoz > 0) then ! interactive ozone generation @@ -414,13 +415,13 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & olyr) ! --- outputs endif ! end_if_ntoz -!> - Call coszmn(), to compute cosine of zenith angle (only when SW is called) +!> - Call coszmn(), to compute cosine of zenith angle (only when SW is called) if (lsswr) then call coszmn (xlon,sinlat,coslat,solhr,im,me, & ! --- inputs coszen, coszdg) ! --- outputs endif -!> - Call getgases(), to set up non-prognostic gas volume mixing +!> - Call getgases(), to set up non-prognostic gas volume mixing !! ratioes (gasvmr). ! - gasvmr(:,:,1) - co2 volume mixing ratio ! - gasvmr(:,:,2) - n2o volume mixing ratio @@ -454,7 +455,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & enddo enddo -!> - Get temperature at layer interface, and layer moisture. +!> - Get temperature at layer interface, and layer moisture. do k = 2, LMK do i = 1, IM tem2da(i,k) = log( plyr(i,k) ) @@ -594,7 +595,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & endif ! end_if_ivflip -!> - Call module_radiation_aerosols::setaer(),to setup aerosols +!> - Call module_radiation_aerosols::setaer(),to setup aerosols !! property profile for radiation. !check print *,' in grrad : calling setaer ' @@ -627,14 +628,8 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & enddo enddo -!> - Obtain cloud information for radiation calculations +!> - Obtain cloud information for radiation calculations !! (clouds,cldsa,mtopa,mbota) -!!\n for prognostic cloud: -!! - For Zhao/Moorthi's prognostic cloud scheme, -!! call module_radiation_clouds::progcld_zhao_carr() -!! - For Zhao/Moorthi's prognostic cloud+pdfcld, -!! call module_radiation_clouds::progcld_zhao_carr_pdf() -!! call module_radiation_clouds::progclduni() for unified cloud and ncnd>=2 ! --- ... obtain cloud information for radiation calculations @@ -847,7 +842,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & endif end do end do - ! Call Thompson's subroutine to compute effective radii + !> - Call Thompson's subroutine calc_effectRad() to compute effective radii do i=1,im ! Effective radii [m] are now intent(out), bounds applied in calc_effectRad !tgs: progclduni has different limits for ice radii (10.0-150.0) than @@ -921,6 +916,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & ccnd(1:IM,1:LMK,1) = ccnd(1:IM,1:LMK,1) + cnvw(1:IM,1:LMK) endif +!> - Call radiation_clouds_prop() to calculate cloud properties. call radiation_clouds_prop & & ( plyr, plvl, tlyr, tvly, qlyr, qstl, rhly, & ! --- inputs: & ccnd, ncndl, cnvw, cnvc, tracer1, & @@ -946,7 +942,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & ! endif ! end_if_ntcw -! perturb cld cover +!> - Call ppfbet() to perturb cld cover. if (pert_clds) then do i=1,im tmp_wt= -1*log( ( 2.0 / ( sppt_wts(i,38) ) ) - 1 ) @@ -1014,6 +1010,7 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & ! --- scale random patterns for surface perturbations with ! perturbation size ! --- turn vegetation fraction pattern into percentile pattern +!> - Call cdfnor() to pert surface albedo. alb1d(:) = 0. if (lndp_type==1) then do k =1,n_var_lndp @@ -1028,9 +1025,5 @@ subroutine GFS_rrtmg_pre_run (im, levs, lm, lmk, lmp, n_var_lndp, & ! mg, sfc-perts end subroutine GFS_rrtmg_pre_run - - subroutine GFS_rrtmg_pre_finalize () - end subroutine GFS_rrtmg_pre_finalize - -!! @} +!> @} end module GFS_rrtmg_pre diff --git a/physics/GFS_rrtmg_setup.F90 b/physics/GFS_rrtmg_setup.F90 index 0e2d87feb..803ccc84a 100644 --- a/physics/GFS_rrtmg_setup.F90 +++ b/physics/GFS_rrtmg_setup.F90 @@ -1,7 +1,9 @@ -!> \file GFS_rrtmg_setup.f90 +!> \file GFS_rrtmg_setup.F90 !! This file contains !> \defgroup GFS_rrtmg_setup_mod GFS RRTMG Scheme Setup +!! This subroutine initializes RRTMG. +!> @{ module GFS_rrtmg_setup use physparam, only : isolar , ictmflg, ico2flg, ioznflg, iaerflg, & @@ -559,7 +561,6 @@ end subroutine radinit !! \param sdec,cdec sine and cosine of the solar declination angle !! \param solcon solar constant adjusted by sun-earth distance \f$(W/m^2)\f$ !> \section gen_radupdate General Algorithm -!> @{ !----------------------------------- subroutine radupdate( idate,jdate,deltsw,deltim,lsswr, me, & & slag,sdec,cdec,solcon) @@ -729,5 +730,6 @@ subroutine radupdate( idate,jdate,deltsw,deltim,lsswr, me, & !................................... end subroutine radupdate !----------------------------------- +!> @} end module GFS_rrtmg_setup diff --git a/physics/GFS_rrtmgp_cloud_mp.F90 b/physics/GFS_rrtmgp_cloud_mp.F90 index 53b4d801c..4f370a2b7 100644 --- a/physics/GFS_rrtmgp_cloud_mp.F90 +++ b/physics/GFS_rrtmgp_cloud_mp.F90 @@ -1,5 +1,10 @@ -! ######################################################################################## -! ######################################################################################## +!> \file GFS_rrtmgp_cloud_mp.F90 +!! +!> \defgroup GFS_rrtmgp_cloud_mp GFS_rrtmgp_cloud_mp.F90 +!! +!! \brief This module contains the interface for ALL cloud microphysics assumptions and +!! the RRTMGP radiation scheme. Specific details below in subroutines. +!! module GFS_rrtmgp_cloud_mp use machine, only: kind_phys use radiation_tools, only: check_error_msg @@ -26,11 +31,17 @@ module GFS_rrtmgp_cloud_mp contains +!>\defgroup gfs_rrtmgp_cloud_mp_mod GFS RRTMGP Cloud MP Module !! \section arg_table_GFS_rrtmgp_cloud_mp_run !! \htmlinclude GFS_rrtmgp_cloud_mp_run_html !! - ! ###################################################################################### - ! ###################################################################################### +!> \ingroup GFS_rrtmgp_cloud_mp +!! +!! 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 GFS_rrtmgp_cloud_mp_run 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, & @@ -285,22 +296,22 @@ subroutine GFS_rrtmgp_cloud_mp_run(nCol, nLev, nTracers, ncnd, i_cldliq, i_cldic end subroutine GFS_rrtmgp_cloud_mp_run - ! ###################################################################################### - ! Compute cloud radiative properties for Grell-Freitas convective cloud scheme. - ! (Adopted from module_SGSCloud_RadPre) - ! - ! - The total convective cloud condensate is partitoned by phase, using temperature, into - ! liquid/ice convective cloud mixing-ratios. Compute convective cloud LWP and IWP's. - ! - ! - The liquid and ice cloud effective particle sizes are assigned reference values*. - ! *TODO* Find references, include DOIs, parameterize magic numbers, etc... - ! - ! - The convective cloud-fraction is computed using Xu-Randall (1996). - ! (DJS asks: Does the GF scheme produce a cloud-fraction? If so, maybe use instead of - ! Xu-Randall? Xu-Randall is consistent with the Thompson MP scheme, but - ! not GFDL-EMC) - ! - ! ###################################################################################### +!> \ingroup GFS_rrtmgp_cloud_mp +!! Compute cloud radiative properties for Grell-Freitas convective cloud scheme. +!! (Adopted from module_SGSCloud_RadPre) +!! +!! - The total convective cloud condensate is partitoned by phase, using temperature, into +!! liquid/ice convective cloud mixing-ratios. Compute convective cloud LWP and IWP's. +!! +!! - The liquid and ice cloud effective particle sizes are assigned reference values*. +!! *TODO* Find references, include DOIs, parameterize magic numbers, etc... +!! +!! - The convective cloud-fraction is computed using Xu-Randall (1996). +!! (DJS asks: Does the GF scheme produce a cloud-fraction? If so, maybe use instead of +!! Xu-Randall? Xu-Randall is consistent with the Thompson MP scheme, but +!! not GFDL-EMC) +!! +!! \section cloud_mp_GF_gen General Algorithm subroutine cloud_mp_GF(nCol, nLev, lsmask, t_lay, p_lev, p_lay, qs_lay, relhum, & qci_conv, con_ttp, con_g, alpha0, cld_cnv_lwp, cld_cnv_reliq, cld_cnv_iwp, & cld_cnv_reice, cld_cnv_frac) @@ -365,17 +376,17 @@ subroutine cloud_mp_GF(nCol, nLev, lsmask, t_lay, p_lev, p_lay, qs_lay, relhum, enddo end subroutine cloud_mp_GF - ! ###################################################################################### - ! Compute cloud radiative properties for MYNN-EDMF PBL cloud scheme. - ! (Adopted from module_SGSCloud_RadPre) - ! - ! - Cloud-fraction, liquid, and ice condensate mixing-ratios from MYNN-EDMF cloud scheme - ! are provided as inputs. Cloud LWP and IWP are computed. - ! - ! - The liquid and ice cloud effective particle sizes are assigned reference values*. - ! *TODO* Find references, include DOIs, parameterize magic numbers, etc... - ! - ! ###################################################################################### +!> \ingroup GFS_rrtmgp_cloud_mp +!! Compute cloud radiative properties for MYNN-EDMF PBL cloud scheme. +!! (Adopted from module_SGSCloud_RadPre) +!! +!! - Cloud-fraction, liquid, and ice condensate mixing-ratios from MYNN-EDMF cloud scheme +!! are provided as inputs. Cloud LWP and IWP are computed. +!! +!! - The liquid and ice cloud effective particle sizes are assigned reference values*. +!! *TODO* Find references, include DOIs, parameterize magic numbers, etc... +!! +!! \section cloud_mp_MYNN_gen General Algorithm subroutine cloud_mp_MYNN(nCol, nLev, lsmask, t_lay, p_lev, p_lay, qs_lay, relhum, & qc_mynn, qi_mynn, con_ttp, con_g, cld_pbl_lwp, cld_pbl_reliq, cld_pbl_iwp, & cld_pbl_reice, cld_pbl_frac) @@ -437,18 +448,18 @@ subroutine cloud_mp_MYNN(nCol, nLev, lsmask, t_lay, p_lev, p_lay, qs_lay, relhum enddo end subroutine cloud_mp_MYNN - ! ###################################################################################### - ! Compute cloud radiative properties for SAMF convective cloud scheme. - ! - ! - The total-cloud convective mixing-ratio is partitioned by phase into liquid/ice - ! cloud properties. LWP and IWP are computed. - ! - ! - The liquid and ice cloud effective particle sizes are assigned reference values. - ! - ! - The convective cloud-fraction is computed using Xu-Randall (1996). - ! (DJS asks: Does the SAMF scheme produce a cloud-fraction?) - ! - ! ###################################################################################### +!> \ingroup GFS_rrtmgp_cloud_mp +!! Compute cloud radiative properties for SAMF convective cloud scheme. +!! +!! - The total-cloud convective mixing-ratio is partitioned by phase into liquid/ice +!! cloud properties. LWP and IWP are computed. +!! +!! - The liquid and ice cloud effective particle sizes are assigned reference values. +!! +!! - The convective cloud-fraction is computed using Xu-Randall (1996). +!! (DJS asks: Does the SAMF scheme produce a cloud-fraction?) +!! +!! \section cloud_mp_SAMF_gen General Algorithm subroutine cloud_mp_SAMF(nCol, nLev, t_lay, p_lev, p_lay, qs_lay, relhum, & cnv_mixratio, con_ttp, con_g, alpha0, cld_cnv_lwp, cld_cnv_reliq, cld_cnv_iwp, & cld_cnv_reice, cld_cnv_frac) @@ -499,17 +510,13 @@ subroutine cloud_mp_SAMF(nCol, nLev, t_lay, p_lev, p_lay, qs_lay, relhum, enddo end subroutine cloud_mp_SAMF - - ! ###################################################################################### - ! This routine computes the cloud radiative properties for a "unified cloud". - ! - ! - "unified cloud" implies that the cloud-fraction is PROVIDED. - ! - ! - The cloud water path is computed for all provided cloud mixing-ratios and hydrometeors. - ! - ! - If particle sizes are provided, they are used. If not, default values are assigned. - ! - ! ###################################################################################### + +!> \ingroup GFS_rrtmgp_cloud_mp +!! This routine computes the cloud radiative properties for a "unified cloud". +!! - "unified cloud" implies that the cloud-fraction is PROVIDED. +!! - The cloud water path is computed for all provided cloud mixing-ratios and hydrometeors. +!! - If particle sizes are provided, they are used. If not, default values are assigned. +!! \section cloud_mp_uni_gen General Algorithm subroutine cloud_mp_uni(nCol, nLev, nTracers, ncnd, i_cldliq, i_cldice, i_cldrain, & i_cldsnow, i_cldgrpl, i_cldtot, effr_in, kdt, lsmask, p_lev, p_lay, t_lay, tv_lay,& effrin_cldliq, effrin_cldice, effrin_cldsnow, tracer, con_g, con_rd, con_ttp, & @@ -635,19 +642,20 @@ subroutine cloud_mp_uni(nCol, nLev, nTracers, ncnd, i_cldliq, i_cldice, i_cldrai enddo ! nLev end subroutine cloud_mp_uni - ! ###################################################################################### - ! This routine computes the cloud radiative properties for the Thompson cloud micro- - ! physics scheme. - ! - ! - The cloud water path is computed for all provided cloud mixing-ratios and hydrometeors. - ! - ! - There are no assumptions about particle size applied here. Effective particle sizes - ! are updated prior to this routine, see cmp_reff_Thompson(). - ! - ! - The cloud-fraction is computed using Xu-Randall** (1996). - ! **Additionally, Conditioned on relative-humidity** - ! - ! ###################################################################################### + +!> \ingroup GFS_rrtmgp_cloud_mp +!! This routine computes the cloud radiative properties for the Thompson cloud micro- +!! physics scheme. +!! +!! - The cloud water path is computed for all provided cloud mixing-ratios and hydrometeors. +!! +!! - There are no assumptions about particle size applied here. Effective particle sizes +!! are updated prior to this routine, see cmp_reff_Thompson(). +!! +!! - The cloud-fraction is computed using Xu-Randall** (1996). +!! **Additionally, Conditioned on relative-humidity** +!! +!! \section cloud_mp_thompson_gen General Algorithm subroutine cloud_mp_thompson(nCol, nLev, nTracers, ncnd, i_cldliq, i_cldice, i_cldrain,& i_cldsnow, i_cldgrpl, p_lev, p_lay, tv_lay, t_lay, tracer, qs_lay, q_lay, relhum, & con_g, con_rd, con_eps, alpha0, lwp_ex, iwp_ex, lwp_fc, iwp_fc, cld_frac, cld_lwp,& @@ -760,14 +768,14 @@ subroutine cloud_mp_thompson(nCol, nLev, nTracers, ncnd, i_cldliq, i_cldice, i_c end subroutine cloud_mp_thompson - ! ###################################################################################### - ! This function computes the cloud-fraction following. - ! Xu-Randall(1996) A Semiempirical Cloudiness Parameterization for Use in Climate Models - ! https://doi.org/10.1175/1520-0469(1996)053<3084:ASCPFU>2.0.CO;2 - ! - ! cld_frac = {1-exp[-alpha*cld_mr/((1-relhum)*qs_lay)**lambda]}*relhum**P - ! - ! ###################################################################################### +!> \ingroup GFS_rrtmgp_cloud_mp +!! This function computes the cloud-fraction following. +!! Xu-Randall(1996) A Semiempirical Cloudiness Parameterization for Use in Climate Models +!! https://doi.org/10.1175/1520-0469(1996)053<3084:ASCPFU>2.0.CO;2 +!! +!! cld_frac = {1-exp[-alpha*cld_mr/((1-relhum)*qs_lay)**lambda]}*relhum**P +!! +!! \section cld_frac_XuRandall_gen General Algorithm function cld_frac_XuRandall(p_lay, qs_lay, relhum, cld_mr, alpha) implicit none ! Inputs @@ -804,11 +812,11 @@ function cld_frac_XuRandall(p_lay, qs_lay, relhum, cld_mr, alpha) return end function - ! ###################################################################################### - ! This routine is a wrapper to update the Thompson effective particle sizes used by the - ! RRTMGP radiation scheme. - ! - ! ###################################################################################### +!> \ingroup GFS_rrtmgp_cloud_mp +!! This routine is a wrapper to update the Thompson effective particle sizes used by the +!! RRTMGP radiation scheme. +!! +!! \section cmp_reff_Thompson_gen General Algorithm subroutine cmp_reff_Thompson(nLev, nCol, i_cldliq, i_cldice, i_cldsnow, i_cldice_nc, & i_cldliq_nc, i_twa, q_lay, p_lay, t_lay, tracer, con_eps, con_rd, ltaerosol, & effrin_cldliq, effrin_cldice, effrin_cldsnow) @@ -879,5 +887,4 @@ subroutine cmp_reff_Thompson(nLev, nCol, i_cldliq, i_cldice, i_cldsnow, i_cldice enddo end subroutine cmp_reff_Thompson - end module GFS_rrtmgp_cloud_mp diff --git a/physics/GFS_rrtmgp_cloud_overlap.F90 b/physics/GFS_rrtmgp_cloud_overlap.F90 index 13794641b..f8cf2a6c8 100644 --- a/physics/GFS_rrtmgp_cloud_overlap.F90 +++ b/physics/GFS_rrtmgp_cloud_overlap.F90 @@ -1,6 +1,11 @@ -! ######################################################################################## -! -! ######################################################################################## +!> \file GFS_rrtmgp_cloud_overlap.F90 +!! +!> \defgroup GFS_rrtmgp_cloud_overlap GFS_rrtmgp_cloud_overlap.F90 +!! +!! \brief This module contains EMC's interface to the different assumptions of vertical cloud +!! structuce, cloud overlap, used by McICA for cloud sampling in the RRTMGP longwave +!! and shortwave schemes. +!! module GFS_rrtmgp_cloud_overlap use machine, only: kind_phys use radiation_tools, only: check_error_msg @@ -9,11 +14,21 @@ module GFS_rrtmgp_cloud_overlap public GFS_rrtmgp_cloud_overlap_init, GFS_rrtmgp_cloud_overlap_run, GFS_rrtmgp_cloud_overlap_finalize contains - ! ###################################################################################### - ! ###################################################################################### + +!>\defgroup gfs_rrtmgp_cloud_overlap_mod GFS RRTMGP Cloud Overlap Module !! \section arg_table_GFS_rrtmgp_cloud_overlap_run !! \htmlinclude GFS_rrtmgp_cloud_overlap_run.html -!! +!! +!> \ingroup GFS_rrtmgp_cloud_overlap +!! +!! This is identical (shares common-code) to RRTMG. The motivation for RRTMGP to have +!! its own scheme is both organizational and philosophical*. +!! +!! *The number of "clouds" being produced by the model physics is often greater than one. +!! rte-rrtmgp can accomodate multiple cloud-types. This module preservers this enhancement +!! in the EMCs coupling to the RRTMGP scheme. +!! +!! \section GFS_rrtmgp_cloud_overlap_run subroutine GFS_rrtmgp_cloud_overlap_run(nCol, nLev, yearlen, doSWrad, doLWrad, & julian, lat, p_lev, p_lay, tv_lay, deltaZc, con_pi, con_g, con_rd, con_epsq, & dcorr_con, idcor, iovr, iovr_dcorr, iovr_exp, iovr_exprand, idcor_con, & diff --git a/physics/GFS_rrtmgp_lw_post.F90 b/physics/GFS_rrtmgp_lw_post.F90 index 75b705df4..afd56dcf1 100644 --- a/physics/GFS_rrtmgp_lw_post.F90 +++ b/physics/GFS_rrtmgp_lw_post.F90 @@ -1,3 +1,9 @@ +!> \file GFS_rrtmgp_lw_post.F90 +!! +!> \defgroup GFS_rrtmgp_lw_post GFS_rrtmgp_lw_post.F90 +!! +!! \brief RRTMGP Longwave post-processing routine. +!! module GFS_rrtmgp_lw_post use machine, only: kind_phys use module_radlw_parameters, only: topflw_type, sfcflw_type @@ -5,21 +11,26 @@ module GFS_rrtmgp_lw_post use radiation_tools, only: check_error_msg implicit none - public GFS_rrtmgp_lw_post_init,GFS_rrtmgp_lw_post_run,GFS_rrtmgp_lw_post_finalize + public GFS_rrtmgp_lw_post_run contains - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_lw_post_init - ! ######################################################################################### - subroutine GFS_rrtmgp_lw_post_init() - end subroutine GFS_rrtmgp_lw_post_init - - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_lw_post_run - ! ######################################################################################## + +!>\defgroup gfs_rrtmgp_lw_post_mod GFS RRTMGP-LW Post Module !> \section arg_table_GFS_rrtmgp_lw_post_run !! \htmlinclude GFS_rrtmgp_lw_post.html !! +!! \ingroup GFS_rrtmgp_lw_post +!! +!! \brief The all-sky longwave radiation tendency is computed, the clear-sky tendency is computed +!! if requested. +!! +!! RRTMGP surface and TOA fluxes are copied to fields that persist between radiation/physics +!! calls. +!! +!! (optional) Save additional diagnostics. +!! +!! \section GFS_rrtmgp_lw_post_run + ! ######################################################################################## subroutine GFS_rrtmgp_lw_post_run (nCol, nLev, lslwr, do_lw_clrsky_hr, save_diag, fhlwr, & p_lev, t_lay, tsfa, fluxlwUP_allsky, fluxlwDOWN_allsky, fluxlwUP_clrsky, iSFC, iTOA,& fluxlwDOWN_clrsky, raddt, cldsa, mtopa, mbota, cld_frac, cldtaulw, fluxr, sfcdlw, & @@ -174,10 +185,4 @@ subroutine GFS_rrtmgp_lw_post_run (nCol, nLev, lslwr, do_lw_clrsky_hr, save_diag end subroutine GFS_rrtmgp_lw_post_run - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_lw_post_finalize - ! ######################################################################################### - subroutine GFS_rrtmgp_lw_post_finalize () - end subroutine GFS_rrtmgp_lw_post_finalize - end module GFS_rrtmgp_lw_post diff --git a/physics/GFS_rrtmgp_pre.F90 b/physics/GFS_rrtmgp_pre.F90 index faf8d4986..755b977b3 100644 --- a/physics/GFS_rrtmgp_pre.F90 +++ b/physics/GFS_rrtmgp_pre.F90 @@ -1,38 +1,47 @@ +!> \file GFS_rrtmgp_pre.F90 +!! +!> \defgroup GFS_rrtmgp_pre GFS_rrtmgp_pre.F90 +!! +!! \brief This module contains code to prepare model fields for use by the RRTMGP +!! radiation scheme. module GFS_rrtmgp_pre use machine, only: & - kind_phys ! Working type + kind_phys !< Working type use funcphys, only: & - fpvs ! Function ot compute sat. vapor pressure over liq. + fpvs !< Function ot compute sat. vapor pressure over liq. use module_radiation_astronomy, only: & coszmn use module_radiation_gases, only: & - NF_VGAS, & ! Number of active gas species - getgases, & ! Routine to setup trace gases - getozn ! Routine to setup ozone + NF_VGAS, & !< Number of active gas species + getgases, & !< Routine to setup trace gases + getozn !< Routine to setup ozone ! RRTMGP types use mo_gas_concentrations, only: ty_gas_concs use radiation_tools, only: check_error_msg,cmp_tlev real(kind_phys), parameter :: & - amd = 28.9644_kind_phys, & ! Molecular weight of dry-air (g/mol) - amw = 18.0154_kind_phys, & ! Molecular weight of water vapor (g/mol) - amo3 = 47.9982_kind_phys, & ! Modelular weight of ozone (g/mol) - amdw = amd/amw, & ! Molecular weight of dry air / water vapor - amdo3 = amd/amo3 ! Molecular weight of dry air / ozone + amd = 28.9644_kind_phys, & !< Molecular weight of dry-air (g/mol) + amw = 18.0154_kind_phys, & !< Molecular weight of water vapor (g/mol) + amo3 = 47.9982_kind_phys, & !< Modelular weight of ozone (g/mol) + amdw = amd/amw, & !< Molecular weight of dry air / water vapor + amdo3 = amd/amo3 !< Molecular weight of dry air / ozone ! Save trace gas indices. integer :: iStr_h2o, iStr_co2, iStr_o3, iStr_n2o, iStr_ch4, iStr_o2, iStr_ccl4, & iStr_cfc11, iStr_cfc12, iStr_cfc22 - public GFS_rrtmgp_pre_run,GFS_rrtmgp_pre_init,GFS_rrtmgp_pre_finalize + public GFS_rrtmgp_pre_run,GFS_rrtmgp_pre_init contains - - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_pre_init - ! ######################################################################################### + +!>\defgroup gfs_rrtmgp_pre GFS RRTMGP Pre Module !! \section arg_table_GFS_rrtmgp_pre_init !! \htmlinclude GFS_rrtmgp_pre_init.html !! +!> \ingroup GFS_rrtmgp_pre +!! +!! \brief Actuve gas-names are read from namelist. Set to interstitial%active_gases. +!! +!! \section GFS_rrtmgp_pre_init subroutine GFS_rrtmgp_pre_init(nGases, active_gases, active_gases_array, errmsg, errflg) ! Inputs integer, intent(in) :: & @@ -93,11 +102,15 @@ subroutine GFS_rrtmgp_pre_init(nGases, active_gases, active_gases_array, errmsg, end subroutine GFS_rrtmgp_pre_init ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_pre_run - ! ######################################################################################### !> \section arg_table_GFS_rrtmgp_pre_run !! \htmlinclude GFS_rrtmgp_pre_run.html !! +!> \ingroup GFS_rrtmgp_pre +!! +!! \brief Sanitize inputs for use in RRTMGP. +!! +!! \section GFS_rrtmgp_pre_run + ! ######################################################################################### subroutine GFS_rrtmgp_pre_run(me, nCol, nLev, nTracers, i_o3, lsswr, lslwr, fhswr, fhlwr, & xlat, xlon, prsl, tgrs, prslk, prsi, qgrs, tsfc, coslat, sinlat, con_g, con_rd, & con_eps, con_epsm1, con_fvirt, con_epsqs, solhr, minGPpres, maxGPpres, minGPtemp, & @@ -381,9 +394,4 @@ subroutine GFS_rrtmgp_pre_run(me, nCol, nLev, nTracers, i_o3, lsswr, lslwr, fhsw end subroutine GFS_rrtmgp_pre_run - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_pre_finalize - ! ######################################################################################### - subroutine GFS_rrtmgp_pre_finalize () - end subroutine GFS_rrtmgp_pre_finalize end module GFS_rrtmgp_pre diff --git a/physics/GFS_rrtmgp_setup.F90 b/physics/GFS_rrtmgp_setup.F90 index f7f657b50..3cd8af019 100644 --- a/physics/GFS_rrtmgp_setup.F90 +++ b/physics/GFS_rrtmgp_setup.F90 @@ -1,5 +1,6 @@ -!> \file GFS_rrtmgp_setup.f90 -!! This file contains +!> \file GFS_rrtmgp_setup.F90 +!! This file initializes the RRTMGP radiation scheme + module GFS_rrtmgp_setup use machine, only : kind_phys use module_radiation_astronomy, only : sol_init, sol_update @@ -31,11 +32,8 @@ module GFS_rrtmgp_setup logical :: loz1st = .true. contains - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_setup_init - ! ######################################################################################### -!> \defgroup GFS_rrtmgp_setup GFS RRTMGP Scheme Setup -!! @{ + +!> \defgroup GFS_rrtmgp_setup_mod GFS RRTMGP Scheme Setup Module !! \section arg_table_GFS_rrtmgp_setup_init !! \htmlinclude GFS_rrtmgp_setup_init.html !! @@ -126,6 +124,14 @@ subroutine GFS_rrtmgp_setup_init(do_RRTMGP, imp_physics, imp_physics_fer_hires, iyear0 = 0 monthd = 0 +!> -# Initialization +!! - astronomy initialization routine: +!! call module_radiation_astronomy::sol_init() +!! - aerosols initialization routine: +!! call module_radiation_aerosols::aer_init() +!! - CO2 and other gases intialization routine: +!! call module_radiation_gases::gas_init() + ! Call initialization routines.. call sol_init ( me ) call aer_init ( levr, me ) @@ -267,5 +273,4 @@ subroutine GFS_rrtmgp_setup_finalize (errmsg, errflg) is_initialized = .false. end subroutine GFS_rrtmgp_setup_finalize - end module GFS_rrtmgp_setup diff --git a/physics/GFS_rrtmgp_sw_post.F90 b/physics/GFS_rrtmgp_sw_post.F90 index fafa162d9..87ddc719b 100644 --- a/physics/GFS_rrtmgp_sw_post.F90 +++ b/physics/GFS_rrtmgp_sw_post.F90 @@ -1,3 +1,9 @@ +!> \file GFS_rrtmgp_sw_post.F90 +!! +!> \defgroup GFS_rrtmgp_sw_post GFS_rrtmgp_sw_post.F90 +!! +!! \brief RRTMGP Shortwave post-processing routine. +!! module GFS_rrtmgp_sw_post use machine, only: kind_phys use module_radiation_aerosols, only: NSPC1 @@ -7,22 +13,27 @@ module GFS_rrtmgp_sw_post use rrtmgp_sw_gas_optics, only: sw_gas_props implicit none - public GFS_rrtmgp_sw_post_init,GFS_rrtmgp_sw_post_run,GFS_rrtmgp_sw_post_finalize + public GFS_rrtmgp_sw_post_run contains - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_sw_post_init - ! ######################################################################################### - subroutine GFS_rrtmgp_sw_post_init() - end subroutine GFS_rrtmgp_sw_post_init - - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_sw_post_run - ! ######################################################################################### +!>\defgroup gfs_rrtmgp_sw_post_mod GFS RRTMGP-SW Post Module !> \section arg_table_GFS_rrtmgp_sw_post_run !! \htmlinclude GFS_rrtmgp_sw_post_run.html !! +!> \ingroup GFS_rrtmgp_sw_post +!! RRTMGP Shortwave post-processing routine. +!! +!! \brief The all-sky shortwave radiation tendency is computed, the clear-sky tendency is +!! computed if requested. +!! +!! RRTMGP surface and TOA fluxes are copied to fields that persist between radiation/physics +!! calls. +!! +!! (optional) Save additional diagnostics. +!! +!! \section GFS_rrtmgp_sw_post_run + ! ######################################################################################### subroutine GFS_rrtmgp_sw_post_run (nCol, nLev, nDay, idxday, lsswr, do_sw_clrsky_hr, & save_diag, fhswr, coszen, coszdg, t_lay, p_lev, sfc_alb_nir_dir, sfc_alb_nir_dif, & sfc_alb_uvvis_dir, sfc_alb_uvvis_dif, fluxswUP_allsky, & @@ -272,10 +283,4 @@ subroutine GFS_rrtmgp_sw_post_run (nCol, nLev, nDay, idxday, lsswr, do_sw_clrsky endif end subroutine GFS_rrtmgp_sw_post_run - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_sw_post_finalize - ! ######################################################################################### - subroutine GFS_rrtmgp_sw_post_finalize () - end subroutine GFS_rrtmgp_sw_post_finalize - end module GFS_rrtmgp_sw_post diff --git a/physics/GFS_rrtmgp_sw_pre.F90 b/physics/GFS_rrtmgp_sw_pre.F90 index 3566575f4..87d0f9ad1 100644 --- a/physics/GFS_rrtmgp_sw_pre.F90 +++ b/physics/GFS_rrtmgp_sw_pre.F90 @@ -1,23 +1,26 @@ +!> \file GFS_rrtmgp_sw_pre.F90 +!! This file contains code to gather the sunlit points for the RRTMGP shortwave scheme. +!! +!> \defgroup GFS_rrtmgp_sw_pre RRTMGP Shortwave pre +!! +!! \brief *TODO* Combine with rrtmg_sw_pre.F90, maybe call sw_rad_pre.F90, use by both. +!! module GFS_rrtmgp_sw_pre use machine, only: kind_phys use mo_gas_optics_rrtmgp, only: ty_gas_optics_rrtmgp use rrtmgp_sw_gas_optics, only: sw_gas_props - - public GFS_rrtmgp_sw_pre_run, GFS_rrtmgp_sw_pre_init, GFS_rrtmgp_sw_pre_finalize + public GFS_rrtmgp_sw_pre_run contains - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_sw_pre_init - ! ######################################################################################### - subroutine GFS_rrtmgp_sw_pre_init () - end subroutine GFS_rrtmgp_sw_pre_init - - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_sw_pre_run - ! ######################################################################################### !> \section arg_table_GFS_rrtmgp_sw_pre_run !! \htmlinclude GFS_rrtmgp_sw_pre.html !! +!! \section GFS_rrtmgp_sw_pre RRTMGP shortwave pre routine +!! @{ +!! +!! Gather the sunlit points for shortwave radiation. +!! + ! ######################################################################################### subroutine GFS_rrtmgp_sw_pre_run(nCol, doSWrad, coszen, nday, idxday, sfc_alb_nir_dir, & sfc_alb_nir_dif, sfc_alb_uvvis_dir, sfc_alb_uvvis_dif, sfc_alb_nir_dir_byband, & sfc_alb_nir_dif_byband, sfc_alb_uvvis_dir_byband, sfc_alb_uvvis_dif_byband, errmsg, & @@ -88,11 +91,5 @@ subroutine GFS_rrtmgp_sw_pre_run(nCol, doSWrad, coszen, nday, idxday, sfc_alb_ni endif end subroutine GFS_rrtmgp_sw_pre_run - - ! ######################################################################################### - ! SUBROUTINE GFS_rrtmgp_sw_pre_finalize - ! ######################################################################################### - subroutine GFS_rrtmgp_sw_pre_finalize () - end subroutine GFS_rrtmgp_sw_pre_finalize - +!> @} end module GFS_rrtmgp_sw_pre diff --git a/physics/GFS_stochastics.F90 b/physics/GFS_stochastics.F90 index 30ca67cd5..e6ee2350f 100644 --- a/physics/GFS_stochastics.F90 +++ b/physics/GFS_stochastics.F90 @@ -1,16 +1,18 @@ -!> \file GFS_stochastics.f90 +!> \file GFS_stochastics.F90 !! This file contains code previously in GFS_stochastics_driver. -!>\defgroup gfs_stoch GFS Stochastics Physics Module -!! This module module GFS_stochastics contains +!>\defgroup gfs_stoch_mod GFS Stochastics Physics Module +!> @{ +!! This is the GFS stochastics physics driver module. +!! !> \section arg_table_GFS_stochastics_init Argument Table !! \htmlinclude GFS_stochastics_init.html !! -!>\section gfs_stochy_general GFS_stochastics_init General Algorithm +!>\section gfs_stochyini_general GFS_stochastics_init General Algorithm !! This is the GFS stochastic physics initialization. !! -# define vertical tapering for CA global subroutine GFS_stochastics_init (si,vfact_ca,km,do_ca,ca_global, errmsg, errflg) @@ -46,10 +48,6 @@ subroutine GFS_stochastics_init (si,vfact_ca,km,do_ca,ca_global, errmsg, errflg) endif end subroutine GFS_stochastics_init - subroutine GFS_stochastics_finalize() - end subroutine GFS_stochastics_finalize - - !> \section arg_table_GFS_stochastics_run Argument Table !! \htmlinclude GFS_stochastics_run.html !! @@ -368,5 +366,5 @@ subroutine GFS_stochastics_run (im, km, kdt, delt, do_sppt, pert_mp, use_zmtnblc endif end subroutine GFS_stochastics_run - +!> @} end module GFS_stochastics diff --git a/physics/GFS_surface_generic_post.F90 b/physics/GFS_surface_generic_post.F90 index eba164c78..945cc14ce 100644 --- a/physics/GFS_surface_generic_post.F90 +++ b/physics/GFS_surface_generic_post.F90 @@ -15,6 +15,9 @@ module GFS_surface_generic_post contains +!>\defgroup gfs_sfc_gen_post_mode GFS surface_generic_post Module +!! This module contains code related to all GFS surface schemes to be run afterward. +!> @{ !> \section arg_table_GFS_surface_generic_post_init Argument Table !! \htmlinclude GFS_surface_generic_post_init.html !! @@ -267,5 +270,5 @@ subroutine GFS_surface_generic_post_run (im, cplflx, cplaqm, cplchm, cplwav, lss slope(:) = slope_save(:) end subroutine GFS_surface_generic_post_run - +!> @} end module GFS_surface_generic_post diff --git a/physics/GFS_surface_generic_pre.F90 b/physics/GFS_surface_generic_pre.F90 index c572201a4..6ecb2f713 100644 --- a/physics/GFS_surface_generic_pre.F90 +++ b/physics/GFS_surface_generic_pre.F90 @@ -1,7 +1,6 @@ !> \file GFS_surface_generic_pre.F90 !! Contains code related to running prior to all GFS surface schemes. -!>\defgroup mod_GFS_surface_generic_pre GFS Surface Generic Pre module module GFS_surface_generic_pre use machine, only: kind_phys @@ -16,6 +15,9 @@ module GFS_surface_generic_pre contains +!>\defgroup mod_GFS_surface_generic_pre GFS surface_generic_pre module +!! This module contains code related to running prior to all GFS surface schemes. +!> @{ !> \section arg_table_GFS_surface_generic_pre_init Argument Table !! \htmlinclude GFS_surface_generic_pre_init.html !! @@ -224,5 +226,6 @@ subroutine update_vegetation_soil_slope_type(nthreads, im, isot, ivegsrc, islmsk !$OMP end parallel do end subroutine update_vegetation_soil_slope_type +!> @} end module GFS_surface_generic_pre diff --git a/physics/GFS_surface_loop_control_part1.F90 b/physics/GFS_surface_loop_control_part1.F90 index 9d73608b4..c3030c144 100644 --- a/physics/GFS_surface_loop_control_part1.F90 +++ b/physics/GFS_surface_loop_control_part1.F90 @@ -1,9 +1,9 @@ !> \file GFS_surface_loop_control_part1.F90 !! This file contains the GFS_surface_loop_control_part1 scheme. -!> \defgroup GFS_surface_loop_control GFS_surface_loop_control scheme +!> \defgroup GFS_surface_loop_control GFS_surface_loop_control_part1 scheme +!! This module contains the GFS_surface_loop_control_part1 scheme. !! @{ - module GFS_surface_loop_control_part1 contains @@ -12,10 +12,8 @@ module GFS_surface_loop_control_part1 !! \section arg_table_GFS_surface_loop_control_part1_run Arguments !! \htmlinclude GFS_surface_loop_control_part1_run.html !! -!! \section general General Algorithm -!! \section detailed Detailed Algorithm -!! @{ - +!! \section gen_loop1 General Algorithm +!! \section detailed_loop1 Detailed Algorithm subroutine GFS_surface_loop_control_part1_run (im, iter, & wind, flag_guess, errmsg, errflg) @@ -46,6 +44,5 @@ subroutine GFS_surface_loop_control_part1_run (im, iter, & enddo end subroutine GFS_surface_loop_control_part1_run -!> @} end module GFS_surface_loop_control_part1 -!> @} \ No newline at end of file +!> @} diff --git a/physics/GFS_surface_loop_control_part2.F90 b/physics/GFS_surface_loop_control_part2.F90 index 80b25ca1e..252b1e5a2 100644 --- a/physics/GFS_surface_loop_control_part2.F90 +++ b/physics/GFS_surface_loop_control_part2.F90 @@ -1,23 +1,18 @@ !> \file GFS_surface_loop_control_part2.F90 !! This file contains the GFS_surface_loop_control_part2 scheme. -!> \defgroup GFS_surface_loop_control GFS_surface_loop_control scheme -!! @{ - +!> \defgroup GFS_surface_loop_control2 GFS_surface_loop_control_part2 Module +!! This module contains the GFS_surface_loop_control_part2 scheme. +!> @{ module GFS_surface_loop_control_part2 contains -!> \brief Brief description of the subroutine -!! #if 0 -!! \section arg_table_GFS_surface_loop_control_part2_run Arguments +!> \section arg_table_GFS_surface_loop_control_part2_run Arguments !! \htmlinclude GFS_surface_loop_control_part2_run.html !! #endif -!! \section general General Algorithm -!! \section detailed Detailed Algorithm -!! @{ - +!> \section looptwo_general General Algorithm subroutine GFS_surface_loop_control_part2_run (im, lsm, lsm_noahmp, iter,& wind, flag_guess, flag_iter, dry, wet, icy, nstf_name1, errmsg, errflg) @@ -60,7 +55,5 @@ subroutine GFS_surface_loop_control_part2_run (im, lsm, lsm_noahmp, iter,& enddo end subroutine GFS_surface_loop_control_part2_run -!> @} - end module GFS_surface_loop_control_part2 !> @} diff --git a/physics/GFS_time_vary_pre.fv3.F90 b/physics/GFS_time_vary_pre.fv3.F90 index 4b7648c38..6f1e9bc19 100644 --- a/physics/GFS_time_vary_pre.fv3.F90 +++ b/physics/GFS_time_vary_pre.fv3.F90 @@ -1,7 +1,6 @@ !> \file GFS_time_vary_pre.fv3.F90 !! Contains code related to GFS physics suite setup (generic part of time_vary_step) -!>\defgroup gfs_time_vary_pre_mod GFS Time Vary Pre Module module GFS_time_vary_pre use funcphys, only: gfuncphys @@ -16,6 +15,9 @@ module GFS_time_vary_pre contains +!>\defgroup gfs_time_vary_pre_mod GFS Time Vary Pre Module +!! This module contains code related to GFS physics suite setup. +!> @{ !> \section arg_table_GFS_time_vary_pre_init Argument Table !! \htmlinclude GFS_time_vary_pre_init.html !! @@ -190,5 +192,5 @@ subroutine GFS_time_vary_pre_timestep_init (jdat, idat, dtp, nsswr, endif end subroutine GFS_time_vary_pre_timestep_init - +!> @} end module GFS_time_vary_pre diff --git a/physics/calpreciptype.f90 b/physics/calpreciptype.f90 index dcc8ed49b..4bcfcbe14 100644 --- a/physics/calpreciptype.f90 +++ b/physics/calpreciptype.f90 @@ -6,7 +6,6 @@ !!tallies are sumed in calwxt_dominant(). !! !>\section gen_calp GFS calpreciptype General Algorithm -!! @{ subroutine calpreciptype(kdt,nrcm,im,ix,lm,lp1,randomno, & xlat,xlon, & gt0,gq0,prsl,prsi,prec, & !input @@ -213,7 +212,6 @@ subroutine calpreciptype(kdt,nrcm,im,ix,lm,lp1,randomno, & deallocate (twet,rh,td) return end -!! @} ! !&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&&& !>\ingroup gfs_calpreciptype @@ -1306,7 +1304,6 @@ subroutine calwxt_revised(lm,lp1,t,q,pmid,pint, & !! different algorithms and sums them up to give a dominant type. !! !>\section gen_calwxt_dominant GFS calwxt_dominant General Algorithm -!! @{ subroutine calwxt_dominant(nalg,rain,freezr,sleet,snow, & & domr,domzr,domip,doms) ! @@ -1376,4 +1373,3 @@ subroutine calwxt_dominant(nalg,rain,freezr,sleet,snow, & ! return end -!! @} diff --git a/physics/cires_orowam2017.f b/physics/cires_orowam2017.f index c20f98f42..278da9100 100644 --- a/physics/cires_orowam2017.f +++ b/physics/cires_orowam2017.f @@ -1,3 +1,10 @@ +!>\file cires_orowam2017.f + +!>\defgroup cires_orowam2017_mod CIRES UGWP orowam2017 Module +!>This is the OROGW-solver of WAM2017. +!>@{ + +!> This is the OROGW-solver os WAM2017. subroutine oro_wam_2017(im, levs,npt,ipt, kref,kdt,me,master, & dtp,dxres, taub, u1, v1, t1, xn, yn, bn2, rho, prsi, prsL, & del, sigma, hprime, gamma, theta, @@ -270,11 +277,8 @@ subroutine oro_wam_2017(im, levs,npt,ipt, kref,kdt,me,master, enddo ! oro-points (i, j, ipt) !23456 end subroutine oro_wam_2017 -!------------------------------------------------------------- -! -! define mean flow and dissipation for OGW-kx spectrum -! -!------------------------------------------------------------- + +!> This subroutine defines mean flow and dissipation for OGW-kx spectrum. subroutine oro_meanflow_v0(nz, nzi, u1, v1, t1, pint, pmid, & delp, rho, bn2, uzi, rhoi, ktur, kalp, dzi, xn, yn) @@ -338,6 +342,7 @@ subroutine oro_meanflow_v0(nz, nzi, u1, v1, t1, pint, pmid, end subroutine oro_meanflow_v0 +!> This subroutine calculates TOFD as in BELJAARS-2004. subroutine ugwpv0_tofd1d(levs, sigflt, elvmax, zsurf, & zpbl, u, v, zmid, utofd, vtofd, epstofd, krf_tofd) use machine , only : kind_phys @@ -384,3 +389,4 @@ subroutine ugwpv0_tofd1d(levs, sigflt, elvmax, zsurf, enddo ! end subroutine ugwpv0_tofd1d +!>@} diff --git a/physics/cires_ugwp.F90 b/physics/cires_ugwp.F90 index c4f0a255d..77b08527b 100644 --- a/physics/cires_ugwp.F90 +++ b/physics/cires_ugwp.F90 @@ -10,7 +10,7 @@ !! 3. GW Effects: Unified representation of GW impacts on the "resolved" flow for all sources (energy-balanced schemes for momentum, heat and mixing). !! https://www.weather.gov/media/sti/nggps/Presentations%202017/02%20NGGPS_VYUDIN_2017_.pdf -!>\defgroup cires_ugwp_run Unified Gravity Wave Physics General Algorithm + module cires_ugwp use machine, only: kind_phys @@ -32,12 +32,12 @@ module cires_ugwp ! ------------------------------------------------------------------------ ! CCPP entry points for CIRES Unified Gravity Wave Physics (UGWP) scheme v0 ! ------------------------------------------------------------------------ -!>@brief The subroutine initializes the CIRES UGWP +!>\defgroup cires_ugwp_run_mod CIRES Unified Gravity Wave Physics v0 Module +!> @{ +!>@ The subroutine initializes the CIRES UGWP V0. !> \section arg_table_cires_ugwp_init Argument Table !! \htmlinclude cires_ugwp_init.html !! -! ----------------------------------------------------------------------- -! subroutine cires_ugwp_init (me, master, nlunit, input_nml_file, logunit, & fn_nml2, lonr, latr, levs, ak, bk, dtp, cdmbgwd, cgwf, & pa_rf_in, tau_rf_in, con_p0, gwd_opt,do_ugwp, errmsg, errflg) @@ -145,16 +145,53 @@ end subroutine cires_ugwp_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 -!! 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 \ref 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). +!>@brief These subroutines and modules execute the CIRES UGWP Version 0. +!> \section gen_cires_ugwp CIRES UGWP V0 Scheme General Algorithm +!! The physics of Non-Orographic Gravity Waves (NGWs) in the UGWP framework +!!(Yudin et al. 2018 \cite yudin_et_al_2018) is represented by four GW-solvers, 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. +!!A major modification of these GW solvers was introduced with 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 scheme, a modification of the +!!Scinocca (2003) \cite scinocca_2003 algorithm for NGWs with non-hydrostatic and rotational +!!effects for GW propagations and background dissipation is contained in the subroutine +!!\ref fv3_ugwp_solv2_v0. Future development plans for the UGWP scheme include additional GW-solvers +!!to 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. +!! 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_v0 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_cires_ugwp_run Argument Table !! \htmlinclude cires_ugwp_run.html !! -!> \section gen_cires_ugwp CIRES UGWP Scheme General Algorithm -!! @{ +! \section det_cires_ugwp CIRES UGWP V0 Scheme Detailed Algorithm subroutine cires_ugwp_run(do_ugwp, me, master, im, levs, ntrac, dtp, kdt, lonr, & oro, oro_uf, hprime, nmtvr, oc, theta, sigma, gamma, elvmax, clx, oa4, & do_tofd, ldiag_ugwp, cdmbgwd, xlat, xlat_d, sinlat, coslat, area, & @@ -399,5 +436,5 @@ subroutine cires_ugwp_run(do_ugwp, me, master, im, levs, ntrac, dtp, kdt, lonr endif end subroutine cires_ugwp_run -!! @} +!> @} end module cires_ugwp diff --git a/physics/cires_ugwp_initialize.F90 b/physics/cires_ugwp_initialize.F90 index e2f7afd7b..ddcbdadf7 100644 --- a/physics/cires_ugwp_initialize.F90 +++ b/physics/cires_ugwp_initialize.F90 @@ -1,10 +1,12 @@ -!=============================== -! cu-cires ugwp-scheme +!>\file cires_ugwp_initialize.F90 +!! This file contains cu-cires ugwp initialization scheme. ! initialization of ugwp_common_v0 ! init gw-solvers (1,2) .. no UFS-funds for (3,4) tests ! init gw-source specifications ! init gw-background dissipation !=============================== + +!> Define constants module ugwp_common_v0 ! use machine, only: kind_phys @@ -31,6 +33,7 @@ end module ugwp_common_v0 !Part-1 init => wave dissipation + RFriction ! !=================================================== +!> Initialization of wave dissipation and RFriction subroutine init_global_gwdis_v0(levs, zkm, pmb, kvg, ktg, krad, kion) implicit none diff --git a/physics/cires_ugwp_module.F90 b/physics/cires_ugwp_module.F90 index 620386ead..3b3ce3114 100644 --- a/physics/cires_ugwp_module.F90 +++ b/physics/cires_ugwp_module.F90 @@ -1,4 +1,5 @@ -! +!>\file cires_ugwp_module.F90 + module cires_ugwpv0_module ! @@ -101,6 +102,7 @@ module cires_ugwpv0_module ! init of cires_ugwp (_init) called from GFS_driver.F90 ! ! ----------------------------------------------------------------------- +!>This subroutine initializes CIRES UGWP subroutine cires_ugwpv0_mod_init (me, master, nlunit, input_nml_file, logunit, & fn_nml, lonr, latr, levs, ak, bk, pref, dtp, cdmvgwd, cgwf, & pa_rf_in, tau_rf_in) @@ -221,6 +223,7 @@ end subroutine cires_ugwpv0_mod_init ! finalize of cires_ugwp (_finalize) ! ----------------------------------------------------------------------- +!> This subroutine deallocate sources/spectra and some diagnostics. subroutine cires_ugwpv0_mod_finalize ! ! deallocate sources/spectra & some diagnostics need to find where "deaalocate them" diff --git a/physics/cires_ugwp_post.F90 b/physics/cires_ugwp_post.F90 index bc75f10f3..f12237e2f 100644 --- a/physics/cires_ugwp_post.F90 +++ b/physics/cires_ugwp_post.F90 @@ -1,15 +1,14 @@ !> \file cires_ugwp_post.F90 !! This file contains -!>\defgroup cires_ugwp_post_mod CIRES UGWP Scheme Post module cires_ugwp_post contains - subroutine cires_ugwp_post_init () - end subroutine cires_ugwp_post_init - -!>@brief The subroutine initializes the CIRES UGWP +!>\defgroup cires_ugwp_post_mod cires_ugwp_post Module +!! This module contains code run cires_ugwp afterwards. +!> @{ +!> The subroutine initializes the CIRES UGWP !> \section arg_table_cires_ugwp_post_run Argument Table !! \htmlinclude cires_ugwp_post_run.html !! @@ -28,7 +27,7 @@ subroutine cires_ugwp_post_run (ldiag_ugwp, dtf, im, levs, & ! Interface variables integer, intent(in) :: im, levs real(kind=kind_phys), intent(in) :: dtf - logical, intent(in) :: ldiag_ugwp !< flag for CIRES UGWP Diagnostics + logical, intent(in) :: ldiag_ugwp ! flag for CIRES UGWP Diagnostics real(kind=kind_phys), intent(in), dimension(:) :: zmtb, zlwb, zogw real(kind=kind_phys), intent(in), dimension(:) :: tau_mtb, tau_ogw, tau_tofd, tau_ngw @@ -68,7 +67,6 @@ subroutine cires_ugwp_post_run (ldiag_ugwp, dtf, im, levs, & end subroutine cires_ugwp_post_run - subroutine cires_ugwp_post_finalize () - end subroutine cires_ugwp_post_finalize +!> @} end module cires_ugwp_post diff --git a/physics/cires_ugwp_triggers.F90 b/physics/cires_ugwp_triggers.F90 index 4a8b97590..29f7ad280 100644 --- a/physics/cires_ugwp_triggers.F90 +++ b/physics/cires_ugwp_triggers.F90 @@ -1,4 +1,6 @@ -! +!>\file cires_ugwp_triggers.F90 +!! + subroutine slat_geos5_tamp_v0(im, tau_amp, xlatdeg, tau_gw) !================= ! GEOS-5 & MERRA-2 lat-dependent GW-source function tau(z=Zlaunch) =rho* diff --git a/physics/cires_ugwpv1_initialize.F90 b/physics/cires_ugwpv1_initialize.F90 index ad39def17..aa54a46f3 100644 --- a/physics/cires_ugwpv1_initialize.F90 +++ b/physics/cires_ugwpv1_initialize.F90 @@ -1,3 +1,6 @@ +!>\file cires_ugwpv1_initialize.F90 +!! + !=============================== ! cu-cires ugwp-scheme ! initialization of selected diff --git a/physics/cires_ugwpv1_module.F90 b/physics/cires_ugwpv1_module.F90 index f5fe7f2ec..9c3fa24ee 100644 --- a/physics/cires_ugwpv1_module.F90 +++ b/physics/cires_ugwpv1_module.F90 @@ -1,3 +1,5 @@ +!>\file cires_ugwpv1_module.F90 +!! module cires_ugwpv1_module diff --git a/physics/cires_ugwpv1_oro.F90 b/physics/cires_ugwpv1_oro.F90 index 247112bf1..531fd6dbc 100644 --- a/physics/cires_ugwpv1_oro.F90 +++ b/physics/cires_ugwpv1_oro.F90 @@ -1,3 +1,6 @@ +!>\file cires_ugwpv1_oro.F90 +!! + module cires_ugwpv1_oro contains diff --git a/physics/cires_ugwpv1_solv2.F90 b/physics/cires_ugwpv1_solv2.F90 index afd94ff5c..983dfeb6b 100644 --- a/physics/cires_ugwpv1_solv2.F90 +++ b/physics/cires_ugwpv1_solv2.F90 @@ -1,3 +1,6 @@ +!>\file cires_ugwpv1_solv2.F90 +!! + module cires_ugwpv1_solv2 diff --git a/physics/cires_ugwpv1_sporo.F90 b/physics/cires_ugwpv1_sporo.F90 index c840b49d8..c5c862316 100644 --- a/physics/cires_ugwpv1_sporo.F90 +++ b/physics/cires_ugwpv1_sporo.F90 @@ -1,4 +1,7 @@ +!>\file cires_ugwpv1_sporo.F90 +!! +!> subroutine oro_spectral_solver(im, levs,npt,ipt, kref,kdt,me,master, & dtp,dxres, taub, u1, v1, t1, xn, yn, bn2, rho, prsi, prsL, & del, sigma, hprime, gamma, theta, & @@ -282,6 +285,7 @@ end subroutine oro_spectral_solver ! define mean flow and dissipation for OGW-kx spectrum ! !------------------------------------------------------------- +!> subroutine oro_meanflow(nz, nzi, u1, v1, t1, pint, pmid, & & delp, rho, bn2, uzi, rhoi, ktur, kalp, dzi, xn, yn) use machine , only : kind_phys diff --git a/physics/cires_ugwpv1_triggers.F90 b/physics/cires_ugwpv1_triggers.F90 index 838ead1ee..009d91775 100644 --- a/physics/cires_ugwpv1_triggers.F90 +++ b/physics/cires_ugwpv1_triggers.F90 @@ -1,3 +1,5 @@ +!>\file cires_ugwpv1_triggers.F90 +!! module cires_ugwpv1_triggers use machine, only: kind_phys @@ -6,15 +8,9 @@ module cires_ugwpv1_triggers ! ! -! -!>\ingroup cires_ugwp_run -!> @{ -!! -!! +!> V1: GEOS-5 & MERRA-2 lat-dependent GW-source function tau(z=Zlaunch) =rho* subroutine slat_geos5_tamp_v1(im, tau_amp, xlatdeg, tau_gw) -!================= -! V1: GEOS-5 & MERRA-2 lat-dependent GW-source function tau(z=Zlaunch) =rho* -!================= + implicit none integer :: im real(kind=kind_phys) :: tau_amp, xlatdeg(im), tau_gw(im) @@ -44,11 +40,10 @@ subroutine slat_geos5_tamp_v1(im, tau_amp, xlatdeg, tau_gw) ! end subroutine slat_geos5_tamp_v1 ! +!> modified for FV3GFS-127L/C96 QBO-experiments +!! GEOS-5 & MERRA-2 lat-dependent GW-source function tau(z=Zlaunch) subroutine slat_geos5_2020(im, tau_amp, xlatdeg, tau_gw) -!================================================================= -! modified for FV3GFS-127L/C96 QBO-experiments -! GEOS-5 & MERRA-2 lat-dependent GW-source function tau(z=Zlaunch) -!================================================================ + implicit none integer :: im real(kind=kind_phys) :: tau_amp, xlatdeg(im), tau_gw(im) @@ -99,14 +94,9 @@ subroutine slat_geos5_2020(im, tau_amp, xlatdeg, tau_gw) ! end subroutine slat_geos5_2020 - +!> WAM: GEOS-5 & MERRA-2 lat-dependent GW-source function tau(z=Zlaunch) =rho* subroutine slat_geos5(im, xlatdeg, tau_gw) -!================= -! -! WAM: GEOS-5 & MERRA-2 lat-dependent GW-source function tau(z=Zlaunch) =rho* -! -!================= implicit none integer :: im real(kind=kind_phys) :: xlatdeg(im) @@ -142,13 +132,9 @@ subroutine slat_geos5(im, xlatdeg, tau_gw) ! end subroutine slat_geos5 -!=============================================== -! -! Spontaneous GW triggers by dynamical inbalances (OKW, fronts/jets, and convection) -! not activated due to "limited" set of GFS-physics -! statein-type ( needs horizontal gradients of winds and temperature, humodity) -! -!=============================================== +!> Spontaneous GW triggers by dynamical inbalances (OKW, fronts/jets, and convection) +!! not activated due to "limited" set of GFS-physics +!! statein-type ( needs horizontal gradients of winds and temperature, humodity) subroutine get_spectra_tau_convgw & (nw, im, levs, dcheat, scheat, precip, icld, xlatd, sinlat, coslat,taub, klev, if_src, nf_src) ! @@ -217,7 +203,8 @@ subroutine get_spectra_tau_convgw & ! ! print *, ' get_spectra_tau_convgw ' end subroutine get_spectra_tau_convgw -! + +!> subroutine get_spectra_tau_nstgw(nw, im, levs, trig_fgf, xlatd, sinlat, coslat, taub, klev, if_src, nf_src) integer :: nw, im, levs real(kind=kind_phys), dimension(im, levs) :: trig_fgf @@ -278,6 +265,7 @@ subroutine get_spectra_tau_nstgw(nw, im, levs, trig_fgf, xlatd, sinlat, coslat, ! end subroutine get_spectra_tau_nstgw ! +!> subroutine get_spectra_tau_okw(nw, im, levs, trig_okw, xlatd, sinlat, coslat, taub, klev, if_src, nf_src) integer :: nw, im, levs real(kind=kind_phys), dimension(im, levs) :: trig_okw diff --git a/physics/cu_gf_deep.F90 b/physics/cu_gf_deep.F90 index f59a985cd..06386a292 100644 --- a/physics/cu_gf_deep.F90 +++ b/physics/cu_gf_deep.F90 @@ -1,9 +1,6 @@ !>\file cu_gf_deep.F90 !! This file is the Grell-Freitas deep convection scheme. -!>\defgroup cu_gf_deep_group Grell-Freitas Deep Convection Module -!>\ingroup cu_gf_group -!! This is Grell-Freitas deep convection scheme module module cu_gf_deep use machine , only : kind_phys real(kind=kind_phys), parameter::g=9.81 @@ -47,6 +44,10 @@ module cu_gf_deep contains +!>\defgroup cu_gf_deep_group Grell-Freitas Deep Convection Module +!>\ingroup cu_gf_group +!! This is Grell-Freitas deep convection scheme module +!> @{ integer function my_maxloc1d(A,N,dir) !$acc routine vector implicit none @@ -68,9 +69,8 @@ integer function my_maxloc1d(A,N,dir) return end function my_maxloc1d -!>\ingroup cu_gf_deep_group -!> \section general_gf_deep GF Deep Convection General Algorithm -!> @{ +!>Driver for the deep or congestus GF routine. +!> \section general_gf_deep Grell-Freitas Deep Convection General Algorithm subroutine cu_gf_deep_run( & itf,ktf,its,ite, kts,kte & ,dicycle & ! diurnal cycle flag @@ -779,7 +779,7 @@ subroutine cu_gf_deep_run( & its,ite, kts,kte, & z_cup,entr_rate,heo,imid) ! -!--- increase detrainment in stable layers +!> - Call cup_minimi() to increase detrainment in stable layers ! call cup_minimi(heso_cup,kbcon,kstabm,kstabi,ierr, & itf,ktf, & @@ -805,7 +805,7 @@ subroutine cu_gf_deep_run( & endif enddo ! -! initial conditions for updraft +!> - Call get_cloud_bc() to initial conditions for updraft ! start_level(i)=k22(i) x_add = xlv*zqexec(i)+cp*ztexec(i) @@ -815,7 +815,7 @@ subroutine cu_gf_deep_run( & !$acc end parallel ! -!--- get inversion layers for mid level cloud tops +!> - Call get_inversion_layer() to get inversion layers for mid level cloud tops ! if(imid.eq.1)then call get_inversion_layers(ierr,p_cup,t_cup,z_cup,q_cup,qes_cup,k_inv_layers, & @@ -1007,7 +1007,7 @@ subroutine cu_gf_deep_run( & !$acc end kernels ! -!--- downdraft originating level - jmin +!> - Call cup_minimi() to calculate downdraft originating level (\p jmin) ! call cup_minimi(heso_cup,k22,kzdown,jmin,ierr, & itf,ktf, & @@ -1395,7 +1395,7 @@ subroutine cu_gf_deep_run( & !! enddo ! ! -! downdraft moist static energy + moisture budget +!> - Compute downdraft moist static energy + moisture budget do k=2,jmin(i)+1 dd_massentru(i,k-1)=dd_massentro(i,k-1)+lambau(i)*dd_massdetro(i,k-1) dd_massdetru(i,k-1)=dd_massdetro(i,k-1)+lambau(i)*dd_massdetro(i,k-1) @@ -1594,11 +1594,11 @@ subroutine cu_gf_deep_run( & endif enddo !$acc end kernels - !--- calculate moist static energy, heights, qes, ... only by bl tendencies + !> - Call cup_env() to calculate moist static energy, heights, qes, ... only by bl tendencies call cup_env(zo,qeso_bl,heo_bl,heso_bl,tn_bl,qo_bl,po,z1, & psur,ierr,tcrit,-1, & itf,ktf, its,ite, kts,kte) - !--- environmental values on cloud levels only by bl tendencies + !> - Call cup_env_clev() to calculate environmental values on cloud levels only by bl tendencies call cup_env_clev(tn_bl,qeso_bl,qo_bl,heo_bl,heso_bl,zo,po,qeso_cup_bl,qo_cup_bl, & heo_cup_bl,heso_cup_bl,zo_cup,po_cup,gammao_cup_bl,tn_cup_bl,psur, & ierr,z1, & @@ -1642,7 +1642,7 @@ subroutine cu_gf_deep_run( & endif enddo !$acc end kernels - !--- calculate workfunctions for updrafts + !> - Call cup_ip_aa0() to calculate workfunctions for updrafts call cup_up_aa0(aa1_bl,zo,zuo,dbyo_bl,gammao_cup_bl,tn_cup_bl, & kbcon,ktop,ierr, & itf,ktf,its,ite, kts,kte) @@ -1939,14 +1939,14 @@ subroutine cu_gf_deep_run( & enddo !$acc end kernels ! -!--- calculate moist static energy, heights, qes +!> - Call cup_env() to calculate moist static energy, heights, qes ! call cup_env(xz,xqes,xhe,xhes,xt,xq,po,z1, & psur,ierr,tcrit,-1, & itf,ktf, & its,ite, kts,kte) ! -!--- environmental values on cloud levels +!> - Call cup_env_clev() to calculate environmental values on cloud levels ! call cup_env_clev(xt,xqes,xq,xhe,xhes,xz,po,xqes_cup,xq_cup, & xhe_cup,xhes_cup,xz_cup,po_cup,gamma_cup,xt_cup,psur, & @@ -2010,7 +2010,7 @@ subroutine cu_gf_deep_run( & enddo !$acc end kernels ! -!--- workfunctions for updraft +!> - Call cup_up_aa0() to calculate workfunctions for updraft ! call cup_up_aa0(xaa0,xz,xzu,xdby,gamma_cup,xt_cup, & kbcon,ktop,ierr, & @@ -2093,7 +2093,7 @@ subroutine cu_gf_deep_run( & its,ite, kts,kte, & z_cup,entr_rate,heo,imid) ! -!--- calculate cloud base mass flux +!> - Call cup_forcing_ens_3d() to calculate cloud base mass flux ! !$acc kernels do i = its,itf @@ -2170,7 +2170,7 @@ subroutine cu_gf_deep_run( & its,ite, kts,kte, & dicycle,xf_dicycle ) -!---------------evap below cloud base +!> - Call rain_evap_below_cloudbase() to calculate evaporation below cloud base call rain_evap_below_cloudbase(itf,ktf,its,ite, & kts,kte,ierr,kbcon,xmb,psur,xland,qo_cup, & @@ -2277,7 +2277,7 @@ subroutine cu_gf_deep_run( & !$acc end kernels ! -! since kinetic energy is being dissipated, add heating accordingly (from ecmwf) +!> - Since kinetic energy is being dissipated, add heating accordingly (from ecmwf) ! !$acc kernels do i=its,itf @@ -2306,11 +2306,10 @@ subroutine cu_gf_deep_run( & ! end subroutine cu_gf_deep_run -!> @} - -!>\ingroup cu_gf_deep_group +!> Calculates tracer fluxes due to subsidence, only up-stream differencing +!! is currently used but flux corrected transport can be turn on. subroutine fct1d3 (ktop,n,dt,z,tracr,massflx,trflx_in,dellac,g) !$acc routine vector ! --- modify a 1-D array of tracer fluxes for the purpose of maintaining @@ -2494,6 +2493,7 @@ subroutine fct1d3 (ktop,n,dt,z,tracr,massflx,trflx_in,dellac,g) return end subroutine fct1d3 +!> Calculates rain evaporation below cloud base. subroutine rain_evap_below_cloudbase(itf,ktf, its,ite, kts,kte,ierr, & kbcon,xmb,psur,xland,qo_cup, & po_cup,qes_cup,pwavo,edto,pwevo,pre,outt,outq) !,outbuoy) @@ -2583,8 +2583,8 @@ subroutine rain_evap_below_cloudbase(itf,ktf, its,ite, kts,kte,ierr, & end subroutine rain_evap_below_cloudbase - - +!> Calculates strength of downdraft based on windshear and/or +!! aerosol content. subroutine cup_dd_edt(ierr,us,vs,z,ktop,kbcon,edt,p,pwav, & pw,ccn,ccnclean,pwev,edtmax,edtmin,edtc,psum2,psumh, & rho,aeroevap,pefc,itf,ktf, & @@ -2728,7 +2728,7 @@ subroutine cup_dd_edt(ierr,us,vs,z,ktop,kbcon,edt,p,pwav, & end subroutine cup_dd_edt -!>\ingroup cu_gf_deep_group +!> Calcultes moisture properties of downdrafts. subroutine cup_dd_moisture(ierrc,zd,hcd,hes_cup,qcd,qes_cup, & pwd,q_cup,z_cup,dd_massentr,dd_massdetr,jmin,ierr, & gamma_cup,pwev,bu,qrcd, & @@ -2885,25 +2885,8 @@ subroutine cup_dd_moisture(ierrc,zd,hcd,hes_cup,qcd,qes_cup, & end subroutine cup_dd_moisture -!>\ingroup cu_gf_deep_group -!!\param z environmental heights -!!\param qes environmental saturation mixing ratio -!!\param he environmental moist static energy -!!\param hes environmental saturation moist static energy -!!\param t environmental temperature -!!\param q environmental mixing ratio -!!\param p environmental pressure -!!\param z1 terrain elevation -!!\param psur surface pressure -!!\param ierr error value, maybe modified in this routine -!!\param tcrit 258.K -!!\param itest -!!\param itf -!!\param ktf -!!\param its -!!\param ite -!!\param kts -!!\param kte +!> Calculates environmental moist static energy, saturation +!! moist static energy, heights, and saturation mixing ratio. subroutine cup_env(z,qes,he,hes,t,q,p,z1, & psur,ierr,tcrit,itest, & itf,ktf, & @@ -3038,8 +3021,8 @@ subroutine cup_env(z,qes,he,hes,t,q,p,z1, & end subroutine cup_env -!>\ingroup cu_gf_deep_group -!!\param t environmental temperature +!> Calculates environmental values on cloud levels. +!>\param t environmental temperature !!\param qes environmental saturation mixing ratio !!\param q environmental mixing ratio !!\param he environmental moist static energy @@ -3143,7 +3126,8 @@ subroutine cup_env_clev(t,qes,q,he,hes,z,p,qes_cup,q_cup, & !$acc end kernels end subroutine cup_env_clev -!>\ingroup cu_gf_deep_group +!> Calculates an ensemble of closures and the resulting ensemble +!! average to determine cloud base mass-flux. subroutine cup_forcing_ens_3d(closure_n,xland,aa0,aa1,xaa0,mbdt,dtime,ierr,ierr2,ierr3,& xf_ens,axx,forcing,maxens3,mconv,rand_clos, & p_cup,ktop,omeg,zd,zdm,k22,zu,pr_ens,edt,edtm,kbcon, & @@ -3538,7 +3522,7 @@ subroutine cup_forcing_ens_3d(closure_n,xland,aa0,aa1,xaa0,mbdt,dtime,ierr,ierr2 end subroutine cup_forcing_ens_3d -!>\ingroup cu_gf_deep_group +!> Calculates the level of convective cloud base. subroutine cup_kbcon(ierrc,cap_inc,iloop_in,k22,kbcon,he_cup,hes_cup, & hkb,ierr,kbmax,p_cup,cap_max, & ztexec,zqexec, & @@ -3697,7 +3681,8 @@ subroutine cup_kbcon(ierrc,cap_inc,iloop_in,k22,kbcon,he_cup,hes_cup, & end subroutine cup_kbcon -!>\ingroup cu_gf_deep_group +!> Calculates the level at which the maximum value in an array +!! occurs. subroutine cup_maximi(array,ks,ke,maxx,ierr, & itf,ktf, & its,ite, kts,kte ) @@ -3760,7 +3745,7 @@ subroutine cup_maximi(array,ks,ke,maxx,ierr, & end subroutine cup_maximi -!>\ingroup cu_gf_deep_group +!> Calculates the level at which the minimum value in an array occurs. subroutine cup_minimi(array,ks,kend,kt,ierr, & itf,ktf, & its,ite, kts,kte ) @@ -3818,7 +3803,7 @@ subroutine cup_minimi(array,ks,kend,kt,ierr, & end subroutine cup_minimi -!>\ingroup cu_gf_deep_group +!> Calculates the cloud work functions for updrafts. subroutine cup_up_aa0(aa0,z,zu,dby,gamma_cup,t_cup, & kbcon,ktop,ierr, & itf,ktf, & @@ -3895,7 +3880,9 @@ subroutine cup_up_aa0(aa0,z,zu,dby,gamma_cup,t_cup, & end subroutine cup_up_aa0 !==================================================================== -!>\ingroup cu_gf_deep_group + +!> Checks for negative or excessive tendencies and corrects in a mass +!! conversing way by adjusting the cloud base mass-flux. subroutine neg_check(name,j,dt,q,outq,outt,outu,outv, & outqc,pret,its,ite,kts,kte,itf,ktf,ktop) @@ -4010,9 +3997,8 @@ subroutine neg_check(name,j,dt,q,outq,outt,outu,outv, & !$acc end kernels end subroutine neg_check -!>\ingroup cu_gf_deep_group -!> This subroutine calculates -!\param +!> This subroutine calculates final output fields including +!! physical tendencies, precipitation, and mass-flux. subroutine cup_output_ens_3d(xff_mid,xf_ens,ierr,dellat,dellaq,dellaqc, & outtem,outq,outqc, & zu,pre,pw,xmb,ktop, & @@ -4267,7 +4253,7 @@ subroutine cup_output_ens_3d(xff_mid,xf_ens,ierr,dellat,dellaq,dellaqc, & end subroutine cup_output_ens_3d !------------------------------------------------------- -!>\ingroup cu_gf_deep_group +!> Calculates moisture properties of the updraft. subroutine cup_up_moisture(name,ierr,z_cup,qc,qrc,pw,pwav, & p_cup,kbcon,ktop,dby,clw_all,xland1, & q,gamma_cup,zu,qes_cup,k22,qe_cup,c0, & @@ -4625,7 +4611,7 @@ subroutine cup_up_moisture(name,ierr,z_cup,qc,qrc,pw,pwav, & end subroutine cup_up_moisture !-------------------------------------------------------------------- -!>\ingroup cu_gf_deep_group +!> Calculates saturation vapor pressure. real function satvap(temp2) !$acc routine seq implicit none @@ -4651,7 +4637,7 @@ real function satvap(temp2) end if end function !-------------------------------------------------------------------- -!>\ingroup cu_gf_deep_group +!> Calculates the average value of a variable at the updraft originating level. subroutine get_cloud_bc(mzp,array,x_aver,k22,add) !$acc routine seq implicit none @@ -4678,7 +4664,7 @@ subroutine get_cloud_bc(mzp,array,x_aver,k22,add) end subroutine get_cloud_bc !======================================================================================== -!>\ingroup cu_gf_deep_group +!> Driver for the normalized mass-flux routine. subroutine rates_up_pdf(rand_vmas,ipr,name,ktop,ierr,p_cup,entr_rate_2d,hkbo,heo,heso_cup,z_cup, & xland,kstabi,k22,kbcon,its,ite,itf,kts,kte,ktf,zuo,kpbl,ktopdby,csum,pmin_lev) implicit none @@ -4809,7 +4795,7 @@ subroutine rates_up_pdf(rand_vmas,ipr,name,ktop,ierr,p_cup,entr_rate_2d,hkbo,heo end subroutine rates_up_pdf !------------------------------------------------------------------------- -!>\ingroup cu_gf_deep_group +!> Calculates a normalized mass-flux profile for updrafts and downdrafts using the beta function. subroutine get_zu_zd_pdf_fim(kklev,p,rand_vmas,zubeg,ipr,xland,zuh2,draft,ierr,kb,kt,zu,kts,kte,ktf,max_mass,kpbli,csum,pmin_lev) !$acc routine vector @@ -5072,8 +5058,7 @@ subroutine get_zu_zd_pdf_fim(kklev,p,rand_vmas,zubeg,ipr,xland,zuh2,draft,ierr,k end subroutine get_zu_zd_pdf_fim !------------------------------------------------------------------------- -!>\ingroup cu_gf_deep_group -!> This subroutine calculates +!> Calculates the cloud work function based on boundary layer forcing. subroutine cup_up_aa1bl(aa0,t,tn,q,qo,dtime, & z_cup,zu,dby,gamma_cup,t_cup, & kbcon,ktop,ierr, & @@ -5143,8 +5128,7 @@ subroutine cup_up_aa1bl(aa0,t,tn,q,qo,dtime, & end subroutine cup_up_aa1bl !---------------------------------------------------------------------- -!>\ingroup cu_gf_deep_group -!> This subroutine calculates +!> Finds temperature inversions using the first and second derivative of temperature. subroutine get_inversion_layers(ierr,p_cup,t_cup,z_cup,qo_cup,qeso_cup,k_inv_layers,& kstart,kend,dtempdz,itf,ktf,its,ite, kts,kte) @@ -5255,8 +5239,7 @@ subroutine get_inversion_layers(ierr,p_cup,t_cup,z_cup,qo_cup,qeso_cup,k_inv_lay end subroutine get_inversion_layers !----------------------------------------------------------------------------------- -!>\ingroup cu_gf_deep_group -!> This function calcualtes +!> Evaluates first or second order derivatives. function deriv3(xx, xi, yi, ni, m) !$acc routine vector !============================================================================*/ @@ -5340,7 +5323,7 @@ function deriv3(xx, xi, yi, ni, m) end if end function deriv3 !============================================================================================= -!>\ingroup cu_gf_deep_group +!> Calculates mass entranment and detrainment rates. subroutine get_lateral_massflux(itf,ktf, its,ite, kts,kte & ,ierr,ktop,zo_cup,zuo,cd,entr_rate_2d & ,up_massentro, up_massdetro ,up_massentr, up_massdetr & @@ -5472,7 +5455,7 @@ subroutine get_lateral_massflux(itf,ktf, its,ite, kts,kte end subroutine get_lateral_massflux !---meltglac------------------------------------------------- !------------------------------------------------------------------------------------ -!>\ingroup cu_gf_deep_group +!> Calculates the partition between cloud water and cloud ice. subroutine get_partition_liq_ice(ierr,tn,po_cup, p_liq_ice,melting_layer & ,itf,ktf,its,ite, kts,kte, cumulus ) implicit none @@ -5573,7 +5556,7 @@ subroutine get_partition_liq_ice(ierr,tn,po_cup, p_liq_ice,melting_layer end subroutine get_partition_liq_ice !------------------------------------------------------------------------------------ -!>\ingroup cu_gf_deep_group +!> Calculates the melting profile. subroutine get_melting_profile(ierr,tn_cup,po_cup, p_liq_ice,melting_layer,qrco & ,pwo,edto,pwdo,melting & ,itf,ktf,its,ite, kts,kte, cumulus ) @@ -5651,7 +5634,7 @@ subroutine get_melting_profile(ierr,tn_cup,po_cup, p_liq_ice,melting_layer,qrco end subroutine get_melting_profile !---meltglac------------------------------------------------- !-----srf-08aug2017-----begin -!>\ingroup cu_gf_deep_group +!> Calculates the cloud top height. subroutine get_cloud_top(name,ktop,ierr,p_cup,entr_rate_2d,hkbo,heo,heso_cup,z_cup, & kstabi,k22,kbcon,its,ite,itf,kts,kte,ktf,zuo,kpbl,klcl,hcot) implicit none @@ -5738,5 +5721,5 @@ subroutine get_cloud_top(name,ktop,ierr,p_cup,entr_rate_2d,hkbo,heo,heso_cup,z_c !$acc end parallel end subroutine get_cloud_top !------------------------------------------------------------------------------------ - +!> @} end module cu_gf_deep diff --git a/physics/cu_gf_driver.F90 b/physics/cu_gf_driver.F90 index 43e82a745..af13d227e 100644 --- a/physics/cu_gf_driver.F90 +++ b/physics/cu_gf_driver.F90 @@ -14,11 +14,16 @@ module cu_gf_driver private - public :: cu_gf_driver_init, cu_gf_driver_run, cu_gf_driver_finalize + public :: cu_gf_driver_init, cu_gf_driver_run contains -!> \brief Brief description of the subroutine +!> \defgroup cu_gf_group Grell-Freitas Convection Module +!! This is the Grell-Freitas scale and aerosol aware scheme. +!>@{ +!>\defgroup cu_gf_driver Grell-Freitas Convection Driver Module +!> \ingroup cu_gf_group +!> This is Grell-Freitas cumulus scheme driver module. !! !! \section arg_table_cu_gf_driver_init Argument Table !! \htmlinclude cu_gf_driver_init.html @@ -61,23 +66,16 @@ subroutine cu_gf_driver_init(imfshalcnv, imfshalcnv_gf, imfdeepcnv, & end subroutine cu_gf_driver_init - subroutine cu_gf_driver_finalize() - end subroutine cu_gf_driver_finalize ! ! t2di is temp after advection, but before physics ! t = current temp (t2di + physics up to now) !=================== -!> \defgroup cu_gf_group Grell-Freitas Convection Scheme Module -!! This is the Grell-Freitas scale and aerosol aware scheme. -!>\defgroup cu_gf_driver Grell-Freitas Convection Scheme Driver Module -!> \ingroup cu_gf_group -!! This is the Grell-Freitas convection scheme driver module. +!> This is the Grell-Freitas convection scheme driver module. !! \section arg_table_cu_gf_driver_run Argument Table !! \htmlinclude cu_gf_driver_run.html !! -!>\section gen_gf_driver GSD GF Cumulus Scheme General Algorithm -!> @{ +!>\section gen_gf_driver Grell-Freitas Cumulus Scheme Driver General Algorithm subroutine cu_gf_driver_run(ntracer,garea,im,km,dt,flag_init,flag_restart,& cactiv,cactiv_m,g,cp,xlv,r_v,forcet,forceqv_spechum,phil,raincv, & qv_spechum,t,cld1d,us,vs,t2di,w,qv2di_spechum,p2di,psuri, & @@ -1178,5 +1176,5 @@ subroutine cu_gf_driver_run(ntracer,garea,im,km,dt,flag_init,flag_restart,& endif endif end subroutine cu_gf_driver_run -!> @} +!>@} end module cu_gf_driver diff --git a/physics/cu_gf_driver_post.F90 b/physics/cu_gf_driver_post.F90 index b9fafc4df..4015fed35 100644 --- a/physics/cu_gf_driver_post.F90 +++ b/physics/cu_gf_driver_post.F90 @@ -7,16 +7,11 @@ module cu_gf_driver_post private - public :: cu_gf_driver_post_init, cu_gf_driver_post_run, cu_gf_driver_post_finalize + public :: cu_gf_driver_post_run contains - subroutine cu_gf_driver_post_init () - end subroutine cu_gf_driver_post_init - - subroutine cu_gf_driver_post_finalize() - end subroutine cu_gf_driver_post_finalize - +!>\ingroup cu_gf_group !> \section arg_table_cu_gf_driver_post_run Argument Table !! \htmlinclude cu_gf_driver_post_run.html !! diff --git a/physics/cu_gf_driver_pre.F90 b/physics/cu_gf_driver_pre.F90 index 58dc0414a..98cc76b95 100644 --- a/physics/cu_gf_driver_pre.F90 +++ b/physics/cu_gf_driver_pre.F90 @@ -7,16 +7,11 @@ module cu_gf_driver_pre private - public :: cu_gf_driver_pre_init, cu_gf_driver_pre_run, cu_gf_driver_pre_finalize + public :: cu_gf_driver_pre_run contains - subroutine cu_gf_driver_pre_init () - end subroutine cu_gf_driver_pre_init - - subroutine cu_gf_driver_pre_finalize() - end subroutine cu_gf_driver_pre_finalize - +!>\ingroup cu_gf_group !> \section arg_table_cu_gf_driver_pre_run Argument Table !! \htmlinclude cu_gf_driver_pre_run.html !! diff --git a/physics/cu_gf_sh.F90 b/physics/cu_gf_sh.F90 index b9a723856..9af9567ad 100644 --- a/physics/cu_gf_sh.F90 +++ b/physics/cu_gf_sh.F90 @@ -1,8 +1,6 @@ !>\file cu_gf_sh.F90 !! This file contains Grell-Freitas shallow convection scheme. -!>\defgroup cu_gf_sh_group Grell-Freitas Shallow Convection Module -!> \ingroup cu_gf_group module cu_gf_sh use machine , only : kind_phys !real(kind=kind_phys), parameter:: c1_shal=0.0015! .0005 @@ -16,7 +14,10 @@ module cu_gf_sh contains -!>\ingroup cu_gf_sh_group +!>\defgroup cu_gf_sh_group Grell-Freitas Shallow Convection Module +!! This module contains Grell-Freitas shallow convection scheme. +!> \ingroup cu_gf_group +!> @{ !> GF shallow convection as described in Grell and !! Freitas (2014) \cite grell_and_freitas_2014. input variables are: !!\param us x wind updated by physics @@ -59,8 +60,7 @@ module cu_gf_sh !!\param itf,ktf,its,ite, kts,kte are dimensions !!\param ipr horizontal index of printed column !!\param tropics =0 -!>\section gen_cu_gf_sh_run GSD cu_gf_sh_run General Algorithm -!> @{ +!>\section gen_cu_gf_sh_run Grell-Freitas Shallow Convection General Algorithm subroutine cu_gf_sh_run ( & us,vs,zo,t,q,z1,tn,qo,po,psur,dhdt,kpbl,rho, & ! input variables, must be supplied hfx,qfx,xland,ichoice,tcrit,dtime, & @@ -269,7 +269,7 @@ subroutine cu_gf_sh_run ( & ! ! -!--- initial detrainmentrates +!> - Initial detrainmentrates ! !$acc kernels do k=kts,ktf diff --git a/physics/dcyc2t3.f b/physics/dcyc2t3.f index 21ab5da2a..767835025 100644 --- a/physics/dcyc2t3.f +++ b/physics/dcyc2t3.f @@ -12,16 +12,10 @@ module dcyc2t3 private - public :: dcyc2t3_init, dcyc2t3_run, dcyc2t3_finalize + public :: dcyc2t3_run contains - subroutine dcyc2t3_init() - end subroutine dcyc2t3_init - - subroutine dcyc2t3_finalize() - end subroutine dcyc2t3_finalize - ! ===================================================================== ! ! description: ! ! ! diff --git a/physics/docs/_doxygen/doxygen-awesome-ccpp.css b/physics/docs/_doxygen/doxygen-awesome-ccpp.css new file mode 100644 index 000000000..036c587d0 --- /dev/null +++ b/physics/docs/_doxygen/doxygen-awesome-ccpp.css @@ -0,0 +1,107 @@ +/* + * Copyright (c) 2021 Nordic Semiconductor ASA + * SPDX-License-Identifier: Apache-2.0 + */ + +/* This file contains color customizations that follow CCPP's branding */ + +html { + --primary-color: #af7fe4; + --primary-dark-color: #7929d2; + --primary-light-color: #cb99f6; + --primary-lighter-color: #dfc8fa; + --primary-lightest-color: #efe4fc; + + --side-nav-background: #333f67; + --side-nav-foreground: #c3e3ff; + + --searchbar-background: var(--page-background-color); + --searchbar-foreground: var(--page-foreground-color); + + --link-color: #2980b9; + --param-color: #b71c1c; + + --side-nav-fixed-width: 300px; + --top-height: 220px; +} + +@media (prefers-color-scheme: dark) { + html:not(.light-mode) { + color-scheme: dark; + + --primary-color: #af7fe4; + --primary-dark-color: #cb99f6; + --primary-light-color: #7929d2; + --primary-lighter-color: #191e21; + --primary-lightest-color: #191a1c; + + --side-nav-background: #252628; + --side-nav-foreground: var(--page-foreground-color); + + --param-color: #ef9a9a; + } +} + +html.dark-mode { + color-scheme: dark; + + --primary-color: #af7fe4; + --primary-dark-color: #cb99f6; + --primary-light-color: #7929d2; + --primary-lighter-color: #191e21; + --primary-lightest-color: #191a1c; + + --side-nav-background: #252628; + --side-nav-foreground: var(--page-foreground-color); + + --param-color: #ef9a9a; +} + +a:link, a:visited, a:hover, a:focus, a:active { + color: var(--link-color) !important; +} + +.paramname { + color: var(--param-color); +} + +dl.section dd, dl.bug dd, dl.deprecated dd { + margin-inline-start: revert; +} + +/* adjust top and title to ~match Sphinx docs */ +#top { + background: var(--side-nav-background); +} + +#titlearea { + padding-bottom: 0; +} + +#titlearea table { + width: 100%; +} + +#projectlogo img { + width: 50px; + height:50px; + max-height: none !important; + padding-top: 12px; +} + +#projectalign { + display: none; +} + +@media screen and (min-width: 767px) { + #doc-content { + padding-top: calc(var(--top-height) - 180px); + } +} + +/* style for re-injected version */ +#projectversion { + color: var(--side-nav-foreground); + padding-top: 25px; + text-align: center; +} diff --git a/physics/docs/_doxygen/doxygen-awesome-ccpp.js b/physics/docs/_doxygen/doxygen-awesome-ccpp.js new file mode 100644 index 000000000..a4e77f456 --- /dev/null +++ b/physics/docs/_doxygen/doxygen-awesome-ccpp.js @@ -0,0 +1,12 @@ +/* + * Copyright (c) 2021 Nordic Semiconductor ASA + * SPDX-License-Identifier: Apache-2.0 + */ + +window.addEventListener('DOMContentLoaded', (event) => { + /* re-inject project version at a custom location */ + let version = document.getElementById('projectnumber').innerText + let titleTable = document.querySelector('#titlearea table'); + let cell = titleTable.insertRow(1).insertCell(0); + cell.innerHTML = '
' + version + '
'; +}); diff --git a/physics/docs/_doxygen/doxygen-awesome-darkmode-toggle.js b/physics/docs/_doxygen/doxygen-awesome-darkmode-toggle.js new file mode 100644 index 000000000..ae72bf7ec --- /dev/null +++ b/physics/docs/_doxygen/doxygen-awesome-darkmode-toggle.js @@ -0,0 +1,115 @@ +/** + +Doxygen Awesome +https://github.com/jothepro/doxygen-awesome-css + +MIT License + +Copyright (c) 2021 jothepro + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +*/ + +class DoxygenAwesomeDarkModeToggle extends HTMLElement { + static prefersLightModeInDarkModeKey = "prefers-light-mode-in-dark-mode" + static prefersDarkModeInLightModeKey = "prefers-dark-mode-in-light-mode" + + static _staticConstructor = function() { + DoxygenAwesomeDarkModeToggle.darkModeEnabled = DoxygenAwesomeDarkModeToggle.userPreference + DoxygenAwesomeDarkModeToggle.enableDarkMode(DoxygenAwesomeDarkModeToggle.darkModeEnabled) + // Update the color scheme when the browsers preference changes + // without user interaction on the website. + window.matchMedia('(prefers-color-scheme: dark)').addEventListener('change', event => { + DoxygenAwesomeDarkModeToggle.onSystemPreferenceChanged() + }) + // Update the color scheme when the tab is made visible again. + // It is possible that the appearance was changed in another tab + // while this tab was in the background. + document.addEventListener("visibilitychange", visibilityState => { + if (document.visibilityState === 'visible') { + DoxygenAwesomeDarkModeToggle.onSystemPreferenceChanged() + } + }); + }() + + constructor() { + super(); + this.onclick=this.toggleDarkMode + } + + /** + * @returns `true` for dark-mode, `false` for light-mode system preference + */ + static get systemPreference() { + return window.matchMedia('(prefers-color-scheme: dark)').matches + } + + /** + * @returns `true` for dark-mode, `false` for light-mode user preference + */ + static get userPreference() { + return (!DoxygenAwesomeDarkModeToggle.systemPreference && localStorage.getItem(DoxygenAwesomeDarkModeToggle.prefersDarkModeInLightModeKey)) || + (DoxygenAwesomeDarkModeToggle.systemPreference && !localStorage.getItem(DoxygenAwesomeDarkModeToggle.prefersLightModeInDarkModeKey)) + } + + static set userPreference(userPreference) { + DoxygenAwesomeDarkModeToggle.darkModeEnabled = userPreference + if(!userPreference) { + if(DoxygenAwesomeDarkModeToggle.systemPreference) { + localStorage.setItem(DoxygenAwesomeDarkModeToggle.prefersLightModeInDarkModeKey, true) + } else { + localStorage.removeItem(DoxygenAwesomeDarkModeToggle.prefersDarkModeInLightModeKey) + } + } else { + if(!DoxygenAwesomeDarkModeToggle.systemPreference) { + localStorage.setItem(DoxygenAwesomeDarkModeToggle.prefersDarkModeInLightModeKey, true) + } else { + localStorage.removeItem(DoxygenAwesomeDarkModeToggle.prefersLightModeInDarkModeKey) + } + } + DoxygenAwesomeDarkModeToggle.onUserPreferenceChanged() + } + + static enableDarkMode(enable) { + let head = document.getElementsByTagName('head')[0] + if(enable) { + document.documentElement.classList.add("dark-mode") + document.documentElement.classList.remove("light-mode") + } else { + document.documentElement.classList.remove("dark-mode") + document.documentElement.classList.add("light-mode") + } + } + + static onSystemPreferenceChanged() { + DoxygenAwesomeDarkModeToggle.darkModeEnabled = DoxygenAwesomeDarkModeToggle.userPreference + DoxygenAwesomeDarkModeToggle.enableDarkMode(DoxygenAwesomeDarkModeToggle.darkModeEnabled) + } + + static onUserPreferenceChanged() { + DoxygenAwesomeDarkModeToggle.enableDarkMode(DoxygenAwesomeDarkModeToggle.darkModeEnabled) + } + + toggleDarkMode() { + DoxygenAwesomeDarkModeToggle.userPreference = !DoxygenAwesomeDarkModeToggle.userPreference + } +} + +customElements.define("doxygen-awesome-dark-mode-toggle", DoxygenAwesomeDarkModeToggle); diff --git a/physics/docs/_doxygen/doxygen-awesome-sidebar-only-darkmode-toggle.css b/physics/docs/_doxygen/doxygen-awesome-sidebar-only-darkmode-toggle.css new file mode 100644 index 000000000..b988b6f05 --- /dev/null +++ b/physics/docs/_doxygen/doxygen-awesome-sidebar-only-darkmode-toggle.css @@ -0,0 +1,40 @@ + +/** + +Doxygen Awesome +https://github.com/jothepro/doxygen-awesome-css + +MIT License + +Copyright (c) 2021 jothepro + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +*/ + +@media screen and (min-width: 768px) { + + #MSearchBox { + width: calc(var(--side-nav-fixed-width) - calc(2 * var(--spacing-medium)) - var(--searchbar-height) - 1px); + } + + #MSearchField { + width: calc(var(--side-nav-fixed-width) - calc(2 * var(--spacing-medium)) - 66px - var(--searchbar-height)); + } +} diff --git a/physics/docs/_doxygen/doxygen-awesome-sidebar-only.css b/physics/docs/_doxygen/doxygen-awesome-sidebar-only.css new file mode 100644 index 000000000..526761db6 --- /dev/null +++ b/physics/docs/_doxygen/doxygen-awesome-sidebar-only.css @@ -0,0 +1,108 @@ +/** + +Doxygen Awesome +https://github.com/jothepro/doxygen-awesome-css + +MIT License + +Copyright (c) 2021 jothepro + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + + */ + +html { + /* side nav width. MUST be = `TREEVIEW_WIDTH`. + * Make sure it is wide enough to contain the page title (logo + title + version) + */ + --side-nav-fixed-width: 340px; + --menu-display: none; + + --top-height: 120px; +} + + +@media screen and (min-width: 768px) { + html { + --searchbar-background: var(--page-background-color); + } + + #side-nav { + min-width: var(--side-nav-fixed-width); + max-width: var(--side-nav-fixed-width); + top: var(--top-height); + overflow: visible; + } + + #nav-tree, #side-nav { + height: calc(100vh - var(--top-height)) !important; + } + + #nav-tree { + padding: 0; + } + + #top { + display: block; + border-bottom: none; + height: var(--top-height); + margin-bottom: calc(0px - var(--top-height)); + max-width: var(--side-nav-fixed-width); + background: var(--side-nav-background); + } + #main-nav { + float: left; + padding-right: 0; + } + + .ui-resizable-handle { + cursor: default; + width: 1px !important; + box-shadow: 0 calc(-2 * var(--top-height)) 0 0 var(--separator-color); + } + + #nav-path { + position: fixed; + right: 0; + left: var(--side-nav-fixed-width); + bottom: 0; + width: auto; + } + + #doc-content { + height: calc(100vh - 31px) !important; + padding-bottom: calc(3 * var(--spacing-large)); + padding-top: calc(var(--top-height) - 80px); + box-sizing: border-box; + margin-left: var(--side-nav-fixed-width) !important; + } + + #MSearchBox { + width: calc(var(--side-nav-fixed-width) - calc(2 * var(--spacing-medium))); + } + + #MSearchField { + width: calc(var(--side-nav-fixed-width) - calc(2 * var(--spacing-medium)) - 65px); + } + + #MSearchResultsWindow { + left: var(--spacing-medium) !important; + right: auto; + } +} diff --git a/physics/docs/_doxygen/doxygen-awesome.css b/physics/docs/_doxygen/doxygen-awesome.css new file mode 100644 index 000000000..217fdedfc --- /dev/null +++ b/physics/docs/_doxygen/doxygen-awesome.css @@ -0,0 +1,2136 @@ +/** + +Doxygen Awesome +https://github.com/jothepro/doxygen-awesome-css + +MIT License + +Copyright (c) 2021 - 2022 jothepro + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. + +*/ + +html { + /* primary theme color. This will affect the entire websites color scheme: links, arrows, labels, ... */ + --primary-color: #1779c4; + --primary-dark-color: #335c80; + --primary-light-color: #70b1e9; + + /* page base colors */ + --page-background-color: white; + --page-foreground-color: #2f4153; + --page-secondary-foreground-color: #637485; + + /* color for all separators on the website: hr, borders, ... */ + --separator-color: #dedede; + + /* border radius for all rounded components. Will affect many components, like dropdowns, memitems, codeblocks, ... */ + --border-radius-large: 8px; + --border-radius-small: 4px; + --border-radius-medium: 6px; + + /* default spacings. Most compontest reference these values for spacing, to provide uniform spacing on the page. */ + --spacing-small: 5px; + --spacing-medium: 10px; + --spacing-large: 16px; + + /* default box shadow used for raising an element above the normal content. Used in dropdowns, Searchresult, ... */ + --box-shadow: 0 2px 8px 0 rgba(0,0,0,.075); + + --odd-color: rgba(0,0,0,.028); + + /* font-families. will affect all text on the website + * font-family: the normal font for text, headlines, menus + * font-family-monospace: used for preformatted text in memtitle, code, fragments + */ + --font-family: -apple-system,BlinkMacSystemFont,Segoe UI,Roboto,Oxygen,Ubuntu,Cantarell,Fira Sans,Droid Sans,Helvetica Neue,sans-serif; + --font-family-monospace: ui-monospace,SFMono-Regular,SF Mono,Menlo,Consolas,Liberation Mono,monospace; + + /* font sizes */ + --page-font-size: 15.6px; + --navigation-font-size: 14.4px; + --code-font-size: 14px; /* affects code, fragment */ + --table-font-size: 12.5px; + --title-font-size: 22px; + + /* content text properties. These only affect the page content, not the navigation or any other ui elements */ + --content-line-height: 27px; + /* The content is centered and constraint in it's width. To make the content fill the whole page, set the variable to auto.*/ + --content-maxwidth: 1000px; + + /* colors for various content boxes: @warning, @note, @deprecated @bug */ + --warning-color: #f8d1cc; + --warning-color-dark: #b61825; + --warning-color-darker: #75070f; + --note-color: #faf3d8; + --note-color-dark: #f3a600; + --note-color-darker: #5f4204; + --todo-color: #e4f3ff; + --todo-color-dark: #1879C4; + --todo-color-darker: #274a5c; + --deprecated-color: #ecf0f3; + --deprecated-color-dark: #5b6269; + --deprecated-color-darker: #43454a; + --bug-color: #e4dafd; + --bug-color-dark: #5b2bdd; + --bug-color-darker: #2a0d72; + --invariant-color: #d8f1e3; + --invariant-color-dark: #44b86f; + --invariant-color-darker: #265532; + + /* blockquote colors */ + --blockquote-background: #f8f9fa; + --blockquote-foreground: #636568; + + /* table colors */ + --tablehead-background: #f1f1f1; + --tablehead-foreground: var(--page-foreground-color); + + /* menu-display: block | none + * Visibility of the top navigation on screens >= 768px. On smaller screen the menu is always visible. + * `GENERATE_TREEVIEW` MUST be enabled! + */ + --menu-display: block; + + --menu-focus-foreground: var(--page-background-color); + --menu-focus-background: var(--primary-color); + --menu-selected-background: rgba(0,0,0,.05); + + + --header-background: var(--page-background-color); + --header-foreground: var(--page-foreground-color); + + /* searchbar colors */ + --searchbar-background: var(--side-nav-background); + --searchbar-foreground: var(--page-foreground-color); + + /* searchbar size + * (`searchbar-width` is only applied on screens >= 768px. + * on smaller screens the searchbar will always fill the entire screen width) */ + --searchbar-height: 33px; + --searchbar-width: 210px; + --searchbar-border-radius: var(--searchbar-height); + + /* code block colors */ + --code-background: #f5f5f5; + --code-foreground: var(--page-foreground-color); + + /* fragment colors */ + --fragment-background: #F8F9FA; + --fragment-foreground: #37474F; + --fragment-keyword: #bb6bb2; + --fragment-keywordtype: #8258b3; + --fragment-keywordflow: #d67c3b; + --fragment-token: #438a59; + --fragment-comment: #969696; + --fragment-link: #5383d6; + --fragment-preprocessor: #46aaa5; + --fragment-linenumber-color: #797979; + --fragment-linenumber-background: #f4f4f5; + --fragment-linenumber-border: #e3e5e7; + --fragment-lineheight: 20px; + + /* sidebar navigation (treeview) colors */ + --side-nav-background: #fbfbfb; + --side-nav-foreground: var(--page-foreground-color); + --side-nav-arrow-opacity: 0; + --side-nav-arrow-hover-opacity: 0.9; + + --toc-background: var(--side-nav-background); + --toc-foreground: var(--side-nav-foreground); + + /* height of an item in any tree / collapsable table */ + --tree-item-height: 30px; + + --memname-font-size: var(--code-font-size); + --memtitle-font-size: 18px; + + --webkit-scrollbar-size: 7px; + --webkit-scrollbar-padding: 4px; + --webkit-scrollbar-color: var(--separator-color); +} + +@media screen and (max-width: 767px) { + html { + --page-font-size: 16px; + --navigation-font-size: 16px; + --code-font-size: 15px; /* affects code, fragment */ + --title-font-size: 22px; + } +} + +@media (prefers-color-scheme: dark) { + html:not(.light-mode) { + color-scheme: dark; + + --primary-color: #1982d2; + --primary-dark-color: #86a9c4; + --primary-light-color: #4779ac; + + --box-shadow: 0 2px 8px 0 rgba(0,0,0,.35); + + --odd-color: rgba(100,100,100,.06); + + --menu-selected-background: rgba(0,0,0,.4); + + --page-background-color: #1C1D1F; + --page-foreground-color: #d2dbde; + --page-secondary-foreground-color: #859399; + --separator-color: #38393b; + --side-nav-background: #252628; + + --code-background: #2a2c2f; + + --tablehead-background: #2a2c2f; + + --blockquote-background: #222325; + --blockquote-foreground: #7e8c92; + + --warning-color: #2e1917; + --warning-color-dark: #ad2617; + --warning-color-darker: #f5b1aa; + --note-color: #3b2e04; + --note-color-dark: #f1b602; + --note-color-darker: #ceb670; + --todo-color: #163750; + --todo-color-dark: #1982D2; + --todo-color-darker: #dcf0fa; + --deprecated-color: #2e323b; + --deprecated-color-dark: #738396; + --deprecated-color-darker: #abb0bd; + --bug-color: #2a2536; + --bug-color-dark: #7661b3; + --bug-color-darker: #ae9ed6; + --invariant-color: #303a35; + --invariant-color-dark: #76ce96; + --invariant-color-darker: #cceed5; + + --fragment-background: #282c34; + --fragment-foreground: #dbe4eb; + --fragment-keyword: #cc99cd; + --fragment-keywordtype: #ab99cd; + --fragment-keywordflow: #e08000; + --fragment-token: #7ec699; + --fragment-comment: #999999; + --fragment-link: #98c0e3; + --fragment-preprocessor: #65cabe; + --fragment-linenumber-color: #cccccc; + --fragment-linenumber-background: #35393c; + --fragment-linenumber-border: #1f1f1f; + } +} + +/* dark mode variables are defined twice, to support both the dark-mode without and with doxygen-awesome-darkmode-toggle.js */ +html.dark-mode { + color-scheme: dark; + + --primary-color: #1982d2; + --primary-dark-color: #86a9c4; + --primary-light-color: #4779ac; + + --box-shadow: 0 2px 8px 0 rgba(0,0,0,.30); + + --odd-color: rgba(100,100,100,.06); + + --menu-selected-background: rgba(0,0,0,.4); + + --page-background-color: #1C1D1F; + --page-foreground-color: #d2dbde; + --page-secondary-foreground-color: #859399; + --separator-color: #38393b; + --side-nav-background: #252628; + + --code-background: #2a2c2f; + + --tablehead-background: #2a2c2f; + + --blockquote-background: #222325; + --blockquote-foreground: #7e8c92; + + --warning-color: #2e1917; + --warning-color-dark: #ad2617; + --warning-color-darker: #f5b1aa; + --note-color: #3b2e04; + --note-color-dark: #f1b602; + --note-color-darker: #ceb670; + --todo-color: #163750; + --todo-color-dark: #1982D2; + --todo-color-darker: #dcf0fa; + --deprecated-color: #2e323b; + --deprecated-color-dark: #738396; + --deprecated-color-darker: #abb0bd; + --bug-color: #2a2536; + --bug-color-dark: #7661b3; + --bug-color-darker: #ae9ed6; + --invariant-color: #303a35; + --invariant-color-dark: #76ce96; + --invariant-color-darker: #cceed5; + + --fragment-background: #282c34; + --fragment-foreground: #dbe4eb; + --fragment-keyword: #cc99cd; + --fragment-keywordtype: #ab99cd; + --fragment-keywordflow: #e08000; + --fragment-token: #7ec699; + --fragment-comment: #999999; + --fragment-link: #98c0e3; + --fragment-preprocessor: #65cabe; + --fragment-linenumber-color: #cccccc; + --fragment-linenumber-background: #35393c; + --fragment-linenumber-border: #1f1f1f; +} + +body { + color: var(--page-foreground-color); + background-color: var(--page-background-color); + font-size: var(--page-font-size); +} + +body, table, div, p, dl, #nav-tree .label, .title, .sm-dox a, .sm-dox a:hover, .sm-dox a:focus, #projectname, .SelectItem, #MSearchField, .navpath li.navelem a, .navpath li.navelem a:hover { + font-family: var(--font-family); +} + +h1, h2, h3, h4, h5 { + margin-top: .9em; + font-weight: 600; + line-height: initial; +} + +p, div, table, dl { + font-size: var(--table-font-size); +} + +a:link, a:visited, a:hover, a:focus, a:active { + color: var(--primary-color) !important; + font-weight: 500; +} + +a.anchor { + scroll-margin-top: var(--spacing-large); +} + +/* + Title and top navigation + */ + +#top { + background: var(--header-background); + border-bottom: 1px solid var(--separator-color); +} + +@media screen and (min-width: 768px) { + #top { + display: flex; + flex-wrap: wrap; + justify-content: space-between; + align-items: center; + } +} + +#main-nav { + flex-grow: 5; + padding: var(--spacing-small) var(--spacing-medium); +} + +#titlearea { + width: auto; + padding: var(--spacing-medium) var(--spacing-large); + background: none; + color: var(--header-foreground); + border-bottom: none; +} + +@media screen and (max-width: 767px) { + #titlearea { + padding-bottom: var(--spacing-small); + } +} + +#titlearea table tbody tr { + height: auto !important; +} + +#projectname { + font-size: var(--title-font-size); + font-weight: 600; +} + +#projectnumber { + font-family: inherit; + font-size: 60%; +} + +#projectbrief { + font-family: inherit; + font-size: 80%; +} + +#projectlogo { + vertical-align: middle; +} + +#projectlogo img { + max-height: calc(var(--title-font-size) * 2); + margin-right: var(--spacing-small); +} + +.sm-dox, .tabs, .tabs2, .tabs3 { + background: none; + padding: 0; +} + +.tabs, .tabs2, .tabs3 { + border-bottom: 1px solid var(--separator-color); + margin-bottom: -1px; +} + +@media screen and (max-width: 767px) { + .sm-dox a span.sub-arrow { + background: var(--code-background); + } + + #main-menu a.has-submenu span.sub-arrow { + color: var(--page-secondary-foreground-color); + border-radius: var(--border-radius-medium); + } + + #main-menu a.has-submenu:hover span.sub-arrow { + color: var(--page-foreground-color); + } +} + +@media screen and (min-width: 768px) { + .sm-dox li, .tablist li { + display: var(--menu-display); + } + + .sm-dox a span.sub-arrow { + border-color: var(--header-foreground) transparent transparent transparent; + } + + .sm-dox a:hover span.sub-arrow { + border-color: var(--menu-focus-foreground) transparent transparent transparent; + } + + .sm-dox ul a span.sub-arrow { + border-color: transparent transparent transparent var(--page-foreground-color); + } + + .sm-dox ul a:hover span.sub-arrow { + border-color: transparent transparent transparent var(--menu-focus-foreground); + } +} + +.sm-dox ul { + background: var(--page-background-color); + box-shadow: var(--box-shadow); + border: 1px solid var(--separator-color); + border-radius: var(--border-radius-medium) !important; + padding: var(--spacing-small); + animation: ease-out 150ms slideInMenu; +} + +@keyframes slideInMenu { + from { + opacity: 0; + transform: translate(0px, -2px); + } + + to { + opacity: 1; + transform: translate(0px, 0px); + } +} + +.sm-dox ul a { + color: var(--page-foreground-color) !important; + background: var(--page-background-color); + font-size: var(--navigation-font-size); +} + +.sm-dox>li>ul:after { + border-bottom-color: var(--page-background-color) !important; +} + +.sm-dox>li>ul:before { + border-bottom-color: var(--separator-color) !important; +} + +.sm-dox ul a:hover, .sm-dox ul a:active, .sm-dox ul a:focus { + font-size: var(--navigation-font-size) !important; + color: var(--menu-focus-foreground) !important; + text-shadow: none; + background-color: var(--menu-focus-background); + border-radius: var(--border-radius-small) !important; +} + +.sm-dox a, .sm-dox a:focus, .tablist li, .tablist li a, .tablist li.current a { + text-shadow: none; + background: transparent; + background-image: none !important; + color: var(--header-foreground) !important; + font-weight: normal; + font-size: var(--navigation-font-size); + border-radius: var(--border-radius-small) !important; +} + +.sm-dox a:focus { + outline: auto; +} + +.sm-dox a:hover, .sm-dox a:active, .tablist li a:hover { + text-shadow: none; + font-weight: normal; + background: var(--menu-focus-background); + color: var(--menu-focus-foreground) !important; + border-radius: var(--border-radius-small) !important; + font-size: var(--navigation-font-size); +} + +.tablist li.current { + border-radius: var(--border-radius-small); + background: var(--menu-selected-background); +} + +.tablist li { + margin: var(--spacing-small) 0 var(--spacing-small) var(--spacing-small); +} + +.tablist a { + padding: 0 var(--spacing-large); +} + + +/* + Search box + */ + +#MSearchBox { + height: var(--searchbar-height); + background: var(--searchbar-background); + border-radius: var(--searchbar-border-radius); + border: 1px solid var(--separator-color); + overflow: hidden; + width: var(--searchbar-width); + position: relative; + box-shadow: none; + display: block; + margin-top: 0; +} + +.left #MSearchSelect { + left: 0; + user-select: none; +} + +.SelectionMark { + user-select: none; +} + +.tabs .left #MSearchSelect { + padding-left: 0; +} + +.tabs #MSearchBox { + position: absolute; + right: var(--spacing-medium); +} + +@media screen and (max-width: 767px) { + .tabs #MSearchBox { + position: relative; + right: 0; + margin-left: var(--spacing-medium); + margin-top: 0; + } +} + +#MSearchSelectWindow, #MSearchResultsWindow { + z-index: 9999; +} + +#MSearchBox.MSearchBoxActive { + border-color: var(--primary-color); + box-shadow: inset 0 0 0 1px var(--primary-color); +} + +#main-menu > li:last-child { + margin-right: 0; +} + +@media screen and (max-width: 767px) { + #main-menu > li:last-child { + height: 50px; + } +} + +#MSearchField { + font-size: var(--navigation-font-size); + height: calc(var(--searchbar-height) - 2px); + background: transparent; + width: calc(var(--searchbar-width) - 64px); +} + +.MSearchBoxActive #MSearchField { + color: var(--searchbar-foreground); +} + +#MSearchSelect { + top: calc(calc(var(--searchbar-height) / 2) - 11px); +} + +.left #MSearchSelect { + padding-left: 8px; +} + +#MSearchBox span.left, #MSearchBox span.right { + background: none; +} + +#MSearchBox span.right { + padding-top: calc(calc(var(--searchbar-height) / 2) - 12px); + position: absolute; + right: var(--spacing-small); +} + +.tabs #MSearchBox span.right { + top: calc(calc(var(--searchbar-height) / 2) - 12px); +} + +@keyframes slideInSearchResults { + from { + opacity: 0; + transform: translate(0, 15px); + } + + to { + opacity: 1; + transform: translate(0, 20px); + } +} + +#MSearchResultsWindow { + left: auto !important; + right: var(--spacing-medium); + border-radius: var(--border-radius-large); + border: 1px solid var(--separator-color); + transform: translate(0, 20px); + box-shadow: var(--box-shadow); + animation: ease-out 280ms slideInSearchResults; + background: var(--page-background-color); +} + +iframe#MSearchResults { + margin: 4px; +} + +iframe { + color-scheme: normal; +} + +@media (prefers-color-scheme: dark) { + html:not(.light-mode) iframe#MSearchResults { + filter: invert() hue-rotate(180deg); + } +} + +html.dark-mode iframe#MSearchResults { + filter: invert() hue-rotate(180deg); +} + +#MSearchSelectWindow { + border: 1px solid var(--separator-color); + border-radius: var(--border-radius-medium); + box-shadow: var(--box-shadow); + background: var(--page-background-color); + padding-top: var(--spacing-small); + padding-bottom: var(--spacing-small); +} + +#MSearchSelectWindow a.SelectItem { + font-size: var(--navigation-font-size); + line-height: var(--content-line-height); + margin: 0 var(--spacing-small); + border-radius: var(--border-radius-small); + color: var(--page-foreground-color) !important; + font-weight: normal; +} + +#MSearchSelectWindow a.SelectItem:hover { + background: var(--menu-focus-background); + color: var(--menu-focus-foreground) !important; +} + +@media screen and (max-width: 767px) { + #MSearchBox { + margin-top: var(--spacing-medium); + margin-bottom: var(--spacing-medium); + width: calc(100vw - 30px); + } + + #main-menu > li:last-child { + float: none !important; + } + + #MSearchField { + width: calc(100vw - 110px); + } + + @keyframes slideInSearchResultsMobile { + from { + opacity: 0; + transform: translate(0, 15px); + } + + to { + opacity: 1; + transform: translate(0, 20px); + } + } + + #MSearchResultsWindow { + left: var(--spacing-medium) !important; + right: var(--spacing-medium); + overflow: auto; + transform: translate(0, 20px); + animation: ease-out 280ms slideInSearchResultsMobile; + } + + /* + * Overwrites for fixing the searchbox on mobile in doxygen 1.9.2 + */ + label.main-menu-btn ~ #searchBoxPos1 { + top: 3px !important; + right: 6px !important; + left: 45px; + display: flex; + } + + label.main-menu-btn ~ #searchBoxPos1 > #MSearchBox { + margin-top: 0; + margin-bottom: 0; + flex-grow: 2; + float: left; + } +} + +/* + Tree view + */ + +#side-nav { + padding: 0 !important; + background: var(--side-nav-background); +} + +@media screen and (max-width: 767px) { + #side-nav { + display: none; + } + + #doc-content { + margin-left: 0 !important; + } +} + +#nav-tree { + background: transparent; +} + +#nav-tree .label { + font-size: var(--navigation-font-size); +} + +#nav-tree .item { + height: var(--tree-item-height); + line-height: var(--tree-item-height); +} + +#nav-sync { + bottom: 12px; + right: 12px; + top: auto !important; + user-select: none; +} + +#nav-tree .selected { + text-shadow: none; + background-image: none; + background-color: transparent; + position: relative; +} + +#nav-tree .selected::after { + content: ""; + position: absolute; + top: 1px; + bottom: 1px; + left: 0; + width: 4px; + border-radius: 0 var(--border-radius-small) var(--border-radius-small) 0; + background: var(--primary-color); +} + + +#nav-tree a { + color: var(--side-nav-foreground) !important; + font-weight: normal; +} + +#nav-tree a:focus { + outline-style: auto; +} + +#nav-tree .arrow { + opacity: var(--side-nav-arrow-opacity); +} + +.arrow { + color: inherit; + cursor: pointer; + font-size: 45%; + vertical-align: middle; + margin-right: 2px; + font-family: serif; + height: auto; + text-align: right; +} + +#nav-tree div.item:hover .arrow, #nav-tree a:focus .arrow { + opacity: var(--side-nav-arrow-hover-opacity); +} + +#nav-tree .selected a { + color: var(--primary-color) !important; + font-weight: bolder; + font-weight: 600; +} + +.ui-resizable-e { + background: var(--separator-color); + width: 1px; +} + +/* + Contents + */ + +div.header { + border-bottom: 1px solid var(--separator-color); + background-color: var(--page-background-color); + background-image: none; +} + +div.contents, div.header .title, div.header .summary { + max-width: var(--content-maxwidth); +} + +div.contents, div.header .title { + line-height: initial; + margin: calc(var(--spacing-medium) + .2em) auto var(--spacing-medium) auto; +} + +div.header .summary { + margin: var(--spacing-medium) auto 0 auto; +} + +div.headertitle { + padding: 0; +} + +div.header .title { + font-weight: 600; + font-size: 210%; + padding: var(--spacing-medium) var(--spacing-large); + word-break: break-word; +} + +div.header .summary { + width: auto; + display: block; + float: none; + padding: 0 var(--spacing-large); +} + +td.memSeparator { + border-color: var(--separator-color); +} + +span.mlabel { + background: var(--primary-color); + border: none; + padding: 4px 9px; + border-radius: 12px; + margin-right: var(--spacing-medium); +} + +span.mlabel:last-of-type { + margin-right: 2px; +} + +div.contents { + padding: 0 var(--spacing-large); +} + +div.contents p, div.contents li { + line-height: var(--content-line-height); +} + +div.contents div.dyncontent { + margin: var(--spacing-medium) 0; +} + +@media (prefers-color-scheme: dark) { + html:not(.light-mode) div.contents div.dyncontent img, + html:not(.light-mode) div.contents center img, + html:not(.light-mode) div.contents table img, + html:not(.light-mode) div.contents div.dyncontent iframe, + html:not(.light-mode) div.contents center iframe, + html:not(.light-mode) div.contents table iframe { + filter: hue-rotate(180deg) invert(); + } +} + +html.dark-mode div.contents div.dyncontent img, +html.dark-mode div.contents center img, +html.dark-mode div.contents table img, +html.dark-mode div.contents div.dyncontent iframe, +html.dark-mode div.contents center iframe, +html.dark-mode div.contents table iframe { + filter: hue-rotate(180deg) invert(); +} + +h2.groupheader { + border-bottom: 0px; + color: var(--page-foreground-color); + box-shadow: + 100px 0 var(--page-background-color), + -100px 0 var(--page-background-color), + 100px 0.75px var(--separator-color), + -100px 0.75px var(--separator-color), + 500px 0 var(--page-background-color), + -500px 0 var(--page-background-color), + 500px 0.75px var(--separator-color), + -500px 0.75px var(--separator-color), + 1500px 0 var(--page-background-color), + -1500px 0 var(--page-background-color), + 1500px 0.75px var(--separator-color), + -1500px 0.75px var(--separator-color), + 2000px 0 var(--page-background-color), + -2000px 0 var(--page-background-color), + 2000px 0.75px var(--separator-color), + -2000px 0.75px var(--separator-color); +} + +blockquote { + margin: 0 var(--spacing-medium) 0 var(--spacing-medium); + padding: var(--spacing-small) var(--spacing-large); + background: var(--blockquote-background); + color: var(--blockquote-foreground); + border-left: 0; + overflow: visible; + border-radius: var(--border-radius-medium); + overflow: visible; + position: relative; +} + +blockquote::before, blockquote::after { + font-weight: bold; + font-family: serif; + font-size: 360%; + opacity: .15; + position: absolute; +} + +blockquote::before { + content: "“"; + left: -10px; + top: 4px; +} + +blockquote::after { + content: "”"; + right: -8px; + bottom: -25px; +} + +blockquote p { + margin: var(--spacing-small) 0 var(--spacing-medium) 0; +} +.paramname { + font-weight: 600; + color: var(--primary-dark-color); +} + +.paramname > code { + border: 0; +} + +table.params .paramname { + font-weight: 600; + font-family: var(--font-family-monospace); + font-size: var(--code-font-size); + padding-right: var(--spacing-small); +} + +.glow { + text-shadow: 0 0 15px var(--primary-light-color) !important; +} + +.alphachar a { + color: var(--page-foreground-color); +} + +/* + Table of Contents + */ + +div.toc { + z-index: 10; + position: relative; + background-color: var(--toc-background); + border: 1px solid var(--separator-color); + border-radius: var(--border-radius-medium); + box-shadow: var(--box-shadow); + padding: 0 var(--spacing-large); + margin: 0 0 var(--spacing-medium) var(--spacing-medium); +} + +div.toc h3 { + color: var(--toc-foreground); + font-size: var(--navigation-font-size); + margin: var(--spacing-large) 0; +} + +div.toc li { + font-size: var(--navigation-font-size); + padding: 0; + background: none; +} + +div.toc li:before { + content: '↓'; + font-weight: 800; + font-family: var(--font-family); + margin-right: var(--spacing-small); + color: var(--toc-foreground); + opacity: .4; +} + +div.toc ul li.level1 { + margin: 0; +} + +div.toc ul li.level2, div.toc ul li.level3 { + margin-top: 0; +} + + +@media screen and (max-width: 767px) { + div.toc { + float: none; + width: auto; + margin: 0 0 var(--spacing-medium) 0; + } +} + +/* + Code & Fragments + */ + +code, div.fragment, pre.fragment { + border-radius: var(--border-radius-small); + border: 1px solid var(--separator-color); + overflow: hidden; +} + +code { + display: inline; + background: var(--code-background); + color: var(--code-foreground); + padding: 2px 6px; + word-break: break-word; +} + +div.fragment, pre.fragment { + margin: var(--spacing-medium) 0; + padding: calc(var(--spacing-large) - (var(--spacing-large) / 6)) var(--spacing-large); + background: var(--fragment-background); + color: var(--fragment-foreground); + overflow-x: auto; +} + +@media screen and (max-width: 767px) { + div.fragment, pre.fragment { + border-top-right-radius: 0; + border-bottom-right-radius: 0; + border-right: 0; + } + + .contents > div.fragment, + .textblock > div.fragment, + .textblock > pre.fragment, + .contents > .doxygen-awesome-fragment-wrapper > div.fragment, + .textblock > .doxygen-awesome-fragment-wrapper > div.fragment, + .textblock > .doxygen-awesome-fragment-wrapper > pre.fragment { + margin: var(--spacing-medium) calc(0px - var(--spacing-large)); + border-radius: 0; + border-left: 0; + } + + .textblock li > .fragment, + .textblock li > .doxygen-awesome-fragment-wrapper > .fragment { + margin: var(--spacing-medium) calc(0px - var(--spacing-large)); + } + + .memdoc li > .fragment, + .memdoc li > .doxygen-awesome-fragment-wrapper > .fragment { + margin: var(--spacing-medium) calc(0px - var(--spacing-medium)); + } + + .textblock ul, .memdoc ul { + overflow: initial; + } + + .memdoc > div.fragment, + .memdoc > pre.fragment, + dl dd > div.fragment, + dl dd pre.fragment, + .memdoc > .doxygen-awesome-fragment-wrapper > div.fragment, + .memdoc > .doxygen-awesome-fragment-wrapper > pre.fragment, + dl dd > .doxygen-awesome-fragment-wrapper > div.fragment, + dl dd .doxygen-awesome-fragment-wrapper > pre.fragment { + margin: var(--spacing-medium) calc(0px - var(--spacing-medium)); + border-radius: 0; + border-left: 0; + } +} + +code, code a, pre.fragment, div.fragment, div.fragment .line, div.fragment span, div.fragment .line a, div.fragment .line span { + font-family: var(--font-family-monospace); + font-size: var(--code-font-size) !important; +} + +div.line:after { + margin-right: var(--spacing-medium); +} + +div.fragment .line, pre.fragment { + white-space: pre; + word-wrap: initial; + line-height: var(--fragment-lineheight); +} + +div.fragment span.keyword { + color: var(--fragment-keyword); +} + +div.fragment span.keywordtype { + color: var(--fragment-keywordtype); +} + +div.fragment span.keywordflow { + color: var(--fragment-keywordflow); +} + +div.fragment span.stringliteral { + color: var(--fragment-token) +} + +div.fragment span.comment { + color: var(--fragment-comment); +} + +div.fragment a.code { + color: var(--fragment-link) !important; +} + +div.fragment span.preprocessor { + color: var(--fragment-preprocessor); +} + +div.fragment span.lineno { + display: inline-block; + width: 27px; + border-right: none; + background: var(--fragment-linenumber-background); + color: var(--fragment-linenumber-color); +} + +div.fragment span.lineno a { + background: none; + color: var(--fragment-link) !important; +} + +div.fragment .line:first-child .lineno { + box-shadow: -999999px 0px 0 999999px var(--fragment-linenumber-background), -999998px 0px 0 999999px var(--fragment-linenumber-border); +} + +/* + dl warning, attention, note, deprecated, bug, ... + */ + +dl.bug dt a, dl.deprecated dt a, dl.todo dt a { + font-weight: bold !important; +} + +dl.warning, dl.attention, dl.note, dl.deprecated, dl.bug, dl.invariant, dl.pre, dl.todo, dl.remark { + padding: var(--spacing-medium); + margin: var(--spacing-medium) 0; + color: var(--page-background-color); + overflow: hidden; + margin-left: 0; + border-radius: var(--border-radius-small); +} + +dl.section dd { + margin-bottom: 2px; +} + +dl.warning, dl.attention { + background: var(--warning-color); + border-left: 8px solid var(--warning-color-dark); + color: var(--warning-color-darker); +} + +dl.warning dt, dl.attention dt { + color: var(--warning-color-dark); +} + +dl.note, dl.remark { + background: var(--note-color); + border-left: 8px solid var(--note-color-dark); + color: var(--note-color-darker); +} + +dl.note dt, dl.remark dt { + color: var(--note-color-dark); +} + +dl.todo { + background: var(--todo-color); + border-left: 8px solid var(--todo-color-dark); + color: var(--todo-color-darker); +} + +dl.todo dt { + color: var(--todo-color-dark); +} + +dl.bug dt a { + color: var(--todo-color-dark) !important; +} + +dl.bug { + background: var(--bug-color); + border-left: 8px solid var(--bug-color-dark); + color: var(--bug-color-darker); +} + +dl.bug dt a { + color: var(--bug-color-dark) !important; +} + +dl.deprecated { + background: var(--deprecated-color); + border-left: 8px solid var(--deprecated-color-dark); + color: var(--deprecated-color-darker); +} + +dl.deprecated dt a { + color: var(--deprecated-color-dark) !important; +} + +dl.section dd, dl.bug dd, dl.deprecated dd, dl.todo dd { + margin-inline-start: 0px; +} + +dl.invariant, dl.pre { + background: var(--invariant-color); + border-left: 8px solid var(--invariant-color-dark); + color: var(--invariant-color-darker); +} + +dl.invariant dt, dl.pre dt { + color: var(--invariant-color-dark); +} + +/* + memitem + */ + +div.memdoc, div.memproto, h2.memtitle { + box-shadow: none; + background-image: none; + border: none; +} + +div.memdoc { + padding: 0 var(--spacing-medium); + background: var(--page-background-color); +} + +h2.memtitle, div.memitem { + border: 1px solid var(--separator-color); + box-shadow: var(--box-shadow); +} + +h2.memtitle { + box-shadow: 0px var(--spacing-medium) 0 -1px var(--fragment-background), var(--box-shadow); +} + +div.memitem { + transition: none; +} + +div.memproto, h2.memtitle { + background: var(--fragment-background); + text-shadow: none; +} + +h2.memtitle { + font-weight: 500; + font-size: var(--memtitle-font-size); + font-family: var(--font-family-monospace); + border-bottom: none; + border-top-left-radius: var(--border-radius-medium); + border-top-right-radius: var(--border-radius-medium); + word-break: break-all; + position: relative; +} + +h2.memtitle:after { + content: ""; + display: block; + background: var(--fragment-background); + height: var(--spacing-medium); + bottom: calc(0px - var(--spacing-medium)); + left: 0; + right: -14px; + position: absolute; + border-top-right-radius: var(--border-radius-medium); +} + +h2.memtitle > span.permalink { + font-size: inherit; +} + +h2.memtitle > span.permalink > a { + text-decoration: none; + padding-left: 3px; + margin-right: -4px; + user-select: none; + display: inline-block; + margin-top: -6px; +} + +h2.memtitle > span.permalink > a:hover { + color: var(--primary-dark-color) !important; +} + +a:target + h2.memtitle, a:target + h2.memtitle + div.memitem { + border-color: var(--primary-light-color); +} + +div.memitem { + border-top-right-radius: var(--border-radius-medium); + border-bottom-right-radius: var(--border-radius-medium); + border-bottom-left-radius: var(--border-radius-medium); + overflow: hidden; + display: block !important; +} + +div.memdoc { + border-radius: 0; +} + +div.memproto { + border-radius: 0 var(--border-radius-small) 0 0; + overflow: auto; + border-bottom: 1px solid var(--separator-color); + padding: var(--spacing-medium); + margin-bottom: -1px; +} + +div.memtitle { + border-top-right-radius: var(--border-radius-medium); + border-top-left-radius: var(--border-radius-medium); +} + +div.memproto table.memname { + font-family: var(--font-family-monospace); + color: var(--page-foreground-color); + font-size: var(--memname-font-size); +} + +div.memproto div.memtemplate { + font-family: var(--font-family-monospace); + color: var(--primary-dark-color); + font-size: var(--memname-font-size); + margin-left: 2px; +} + +table.mlabels, table.mlabels > tbody { + display: block; +} + +td.mlabels-left { + width: auto; +} + +td.mlabels-right { + margin-top: 3px; + position: sticky; + left: 0; +} + +table.mlabels > tbody > tr:first-child { + display: flex; + justify-content: space-between; + flex-wrap: wrap; +} + +.memname, .memitem span.mlabels { + margin: 0 +} + +/* + reflist + */ + +dl.reflist { + box-shadow: var(--box-shadow); + border-radius: var(--border-radius-medium); + border: 1px solid var(--separator-color); + overflow: hidden; + padding: 0; +} + + +dl.reflist dt, dl.reflist dd { + box-shadow: none; + text-shadow: none; + background-image: none; + border: none; + padding: 12px; +} + + +dl.reflist dt { + font-weight: 500; + border-radius: 0; + background: var(--code-background); + border-bottom: 1px solid var(--separator-color); + color: var(--page-foreground-color) +} + + +dl.reflist dd { + background: none; +} + +/* + Table + */ + +.contents table:not(.memberdecls):not(.mlabels):not(.fieldtable):not(.memname) { + display: inline-block; + max-width: 100%; + } + +.contents > table:not(.memberdecls):not(.mlabels):not(.fieldtable):not(.memname):not(.classindex) { + margin-left: calc(0px - var(--spacing-large)); + margin-right: calc(0px - var(--spacing-large)); + max-width: calc(100% + 2 * var(--spacing-large)); +} + +table.markdownTable, table.fieldtable { + border: none; + margin: var(--spacing-medium) 0; + box-shadow: 0 0 0 1px var(--separator-color); + border-radius: var(--border-radius-small); +} + +table.fieldtable { + width: 100%; +} + +th.markdownTableHeadLeft, th.markdownTableHeadRight, th.markdownTableHeadCenter, th.markdownTableHeadNone { + background: var(--tablehead-background); + color: var(--tablehead-foreground); + font-weight: 600; + font-size: var(--page-font-size); +} + +th.markdownTableHeadLeft:first-child, th.markdownTableHeadRight:first-child, th.markdownTableHeadCenter:first-child, th.markdownTableHeadNone:first-child { + border-top-left-radius: var(--border-radius-small); +} + +th.markdownTableHeadLeft:last-child, th.markdownTableHeadRight:last-child, th.markdownTableHeadCenter:last-child, th.markdownTableHeadNone:last-child { + border-top-right-radius: var(--border-radius-small); +} + +table.markdownTable td, table.markdownTable th, table.fieldtable dt { + border: none; + border-right: 1px solid var(--separator-color); + padding: var(--spacing-small) var(--spacing-medium); +} + +table.markdownTable td:last-child, table.markdownTable th:last-child, table.fieldtable dt:last-child { + border: none; +} + +table.markdownTable tr, table.markdownTable tr { + border-bottom: 1px solid var(--separator-color); +} + +table.markdownTable tr:last-child, table.markdownTable tr:last-child { + border-bottom: none; +} + +table.fieldtable th { + font-size: var(--page-font-size); + font-weight: 600; + background-image: none; + background-color: var(--tablehead-background); + color: var(--tablehead-foreground); + border-bottom: 1px solid var(--separator-color); +} + +.fieldtable td.fieldtype, .fieldtable td.fieldname { + border-bottom: 1px solid var(--separator-color); + border-right: 1px solid var(--separator-color); +} + +.fieldtable td.fielddoc { + border-bottom: 1px solid var(--separator-color); +} + +.memberdecls td.glow, .fieldtable tr.glow { + background-color: var(--primary-light-color); + box-shadow: 0 0 15px var(--primary-light-color); +} + +table.memberdecls { + display: block; +} + +table.memberdecls tr[class^='memitem'] { + font-family: var(--font-family-monospace); + font-size: var(--code-font-size); +} + +table.memberdecls tr[class^='memitem'] .memTemplParams { + font-family: var(--font-family-monospace); + font-size: var(--code-font-size); + color: var(--primary-dark-color); +} + +table.memberdecls .memItemLeft, +table.memberdecls .memItemRight, +table.memberdecls .memTemplItemLeft, +table.memberdecls .memTemplItemRight, +table.memberdecls .memTemplParams { + transition: none; + padding-top: var(--spacing-small); + padding-bottom: var(--spacing-small); + border-top: 1px solid var(--separator-color); + border-bottom: 1px solid var(--separator-color); + background-color: var(--fragment-background); +} + +table.memberdecls .memTemplItemLeft, +table.memberdecls .memTemplItemRight { + padding-top: 2px; +} + +table.memberdecls .memTemplParams { + border-bottom: 0; + border-left: 1px solid var(--separator-color); + border-right: 1px solid var(--separator-color); + border-radius: var(--border-radius-small) var(--border-radius-small) 0 0; + padding-bottom: 0; +} + +table.memberdecls .memTemplItemLeft { + border-radius: 0 0 0 var(--border-radius-small); + border-left: 1px solid var(--separator-color); + border-top: 0; +} + +table.memberdecls .memTemplItemRight { + border-radius: 0 0 var(--border-radius-small) 0; + border-right: 1px solid var(--separator-color); + border-top: 0; +} + +table.memberdecls .memItemLeft { + border-radius: var(--border-radius-small) 0 0 var(--border-radius-small); + border-left: 1px solid var(--separator-color); + padding-left: var(--spacing-medium); + padding-right: 0; +} + +table.memberdecls .memItemRight { + border-radius: 0 var(--border-radius-small) var(--border-radius-small) 0; + border-right: 1px solid var(--separator-color); + padding-right: var(--spacing-medium); + padding-left: 0; + +} + +table.memberdecls .mdescLeft, table.memberdecls .mdescRight { + background: none; + color: var(--page-foreground-color); + padding: var(--spacing-small) 0; +} + +table.memberdecls .memSeparator { + background: var(--page-background-color); + height: var(--spacing-large); + border: 0; + transition: none; +} + +table.memberdecls .groupheader { + margin-bottom: var(--spacing-large); +} + +table.memberdecls .inherit_header td { + padding: 0 0 var(--spacing-medium) 0; + text-indent: -12px; + line-height: 1.5em; + color: var(--page-secondary-foreground-color); +} + +@media screen and (max-width: 767px) { + + table.memberdecls .memItemLeft, + table.memberdecls .memItemRight, + table.memberdecls .mdescLeft, + table.memberdecls .mdescRight, + table.memberdecls .memTemplItemLeft, + table.memberdecls .memTemplItemRight, + table.memberdecls .memTemplParams { + display: block; + text-align: left; + padding-left: var(--spacing-large); + margin: 0 calc(0px - var(--spacing-large)) 0 calc(0px - var(--spacing-large)); + border-right: none; + border-left: none; + border-radius: 0; + } + + table.memberdecls .memItemLeft, + table.memberdecls .mdescLeft, + table.memberdecls .memTemplItemLeft { + border-bottom: 0; + padding-bottom: 0; + } + + table.memberdecls .memTemplItemLeft { + padding-top: 0; + } + + table.memberdecls .mdescLeft { + margin-top: calc(0px - var(--page-font-size)); + } + + table.memberdecls .memItemRight, + table.memberdecls .mdescRight, + table.memberdecls .memTemplItemRight { + border-top: 0; + padding-top: 0; + padding-right: var(--spacing-large); + overflow-x: auto; + } + + table.memberdecls tr[class^='memitem']:not(.inherit) { + display: block; + width: calc(100vw - 2 * var(--spacing-large)); + } + + table.memberdecls .mdescRight { + color: var(--page-foreground-color); + } + + table.memberdecls tr.inherit { + visibility: hidden; + } + + table.memberdecls tr[style="display: table-row;"] { + display: block !important; + visibility: visible; + width: calc(100vw - 2 * var(--spacing-large)); + animation: fade .5s; + } + + @keyframes fade { + 0% { + opacity: 0; + max-height: 0; + } + + 100% { + opacity: 1; + max-height: 200px; + } + } +} + + +/* + Horizontal Rule + */ + +hr { + margin-top: var(--spacing-large); + margin-bottom: var(--spacing-large); + height: 1px; + background-color: var(--separator-color); + border: 0; +} + +.contents hr { + box-shadow: 100px 0 0 var(--separator-color), + -100px 0 0 var(--separator-color), + 500px 0 0 var(--separator-color), + -500px 0 0 var(--separator-color), + 1500px 0 0 var(--separator-color), + -1500px 0 0 var(--separator-color), + 2000px 0 0 var(--separator-color), + -2000px 0 0 var(--separator-color); +} + +.contents img, .contents .center, .contents center, .contents div.image object { + max-width: 100%; + overflow: auto; +} + +@media screen and (max-width: 767px) { + .contents .dyncontent > .center, .contents > center { + margin-left: calc(0px - var(--spacing-large)); + margin-right: calc(0px - var(--spacing-large)); + max-width: calc(100% + 2 * var(--spacing-large)); + } +} + +/* + Directories + */ +div.directory { + border-top: 1px solid var(--separator-color); + border-bottom: 1px solid var(--separator-color); + width: auto; +} + +table.directory { + font-family: var(--font-family); + font-size: var(--page-font-size); + font-weight: normal; + width: 100%; +} + +table.directory td.entry { + padding: var(--spacing-small); +} + +table.directory td.desc { + min-width: 250px; +} + +table.directory tr.even { + background-color: var(--odd-color); +} + +.icona { + width: auto; + height: auto; + margin: 0 var(--spacing-small); +} + +.icon { + background: var(--primary-color); + width: 18px; + height: 18px; + line-height: 18px; +} + +.iconfopen, .icondoc, .iconfclosed { + background-position: center; + margin-bottom: 0; +} + +.icondoc { + filter: saturate(0.2); +} + +@media screen and (max-width: 767px) { + div.directory { + margin-left: calc(0px - var(--spacing-large)); + margin-right: calc(0px - var(--spacing-large)); + } +} + +@media (prefers-color-scheme: dark) { + html:not(.light-mode) .iconfopen, html:not(.light-mode) .iconfclosed { + filter: hue-rotate(180deg) invert(); + } +} + +html.dark-mode .iconfopen, html.dark-mode .iconfclosed { + filter: hue-rotate(180deg) invert(); +} + +/* + Class list + */ + +.classindex dl.odd { + background: var(--odd-color); + border-radius: var(--border-radius-small); +} + +/* + Class Index Doxygen 1.8 +*/ + +table.classindex { + margin-left: 0; + margin-right: 0; + width: 100%; +} + +table.classindex table div.ah { + background-image: none; + background-color: initial; + border-color: var(--separator-color); + color: var(--page-foreground-color); + box-shadow: var(--box-shadow); + border-radius: var(--border-radius-large); + padding: var(--spacing-small); +} + +div.qindex { + background-color: var(--odd-color); + border-radius: var(--border-radius-small); + border: 1px solid var(--separator-color); + padding: var(--spacing-small) 0; +} + +/* + Footer and nav-path + */ + +#nav-path { + width: 100%; +} + +#nav-path ul { + background-image: none; + background: var(--page-background-color); + border: none; + border-top: 1px solid var(--separator-color); + border-bottom: 1px solid var(--separator-color); + border-bottom: 0; + box-shadow: 0 0.75px 0 var(--separator-color); + font-size: var(--navigation-font-size); +} + +img.footer { + width: 60px; +} + +.navpath li.footer { + color: var(--page-secondary-foreground-color); +} + +address.footer { + color: var(--page-secondary-foreground-color); + margin-bottom: var(--spacing-large); +} + +#nav-path li.navelem { + background-image: none; + display: flex; + align-items: center; +} + +.navpath li.navelem a { + text-shadow: none; + display: inline-block; + color: var(--primary-color) !important; +} + +.navpath li.navelem b { + color: var(--primary-dark-color); + font-weight: 500; +} + +li.navelem { + padding: 0; + margin-left: -8px; +} + +li.navelem:first-child { + margin-left: var(--spacing-large); +} + +li.navelem:first-child:before { + display: none; +} + +#nav-path li.navelem:after { + content: ''; + border: 5px solid var(--page-background-color); + border-bottom-color: transparent; + border-right-color: transparent; + border-top-color: transparent; + transform: translateY(-1px) scaleY(4.2); + z-index: 10; + margin-left: 6px; +} + +#nav-path li.navelem:before { + content: ''; + border: 5px solid var(--separator-color); + border-bottom-color: transparent; + border-right-color: transparent; + border-top-color: transparent; + transform: translateY(-1px) scaleY(3.2); + margin-right: var(--spacing-small); +} + +.navpath li.navelem a:hover { + color: var(--primary-color); +} + +/* + Scrollbars for Webkit +*/ + +#nav-tree::-webkit-scrollbar, +div.fragment::-webkit-scrollbar, +pre.fragment::-webkit-scrollbar, +div.memproto::-webkit-scrollbar, +.contents center::-webkit-scrollbar, +.contents .center::-webkit-scrollbar, +.contents table:not(.memberdecls):not(.mlabels):not(.fieldtable):not(.memname)::-webkit-scrollbar { + width: calc(var(--webkit-scrollbar-size) + var(--webkit-scrollbar-padding) + var(--webkit-scrollbar-padding)); + height: calc(var(--webkit-scrollbar-size) + var(--webkit-scrollbar-padding) + var(--webkit-scrollbar-padding)); +} + +#nav-tree::-webkit-scrollbar-thumb, +div.fragment::-webkit-scrollbar-thumb, +pre.fragment::-webkit-scrollbar-thumb, +div.memproto::-webkit-scrollbar-thumb, +.contents center::-webkit-scrollbar-thumb, +.contents .center::-webkit-scrollbar-thumb, +.contents table:not(.memberdecls):not(.mlabels):not(.fieldtable):not(.memname)::-webkit-scrollbar-thumb { + background-color: transparent; + border: var(--webkit-scrollbar-padding) solid transparent; + border-radius: calc(var(--webkit-scrollbar-padding) + var(--webkit-scrollbar-padding)); + background-clip: padding-box; +} + +#nav-tree:hover::-webkit-scrollbar-thumb, +div.fragment:hover::-webkit-scrollbar-thumb, +pre.fragment:hover::-webkit-scrollbar-thumb, +div.memproto:hover::-webkit-scrollbar-thumb, +.contents center:hover::-webkit-scrollbar-thumb, +.contents .center:hover::-webkit-scrollbar-thumb, +.contents table:not(.memberdecls):not(.mlabels):not(.fieldtable):not(.memname):hover::-webkit-scrollbar-thumb { + background-color: var(--webkit-scrollbar-color); +} + +#nav-tree::-webkit-scrollbar-track, +div.fragment::-webkit-scrollbar-track, +pre.fragment::-webkit-scrollbar-track, +div.memproto::-webkit-scrollbar-track, +.contents center::-webkit-scrollbar-track, +.contents .center::-webkit-scrollbar-track, +.contents table:not(.memberdecls):not(.mlabels):not(.fieldtable):not(.memname)::-webkit-scrollbar-track { + background: transparent; +} + +#nav-tree::-webkit-scrollbar-corner { + background-color: var(--side-nav-background); +} + +#nav-tree, +div.fragment, +pre.fragment, +div.memproto, +.contents center, +.contents .center, +.contents table:not(.memberdecls):not(.mlabels):not(.fieldtable):not(.memname) { + overflow-x: auto; + overflow-x: overlay; +} + +#nav-tree { + overflow-x: auto; + overflow-y: auto; + overflow-y: overlay; +} + +/* + Scrollbars for Firefox +*/ + +#nav-tree, +div.fragment, +pre.fragment, +div.memproto, +.contents center, +.contents .center, +.contents table:not(.memberdecls):not(.mlabels):not(.fieldtable):not(.memname) { + scrollbar-width: thin; +} + +/* + Optional Dark mode toggle button +*/ + +doxygen-awesome-dark-mode-toggle { + display: inline-block; + margin: 0 0 0 var(--spacing-small); + padding: 0; + width: var(--searchbar-height); + height: var(--searchbar-height); + background: none; + border: none; + border-radius: var(--searchbar-height); + vertical-align: middle; + text-align: center; + line-height: var(--searchbar-height); + font-size: 22px; + display: flex; + align-items: center; + justify-content: center; + user-select: none; + cursor: pointer; +} + +doxygen-awesome-dark-mode-toggle > svg { + transition: transform .1s ease-in-out; +} + +doxygen-awesome-dark-mode-toggle:active > svg { + transform: scale(.5); +} + +doxygen-awesome-dark-mode-toggle:hover { + background-color: rgba(0,0,0,.03); +} + +html.dark-mode doxygen-awesome-dark-mode-toggle:hover { + background-color: rgba(0,0,0,.18); +} + +/* + Optional fragment copy button +*/ +.doxygen-awesome-fragment-wrapper { + position: relative; +} + +doxygen-awesome-fragment-copy-button { + opacity: 0; + background: var(--fragment-background); + width: 28px; + height: 28px; + position: absolute; + right: calc(var(--spacing-large) - (var(--spacing-large) / 2.5)); + top: calc(var(--spacing-large) - (var(--spacing-large) / 2.5)); + border: 1px solid var(--fragment-foreground); + cursor: pointer; + border-radius: var(--border-radius-small); + display: flex; + justify-content: center; + align-items: center; +} + +.doxygen-awesome-fragment-wrapper:hover doxygen-awesome-fragment-copy-button, doxygen-awesome-fragment-copy-button.success { + opacity: .28; +} + +doxygen-awesome-fragment-copy-button:hover, doxygen-awesome-fragment-copy-button.success { + opacity: 1 !important; +} + +doxygen-awesome-fragment-copy-button:active:not([class~=success]) svg { + transform: scale(.91); +} + +doxygen-awesome-fragment-copy-button svg { + fill: var(--fragment-foreground); + width: 18px; + height: 18px; +} + +doxygen-awesome-fragment-copy-button.success svg { + fill: rgb(14, 168, 14); +} + +doxygen-awesome-fragment-copy-button.success { + border-color: rgb(14, 168, 14); +} + +@media screen and (max-width: 767px) { + .textblock > .doxygen-awesome-fragment-wrapper > doxygen-awesome-fragment-copy-button, + .textblock li > .doxygen-awesome-fragment-wrapper > doxygen-awesome-fragment-copy-button, + .memdoc li > .doxygen-awesome-fragment-wrapper > doxygen-awesome-fragment-copy-button, + .memdoc > .doxygen-awesome-fragment-wrapper > doxygen-awesome-fragment-copy-button, + dl dd > .doxygen-awesome-fragment-wrapper > doxygen-awesome-fragment-copy-button { + right: 0; + } +} + +/* + Optional paragraph link button +*/ + +a.anchorlink { + font-size: 90%; + margin-left: var(--spacing-small); + color: var(--page-foreground-color) !important; + text-decoration: none; + opacity: .15; + display: none; + transition: opacity .1s ease-in-out, color .1s ease-in-out; +} + +a.anchorlink svg { + fill: var(--page-foreground-color); +} + +h3 a.anchorlink svg, h4 a.anchorlink svg { + margin-bottom: -3px; + margin-top: -4px; +} + +a.anchorlink:hover { + opacity: .45; +} + +h2:hover a.anchorlink, h1:hover a.anchorlink, h3:hover a.anchorlink, h4:hover a.anchorlink { + display: inline-block; +} diff --git a/physics/docs/_doxygen/footer.html b/physics/docs/_doxygen/footer.html new file mode 100644 index 000000000..9d24d69b7 --- /dev/null +++ b/physics/docs/_doxygen/footer.html @@ -0,0 +1,31 @@ + + + + + + +
+$generatedby doxygen $doxygenversion +
+ + + + diff --git a/physics/docs/_doxygen/header.html b/physics/docs/_doxygen/header.html new file mode 100644 index 000000000..2e72051ea --- /dev/null +++ b/physics/docs/_doxygen/header.html @@ -0,0 +1,62 @@ + + + + + + + + +$projectname: $title +$title + + + + + + +$treeview +$search +$mathjax + +$extrastylesheet + + +
+ + +
+ + + + + + + + + + + + + + + + + + + + + +
+
$projectname +  $projectnumber +
+
$projectbrief
+ 		+
$projectbrief
+ 		$searchbox
+
+ + diff --git a/physics/docs/ccpp_dox b/physics/docs/ccpp_dox deleted file mode 100644 index b28746a91..000000000 --- a/physics/docs/ccpp_dox +++ /dev/null @@ -1,339 +0,0 @@ -# Doxyfile 1.8.11 -DOXYFILE_ENCODING = UTF-8 -PROJECT_NAME = "GMTB Common Community Physics Package (CCPP) Scientific Documentation" -PROJECT_NUMBER = "Version 1.0" -PROJECT_BRIEF = "" -PROJECT_LOGO = img/dtc_logo.png -OUTPUT_DIRECTORY = doc -CREATE_SUBDIRS = NO -ALLOW_UNICODE_NAMES = NO -OUTPUT_LANGUAGE = English -BRIEF_MEMBER_DESC = YES -REPEAT_BRIEF = NO -ABBREVIATE_BRIEF = -ALWAYS_DETAILED_SEC = NO -INLINE_INHERITED_MEMB = NO -FULL_PATH_NAMES = YES -STRIP_FROM_PATH = -STRIP_FROM_INC_PATH = -SHORT_NAMES = NO -JAVADOC_AUTOBRIEF = NO -QT_AUTOBRIEF = NO -MULTILINE_CPP_IS_BRIEF = NO -INHERIT_DOCS = YES -SEPARATE_MEMBER_PAGES = NO -TAB_SIZE = 4 -ALIASES = -TCL_SUBST = -OPTIMIZE_OUTPUT_FOR_C = NO -OPTIMIZE_OUTPUT_JAVA = NO -OPTIMIZE_FOR_FORTRAN = YES -OPTIMIZE_OUTPUT_VHDL = NO -EXTENSION_MAPPING = .f=FortranFixed \ - .f90=FortranFree \ - .f=FortranFree -MARKDOWN_SUPPORT = YES -AUTOLINK_SUPPORT = YES -BUILTIN_STL_SUPPORT = NO -CPP_CLI_SUPPORT = NO -SIP_SUPPORT = NO -IDL_PROPERTY_SUPPORT = YES -DISTRIBUTE_GROUP_DOC = NO -GROUP_NESTED_COMPOUNDS = NO -SUBGROUPING = YES -INLINE_GROUPED_CLASSES = NO -INLINE_SIMPLE_STRUCTS = NO -TYPEDEF_HIDES_STRUCT = NO -LOOKUP_CACHE_SIZE = 0 -EXTRACT_ALL = NO -EXTRACT_PRIVATE = YES -EXTRACT_PACKAGE = NO -EXTRACT_STATIC = NO -EXTRACT_LOCAL_CLASSES = YES -EXTRACT_LOCAL_METHODS = NO -EXTRACT_ANON_NSPACES = NO -HIDE_UNDOC_MEMBERS = NO -HIDE_UNDOC_CLASSES = NO -HIDE_FRIEND_COMPOUNDS = NO -HIDE_IN_BODY_DOCS = NO -INTERNAL_DOCS = NO - -CASE_SENSE_NAMES = NO - -HIDE_SCOPE_NAMES = NO - -HIDE_COMPOUND_REFERENCE= NO - -SHOW_INCLUDE_FILES = YES - -SHOW_GROUPED_MEMB_INC = NO - -FORCE_LOCAL_INCLUDES = NO - -INLINE_INFO = YES - -SORT_MEMBER_DOCS = YES - -SORT_BRIEF_DOCS = NO -SORT_MEMBERS_CTORS_1ST = NO -SORT_GROUP_NAMES = NO -SORT_BY_SCOPE_NAME = NO -STRICT_PROTO_MATCHING = NO -GENERATE_TODOLIST = YES -GENERATE_TESTLIST = YES -GENERATE_BUGLIST = YES -GENERATE_DEPRECATEDLIST= YES -ENABLED_SECTIONS = -MAX_INITIALIZER_LINES = 30 -SHOW_USED_FILES = YES -SHOW_FILES = YES -SHOW_NAMESPACES = YES -FILE_VERSION_FILTER = -LAYOUT_FILE = ccpp_dox_layout.xml -CITE_BIB_FILES = library.bib -QUIET = NO -WARNINGS = YES -WARN_IF_UNDOCUMENTED = NO -WARN_IF_DOC_ERROR = YES -WARN_NO_PARAMDOC = NO -WARN_AS_ERROR = NO -WARN_FORMAT = -WARN_LOGFILE = -INPUT = txt/mainpage_bootstrapped.txt \ - txt/GFS_RRTMG.txt \ - txt/GFS_SAMFdeep.txt \ - txt/GFS_SAMFshal.txt \ - txt/GFS_HEDMF.txt \ - txt/GFS_ZHAOC.txt \ - txt/GFS_SFCLYR.txt \ - txt/GFS_SFCSICE.txt \ - txt/GFS_NOAH.txt \ - txt/GFS_NSST.txt \ - txt/GFS_GWDPS.txt \ - txt/GFS_GWDC.txt \ - txt/GFS_OZPHYS.txt \ -### Radiation - ../radiation_aerosols.f \ - ../radiation_astronomy.f \ - ../radiation_clouds.f \ - ../radiation_gases.f \ - ../radiation_surface.f \ - ../radlw_datatb.f \ - ../radlw_main.f \ - ../radlw_param.f \ - ../radsw_datatb.f \ - ../radsw_main.f \ - ../radsw_param.f \ - ../GFS_radupdate.f90 \ -### Deep Convection - ../mfdeepcnv.f \ -### Shallow Convection - ../mfshalcnv.f \ -### PBL - ../moninedmf.f \ - ../mfpbl.f \ - ../tridi.f \ -### Microphysics - ../precpd.f \ - ../gscond.f \ -### Land Surface - ../sfc_drv.f \ - ../sflx.f \ - ../sfc_diff.f \ - ../GFS_calpreciptype.f90 \ -### Sea Ice Surface - ../sfc_sice.f \ -### Ocean Surface - ../sfc_nst.f \ - ../module_nst_model.f90 \ - ../module_nst_water_prop.f90 \ - ../module_nst_parameters.f90 \ -### Orographic Gravity Wave - ../gwdps.f \ -### Convective Gravity Wave - ../gwdc.f \ -### Prognostic Ozone - ../ozinterp.f90 \ - ../ozphys.f \ -INPUT_ENCODING = UTF-8 -FILE_PATTERNS = *.f \ - *.f90 \ - *.txt -RECURSIVE = YES -EXCLUDE = -EXCLUDE_SYMLINKS = NO -EXCLUDE_PATTERNS = -EXCLUDE_SYMBOLS = -EXAMPLE_PATH = -EXAMPLE_PATTERNS = -EXAMPLE_RECURSIVE = NO -IMAGE_PATH = img -INPUT_FILTER = -FILTER_PATTERNS = -FILTER_SOURCE_FILES = NO -FILTER_SOURCE_PATTERNS = -USE_MDFILE_AS_MAINPAGE = -SOURCE_BROWSER = YES -INLINE_SOURCES = NO -STRIP_CODE_COMMENTS = YES -REFERENCED_BY_RELATION = YES -REFERENCES_RELATION = YES -REFERENCES_LINK_SOURCE = YES -SOURCE_TOOLTIPS = YES -USE_HTAGS = NO -VERBATIM_HEADERS = YES -#CLANG_ASSISTED_PARSING = NO -#CLANG_OPTIONS = -ALPHABETICAL_INDEX = YES -COLS_IN_ALPHA_INDEX = 5 -IGNORE_PREFIX = -GENERATE_HTML = YES -HTML_OUTPUT = html -HTML_FILE_EXTENSION = .html -HTML_HEADER = -HTML_FOOTER = -HTML_STYLESHEET = -HTML_EXTRA_STYLESHEET = ccpp_dox_extra_style.css -HTML_EXTRA_FILES = -HTML_COLORSTYLE_HUE = 220 -HTML_COLORSTYLE_SAT = 100 -HTML_COLORSTYLE_GAMMA = 80 -HTML_TIMESTAMP = NO -HTML_DYNAMIC_SECTIONS = NO -HTML_INDEX_NUM_ENTRIES = 100 -GENERATE_DOCSET = NO -DOCSET_FEEDNAME = "Doxygen generated docs" -DOCSET_BUNDLE_ID = org.doxygen.Project -DOCSET_PUBLISHER_ID = org.doxygen.Publisher -DOCSET_PUBLISHER_NAME = Publisher -GENERATE_HTMLHELP = NO -CHM_FILE = -HHC_LOCATION = -GENERATE_CHI = NO -CHM_INDEX_ENCODING = -BINARY_TOC = NO -TOC_EXPAND = NO -GENERATE_QHP = NO -QCH_FILE = -QHP_NAMESPACE = org.doxygen.Project -QHP_VIRTUAL_FOLDER = doc -QHP_CUST_FILTER_NAME = -QHP_CUST_FILTER_ATTRS = -QHP_SECT_FILTER_ATTRS = -QHG_LOCATION = -GENERATE_ECLIPSEHELP = NO -ECLIPSE_DOC_ID = org.doxygen.Project -DISABLE_INDEX = YES -GENERATE_TREEVIEW = YES -ENUM_VALUES_PER_LINE = 4 -TREEVIEW_WIDTH = 250 -EXT_LINKS_IN_WINDOW = NO -FORMULA_FONTSIZE = 10 -FORMULA_TRANSPARENT = YES -USE_MATHJAX = YES -MATHJAX_FORMAT = HTML-CSS -MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.1 -MATHJAX_EXTENSIONS = -MATHJAX_CODEFILE = -SEARCHENGINE = YES -SERVER_BASED_SEARCH = NO -EXTERNAL_SEARCH = NO -SEARCHENGINE_URL = -SEARCHDATA_FILE = searchdata.xml -EXTERNAL_SEARCH_ID = -EXTRA_SEARCH_MAPPINGS = -GENERATE_LATEX = YES -LATEX_OUTPUT = latex -LATEX_CMD_NAME = latex -MAKEINDEX_CMD_NAME = makeindex -COMPACT_LATEX = NO -PAPER_TYPE = a4 -EXTRA_PACKAGES = amsmath -LATEX_HEADER = -LATEX_FOOTER = -LATEX_EXTRA_STYLESHEET = -LATEX_EXTRA_FILES = -PDF_HYPERLINKS = YES -USE_PDFLATEX = YES -LATEX_BATCHMODE = NO -LATEX_HIDE_INDICES = NO -LATEX_SOURCE_CODE = NO - -LATEX_BIB_STYLE = plainnat - -LATEX_TIMESTAMP = NO - -GENERATE_RTF = NO - -RTF_OUTPUT = rtf -COMPACT_RTF = NO -RTF_HYPERLINKS = NO -RTF_STYLESHEET_FILE = -RTF_EXTENSIONS_FILE = -RTF_SOURCE_CODE = NO -GENERATE_MAN = NO -MAN_OUTPUT = man -MAN_EXTENSION = .3 -MAN_SUBDIR = -MAN_LINKS = NO -GENERATE_XML = NO -XML_OUTPUT = xml -XML_PROGRAMLISTING = YES -GENERATE_DOCBOOK = NO -DOCBOOK_OUTPUT = docbook -DOCBOOK_PROGRAMLISTING = NO -GENERATE_AUTOGEN_DEF = NO -GENERATE_PERLMOD = NO -PERLMOD_LATEX = NO -PERLMOD_PRETTY = YES -PERLMOD_MAKEVAR_PREFIX = -ENABLE_PREPROCESSING = YES -MACRO_EXPANSION = NO -EXPAND_ONLY_PREDEF = NO -SEARCH_INCLUDES = YES -INCLUDE_PATH = -INCLUDE_FILE_PATTERNS = -PREDEFINED = -EXPAND_AS_DEFINED = -SKIP_FUNCTION_MACROS = YES -TAGFILES = -GENERATE_TAGFILE = -ALLEXTERNALS = NO -EXTERNAL_GROUPS = YES -EXTERNAL_PAGES = YES -PERL_PATH = /usr/bin/perl -CLASS_DIAGRAMS = YES -MSCGEN_PATH = -DIA_PATH = -HIDE_UNDOC_RELATIONS = YES -HAVE_DOT = YES -DOT_NUM_THREADS = 0 -DOT_FONTNAME = Helvetica -DOT_FONTSIZE = 10 -DOT_FONTPATH = -CLASS_GRAPH = YES -COLLABORATION_GRAPH = YES -GROUP_GRAPHS = NO -UML_LOOK = NO -UML_LIMIT_NUM_FIELDS = 10 -TEMPLATE_RELATIONS = NO -INCLUDE_GRAPH = YES -INCLUDED_BY_GRAPH = YES -CALL_GRAPH = YES -CALLER_GRAPH = YES -GRAPHICAL_HIERARCHY = YES -DIRECTORY_GRAPH = YES -DOT_IMAGE_FORMAT = png -INTERACTIVE_SVG = NO -DOT_PATH = -DOTFILE_DIRS = -MSCFILE_DIRS = -DIAFILE_DIRS = -PLANTUML_JAR_PATH = -PLANTUML_INCLUDE_PATH = -DOT_GRAPH_MAX_NODES = 50 -MAX_DOT_GRAPH_DEPTH = 0 -DOT_TRANSPARENT = NO -DOT_MULTI_TARGETS = NO -GENERATE_LEGEND = YES -DOT_CLEANUP = YES diff --git a/physics/docs/ccpp_dox_extra_style.css b/physics/docs/ccpp_dox_extra_style.css deleted file mode 100644 index 6110b1472..000000000 --- a/physics/docs/ccpp_dox_extra_style.css +++ /dev/null @@ -1,19 +0,0 @@ -div.image img[src="Hybrid_EDMF_Flowchart.png"]{ - width:5cm; -} - -div.image img[src="SAS_Flowchart.png"]{ - width:5cm; -} - -div.image img[src="Shallow_SAS_Flowchart.png"]{ - width:5cm; -} - -div.image img[src="schematic_Rad_mod.png"]{ - width:600px; -} - -div.image img[src="GFS_Operational_Physics.png"]{ - width:16cm; -} diff --git a/physics/docs/ccpp_dox_layout.xml b/physics/docs/ccpp_dox_layout.xml index 38112e6d9..6242933b7 100644 --- a/physics/docs/ccpp_dox_layout.xml +++ b/physics/docs/ccpp_dox_layout.xml @@ -1,17 +1,23 @@ - + - + - - + + + + + + + + - + @@ -73,8 +79,14 @@ + + + + + + @@ -84,6 +96,8 @@ + + @@ -91,18 +105,34 @@ + + + + + + + + + + + + + + + + @@ -113,28 +143,30 @@ + + - - - + + + @@ -148,11 +180,14 @@ + + + @@ -165,6 +200,7 @@ + diff --git a/physics/docs/ccpp_doxyfile b/physics/docs/ccpp_doxyfile index 0578d14a8..9465d00ca 100644 --- a/physics/docs/ccpp_doxyfile +++ b/physics/docs/ccpp_doxyfile @@ -1,8 +1,9 @@ -# Doxyfile 1.8.11 +# Doxyfile 1.9.3 + DOXYFILE_ENCODING = UTF-8 -PROJECT_NAME = "Common Community Physics Package (CCPP) Scientific Documentation" -PROJECT_NUMBER = "" -PROJECT_BRIEF = " " +PROJECT_NAME = "CCPP SciDoc" +PROJECT_NUMBER = "v6.0.0" +PROJECT_BRIEF = "Common Community Physics Package Developed at DTC" PROJECT_LOGO = img/dtc_logo.png OUTPUT_DIRECTORY = doc CREATE_SUBDIRS = NO @@ -18,22 +19,25 @@ STRIP_FROM_PATH = STRIP_FROM_INC_PATH = SHORT_NAMES = NO JAVADOC_AUTOBRIEF = NO +JAVADOC_BANNER = NO QT_AUTOBRIEF = NO MULTILINE_CPP_IS_BRIEF = NO +PYTHON_DOCSTRING = YES INHERIT_DOCS = YES SEPARATE_MEMBER_PAGES = YES TAB_SIZE = 4 ALIASES = -TCL_SUBST = OPTIMIZE_OUTPUT_FOR_C = NO OPTIMIZE_OUTPUT_JAVA = NO OPTIMIZE_FOR_FORTRAN = YES OPTIMIZE_OUTPUT_VHDL = NO -EXTENSION_MAPPING = .f=Fortranfixed \ - .F=Fortranfixed \ - .F90=FortranFree \ +OPTIMIZE_OUTPUT_SLICE = NO +EXTENSION_MAPPING = .f=FortranFree \ + .F=FortranFree \ + .F90=FortranFree \ .f90=FortranFree MARKDOWN_SUPPORT = YES +TOC_INCLUDE_HEADINGS = 5 AUTOLINK_SUPPORT = YES BUILTIN_STL_SUPPORT = NO CPP_CLI_SUPPORT = NO @@ -46,35 +50,35 @@ INLINE_GROUPED_CLASSES = NO INLINE_SIMPLE_STRUCTS = NO TYPEDEF_HIDES_STRUCT = YES LOOKUP_CACHE_SIZE = 0 +NUM_PROC_THREADS = 1 + +#--------------------------------------------------------------------------- +# Build related configuration options +#--------------------------------------------------------------------------- + EXTRACT_ALL = YES EXTRACT_PRIVATE = YES +EXTRACT_PRIV_VIRTUAL = NO EXTRACT_PACKAGE = YES EXTRACT_STATIC = YES EXTRACT_LOCAL_CLASSES = YES EXTRACT_LOCAL_METHODS = YES EXTRACT_ANON_NSPACES = YES +RESOLVE_UNNAMED_PARAMS = YES HIDE_UNDOC_MEMBERS = NO HIDE_UNDOC_CLASSES = NO HIDE_FRIEND_COMPOUNDS = NO HIDE_IN_BODY_DOCS = NO INTERNAL_DOCS = YES - CASE_SENSE_NAMES = NO - HIDE_SCOPE_NAMES = NO - HIDE_COMPOUND_REFERENCE= NO - +SHOW_HEADERFILE = YES SHOW_INCLUDE_FILES = NO - SHOW_GROUPED_MEMB_INC = NO - FORCE_LOCAL_INCLUDES = NO - INLINE_INFO = YES - SORT_MEMBER_DOCS = NO - SORT_BRIEF_DOCS = NO SORT_MEMBERS_CTORS_1ST = NO SORT_GROUP_NAMES = NO @@ -86,63 +90,72 @@ GENERATE_BUGLIST = YES GENERATE_DEPRECATEDLIST= YES ENABLED_SECTIONS = YES MAX_INITIALIZER_LINES = 30 -SHOW_USED_FILES = YES -SHOW_FILES = YES +SHOW_USED_FILES = NO +SHOW_FILES = NO SHOW_NAMESPACES = YES FILE_VERSION_FILTER = LAYOUT_FILE = ccpp_dox_layout.xml CITE_BIB_FILES = library.bib + +#--------------------------------------------------------------------------- +# Configuration options related to warning and progress messages +#--------------------------------------------------------------------------- QUIET = NO WARNINGS = YES WARN_IF_UNDOCUMENTED = NO WARN_IF_DOC_ERROR = YES +WARN_IF_INCOMPLETE_DOC = YES WARN_NO_PARAMDOC = NO WARN_AS_ERROR = NO WARN_FORMAT = -WARN_LOGFILE = -INPUT = pdftxt/mainpage.txt \ +WARN_LOGFILE = + +#--------------------------------------------------------------------------- +# Configuration options related to the input files +#--------------------------------------------------------------------------- + +INPUT = pdftxt/mainpage.txt \ pdftxt/all_shemes_list.txt \ - pdftxt/GFSv15_suite.txt \ - pdftxt/GFSv15_suite_TKEEDMF.txt \ - pdftxt/CPT_adv_suite.txt \ - pdftxt/GSD_adv_suite.txt \ - pdftxt/GFS_RRTMG.txt \ + pdftxt/GFS_v16_suite.txt \ + pdftxt/GFS_v17_p8_suite.txt \ + pdftxt/RAP_suite.txt \ + pdftxt/RE6/FV3_RAP_input.nml \ + pdftxt/HRRR_suite.txt \ + pdftxt/RE6/FV3_HRRR_input.nml \ + pdftxt/RRFS_v1beta_suite.txt \ + pdftxt/WoFS_v0_suite.txt \ + pdftxt/RRFS_SGSCLOUD.txt \ + pdftxt/GFS_RRTMG.txt \ pdftxt/GFS_SFCLYR.txt \ + pdftxt/MYNN_SFCLAYER.txt \ pdftxt/GFS_NSST.txt \ + pdftxt/GFS_OCEAN.txt \ pdftxt/GFS_NOAH.txt \ pdftxt/GFS_SFCSICE.txt \ - pdftxt/GFS_HEDMF.txt \ - pdftxt/GFS_SATMEDMF.txt \ - pdftxt/GFS_SATMEDMFVDIFQ.txt \ - pdftxt/GFS_GWDPS.txt \ + pdftxt/GFS_SATMEDMFVDIFQ.txt \ + pdftxt/GFS_NOAHMP.txt \ + pdftxt/GFS_UGWPv0.txt \ + pdftxt/GFS_unified_ugwp.txt \ + pdftxt/GFS_drag_suite.txt \ + pdftxt/GFS_GWDPS.txt \ pdftxt/GFS_OZPHYS.txt \ pdftxt/GFS_H2OPHYS.txt \ - pdftxt/GFS_RAYLEIGH.txt \ - pdftxt/GFS_SAMF.txt \ pdftxt/GFS_SAMFdeep.txt \ - pdftxt/GFS_GWDC.txt \ - pdftxt/UGWPv0.txt \ pdftxt/GFS_SAMFshal.txt \ pdftxt/GFDL_cloud.txt \ -### pdftxt/GFS_SURFACE_PERT.txt \ - pdftxt/GFS_CALPRECIPTYPE.txt \ -### pdftxt/rad_cld.txt \ - pdftxt/CPT_CSAW.txt \ - pdftxt/CPT_MG3.txt \ - pdftxt/GSD_MYNN_EDMF.txt \ - pdftxt/GSD_CU_GF_deep.txt \ - pdftxt/GSD_RUCLSM.txt \ - pdftxt/GSD_THOMPSON.txt \ - pdftxt/HWRF_FAMP.txt \ -### pdftxt/GFSphys_namelist.txt \ -### pdftxt/GFS_STOCHY_PHYS.txt \ + pdftxt/NSSLMICRO.txt \ + pdftxt/MYNN_EDMF.txt \ + pdftxt/CU_GF_deep.txt \ + pdftxt/RUCLSM.txt \ + pdftxt/THOMPSON.txt \ pdftxt/suite_input.nml.txt \ - pdftxt/NoahMP.txt \ -### in-core MP - ../gfdl_fv_sat_adj.F90 \ -### time_vary - ../GFS_phys_time_vary.fv3.F90 \ + pdftxt/GFS_SPP.txt \ + ../fv_sat_adj.F90 \ + ../GFS_time_vary_pre.fv3.F90 \ ../GFS_rad_time_vary.fv3.F90 \ + ../GFS_phys_time_vary.fv3.F90 \ + ../get_prs_fv3.F90 \ + ../get_phi_fv3.F90 \ ../ozne_def.f \ ../ozinterp.f90 \ ../h2o_def.f \ @@ -151,107 +164,115 @@ INPUT = pdftxt/mainpage.txt \ ../aerinterp.F90 \ ../iccn_def.F \ ../iccninterp.F90 \ - ../sfcsub.F \ - ../gcycle.F90 \ -### Radiation - ../radlw_main.f \ - ../radsw_main.f \ + ../sfcsub.F \ + ../gcycle.F90 \ + ../GFS_suite_interstitial_1.F90 \ + ../GFS_suite_interstitial_2.F90 \ + ../GFS_suite_interstitial_3.F90 \ + ../GFS_suite_interstitial_4.F90 \ + ../GFS_suite_interstitial_5.F90 \ + ../GFS_suite_interstitial_phys_reset.F90 \ + ../GFS_suite_interstitial_rad_reset.F90 \ + ../GFS_suite_stateout_reset.F90 \ + ../GFS_suite_stateout_update.F90 \ + ../GFS_surface_composites_inter.F90 \ + ../GFS_surface_composites_pre.F90 \ + ../GFS_surface_composites_post.F90 \ + ../GFS_surface_loop_control_part1.F90 \ + ../GFS_surface_loop_control_part2.F90 \ + ../GFS_radiation_surface.F90 \ + ../GFS_rrtmg_pre.F90 \ + ../GFS_rrtmg_post.F90 \ + ../GFS_rrtmg_setup.F90 \ + ../rad_sw_pre.F90 \ + ../sgscloud_radpre.F90 \ + ../sgscloud_radpost.F90 \ + ../radsw_main.F90 \ + ../rrtmg_sw_post.F90 \ + ../rrtmg_lw_pre.F90 \ + ../radlw_main.F90 \ + ../rrtmg_lw_post.F90 \ ../radiation_aerosols.f \ ../radiation_astronomy.f \ ../radiation_clouds.f \ + ../radiation_cloud_overlap.F90 \ ../radiation_gases.f \ - ../radiation_surface.f \ + ../radiation_surface.f \ ../radlw_param.f \ ../radlw_datatb.f \ ../radsw_param.f \ ../radsw_datatb.f \ - ../dcyc2.f \ -### Land Surface - ../sfc_diff.f \ - ../sfc_nst.f \ - ../module_nst_model.f90 \ - ../module_nst_parameters.f90 \ + ../GFS_cloud_diagnostics.F90 \ + ../dcyc2t3.f \ + ../sfc_diff.f \ + ../sfc_diag.f \ + ../sfc_diag_post.F90 \ + ../sfc_nst.f \ + ../sfc_nst_pre.f \ + ../sfc_nst_post.f \ + ../sfc_ocean.F \ + ../module_nst_model.f90 \ + ../module_nst_parameters.f90 \ ../module_nst_water_prop.f90 \ - ../sfc_drv.f \ - ../sflx.f \ + ../lsm_noah.f \ + ../sflx.f \ ../namelist_soilveg.f \ ../set_soilveg.f \ - ../sfc_noahmp_drv.f \ - ../module_sf_noahmplsm.f90 \ - ../module_sf_noahmp_glacier.f90 \ - ../noahmp_tables.f90 \ -### Sea Ice Surface + ../noahmpdrv.F90 \ + ../module_sf_noahmplsm.f90 \ + ../module_sf_noahmp_glacier.f90 \ + ../noahmp_tables.f90 \ + ../GFS_surface_generic_pre.F90 \ + ../GFS_surface_generic_post.F90 \ + ../surface_perturbation.F90 \ + ../GFS_DCNV_generic_pre.F90 \ + ../GFS_DCNV_generic_post.F90 \ + ../GFS_SCNV_generic_pre.F90 \ + ../GFS_SCNV_generic_post.F90 \ ../sfc_sice.f \ -### PBL - ../moninedmf.f \ - ../mfpbl.f \ - ../tridi.f \ -### satmedmf - ../satmedmfvdif.F \ - ../mfpblt.f \ - ../mfscu.f \ - ../tridi.f \ -### satmedmfvdifq - ../satmedmfvdifq.F \ + ../satmedmfvdifq.F \ ../mfpbltq.f \ ../mfscuq.f \ ../tridi.f \ -### Orographic Gravity Wave - ../gwdps.f \ -### Rayleigh Dampling - ../rayleigh_damp.f \ -### Prognostic Ozone - ../ozphys_2015.f \ -### ../ozphys.f \ -### stratospheric h2o + ../GFS_GWD_generic_pre.F90 \ + ../GFS_GWD_generic_post.F90 \ + ../unified_ugwp.F90 \ + ../drag_suite.F90 \ + ../cires_tauamf_data.F90 \ + ../cires_orowam2017.f \ + ../cires_ugwp.F90 \ + ../cires_ugwp_initialize.F90 \ + ../cires_ugwp_module.F90 \ + ../cires_ugwp_post.F90 \ + ../cires_ugwp_triggers.F90 \ + ../cires_ugwp_module.F90 \ + ../gwdps.f \ + ../ugwp_driver_v0.F \ + ../ozphys_2015.f \ ../h2ophys.f \ -### Deep Convection ../samfdeepcnv.f \ -### Convective Gravity Wave - ../gwdc.f \ -### Shallow Convection ../samfshalcnv.f \ ../cnvc90.f \ -### Unified Gravity Wave - ../cires_ugwp.F90 \ - ../ugwp_driver_v0.F \ - ../cires_ugwp_triggers.F90 \ -### Microphysics -### ../gscond.f \ -### ../precpd.f \ ../module_bfmicrophysics.f \ -### GFDL cloud MP ../gfdl_cloud_microphys.F90 \ ../module_gfdl_cloud_microphys.F90 \ -### - ../GFS_MP_generic.F90 \ + ../GFS_MP_generic_pre.F90 \ + ../GFS_MP_generic_post.F90 \ + ../GFS_PBL_generic_common.F90 \ + ../GFS_PBL_generic_pre.F90 \ + ../GFS_PBL_generic_post.F90 \ ../calpreciptype.f90 \ -### stochy -### ../GFS_stochastics.F90 \ -### ../surface_perturbation.F90 \ -### ../../stochastic_physics/stochastic_physics.F90 \ -### CPT - ../m_micro.F90 \ -### ../micro_mg2_0.F90 \ - ../micro_mg3_0.F90 \ - ../micro_mg_utils.F90 \ - ../cldmacro.F \ - ../aer_cloud.F \ - ../cldwat2m_micro.F \ - ../wv_saturation.F \ - ../cs_conv_aw_adj.F90 \ - ../cs_conv.F90 \ -### GSD + ../GFS_stochastics.F90 \ ../cu_gf_driver.F90 \ + ../cu_gf_driver_pre.F90 \ ../cu_gf_deep.F90 \ ../cu_gf_sh.F90 \ - ../module_MYNNrad_pre.F90 \ - ../module_MYNNrad_post.F90 \ - ../module_MYNNPBL_wrapper.F90 \ + ../cu_gf_driver_post.F90 \ + ../mynnedmf_wrapper.F90 \ ../module_bl_mynn.F90 \ -### ../module_MYNNSFC_wrapper.F90 \ -### ../module_sf_mynn.F90 \ - ../sfc_drv_ruc.F90 \ + ../mynnsfc_wrapper.F90 \ + ../module_sf_mynn.F90 \ + ../lsm_ruc.F90 \ ../module_sf_ruclsm.F90 \ ../namelist_soilveg_ruc.F90 \ ../set_soilveg_ruc.F90 \ @@ -262,17 +283,15 @@ INPUT = pdftxt/mainpage.txt \ ../module_mp_thompson.F90 \ ../module_mp_radar.F90 \ ../mp_thompson_post.F90 \ -### HAFS - ../mp_fer_hires.F90 \ - ../module_MP_FER_HIRES.F90 \ -### utils + ../mp_nssl.F90 \ + ../module_mp_nssl_2mom.F90 \ ../funcphys.f90 \ ../physparam.f \ ../physcons.F90 \ ../radcons.f90 \ - ../mersenne_twister.f \ - compns_stochy.F90 - + ../mersenne_twister.f \ + ../maximum_hourly_diagnostics.F90 \ + ../phys_tend.F90 INPUT_ENCODING = UTF-8 FILE_PATTERNS = *.f \ @@ -286,8 +305,9 @@ EXCLUDE = EXCLUDE_SYMLINKS = NO EXCLUDE_PATTERNS = EXCLUDE_SYMBOLS = -EXAMPLE_PATH = ./ -EXAMPLE_PATTERNS = +EXAMPLE_PATH = pdftxt/RE6 \ + doc/html +EXAMPLE_PATTERNS = EXAMPLE_RECURSIVE = NO IMAGE_PATH = img INPUT_FILTER = @@ -295,6 +315,11 @@ FILTER_PATTERNS = FILTER_SOURCE_FILES = NO FILTER_SOURCE_PATTERNS = USE_MDFILE_AS_MAINPAGE = + +#--------------------------------------------------------------------------- +# Configuration options related to source browsing +#--------------------------------------------------------------------------- + SOURCE_BROWSER = NO INLINE_SOURCES = NO STRIP_CODE_COMMENTS = YES @@ -304,27 +329,44 @@ REFERENCES_LINK_SOURCE = YES SOURCE_TOOLTIPS = YES USE_HTAGS = NO VERBATIM_HEADERS = YES -#CLANG_ASSISTED_PARSING = NO -#CLANG_OPTIONS = +CLANG_ASSISTED_PARSING = NO +CLANG_ADD_INC_PATHS = YES +CLANG_OPTIONS = +CLANG_DATABASE_PATH = + +#--------------------------------------------------------------------------- +# Configuration options related to the alphabetical class index +#--------------------------------------------------------------------------- + ALPHABETICAL_INDEX = NO -COLS_IN_ALPHA_INDEX = 5 IGNORE_PREFIX = + +#--------------------------------------------------------------------------- +# Configuration options related to the HTML output +#--------------------------------------------------------------------------- + GENERATE_HTML = YES HTML_OUTPUT = html HTML_FILE_EXTENSION = .html -HTML_HEADER = -HTML_FOOTER = -HTML_STYLESHEET = -HTML_EXTRA_STYLESHEET = ccpp_dox_extra_style.css -HTML_EXTRA_FILES = -HTML_COLORSTYLE_HUE = 220 -HTML_COLORSTYLE_SAT = 100 -HTML_COLORSTYLE_GAMMA = 80 +HTML_HEADER = _doxygen/header.html +HTML_FOOTER = _doxygen/footer.html +HTML_STYLESHEET = +HTML_EXTRA_STYLESHEET = _doxygen/doxygen-awesome.css \ + _doxygen/doxygen-awesome-sidebar-only.css \ + _doxygen/doxygen-awesome-sidebar-only-darkmode-toggle.css \ + _doxygen/doxygen-awesome-ccpp.css +HTML_EXTRA_FILES = _doxygen/doxygen-awesome-darkmode-toggle.js \ + _doxygen/doxygen-awesome-ccpp.js +HTML_COLORSTYLE_HUE = 209 +HTML_COLORSTYLE_SAT = 255 +HTML_COLORSTYLE_GAMMA = 113 HTML_TIMESTAMP = NO +HTML_DYNAMIC_MENUS = YES HTML_DYNAMIC_SECTIONS = NO HTML_INDEX_NUM_ENTRIES = 100 GENERATE_DOCSET = NO DOCSET_FEEDNAME = "Doxygen generated docs" +DOCSET_FEEDURL = DOCSET_BUNDLE_ID = org.doxygen.Project DOCSET_PUBLISHER_ID = org.doxygen.Publisher DOCSET_PUBLISHER_NAME = Publisher @@ -347,14 +389,20 @@ GENERATE_ECLIPSEHELP = NO ECLIPSE_DOC_ID = org.doxygen.Project DISABLE_INDEX = YES GENERATE_TREEVIEW = YES +FULL_SIDEBAR = NO ENUM_VALUES_PER_LINE = 4 -TREEVIEW_WIDTH = 250 +TREEVIEW_WIDTH = 335 EXT_LINKS_IN_WINDOW = NO +OBFUSCATE_EMAILS = YES +HTML_FORMULA_FORMAT = SVG FORMULA_FONTSIZE = 10 FORMULA_TRANSPARENT = YES +FORMULA_MACROFILE = USE_MATHJAX = YES +MATHJAX_VERSION = MathJax_2 MATHJAX_FORMAT = HTML-CSS -MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2 +#MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2 +MATHJAX_RELPATH = https://cdn.jsdelivr.net/npm/mathjax@2 MATHJAX_EXTENSIONS = MATHJAX_CODEFILE = SEARCHENGINE = YES @@ -364,51 +412,87 @@ SEARCHENGINE_URL = SEARCHDATA_FILE = searchdata.xml EXTERNAL_SEARCH_ID = EXTRA_SEARCH_MAPPINGS = + +#--------------------------------------------------------------------------- +# Configuration options related to the LaTeX output +#--------------------------------------------------------------------------- + GENERATE_LATEX = YES LATEX_OUTPUT = latex LATEX_CMD_NAME = latex MAKEINDEX_CMD_NAME = makeindex +LATEX_MAKEINDEX_CMD = makeindex COMPACT_LATEX = YES PAPER_TYPE = a4 EXTRA_PACKAGES = amsmath -LATEX_HEADER = -LATEX_FOOTER = -LATEX_EXTRA_STYLESHEET = +LATEX_HEADER = +LATEX_FOOTER = +LATEX_EXTRA_STYLESHEET = LATEX_EXTRA_FILES = PDF_HYPERLINKS = YES USE_PDFLATEX = YES LATEX_BATCHMODE = NO LATEX_HIDE_INDICES = YES -LATEX_SOURCE_CODE = NO - LATEX_BIB_STYLE = plainnat - LATEX_TIMESTAMP = NO +LATEX_EMOJI_DIRECTORY = -GENERATE_RTF = NO +#--------------------------------------------------------------------------- +# Configuration options related to the RTF output +#--------------------------------------------------------------------------- +GENERATE_RTF = NO RTF_OUTPUT = rtf COMPACT_RTF = NO RTF_HYPERLINKS = NO RTF_STYLESHEET_FILE = RTF_EXTENSIONS_FILE = -RTF_SOURCE_CODE = NO + +#--------------------------------------------------------------------------- +# Configuration options related to the man page output +#--------------------------------------------------------------------------- + GENERATE_MAN = NO MAN_OUTPUT = man MAN_EXTENSION = .3 MAN_SUBDIR = MAN_LINKS = NO + +#--------------------------------------------------------------------------- +# Configuration options related to the XML output +#--------------------------------------------------------------------------- + GENERATE_XML = NO XML_OUTPUT = xml XML_PROGRAMLISTING = YES +XML_NS_MEMB_FILE_SCOPE = NO + +#--------------------------------------------------------------------------- +# Configuration options related to the DOCBOOK output +#--------------------------------------------------------------------------- + GENERATE_DOCBOOK = NO DOCBOOK_OUTPUT = docbook -DOCBOOK_PROGRAMLISTING = NO + +#--------------------------------------------------------------------------- +# Configuration options for the AutoGen Definitions output +#--------------------------------------------------------------------------- + GENERATE_AUTOGEN_DEF = NO + +#--------------------------------------------------------------------------- +# Configuration options related to the Perl module output +#--------------------------------------------------------------------------- + GENERATE_PERLMOD = NO PERLMOD_LATEX = NO PERLMOD_PRETTY = YES PERLMOD_MAKEVAR_PREFIX = + +#--------------------------------------------------------------------------- +# Configuration options related to the preprocessor +#--------------------------------------------------------------------------- + ENABLE_PREPROCESSING = NO MACRO_EXPANSION = NO EXPAND_ONLY_PREDEF = NO @@ -417,47 +501,58 @@ INCLUDE_PATH = INCLUDE_FILE_PATTERNS = PREDEFINED = CCPP \ MULTI_GASES \ - 0 + 0 EXPAND_AS_DEFINED = SKIP_FUNCTION_MACROS = YES + +#--------------------------------------------------------------------------- +# Configuration options related to external references +#--------------------------------------------------------------------------- + TAGFILES = GENERATE_TAGFILE = ALLEXTERNALS = NO EXTERNAL_GROUPS = YES EXTERNAL_PAGES = YES -PERL_PATH = /usr/bin/perl -CLASS_DIAGRAMS = YES -MSCGEN_PATH = + +#--------------------------------------------------------------------------- +# Configuration options related to the dot tool +#--------------------------------------------------------------------------- + DIA_PATH = -HIDE_UNDOC_RELATIONS = NO +HIDE_UNDOC_RELATIONS = YES HAVE_DOT = YES DOT_NUM_THREADS = 0 -DOT_FONTNAME = Helvetica -DOT_FONTSIZE = 10 +DOT_FONTNAME = Source Sans Pro +DOT_FONTSIZE = DOT_FONTPATH = -CLASS_GRAPH = NO -COLLABORATION_GRAPH = NO +CLASS_GRAPH = YES +COLLABORATION_GRAPH = YES GROUP_GRAPHS = YES UML_LOOK = YES UML_LIMIT_NUM_FIELDS = 10 +DOT_UML_DETAILS = NO +DOT_WRAP_THRESHOLD = 17 TEMPLATE_RELATIONS = NO INCLUDE_GRAPH = YES INCLUDED_BY_GRAPH = NO CALL_GRAPH = YES -CALLER_GRAPH = NO +CALLER_GRAPH = YES GRAPHICAL_HIERARCHY = YES DIRECTORY_GRAPH = YES -DOT_IMAGE_FORMAT = svg +DIR_GRAPH_MAX_DEPTH = 1 +DOT_IMAGE_FORMAT = SVG INTERACTIVE_SVG = NO DOT_PATH = DOTFILE_DIRS = MSCFILE_DIRS = DIAFILE_DIRS = PLANTUML_JAR_PATH = +PLANTUML_CFG_FILE = PLANTUML_INCLUDE_PATH = -DOT_GRAPH_MAX_NODES = 200 +DOT_GRAPH_MAX_NODES = 1000 MAX_DOT_GRAPH_DEPTH = 0 -DOT_TRANSPARENT = NO -DOT_MULTI_TARGETS = YES +DOT_TRANSPARENT = YES +DOT_MULTI_TARGETS = YES GENERATE_LEGEND = YES DOT_CLEANUP = YES diff --git a/physics/docs/ccpplatex_dox b/physics/docs/ccpplatex_dox deleted file mode 100644 index 5d0e68ae0..000000000 --- a/physics/docs/ccpplatex_dox +++ /dev/null @@ -1,364 +0,0 @@ -# Doxyfile 1.8.11 -DOXYFILE_ENCODING = UTF-8 -PROJECT_NAME = "Common Community Physics Package (CCPP) Scientific Documentation" -PROJECT_NUMBER = "Version 2.0" -PROJECT_BRIEF = " " -PROJECT_LOGO = img/dtc_logo.png -OUTPUT_DIRECTORY = doc -CREATE_SUBDIRS = NO -ALLOW_UNICODE_NAMES = NO -OUTPUT_LANGUAGE = English -BRIEF_MEMBER_DESC = YES -REPEAT_BRIEF = NO -ABBREVIATE_BRIEF = -ALWAYS_DETAILED_SEC = NO -INLINE_INHERITED_MEMB = NO -FULL_PATH_NAMES = NO -STRIP_FROM_PATH = -STRIP_FROM_INC_PATH = -SHORT_NAMES = NO -JAVADOC_AUTOBRIEF = NO -QT_AUTOBRIEF = NO -MULTILINE_CPP_IS_BRIEF = NO -INHERIT_DOCS = YES -SEPARATE_MEMBER_PAGES = YES -TAB_SIZE = 4 -ALIASES = -TCL_SUBST = -OPTIMIZE_OUTPUT_FOR_C = NO -OPTIMIZE_OUTPUT_JAVA = NO -OPTIMIZE_FOR_FORTRAN = YES -OPTIMIZE_OUTPUT_VHDL = NO -EXTENSION_MAPPING = .F=FortranFree \ - .f=FortranFree \ - .F90=FortranFree \ - .f90=FortranFree -MARKDOWN_SUPPORT = YES -AUTOLINK_SUPPORT = YES -BUILTIN_STL_SUPPORT = NO -CPP_CLI_SUPPORT = NO -SIP_SUPPORT = NO -IDL_PROPERTY_SUPPORT = YES -DISTRIBUTE_GROUP_DOC = YES -GROUP_NESTED_COMPOUNDS = NO -SUBGROUPING = YES -INLINE_GROUPED_CLASSES = NO -INLINE_SIMPLE_STRUCTS = NO -TYPEDEF_HIDES_STRUCT = NO -LOOKUP_CACHE_SIZE = 0 -EXTRACT_ALL = YES -EXTRACT_PRIVATE = YES -EXTRACT_PACKAGE = YES -EXTRACT_STATIC = YES -EXTRACT_LOCAL_CLASSES = YES -EXTRACT_LOCAL_METHODS = YES -EXTRACT_ANON_NSPACES = YES -HIDE_UNDOC_MEMBERS = NO -HIDE_UNDOC_CLASSES = NO -HIDE_FRIEND_COMPOUNDS = NO -HIDE_IN_BODY_DOCS = NO -INTERNAL_DOCS = YES - -CASE_SENSE_NAMES = NO - -HIDE_SCOPE_NAMES = NO - -HIDE_COMPOUND_REFERENCE= NO - -SHOW_INCLUDE_FILES = NO - -SHOW_GROUPED_MEMB_INC = NO - -FORCE_LOCAL_INCLUDES = NO - -INLINE_INFO = YES - -SORT_MEMBER_DOCS = NO - -SORT_BRIEF_DOCS = NO -SORT_MEMBERS_CTORS_1ST = NO -SORT_GROUP_NAMES = NO -SORT_BY_SCOPE_NAME = NO -STRICT_PROTO_MATCHING = NO -GENERATE_TODOLIST = YES -GENERATE_TESTLIST = YES -GENERATE_BUGLIST = YES -GENERATE_DEPRECATEDLIST= YES -ENABLED_SECTIONS = -MAX_INITIALIZER_LINES = 30 -SHOW_USED_FILES = YES -SHOW_FILES = YES -SHOW_NAMESPACES = YES -FILE_VERSION_FILTER = -LAYOUT_FILE = ccpp_dox_layout.xml -CITE_BIB_FILES = library.bib -QUIET = NO -WARNINGS = YES -WARN_IF_UNDOCUMENTED = NO -WARN_IF_DOC_ERROR = YES -WARN_NO_PARAMDOC = NO -WARN_AS_ERROR = NO -WARN_FORMAT = -WARN_LOGFILE = -INPUT = pdftxt/mainpage.txt \ - pdftxt/code_overview.txt \ - pdftxt/GFS_RRTMG.txt \ - pdftxt/GFS_SFCLYR.txt \ - pdftxt/GFS_NSST.txt \ - pdftxt/GFS_NOAH.txt \ - pdftxt/GFS_SFCSICE.txt \ - pdftxt/GFS_HEDMF.txt \ - pdftxt/GFS_GWDPS.txt \ - pdftxt/GFS_OZPHYS.txt \ - pdftxt/GFS_H2OPHYS.txt \ - pdftxt/GFS_RAYLEIGH.txt \ - pdftxt/GFS_SAMFdeep.txt \ - pdftxt/GFS_GWDC.txt \ - pdftxt/GFS_SAMFshal.txt \ - pdftxt/GFS_ZHAOC.txt \ - pdftxt/GFDL_cloud.txt \ - pdftxt/GFS_CALPRECIPTYPE.txt \ -### Radiation - ../radlw_main.f \ - ../radsw_main.f \ - ../radiation_aerosols.f \ - ../radiation_astronomy.f \ - ../radiation_clouds.f \ - ../radiation_gases.f \ - ../radiation_surface.f \ - ../radlw_param.f \ - ../radlw_datatb.f \ - ../radsw_param.f \ - ../radsw_datatb.f \ -### Land Surface - ../sfc_diff.f \ - ../sfc_nst.f \ - ../module_nst_model.f90 \ - ../module_nst_parameters.f90 \ - ../module_nst_water_prop.f90 \ - ../sfc_drv.f \ - ../sflx.f \ -### Sea Ice Surface - ../sfc_sice.f \ -### PBL - ../moninedmf.f \ - ../mfpbl.f \ - ../tridi.f \ -### Orographic Gravity Wave - ../gwdps.f \ -### Rayleigh Dampling - ../rayleigh_damp.f \ -### Prognostic Ozone - ../ozphys.f \ -### stratospheric h2o - ../h2ophys.f \ -### Deep Convection - ../samfdeepcnv.f \ -### Convective Gravity Wave - ../gwdc.f \ -### Shallow Convection - ../samfshalcnv.f \ -### Microphysics - ../gscond.f \ - ../precpd.f \ - ../module_bfmicrophysics.f \ -### GFDL cloud MP - ../gfdl_cloud_microphys.F90 \ - ../gfdl_fv_sat_adj.F90 \ -### - ../GFS_MP_generic.F90 \ - ../calpreciptype.f90 \ -### stochy -### ../GFS_stochastics.F90 \ -### ../surface_perturbation.F90 \ -### ../../stochastic_physics/stochastic_physics.F90 \ -### utils - ../funcphys.f90 \ - ../physparam.f \ - ../physcons.f90 \ - ../radcons.f90 \ - ../machine.F - -INPUT_ENCODING = UTF-8 -FILE_PATTERNS = *.f \ - *.F90 \ - *.f90 \ - *.txt -RECURSIVE = YES -EXCLUDE = -EXCLUDE_SYMLINKS = NO -EXCLUDE_PATTERNS = -EXCLUDE_SYMBOLS = -EXAMPLE_PATH = . -EXAMPLE_PATTERNS = -EXAMPLE_RECURSIVE = NO -IMAGE_PATH = img -INPUT_FILTER = -FILTER_PATTERNS = -FILTER_SOURCE_FILES = NO -FILTER_SOURCE_PATTERNS = -USE_MDFILE_AS_MAINPAGE = -SOURCE_BROWSER = NO -INLINE_SOURCES = NO -STRIP_CODE_COMMENTS = YES -REFERENCED_BY_RELATION = YES -REFERENCES_RELATION = YES -REFERENCES_LINK_SOURCE = YES -SOURCE_TOOLTIPS = YES -USE_HTAGS = NO -VERBATIM_HEADERS = YES -#CLANG_ASSISTED_PARSING = NO -#CLANG_OPTIONS = -ALPHABETICAL_INDEX = NO -COLS_IN_ALPHA_INDEX = 5 -IGNORE_PREFIX = -GENERATE_HTML = YES -HTML_OUTPUT = html -HTML_FILE_EXTENSION = .html -HTML_HEADER = -HTML_FOOTER = -HTML_STYLESHEET = -HTML_EXTRA_STYLESHEET = ccpp_dox_extra_style.css -HTML_EXTRA_FILES = -HTML_COLORSTYLE_HUE = 220 -HTML_COLORSTYLE_SAT = 100 -HTML_COLORSTYLE_GAMMA = 80 -HTML_TIMESTAMP = NO -HTML_DYNAMIC_SECTIONS = NO -HTML_INDEX_NUM_ENTRIES = 100 -GENERATE_DOCSET = NO -DOCSET_FEEDNAME = "Doxygen generated docs" -DOCSET_BUNDLE_ID = org.doxygen.Project -DOCSET_PUBLISHER_ID = org.doxygen.Publisher -DOCSET_PUBLISHER_NAME = Publisher -GENERATE_HTMLHELP = NO -CHM_FILE = -HHC_LOCATION = -GENERATE_CHI = NO -CHM_INDEX_ENCODING = -BINARY_TOC = NO -TOC_EXPAND = NO -GENERATE_QHP = NO -QCH_FILE = -QHP_NAMESPACE = org.doxygen.Project -QHP_VIRTUAL_FOLDER = doc -QHP_CUST_FILTER_NAME = -QHP_CUST_FILTER_ATTRS = -QHP_SECT_FILTER_ATTRS = -QHG_LOCATION = -GENERATE_ECLIPSEHELP = NO -ECLIPSE_DOC_ID = org.doxygen.Project -DISABLE_INDEX = YES -GENERATE_TREEVIEW = YES -ENUM_VALUES_PER_LINE = 4 -TREEVIEW_WIDTH = 250 -EXT_LINKS_IN_WINDOW = NO -FORMULA_FONTSIZE = 10 -FORMULA_TRANSPARENT = YES -USE_MATHJAX = YES -MATHJAX_FORMAT = HTML-CSS -MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2 -MATHJAX_EXTENSIONS = -MATHJAX_CODEFILE = -SEARCHENGINE = YES -SERVER_BASED_SEARCH = NO -EXTERNAL_SEARCH = NO -SEARCHENGINE_URL = -SEARCHDATA_FILE = searchdata.xml -EXTERNAL_SEARCH_ID = -EXTRA_SEARCH_MAPPINGS = -GENERATE_LATEX = YES -LATEX_OUTPUT = latex -LATEX_CMD_NAME = latex -MAKEINDEX_CMD_NAME = makeindex -COMPACT_LATEX = YES -PAPER_TYPE = a4 -EXTRA_PACKAGES = amsmath -LATEX_HEADER = -LATEX_FOOTER = -LATEX_EXTRA_STYLESHEET = -LATEX_EXTRA_FILES = -PDF_HYPERLINKS = YES -USE_PDFLATEX = YES -LATEX_BATCHMODE = NO -LATEX_HIDE_INDICES = YES -LATEX_SOURCE_CODE = NO - -LATEX_BIB_STYLE = plainnat - -LATEX_TIMESTAMP = NO - -GENERATE_RTF = NO - -RTF_OUTPUT = rtf -COMPACT_RTF = NO -RTF_HYPERLINKS = NO -RTF_STYLESHEET_FILE = -RTF_EXTENSIONS_FILE = -RTF_SOURCE_CODE = NO -GENERATE_MAN = NO -MAN_OUTPUT = man -MAN_EXTENSION = .3 -MAN_SUBDIR = -MAN_LINKS = NO -GENERATE_XML = NO -XML_OUTPUT = xml -XML_PROGRAMLISTING = YES -GENERATE_DOCBOOK = NO -DOCBOOK_OUTPUT = docbook -DOCBOOK_PROGRAMLISTING = NO -GENERATE_AUTOGEN_DEF = NO -GENERATE_PERLMOD = NO -PERLMOD_LATEX = NO -PERLMOD_PRETTY = YES -PERLMOD_MAKEVAR_PREFIX = -ENABLE_PREPROCESSING = YES -MACRO_EXPANSION = NO -EXPAND_ONLY_PREDEF = NO -SEARCH_INCLUDES = YES -INCLUDE_PATH = -INCLUDE_FILE_PATTERNS = -PREDEFINED = -EXPAND_AS_DEFINED = -SKIP_FUNCTION_MACROS = YES -TAGFILES = -GENERATE_TAGFILE = -ALLEXTERNALS = NO -EXTERNAL_GROUPS = YES -EXTERNAL_PAGES = YES -PERL_PATH = /usr/bin/perl -CLASS_DIAGRAMS = YES -MSCGEN_PATH = -DIA_PATH = -HIDE_UNDOC_RELATIONS = NO -HAVE_DOT = YES -DOT_NUM_THREADS = 0 -DOT_FONTNAME = Helvetica -DOT_FONTSIZE = 10 -DOT_FONTPATH = -CLASS_GRAPH = NO -COLLABORATION_GRAPH = NO -GROUP_GRAPHS = YES -UML_LOOK = YES -UML_LIMIT_NUM_FIELDS = 10 -TEMPLATE_RELATIONS = NO -INCLUDE_GRAPH = YES -INCLUDED_BY_GRAPH = NO -CALL_GRAPH = YES -CALLER_GRAPH = NO -GRAPHICAL_HIERARCHY = NO -DIRECTORY_GRAPH = YES -DOT_IMAGE_FORMAT = svg -INTERACTIVE_SVG = YES -DOT_PATH = -DOTFILE_DIRS = -MSCFILE_DIRS = -DIAFILE_DIRS = -PLANTUML_JAR_PATH = -PLANTUML_INCLUDE_PATH = -DOT_GRAPH_MAX_NODES = 200 -MAX_DOT_GRAPH_DEPTH = 0 -DOT_TRANSPARENT = NO -DOT_MULTI_TARGETS = NO -GENERATE_LEGEND = YES -DOT_CLEANUP = YES diff --git a/physics/docs/ccppv3_doxyfile b/physics/docs/ccppv3_doxyfile deleted file mode 100644 index 6933751a4..000000000 --- a/physics/docs/ccppv3_doxyfile +++ /dev/null @@ -1,439 +0,0 @@ -# Doxyfile 1.8.11 -DOXYFILE_ENCODING = UTF-8 -PROJECT_NAME = "Common Community Physics Package (CCPP) Scientific Documentation" -PROJECT_NUMBER = "Version 3.0" -PROJECT_BRIEF = " " -PROJECT_LOGO = img/dtc_logo.png -OUTPUT_DIRECTORY = doc -CREATE_SUBDIRS = NO -ALLOW_UNICODE_NAMES = NO -OUTPUT_LANGUAGE = English -BRIEF_MEMBER_DESC = YES -REPEAT_BRIEF = NO -ABBREVIATE_BRIEF = -ALWAYS_DETAILED_SEC = NO -INLINE_INHERITED_MEMB = NO -FULL_PATH_NAMES = NO -STRIP_FROM_PATH = -STRIP_FROM_INC_PATH = -SHORT_NAMES = NO -JAVADOC_AUTOBRIEF = NO -QT_AUTOBRIEF = NO -MULTILINE_CPP_IS_BRIEF = NO -INHERIT_DOCS = YES -SEPARATE_MEMBER_PAGES = YES -TAB_SIZE = 4 -ALIASES = -TCL_SUBST = -OPTIMIZE_OUTPUT_FOR_C = NO -OPTIMIZE_OUTPUT_JAVA = NO -OPTIMIZE_FOR_FORTRAN = YES -OPTIMIZE_OUTPUT_VHDL = NO -EXTENSION_MAPPING = .f=FortranFree \ - .F90=FortranFree \ - .f90=FortranFree -MARKDOWN_SUPPORT = YES -AUTOLINK_SUPPORT = YES -BUILTIN_STL_SUPPORT = NO -CPP_CLI_SUPPORT = NO -SIP_SUPPORT = NO -IDL_PROPERTY_SUPPORT = YES -DISTRIBUTE_GROUP_DOC = YES -GROUP_NESTED_COMPOUNDS = NO -SUBGROUPING = YES -INLINE_GROUPED_CLASSES = NO -INLINE_SIMPLE_STRUCTS = NO -TYPEDEF_HIDES_STRUCT = YES -LOOKUP_CACHE_SIZE = 0 -EXTRACT_ALL = YES -EXTRACT_PRIVATE = YES -EXTRACT_PACKAGE = YES -EXTRACT_STATIC = YES -EXTRACT_LOCAL_CLASSES = YES -EXTRACT_LOCAL_METHODS = YES -EXTRACT_ANON_NSPACES = YES -HIDE_UNDOC_MEMBERS = NO -HIDE_UNDOC_CLASSES = NO -HIDE_FRIEND_COMPOUNDS = NO -HIDE_IN_BODY_DOCS = NO -INTERNAL_DOCS = YES - -CASE_SENSE_NAMES = NO - -HIDE_SCOPE_NAMES = NO - -HIDE_COMPOUND_REFERENCE= NO - -SHOW_INCLUDE_FILES = NO - -SHOW_GROUPED_MEMB_INC = NO - -FORCE_LOCAL_INCLUDES = NO - -INLINE_INFO = YES - -SORT_MEMBER_DOCS = NO - -SORT_BRIEF_DOCS = NO -SORT_MEMBERS_CTORS_1ST = NO -SORT_GROUP_NAMES = NO -SORT_BY_SCOPE_NAME = NO -STRICT_PROTO_MATCHING = NO -GENERATE_TODOLIST = YES -GENERATE_TESTLIST = YES -GENERATE_BUGLIST = YES -GENERATE_DEPRECATEDLIST= YES -ENABLED_SECTIONS = YES -MAX_INITIALIZER_LINES = 30 -SHOW_USED_FILES = YES -SHOW_FILES = YES -SHOW_NAMESPACES = YES -FILE_VERSION_FILTER = -LAYOUT_FILE = ccpp_dox_layout.xml -CITE_BIB_FILES = library.bib -QUIET = NO -WARNINGS = YES -WARN_IF_UNDOCUMENTED = NO -WARN_IF_DOC_ERROR = YES -WARN_NO_PARAMDOC = NO -WARN_AS_ERROR = NO -WARN_FORMAT = -WARN_LOGFILE = -INPUT = pdftxt/mainpage.txt \ - pdftxt/all_shemes_list.txt \ - pdftxt/GFSv15_suite.txt \ - pdftxt/GFSv15_suite_TKEEDMF.txt \ - pdftxt/CPT_adv_suite.txt \ - pdftxt/GSD_adv_suite.txt \ - pdftxt/GFS_RRTMG.txt \ - pdftxt/GFS_SFCLYR.txt \ - pdftxt/GFS_NSST.txt \ - pdftxt/GFS_NOAH.txt \ - pdftxt/GFS_SFCSICE.txt \ - pdftxt/GFS_HEDMF.txt \ - pdftxt/GFS_SATMEDMF.txt \ - pdftxt/GFS_GWDPS.txt \ - pdftxt/GFS_OZPHYS.txt \ - pdftxt/GFS_H2OPHYS.txt \ - pdftxt/GFS_RAYLEIGH.txt \ - pdftxt/GFS_SAMFdeep.txt \ - pdftxt/GFS_GWDC.txt \ - pdftxt/GFS_SAMFshal.txt \ - pdftxt/GFDL_cloud.txt \ -### pdftxt/GFS_SURFACE_PERT.txt \ - pdftxt/GFS_CALPRECIPTYPE.txt \ -### pdftxt/rad_cld.txt \ - pdftxt/CPT_CSAW.txt \ - pdftxt/CPT_MG3.txt \ - pdftxt/GSD_MYNN_EDMF.txt \ - pdftxt/GSD_CU_GF_deep.txt \ - pdftxt/GSD_RUCLSM.txt \ - pdftxt/GSD_THOMPSON.txt \ -### pdftxt/GFSphys_namelist.txt \ -### pdftxt/GFS_STOCHY_PHYS.txt \ - pdftxt/suite_input.nml.txt \ -### in-core MP - ../gfdl_fv_sat_adj.F90 \ -### time_vary - ../GFS_phys_time_vary.fv3.F90 \ - ../ozne_def.f \ - ../ozinterp.f90 \ - ../h2o_def.f \ - ../h2ointerp.f90 \ - ../aerclm_def.F \ - ../aerinterp.F90 \ - ../iccn_def.F \ - ../iccninterp.F90 \ -### Radiation - ../radlw_main.f \ - ../radsw_main.f \ - ../radiation_aerosols.f \ - ../radiation_astronomy.f \ - ../radiation_clouds.f \ - ../radiation_gases.f \ - ../radiation_surface.f \ - ../radlw_param.f \ - ../radlw_datatb.f \ - ../radsw_param.f \ - ../radsw_datatb.f \ - ../dcyc2.f \ -### Land Surface - ../sfc_diff.f \ - ../sfc_nst.f \ - ../module_nst_model.f90 \ - ../module_nst_parameters.f90 \ - ../module_nst_water_prop.f90 \ - ../sfc_drv.f \ - ../sfcsub.F \ - ../gcycle.F90 \ - ../sflx.f \ - ../namelist_soilveg.f \ - ../set_soilveg.f \ -### Sea Ice Surface - ../sfc_sice.f \ -### PBL - ../moninedmf.f \ - ../mfpbl.f \ - ../tridi.f \ -### satmedmf - ../satmedmfvdif.F \ - ../mfpblt.f \ - ../mfscu.f \ - ../tridi.f \ -### Orographic Gravity Wave - ../gwdps.f \ -### Rayleigh Dampling - ../rayleigh_damp.f \ -### Prognostic Ozone - ../ozphys_2015.f \ -### ../ozphys.f \ -### stratospheric h2o - ../h2ophys.f \ -### Deep Convection - ../samfdeepcnv.f \ -### Convective Gravity Wave - ../gwdc.f \ -### Shallow Convection - ../samfshalcnv.f \ - ../cnvc90.f \ -### Microphysics -### ../gscond.f \ -### ../precpd.f \ - ../module_bfmicrophysics.f \ -### GFDL cloud MP - ../gfdl_cloud_microphys.F90 \ - ../module_gfdl_cloud_microphys.F90 \ -### - ../GFS_MP_generic.F90 \ - ../calpreciptype.f90 \ -### stochy -### ../GFS_stochastics.F90 \ -### ../surface_perturbation.F90 \ -### ../../stochastic_physics/stochastic_physics.F90 \ -### CPT - ../m_micro.F90 \ -### ../micro_mg2_0.F90 \ - ../micro_mg3_0.F90 \ - ../micro_mg_utils.F90 \ - ../cldmacro.F \ - ../aer_cloud.F \ - ../cldwat2m_micro.F \ - ../wv_saturation.F \ - ../cs_conv_aw_adj.F90 \ - ../cs_conv.F90 \ -### GSD - ../cu_gf_driver.F90 \ - ../cu_gf_deep.F90 \ - ../cu_gf_sh.F90 \ - ../module_MYNNrad_pre.F90 \ - ../module_MYNNrad_post.F90 \ - ../module_MYNNPBL_wrapper.F90 \ - ../module_bl_mynn.F90 \ -### ../module_MYNNSFC_wrapper.F90 \ -### ../module_sf_mynn.F90 \ - ../sfc_drv_ruc.F90 \ - ../module_sf_ruclsm.F90 \ - ../namelist_soilveg_ruc.F90 \ - ../set_soilveg_ruc.F90 \ - ../module_soil_pre.F90 \ - ../mp_thompson_pre.F90 \ - ../module_mp_thompson_make_number_concentrations.F90 \ - ../mp_thompson.F90 \ - ../module_mp_thompson.F90 \ - ../module_mp_radar.F90 \ - ../mp_thompson_post.F90 \ -### utils - ../funcphys.f90 \ - ../physparam.f \ - ../physcons.F90 \ - ../radcons.f90 \ - ../mersenne_twister.f \ - compns_stochy.F90 - - -INPUT_ENCODING = UTF-8 -FILE_PATTERNS = *.f \ - *.F90 \ - *.f90 \ - *.nml \ - *.txt -RECURSIVE = YES -EXCLUDE = -EXCLUDE_SYMLINKS = NO -EXCLUDE_PATTERNS = -EXCLUDE_SYMBOLS = -EXAMPLE_PATH = -EXAMPLE_PATTERNS = -EXAMPLE_RECURSIVE = NO -IMAGE_PATH = img -INPUT_FILTER = -FILTER_PATTERNS = -FILTER_SOURCE_FILES = NO -FILTER_SOURCE_PATTERNS = -USE_MDFILE_AS_MAINPAGE = -SOURCE_BROWSER = NO -INLINE_SOURCES = NO -STRIP_CODE_COMMENTS = YES -REFERENCED_BY_RELATION = YES -REFERENCES_RELATION = YES -REFERENCES_LINK_SOURCE = YES -SOURCE_TOOLTIPS = YES -USE_HTAGS = NO -VERBATIM_HEADERS = YES -#CLANG_ASSISTED_PARSING = NO -#CLANG_OPTIONS = -ALPHABETICAL_INDEX = NO -COLS_IN_ALPHA_INDEX = 5 -IGNORE_PREFIX = -GENERATE_HTML = YES -HTML_OUTPUT = html -HTML_FILE_EXTENSION = .html -HTML_HEADER = -HTML_FOOTER = -HTML_STYLESHEET = -HTML_EXTRA_STYLESHEET = ccpp_dox_extra_style.css -HTML_EXTRA_FILES = -HTML_COLORSTYLE_HUE = 220 -HTML_COLORSTYLE_SAT = 100 -HTML_COLORSTYLE_GAMMA = 80 -HTML_TIMESTAMP = NO -HTML_DYNAMIC_SECTIONS = NO -HTML_INDEX_NUM_ENTRIES = 100 -GENERATE_DOCSET = NO -DOCSET_FEEDNAME = "Doxygen generated docs" -DOCSET_BUNDLE_ID = org.doxygen.Project -DOCSET_PUBLISHER_ID = org.doxygen.Publisher -DOCSET_PUBLISHER_NAME = Publisher -GENERATE_HTMLHELP = NO -CHM_FILE = -HHC_LOCATION = -GENERATE_CHI = NO -CHM_INDEX_ENCODING = -BINARY_TOC = NO -TOC_EXPAND = NO -GENERATE_QHP = NO -QCH_FILE = -QHP_NAMESPACE = org.doxygen.Project -QHP_VIRTUAL_FOLDER = doc -QHP_CUST_FILTER_NAME = -QHP_CUST_FILTER_ATTRS = -QHP_SECT_FILTER_ATTRS = -QHG_LOCATION = -GENERATE_ECLIPSEHELP = NO -ECLIPSE_DOC_ID = org.doxygen.Project -DISABLE_INDEX = YES -GENERATE_TREEVIEW = YES -ENUM_VALUES_PER_LINE = 4 -TREEVIEW_WIDTH = 250 -EXT_LINKS_IN_WINDOW = NO -FORMULA_FONTSIZE = 10 -FORMULA_TRANSPARENT = YES -USE_MATHJAX = YES -MATHJAX_FORMAT = HTML-CSS -MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2 -MATHJAX_EXTENSIONS = -MATHJAX_CODEFILE = -SEARCHENGINE = YES -SERVER_BASED_SEARCH = NO -EXTERNAL_SEARCH = NO -SEARCHENGINE_URL = -SEARCHDATA_FILE = searchdata.xml -EXTERNAL_SEARCH_ID = -EXTRA_SEARCH_MAPPINGS = -GENERATE_LATEX = YES -LATEX_OUTPUT = latex -LATEX_CMD_NAME = latex -MAKEINDEX_CMD_NAME = makeindex -COMPACT_LATEX = YES -PAPER_TYPE = a4 -EXTRA_PACKAGES = amsmath -LATEX_HEADER = -LATEX_FOOTER = -LATEX_EXTRA_STYLESHEET = -LATEX_EXTRA_FILES = -PDF_HYPERLINKS = YES -USE_PDFLATEX = YES -LATEX_BATCHMODE = NO -LATEX_HIDE_INDICES = YES -LATEX_SOURCE_CODE = NO - -LATEX_BIB_STYLE = plainnat - -LATEX_TIMESTAMP = NO - -GENERATE_RTF = NO - -RTF_OUTPUT = rtf -COMPACT_RTF = NO -RTF_HYPERLINKS = NO -RTF_STYLESHEET_FILE = -RTF_EXTENSIONS_FILE = -RTF_SOURCE_CODE = NO -GENERATE_MAN = NO -MAN_OUTPUT = man -MAN_EXTENSION = .3 -MAN_SUBDIR = -MAN_LINKS = NO -GENERATE_XML = NO -XML_OUTPUT = xml -XML_PROGRAMLISTING = YES -GENERATE_DOCBOOK = NO -DOCBOOK_OUTPUT = docbook -DOCBOOK_PROGRAMLISTING = NO -GENERATE_AUTOGEN_DEF = NO -GENERATE_PERLMOD = NO -PERLMOD_LATEX = NO -PERLMOD_PRETTY = YES -PERLMOD_MAKEVAR_PREFIX = -ENABLE_PREPROCESSING = NO -MACRO_EXPANSION = NO -EXPAND_ONLY_PREDEF = NO -SEARCH_INCLUDES = YES -INCLUDE_PATH = -INCLUDE_FILE_PATTERNS = -PREDEFINED = CCPP \ - MULTI_GASES \ - 0 -EXPAND_AS_DEFINED = -SKIP_FUNCTION_MACROS = YES -TAGFILES = -GENERATE_TAGFILE = -ALLEXTERNALS = NO -EXTERNAL_GROUPS = YES -EXTERNAL_PAGES = YES -PERL_PATH = /usr/bin/perl -CLASS_DIAGRAMS = YES -MSCGEN_PATH = -DIA_PATH = -HIDE_UNDOC_RELATIONS = NO -HAVE_DOT = YES -DOT_NUM_THREADS = 0 -DOT_FONTNAME = Helvetica -DOT_FONTSIZE = 10 -DOT_FONTPATH = -CLASS_GRAPH = NO -COLLABORATION_GRAPH = NO -GROUP_GRAPHS = YES -UML_LOOK = YES -UML_LIMIT_NUM_FIELDS = 10 -TEMPLATE_RELATIONS = NO -INCLUDE_GRAPH = YES -INCLUDED_BY_GRAPH = NO -CALL_GRAPH = YES -CALLER_GRAPH = NO -GRAPHICAL_HIERARCHY = YES -DIRECTORY_GRAPH = YES -DOT_IMAGE_FORMAT = svg -INTERACTIVE_SVG = NO -DOT_PATH = -DOTFILE_DIRS = -MSCFILE_DIRS = -DIAFILE_DIRS = -PLANTUML_JAR_PATH = -PLANTUML_INCLUDE_PATH = -DOT_GRAPH_MAX_NODES = 200 -MAX_DOT_GRAPH_DEPTH = 0 -DOT_TRANSPARENT = NO -DOT_MULTI_TARGETS = YES -GENERATE_LEGEND = YES -DOT_CLEANUP = YES diff --git a/physics/docs/ccppv3_fv3_doxyfile b/physics/docs/ccppv3_fv3_doxyfile deleted file mode 100644 index b2b896b9e..000000000 --- a/physics/docs/ccppv3_fv3_doxyfile +++ /dev/null @@ -1,441 +0,0 @@ -# Doxyfile 1.8.11 -DOXYFILE_ENCODING = UTF-8 -PROJECT_NAME = "Common Community Physics Package (CCPP) Scientific Documentation" -PROJECT_NUMBER = "Version 3.0" -PROJECT_BRIEF = " " -PROJECT_LOGO = img/dtc_logo.png -OUTPUT_DIRECTORY = doc -CREATE_SUBDIRS = NO -ALLOW_UNICODE_NAMES = NO -OUTPUT_LANGUAGE = English -BRIEF_MEMBER_DESC = YES -REPEAT_BRIEF = NO -ABBREVIATE_BRIEF = -ALWAYS_DETAILED_SEC = NO -INLINE_INHERITED_MEMB = NO -FULL_PATH_NAMES = NO -STRIP_FROM_PATH = -STRIP_FROM_INC_PATH = -SHORT_NAMES = NO -JAVADOC_AUTOBRIEF = NO -QT_AUTOBRIEF = NO -MULTILINE_CPP_IS_BRIEF = NO -INHERIT_DOCS = YES -SEPARATE_MEMBER_PAGES = YES -TAB_SIZE = 4 -ALIASES = -TCL_SUBST = -OPTIMIZE_OUTPUT_FOR_C = NO -OPTIMIZE_OUTPUT_JAVA = NO -OPTIMIZE_FOR_FORTRAN = YES -OPTIMIZE_OUTPUT_VHDL = NO -EXTENSION_MAPPING = .f=FortranFree \ - .F90=FortranFree \ - .f90=FortranFree -MARKDOWN_SUPPORT = YES -AUTOLINK_SUPPORT = YES -BUILTIN_STL_SUPPORT = NO -CPP_CLI_SUPPORT = NO -SIP_SUPPORT = NO -IDL_PROPERTY_SUPPORT = YES -DISTRIBUTE_GROUP_DOC = YES -GROUP_NESTED_COMPOUNDS = NO -SUBGROUPING = YES -INLINE_GROUPED_CLASSES = NO -INLINE_SIMPLE_STRUCTS = NO -TYPEDEF_HIDES_STRUCT = YES -LOOKUP_CACHE_SIZE = 0 -EXTRACT_ALL = YES -EXTRACT_PRIVATE = YES -EXTRACT_PACKAGE = YES -EXTRACT_STATIC = YES -EXTRACT_LOCAL_CLASSES = YES -EXTRACT_LOCAL_METHODS = YES -EXTRACT_ANON_NSPACES = YES -HIDE_UNDOC_MEMBERS = NO -HIDE_UNDOC_CLASSES = NO -HIDE_FRIEND_COMPOUNDS = NO -HIDE_IN_BODY_DOCS = NO -INTERNAL_DOCS = YES - -CASE_SENSE_NAMES = NO - -HIDE_SCOPE_NAMES = NO - -HIDE_COMPOUND_REFERENCE= NO - -SHOW_INCLUDE_FILES = NO - -SHOW_GROUPED_MEMB_INC = NO - -FORCE_LOCAL_INCLUDES = NO - -INLINE_INFO = YES - -SORT_MEMBER_DOCS = NO - -SORT_BRIEF_DOCS = NO -SORT_MEMBERS_CTORS_1ST = NO -SORT_GROUP_NAMES = NO -SORT_BY_SCOPE_NAME = NO -STRICT_PROTO_MATCHING = NO -GENERATE_TODOLIST = YES -GENERATE_TESTLIST = YES -GENERATE_BUGLIST = YES -GENERATE_DEPRECATEDLIST= YES -ENABLED_SECTIONS = YES -MAX_INITIALIZER_LINES = 30 -SHOW_USED_FILES = YES -SHOW_FILES = YES -SHOW_NAMESPACES = YES -FILE_VERSION_FILTER = -LAYOUT_FILE = ccpp_dox_layout.xml -CITE_BIB_FILES = library.bib -QUIET = NO -WARNINGS = YES -WARN_IF_UNDOCUMENTED = NO -WARN_IF_DOC_ERROR = YES -WARN_NO_PARAMDOC = NO -WARN_AS_ERROR = NO -WARN_FORMAT = -WARN_LOGFILE = -INPUT = pdftxt/mainpage.txt \ - pdftxt/all_shemes_list.txt \ - pdftxt/GFSv15_suite.txt \ - pdftxt/GFSv15_suite_TKEEDMF.txt \ - pdftxt/CPT_adv_suite.txt \ - pdftxt/GSD_adv_suite.txt \ - pdftxt/GFS_RRTMG.txt \ - pdftxt/GFS_SFCLYR.txt \ - pdftxt/GFS_NSST.txt \ - pdftxt/GFS_NOAH.txt \ - pdftxt/GFS_SFCSICE.txt \ - pdftxt/GFS_HEDMF.txt \ - pdftxt/GFS_SATMEDMF.txt \ - pdftxt/GFS_GWDPS.txt \ - pdftxt/GFS_OZPHYS.txt \ - pdftxt/GFS_H2OPHYS.txt \ - pdftxt/GFS_RAYLEIGH.txt \ - pdftxt/GFS_SAMF.txt \ - pdftxt/GFS_SAMFdeep.txt \ - pdftxt/GFS_GWDC.txt \ - pdftxt/GFS_SAMFshal.txt \ - pdftxt/GFDL_cloud.txt \ -### pdftxt/GFS_SURFACE_PERT.txt \ - pdftxt/GFS_CALPRECIPTYPE.txt \ -### pdftxt/rad_cld.txt \ - pdftxt/CPT_CSAW.txt \ - pdftxt/CPT_MG3.txt \ - pdftxt/GSD_MYNN_EDMF.txt \ - pdftxt/GSD_CU_GF_deep.txt \ - pdftxt/GSD_RUCLSM.txt \ - pdftxt/GSD_THOMPSON.txt \ -### pdftxt/GFSphys_namelist.txt \ -### pdftxt/GFS_STOCHY_PHYS.txt \ - pdftxt/suite_input.nml.txt \ -### in-core MP - ../gfdl_fv_sat_adj.F90 \ -### time_vary - ../GFS_phys_time_vary.fv3.F90 \ - ../GFS_rad_time_vary.fv3.F90 \ - ../ozne_def.f \ - ../ozinterp.f90 \ - ../h2o_def.f \ - ../h2ointerp.f90 \ - ../aerclm_def.F \ - ../aerinterp.F90 \ - ../iccn_def.F \ - ../iccninterp.F90 \ - ../sfcsub.F \ - ../gcycle.F90 \ -### Radiation - ../radlw_main.f \ - ../radsw_main.f \ - ../radiation_aerosols.f \ - ../radiation_astronomy.f \ - ../radiation_clouds.f \ - ../radiation_gases.f \ - ../radiation_surface.f \ - ../radlw_param.f \ - ../radlw_datatb.f \ - ../radsw_param.f \ - ../radsw_datatb.f \ - ../dcyc2.f \ -### Land Surface - ../sfc_diff.f \ - ../sfc_nst.f \ - ../module_nst_model.f90 \ - ../module_nst_parameters.f90 \ - ../module_nst_water_prop.f90 \ - ../sfc_drv.f \ - ../sflx.f \ - ../namelist_soilveg.f \ - ../set_soilveg.f \ -### Sea Ice Surface - ../sfc_sice.f \ -### PBL - ../moninedmf.f \ - ../mfpbl.f \ - ../tridi.f \ -### satmedmf - ../satmedmfvdif.F \ - ../mfpblt.f \ - ../mfscu.f \ - ../tridi.f \ -### Orographic Gravity Wave - ../gwdps.f \ -### Rayleigh Dampling - ../rayleigh_damp.f \ -### Prognostic Ozone - ../ozphys_2015.f \ -### ../ozphys.f \ -### stratospheric h2o - ../h2ophys.f \ -### Deep Convection - ../samfdeepcnv.f \ -### Convective Gravity Wave - ../gwdc.f \ -### Shallow Convection - ../samfshalcnv.f \ - ../cnvc90.f \ -### Microphysics -### ../gscond.f \ -### ../precpd.f \ - ../module_bfmicrophysics.f \ -### GFDL cloud MP - ../gfdl_cloud_microphys.F90 \ - ../module_gfdl_cloud_microphys.F90 \ -### - ../GFS_MP_generic.F90 \ - ../calpreciptype.f90 \ -### stochy -### ../GFS_stochastics.F90 \ -### ../surface_perturbation.F90 \ -### ../../stochastic_physics/stochastic_physics.F90 \ -### CPT - ../m_micro.F90 \ -### ../micro_mg2_0.F90 \ - ../micro_mg3_0.F90 \ - ../micro_mg_utils.F90 \ - ../cldmacro.F \ - ../aer_cloud.F \ - ../cldwat2m_micro.F \ - ../wv_saturation.F \ - ../cs_conv_aw_adj.F90 \ - ../cs_conv.F90 \ -### GSD - ../cu_gf_driver.F90 \ - ../cu_gf_deep.F90 \ - ../cu_gf_sh.F90 \ - ../module_MYNNrad_pre.F90 \ - ../module_MYNNrad_post.F90 \ - ../module_MYNNPBL_wrapper.F90 \ - ../module_bl_mynn.F90 \ -### ../module_MYNNSFC_wrapper.F90 \ -### ../module_sf_mynn.F90 \ - ../sfc_drv_ruc.F90 \ - ../module_sf_ruclsm.F90 \ - ../namelist_soilveg_ruc.F90 \ - ../set_soilveg_ruc.F90 \ - ../module_soil_pre.F90 \ - ../mp_thompson_pre.F90 \ - ../module_mp_thompson_make_number_concentrations.F90 \ - ../mp_thompson.F90 \ - ../module_mp_thompson.F90 \ - ../module_mp_radar.F90 \ - ../mp_thompson_post.F90 \ -### utils - ../funcphys.f90 \ - ../physparam.f \ - ../physcons.F90 \ - ../radcons.f90 \ - ../mersenne_twister.f \ - compns_stochy.F90 - - -INPUT_ENCODING = UTF-8 -FILE_PATTERNS = *.f \ - *.F90 \ - *.f90 \ - *.nml \ - *.txt -RECURSIVE = YES -EXCLUDE = -EXCLUDE_SYMLINKS = NO -EXCLUDE_PATTERNS = -EXCLUDE_SYMBOLS = -EXAMPLE_PATH = -EXAMPLE_PATTERNS = -EXAMPLE_RECURSIVE = NO -IMAGE_PATH = img -INPUT_FILTER = -FILTER_PATTERNS = -FILTER_SOURCE_FILES = NO -FILTER_SOURCE_PATTERNS = -USE_MDFILE_AS_MAINPAGE = -SOURCE_BROWSER = NO -INLINE_SOURCES = NO -STRIP_CODE_COMMENTS = YES -REFERENCED_BY_RELATION = YES -REFERENCES_RELATION = YES -REFERENCES_LINK_SOURCE = YES -SOURCE_TOOLTIPS = YES -USE_HTAGS = NO -VERBATIM_HEADERS = YES -#CLANG_ASSISTED_PARSING = NO -#CLANG_OPTIONS = -ALPHABETICAL_INDEX = NO -COLS_IN_ALPHA_INDEX = 5 -IGNORE_PREFIX = -GENERATE_HTML = YES -HTML_OUTPUT = html -HTML_FILE_EXTENSION = .html -HTML_HEADER = -HTML_FOOTER = -HTML_STYLESHEET = -HTML_EXTRA_STYLESHEET = ccpp_dox_extra_style.css -HTML_EXTRA_FILES = -HTML_COLORSTYLE_HUE = 220 -HTML_COLORSTYLE_SAT = 100 -HTML_COLORSTYLE_GAMMA = 80 -HTML_TIMESTAMP = NO -HTML_DYNAMIC_SECTIONS = NO -HTML_INDEX_NUM_ENTRIES = 100 -GENERATE_DOCSET = NO -DOCSET_FEEDNAME = "Doxygen generated docs" -DOCSET_BUNDLE_ID = org.doxygen.Project -DOCSET_PUBLISHER_ID = org.doxygen.Publisher -DOCSET_PUBLISHER_NAME = Publisher -GENERATE_HTMLHELP = NO -CHM_FILE = -HHC_LOCATION = -GENERATE_CHI = NO -CHM_INDEX_ENCODING = -BINARY_TOC = NO -TOC_EXPAND = NO -GENERATE_QHP = NO -QCH_FILE = -QHP_NAMESPACE = org.doxygen.Project -QHP_VIRTUAL_FOLDER = doc -QHP_CUST_FILTER_NAME = -QHP_CUST_FILTER_ATTRS = -QHP_SECT_FILTER_ATTRS = -QHG_LOCATION = -GENERATE_ECLIPSEHELP = NO -ECLIPSE_DOC_ID = org.doxygen.Project -DISABLE_INDEX = YES -GENERATE_TREEVIEW = YES -ENUM_VALUES_PER_LINE = 4 -TREEVIEW_WIDTH = 250 -EXT_LINKS_IN_WINDOW = NO -FORMULA_FONTSIZE = 10 -FORMULA_TRANSPARENT = YES -USE_MATHJAX = YES -MATHJAX_FORMAT = HTML-CSS -MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2 -MATHJAX_EXTENSIONS = -MATHJAX_CODEFILE = -SEARCHENGINE = YES -SERVER_BASED_SEARCH = NO -EXTERNAL_SEARCH = NO -SEARCHENGINE_URL = -SEARCHDATA_FILE = searchdata.xml -EXTERNAL_SEARCH_ID = -EXTRA_SEARCH_MAPPINGS = -GENERATE_LATEX = YES -LATEX_OUTPUT = latex -LATEX_CMD_NAME = latex -MAKEINDEX_CMD_NAME = makeindex -COMPACT_LATEX = YES -PAPER_TYPE = a4 -EXTRA_PACKAGES = amsmath -LATEX_HEADER = -LATEX_FOOTER = -LATEX_EXTRA_STYLESHEET = -LATEX_EXTRA_FILES = -PDF_HYPERLINKS = YES -USE_PDFLATEX = YES -LATEX_BATCHMODE = NO -LATEX_HIDE_INDICES = YES -LATEX_SOURCE_CODE = NO - -LATEX_BIB_STYLE = plainnat - -LATEX_TIMESTAMP = NO - -GENERATE_RTF = NO - -RTF_OUTPUT = rtf -COMPACT_RTF = NO -RTF_HYPERLINKS = NO -RTF_STYLESHEET_FILE = -RTF_EXTENSIONS_FILE = -RTF_SOURCE_CODE = NO -GENERATE_MAN = NO -MAN_OUTPUT = man -MAN_EXTENSION = .3 -MAN_SUBDIR = -MAN_LINKS = NO -GENERATE_XML = NO -XML_OUTPUT = xml -XML_PROGRAMLISTING = YES -GENERATE_DOCBOOK = NO -DOCBOOK_OUTPUT = docbook -DOCBOOK_PROGRAMLISTING = NO -GENERATE_AUTOGEN_DEF = NO -GENERATE_PERLMOD = NO -PERLMOD_LATEX = NO -PERLMOD_PRETTY = YES -PERLMOD_MAKEVAR_PREFIX = -ENABLE_PREPROCESSING = NO -MACRO_EXPANSION = NO -EXPAND_ONLY_PREDEF = NO -SEARCH_INCLUDES = YES -INCLUDE_PATH = -INCLUDE_FILE_PATTERNS = -PREDEFINED = CCPP \ - MULTI_GASES \ - 0 -EXPAND_AS_DEFINED = -SKIP_FUNCTION_MACROS = YES -TAGFILES = -GENERATE_TAGFILE = -ALLEXTERNALS = NO -EXTERNAL_GROUPS = YES -EXTERNAL_PAGES = YES -PERL_PATH = /usr/bin/perl -CLASS_DIAGRAMS = YES -MSCGEN_PATH = -DIA_PATH = -HIDE_UNDOC_RELATIONS = NO -HAVE_DOT = YES -DOT_NUM_THREADS = 0 -DOT_FONTNAME = Helvetica -DOT_FONTSIZE = 10 -DOT_FONTPATH = -CLASS_GRAPH = NO -COLLABORATION_GRAPH = NO -GROUP_GRAPHS = YES -UML_LOOK = YES -UML_LIMIT_NUM_FIELDS = 10 -TEMPLATE_RELATIONS = NO -INCLUDE_GRAPH = YES -INCLUDED_BY_GRAPH = NO -CALL_GRAPH = YES -CALLER_GRAPH = NO -GRAPHICAL_HIERARCHY = YES -DIRECTORY_GRAPH = YES -DOT_IMAGE_FORMAT = svg -INTERACTIVE_SVG = NO -DOT_PATH = -DOTFILE_DIRS = -MSCFILE_DIRS = -DIAFILE_DIRS = -PLANTUML_JAR_PATH = -PLANTUML_INCLUDE_PATH = -DOT_GRAPH_MAX_NODES = 200 -MAX_DOT_GRAPH_DEPTH = 0 -DOT_TRANSPARENT = NO -DOT_MULTI_TARGETS = YES -GENERATE_LEGEND = YES -DOT_CLEANUP = YES diff --git a/physics/docs/ccppv4_doxyfile b/physics/docs/ccppv4_doxyfile deleted file mode 100644 index e80b27eb9..000000000 --- a/physics/docs/ccppv4_doxyfile +++ /dev/null @@ -1,467 +0,0 @@ -# Doxyfile 1.8.11 -DOXYFILE_ENCODING = UTF-8 -PROJECT_NAME = "CCPP Scientific Documentation" -PROJECT_NUMBER = "" -PROJECT_BRIEF = "v4.0" -PROJECT_LOGO = img/dtc_logo.png -OUTPUT_DIRECTORY = doc -CREATE_SUBDIRS = NO -ALLOW_UNICODE_NAMES = NO -OUTPUT_LANGUAGE = English -BRIEF_MEMBER_DESC = YES -REPEAT_BRIEF = NO -ABBREVIATE_BRIEF = -ALWAYS_DETAILED_SEC = NO -INLINE_INHERITED_MEMB = NO -FULL_PATH_NAMES = NO -STRIP_FROM_PATH = -STRIP_FROM_INC_PATH = -SHORT_NAMES = NO -JAVADOC_AUTOBRIEF = NO -QT_AUTOBRIEF = NO -MULTILINE_CPP_IS_BRIEF = NO -INHERIT_DOCS = YES -SEPARATE_MEMBER_PAGES = YES -TAB_SIZE = 4 -ALIASES = -TCL_SUBST = -OPTIMIZE_OUTPUT_FOR_C = NO -OPTIMIZE_OUTPUT_JAVA = NO -OPTIMIZE_FOR_FORTRAN = YES -OPTIMIZE_OUTPUT_VHDL = NO -EXTENSION_MAPPING = .f=FortranFree \ - .F=FortranFree \ - .F90=FortranFree \ - .f90=FortranFree -MARKDOWN_SUPPORT = YES -AUTOLINK_SUPPORT = YES -BUILTIN_STL_SUPPORT = NO -CPP_CLI_SUPPORT = NO -SIP_SUPPORT = NO -IDL_PROPERTY_SUPPORT = YES -DISTRIBUTE_GROUP_DOC = YES -GROUP_NESTED_COMPOUNDS = NO -SUBGROUPING = YES -INLINE_GROUPED_CLASSES = NO -INLINE_SIMPLE_STRUCTS = NO -TYPEDEF_HIDES_STRUCT = YES -LOOKUP_CACHE_SIZE = 0 -EXTRACT_ALL = YES -EXTRACT_PRIVATE = YES -EXTRACT_PACKAGE = YES -EXTRACT_STATIC = YES -EXTRACT_LOCAL_CLASSES = YES -EXTRACT_LOCAL_METHODS = YES -EXTRACT_ANON_NSPACES = YES -HIDE_UNDOC_MEMBERS = NO -HIDE_UNDOC_CLASSES = NO -HIDE_FRIEND_COMPOUNDS = NO -HIDE_IN_BODY_DOCS = NO -INTERNAL_DOCS = YES - -CASE_SENSE_NAMES = NO - -HIDE_SCOPE_NAMES = NO - -HIDE_COMPOUND_REFERENCE= NO - -SHOW_INCLUDE_FILES = NO - -SHOW_GROUPED_MEMB_INC = NO - -FORCE_LOCAL_INCLUDES = NO - -INLINE_INFO = YES - -SORT_MEMBER_DOCS = NO - -SORT_BRIEF_DOCS = NO -SORT_MEMBERS_CTORS_1ST = NO -SORT_GROUP_NAMES = NO -SORT_BY_SCOPE_NAME = NO -STRICT_PROTO_MATCHING = NO -GENERATE_TODOLIST = YES -GENERATE_TESTLIST = YES -GENERATE_BUGLIST = YES -GENERATE_DEPRECATEDLIST= YES -ENABLED_SECTIONS = YES -MAX_INITIALIZER_LINES = 30 -SHOW_USED_FILES = YES -SHOW_FILES = YES -SHOW_NAMESPACES = YES -FILE_VERSION_FILTER = -LAYOUT_FILE = ccpp_dox_layout.xml -CITE_BIB_FILES = library.bib -QUIET = NO -WARNINGS = YES -WARN_IF_UNDOCUMENTED = NO -WARN_IF_DOC_ERROR = YES -WARN_NO_PARAMDOC = NO -WARN_AS_ERROR = NO -WARN_FORMAT = -WARN_LOGFILE = -INPUT = pdftxt/mainpage.txt \ - pdftxt/all_shemes_list.txt \ - pdftxt/GFSv15p2_suite.txt \ - pdftxt/GFSv15p2_no_nsst_suite.txt \ - pdftxt/suite_FV3_GFS_v15p2.xml.txt \ - pdftxt/suite_FV3_GFS_v15p2_no_nsst.xml.txt \ - pdftxt/GFSv16beta_suite.txt \ - pdftxt/GFSv16beta_no_nsst_suite.txt \ - pdftxt/suite_FV3_GFS_v16beta.xml.txt \ - pdftxt/suite_FV3_GFS_v16beta_no_nsst.xml.txt \ - pdftxt/GSD_adv_suite.txt \ - pdftxt/CPT_adv_suite.txt \ - pdftxt/GFS_RRTMG.txt \ - pdftxt/GFS_SFCLYR.txt \ - pdftxt/GFS_NSST.txt \ - pdftxt/GFS_OCEAN.txt \ - pdftxt/GFS_NOAH.txt \ - pdftxt/GFS_SFCSICE.txt \ - pdftxt/GFS_HEDMF.txt \ - pdftxt/GFS_SATMEDMFVDIFQ.txt \ -## pdftxt/GFS_NoahMP.txt \ - pdftxt/GFS_UGWPv0.txt \ - pdftxt/GFS_GWDPS.txt \ - pdftxt/GFS_OZPHYS.txt \ - pdftxt/GFS_H2OPHYS.txt \ - pdftxt/GFS_RAYLEIGH.txt \ - pdftxt/GFS_SAMF.txt \ - pdftxt/GFS_SAMFdeep.txt \ - pdftxt/GFS_SAMFshal.txt \ - pdftxt/GFDL_cloud.txt \ - pdftxt/GFS_CALPRECIPTYPE.txt \ -### pdftxt/rad_cld.txt \ - pdftxt/CPT_CSAW.txt \ - pdftxt/CPT_MG3.txt \ - pdftxt/GSD_MYNN_EDMF.txt \ - pdftxt/GSD_CU_GF_deep.txt \ - pdftxt/GSD_RUCLSM.txt \ - pdftxt/GSD_THOMPSON.txt \ -### pdftxt/GFSphys_namelist.txt \ -### pdftxt/GFS_STOCHY_PHYS.txt \ - pdftxt/suite_input.nml.txt \ -### in-core MP - ../gfdl_fv_sat_adj.F90 \ -### time_vary - ../GFS_time_vary_pre.fv3.F90 \ - ../GFS_rad_time_vary.fv3.F90 \ - ../GFS_phys_time_vary.fv3.F90 \ - ../ozne_def.f \ - ../ozinterp.f90 \ - ../h2o_def.f \ - ../h2ointerp.f90 \ - ../aerclm_def.F \ - ../aerinterp.F90 \ - ../iccn_def.F \ - ../iccninterp.F90 \ - ../sfcsub.F \ - ../gcycle.F90 \ -### Radiation -### ../GFS_rrtmg_pre.F90 \ -### ../rrtmg_sw_pre.F90 \ - ../radsw_main.f \ -### ../rrtmg_sw_post.F90 \ -### ../rrtmg_lw_pre.F90 \ - ../radlw_main.f \ -### ../rrtmg_lw_post.F90 \ - ../radiation_aerosols.f \ - ../radiation_astronomy.f \ - ../radiation_clouds.f \ - ../radiation_gases.f \ - ../radiation_surface.f \ - ../radlw_param.f \ - ../radlw_datatb.f \ - ../radsw_param.f \ - ../radsw_datatb.f \ - ../dcyc2.f \ -### Land Surface - ../sfc_diff.f \ - ../sfc_nst.f \ - ../sfc_ocean.F \ - ../module_nst_model.f90 \ - ../module_nst_parameters.f90 \ - ../module_nst_water_prop.f90 \ - ../sfc_drv.f \ - ../sflx.f \ - ../namelist_soilveg.f \ - ../set_soilveg.f \ -### Sea Ice Surface - ../sfc_sice.f \ -### PBL - ../moninedmf.f \ - ../mfpbl.f \ - ../tridi.f \ -### satmedmf -## ../satmedmfvdif.F \ - ../satmedmfvdifq.F \ - ../mfpbltq.f \ - ../mfscuq.f \ - ../tridi.f \ -### Orographic Gravity Wave - ../GFS_GWD_generic.F90 \ - ../cires_ugwp.F90 \ - ../gwdps.f \ - ../ugwp_driver_v0.F \ - ../cires_ugwp_triggers.F90 \ - ../cires_ugwp_module.F90 \ - ../cires_ugwp_utils.F90 \ - ../cires_ugwp_solvers.F90 \ -### ../cires_ugwp_post.F90 \ -### ../cires_ugwp_initialize.F90 \ - ../cires_vert_wmsdis.F90 \ - ../cires_vert_orodis.F90 \ - ../cires_vert_lsatdis.F90 \ -### Rayleigh Dampling - ../rayleigh_damp.f \ -### Prognostic Ozone - ../ozphys_2015.f \ -### ../ozphys.f \ -### stratospheric h2o - ../h2ophys.f \ -### Deep Convection - ../samfdeepcnv.f \ -### Convective Gravity Wave -### ../gwdc.f \ -### Shallow Convection - ../samfshalcnv.f \ - ../cnvc90.f \ -### Microphysics -### ../gscond.f \ -### ../precpd.f \ - ../module_bfmicrophysics.f \ -### GFDL cloud MP - ../gfdl_cloud_microphys.F90 \ - ../module_gfdl_cloud_microphys.F90 \ -### - ../GFS_MP_generic.F90 \ - ../calpreciptype.f90 \ -### stochy - ../GFS_stochastics.F90 \ -### ../surface_perturbation.F90 \ -### ../../stochastic_physics/stochastic_physics.F90 \ -### CPT - ../m_micro.F90 \ -### ../micro_mg2_0.F90 \ - ../micro_mg3_0.F90 \ - ../micro_mg_utils.F90 \ - ../cldmacro.F \ - ../aer_cloud.F \ - ../cldwat2m_micro.F \ - ../wv_saturation.F \ - ../cs_conv_aw_adj.F90 \ - ../cs_conv.F90 \ -### GSD - ../cu_gf_driver.F90 \ - ../cu_gf_deep.F90 \ - ../cu_gf_sh.F90 \ - ../module_MYNNrad_pre.F90 \ - ../module_MYNNrad_post.F90 \ - ../module_MYNNPBL_wrapper.F90 \ - ../module_bl_mynn.F90 \ -### ../module_MYNNSFC_wrapper.F90 \ -### ../module_sf_mynn.F90 \ - ../sfc_drv_ruc.F90 \ - ../module_sf_ruclsm.F90 \ - ../namelist_soilveg_ruc.F90 \ - ../set_soilveg_ruc.F90 \ - ../module_soil_pre.F90 \ - ../mp_thompson_pre.F90 \ - ../module_mp_thompson_make_number_concentrations.F90 \ - ../mp_thompson.F90 \ - ../module_mp_thompson.F90 \ - ../module_mp_radar.F90 \ - ../mp_thompson_post.F90 \ -### utils - ../funcphys.f90 \ - ../physparam.f \ - ../physcons.F90 \ - ../radcons.f90 \ - ../mersenne_twister.f -INPUT_ENCODING = UTF-8 -FILE_PATTERNS = *.f \ - *.F \ - *.F90 \ - *.f90 \ - *.nml \ - *.txt -RECURSIVE = YES -EXCLUDE = -EXCLUDE_SYMLINKS = NO -EXCLUDE_PATTERNS = -EXCLUDE_SYMBOLS = -EXAMPLE_PATH = ./ -EXAMPLE_PATTERNS = -EXAMPLE_RECURSIVE = NO -IMAGE_PATH = img -INPUT_FILTER = -FILTER_PATTERNS = -FILTER_SOURCE_FILES = NO -FILTER_SOURCE_PATTERNS = -USE_MDFILE_AS_MAINPAGE = -SOURCE_BROWSER = NO -INLINE_SOURCES = NO -STRIP_CODE_COMMENTS = YES -REFERENCED_BY_RELATION = YES -REFERENCES_RELATION = YES -REFERENCES_LINK_SOURCE = YES -SOURCE_TOOLTIPS = YES -USE_HTAGS = NO -VERBATIM_HEADERS = YES -#CLANG_ASSISTED_PARSING = NO -#CLANG_OPTIONS = -ALPHABETICAL_INDEX = NO -COLS_IN_ALPHA_INDEX = 5 -IGNORE_PREFIX = -GENERATE_HTML = YES -HTML_OUTPUT = html -HTML_FILE_EXTENSION = .html -HTML_HEADER = -HTML_FOOTER = -HTML_STYLESHEET = -HTML_EXTRA_STYLESHEET = ccpp_dox_extra_style.css -HTML_EXTRA_FILES = -HTML_COLORSTYLE_HUE = 220 -HTML_COLORSTYLE_SAT = 100 -HTML_COLORSTYLE_GAMMA = 80 -HTML_TIMESTAMP = NO -HTML_DYNAMIC_SECTIONS = NO -HTML_INDEX_NUM_ENTRIES = 100 -GENERATE_DOCSET = NO -DOCSET_FEEDNAME = "Doxygen generated docs" -DOCSET_BUNDLE_ID = org.doxygen.Project -DOCSET_PUBLISHER_ID = org.doxygen.Publisher -DOCSET_PUBLISHER_NAME = Publisher -GENERATE_HTMLHELP = NO -CHM_FILE = -HHC_LOCATION = -GENERATE_CHI = NO -CHM_INDEX_ENCODING = -BINARY_TOC = NO -TOC_EXPAND = NO -GENERATE_QHP = NO -QCH_FILE = -QHP_NAMESPACE = org.doxygen.Project -QHP_VIRTUAL_FOLDER = doc -QHP_CUST_FILTER_NAME = -QHP_CUST_FILTER_ATTRS = -QHP_SECT_FILTER_ATTRS = -QHG_LOCATION = -GENERATE_ECLIPSEHELP = NO -ECLIPSE_DOC_ID = org.doxygen.Project -DISABLE_INDEX = YES -GENERATE_TREEVIEW = YES -ENUM_VALUES_PER_LINE = 4 -TREEVIEW_WIDTH = 250 -EXT_LINKS_IN_WINDOW = NO -FORMULA_FONTSIZE = 10 -FORMULA_TRANSPARENT = YES -USE_MATHJAX = YES -MATHJAX_FORMAT = HTML-CSS -MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2 -MATHJAX_EXTENSIONS = -MATHJAX_CODEFILE = -SEARCHENGINE = YES -SERVER_BASED_SEARCH = NO -EXTERNAL_SEARCH = NO -SEARCHENGINE_URL = -SEARCHDATA_FILE = searchdata.xml -EXTERNAL_SEARCH_ID = -EXTRA_SEARCH_MAPPINGS = -GENERATE_LATEX = YES -LATEX_OUTPUT = latex -LATEX_CMD_NAME = latex -MAKEINDEX_CMD_NAME = makeindex -COMPACT_LATEX = YES -PAPER_TYPE = a4 -EXTRA_PACKAGES = amsmath -LATEX_HEADER = -LATEX_FOOTER = -LATEX_EXTRA_STYLESHEET = -LATEX_EXTRA_FILES = -PDF_HYPERLINKS = YES -USE_PDFLATEX = YES -LATEX_BATCHMODE = NO -LATEX_HIDE_INDICES = YES -LATEX_SOURCE_CODE = NO - -LATEX_BIB_STYLE = plainnat - -LATEX_TIMESTAMP = NO - -GENERATE_RTF = NO - -RTF_OUTPUT = rtf -COMPACT_RTF = NO -RTF_HYPERLINKS = NO -RTF_STYLESHEET_FILE = -RTF_EXTENSIONS_FILE = -RTF_SOURCE_CODE = NO -GENERATE_MAN = NO -MAN_OUTPUT = man -MAN_EXTENSION = .3 -MAN_SUBDIR = -MAN_LINKS = NO -GENERATE_XML = NO -XML_OUTPUT = xml -XML_PROGRAMLISTING = YES -GENERATE_DOCBOOK = NO -DOCBOOK_OUTPUT = docbook -DOCBOOK_PROGRAMLISTING = NO -GENERATE_AUTOGEN_DEF = NO -GENERATE_PERLMOD = NO -PERLMOD_LATEX = NO -PERLMOD_PRETTY = YES -PERLMOD_MAKEVAR_PREFIX = -ENABLE_PREPROCESSING = NO -MACRO_EXPANSION = NO -EXPAND_ONLY_PREDEF = NO -SEARCH_INCLUDES = YES -INCLUDE_PATH = -INCLUDE_FILE_PATTERNS = -PREDEFINED = CCPP \ - MULTI_GASES \ - 0 -EXPAND_AS_DEFINED = -SKIP_FUNCTION_MACROS = YES -TAGFILES = -GENERATE_TAGFILE = -ALLEXTERNALS = NO -EXTERNAL_GROUPS = YES -EXTERNAL_PAGES = YES -PERL_PATH = /usr/bin/perl -CLASS_DIAGRAMS = YES -MSCGEN_PATH = -DIA_PATH = -HIDE_UNDOC_RELATIONS = NO -HAVE_DOT = YES -DOT_NUM_THREADS = 0 -DOT_FONTNAME = Helvetica -DOT_FONTSIZE = 10 -DOT_FONTPATH = -CLASS_GRAPH = NO -COLLABORATION_GRAPH = NO -GROUP_GRAPHS = YES -UML_LOOK = YES -UML_LIMIT_NUM_FIELDS = 10 -TEMPLATE_RELATIONS = NO -INCLUDE_GRAPH = YES -INCLUDED_BY_GRAPH = NO -CALL_GRAPH = YES -CALLER_GRAPH = NO -GRAPHICAL_HIERARCHY = YES -DIRECTORY_GRAPH = YES -DOT_IMAGE_FORMAT = svg -INTERACTIVE_SVG = NO -DOT_PATH = -DOTFILE_DIRS = -MSCFILE_DIRS = -DIAFILE_DIRS = -PLANTUML_JAR_PATH = -PLANTUML_INCLUDE_PATH = -DOT_GRAPH_MAX_NODES = 200 -MAX_DOT_GRAPH_DEPTH = 0 -DOT_TRANSPARENT = NO -DOT_MULTI_TARGETS = YES -GENERATE_LEGEND = YES -DOT_CLEANUP = YES diff --git a/physics/docs/ccppv5_doxyfile b/physics/docs/ccppv5_doxyfile deleted file mode 100644 index 1c1046c8c..000000000 --- a/physics/docs/ccppv5_doxyfile +++ /dev/null @@ -1,476 +0,0 @@ -# Doxyfile 1.8.11 -DOXYFILE_ENCODING = UTF-8 -PROJECT_NAME = "CCPP Scientific Documentation" -PROJECT_NUMBER = "" -PROJECT_BRIEF = "v5.0.0" -PROJECT_LOGO = img/dtc_logo.png -OUTPUT_DIRECTORY = doc -CREATE_SUBDIRS = NO -ALLOW_UNICODE_NAMES = NO -OUTPUT_LANGUAGE = English -BRIEF_MEMBER_DESC = YES -REPEAT_BRIEF = NO -ABBREVIATE_BRIEF = -ALWAYS_DETAILED_SEC = NO -INLINE_INHERITED_MEMB = NO -FULL_PATH_NAMES = NO -STRIP_FROM_PATH = -STRIP_FROM_INC_PATH = -SHORT_NAMES = NO -JAVADOC_AUTOBRIEF = NO -QT_AUTOBRIEF = NO -MULTILINE_CPP_IS_BRIEF = NO -INHERIT_DOCS = YES -SEPARATE_MEMBER_PAGES = YES -TAB_SIZE = 4 -ALIASES = -TCL_SUBST = -OPTIMIZE_OUTPUT_FOR_C = NO -OPTIMIZE_OUTPUT_JAVA = NO -OPTIMIZE_FOR_FORTRAN = YES -OPTIMIZE_OUTPUT_VHDL = NO -EXTENSION_MAPPING = .f=FortranFree \ - .F=FortranFree \ - .F90=FortranFree \ - .f90=FortranFree -MARKDOWN_SUPPORT = YES -AUTOLINK_SUPPORT = YES -BUILTIN_STL_SUPPORT = NO -CPP_CLI_SUPPORT = NO -SIP_SUPPORT = NO -IDL_PROPERTY_SUPPORT = YES -DISTRIBUTE_GROUP_DOC = YES -GROUP_NESTED_COMPOUNDS = NO -SUBGROUPING = YES -INLINE_GROUPED_CLASSES = NO -INLINE_SIMPLE_STRUCTS = NO -TYPEDEF_HIDES_STRUCT = YES -LOOKUP_CACHE_SIZE = 0 -EXTRACT_ALL = YES -EXTRACT_PRIVATE = YES -EXTRACT_PACKAGE = YES -EXTRACT_STATIC = YES -EXTRACT_LOCAL_CLASSES = YES -EXTRACT_LOCAL_METHODS = YES -EXTRACT_ANON_NSPACES = YES -HIDE_UNDOC_MEMBERS = NO -HIDE_UNDOC_CLASSES = NO -HIDE_FRIEND_COMPOUNDS = NO -HIDE_IN_BODY_DOCS = NO -INTERNAL_DOCS = YES - -CASE_SENSE_NAMES = NO - -HIDE_SCOPE_NAMES = NO - -HIDE_COMPOUND_REFERENCE= NO - -SHOW_INCLUDE_FILES = NO - -SHOW_GROUPED_MEMB_INC = NO - -FORCE_LOCAL_INCLUDES = NO - -INLINE_INFO = YES - -SORT_MEMBER_DOCS = NO - -SORT_BRIEF_DOCS = NO -SORT_MEMBERS_CTORS_1ST = NO -SORT_GROUP_NAMES = NO -SORT_BY_SCOPE_NAME = NO -STRICT_PROTO_MATCHING = NO -GENERATE_TODOLIST = YES -GENERATE_TESTLIST = YES -GENERATE_BUGLIST = YES -GENERATE_DEPRECATEDLIST= YES -ENABLED_SECTIONS = YES -MAX_INITIALIZER_LINES = 30 -SHOW_USED_FILES = YES -SHOW_FILES = YES -SHOW_NAMESPACES = YES -FILE_VERSION_FILTER = -LAYOUT_FILE = ccpp_dox_layout.xml -CITE_BIB_FILES = library.bib -QUIET = NO -WARNINGS = YES -WARN_IF_UNDOCUMENTED = NO -WARN_IF_DOC_ERROR = YES -WARN_NO_PARAMDOC = NO -WARN_AS_ERROR = NO -WARN_FORMAT = -WARN_LOGFILE = -INPUT = pdftxt/mainpage.txt \ - pdftxt/all_shemes_list.txt \ - pdftxt/GFSv15p2_suite.txt \ -### pdftxt/GFSv15p2_no_nsst_suite.txt \ -### pdftxt/suite_FV3_GFS_v15p2.xml.txt \ - pdftxt/GFSv16beta_suite.txt \ -### pdftxt/GFSv16beta_no_nsst_suite.txt \ -### pdftxt/suite_FV3_GFS_v16beta.xml.txt \ - pdftxt/GSD_adv_suite.txt \ - pdftxt/CPT_adv_suite.txt \ - pdftxt/RRFS_v1alpha_suite.txt \ - pdftxt/RRFS_SGSCLOUD.txt \ - pdftxt/GFS_RRTMG.txt \ - pdftxt/GFS_SFCLYR.txt \ -### pdftxt/MYNN_SFCLAYER.txt \ - pdftxt/GFS_NSST.txt \ - pdftxt/GFS_OCEAN.txt \ - pdftxt/GFS_NOAH.txt \ - pdftxt/GFS_SFCSICE.txt \ - pdftxt/GFS_HEDMF.txt \ - pdftxt/GFS_SATMEDMFVDIFQ.txt \ - pdftxt/GFS_NOAHMP.txt \ - pdftxt/GFS_UGWPv0.txt \ - pdftxt/GFS_GWDPS.txt \ - pdftxt/GFS_OZPHYS.txt \ - pdftxt/GFS_H2OPHYS.txt \ - pdftxt/GFS_RAYLEIGH.txt \ - pdftxt/GFS_SAMFdeep.txt \ - pdftxt/GFS_SAMFshal.txt \ - pdftxt/GFDL_cloud.txt \ -### pdftxt/GFS_CALPRECIPTYPE.txt \ -### pdftxt/rad_cld.txt \ - pdftxt/CPT_CSAW.txt \ - pdftxt/CPT_MG3.txt \ - pdftxt/MYNN_EDMF.txt \ - pdftxt/CU_GF_deep.txt \ - pdftxt/RUCLSM.txt \ - pdftxt/THOMPSON.txt \ -### pdftxt/GFSphys_namelist.txt \ -### pdftxt/GFS_STOCHY_PHYS.txt \ - pdftxt/suite_input.nml.txt \ -### in-core MP - ../gfdl_fv_sat_adj.F90 \ -### time_vary - ../GFS_time_vary_pre.fv3.F90 \ - ../GFS_rad_time_vary.fv3.F90 \ - ../GFS_phys_time_vary.fv3.F90 \ - ../ozne_def.f \ - ../ozinterp.f90 \ - ../h2o_def.f \ - ../h2ointerp.f90 \ - ../aerclm_def.F \ - ../aerinterp.F90 \ - ../iccn_def.F \ - ../iccninterp.F90 \ - ../sfcsub.F \ - ../gcycle.F90 \ -### Radiation - ../GFS_rrtmg_pre.F90 \ - ../GFS_rrtmg_post.F90 \ - ../GFS_rrtmg_setup.F90 \ - ../rrtmg_sw_pre.F90 \ - ../module_SGSCloud_RadPre.F90 \ - ../module_SGSCloud_RadPost.F90 \ - ../radsw_main.f \ - ../rrtmg_sw_post.F90 \ - ../rrtmg_lw_pre.F90 \ - ../radlw_main.f \ - ../rrtmg_lw_post.F90 \ - ../radiation_aerosols.f \ - ../radiation_astronomy.f \ - ../radiation_clouds.f \ - ../radiation_gases.f \ - ../radiation_surface.f \ - ../radlw_param.f \ - ../radlw_datatb.f \ - ../radsw_param.f \ - ../radsw_datatb.f \ - ../dcyc2.f \ -### Land Surface - ../sfc_diff.f \ -### ../module_MYNNSFC_wrapper.F90 \ -### ../module_sf_mynn.F90 \ - ../sfc_nst.f \ - ../sfc_ocean.F \ - ../module_nst_model.f90 \ - ../module_nst_parameters.f90 \ - ../module_nst_water_prop.f90 \ - ../sfc_drv.f \ - ../sflx.f \ - ../namelist_soilveg.f \ - ../set_soilveg.f \ - ../sfc_noahmp_drv.f \ - ../module_sf_noahmplsm.f90 \ - ../module_sf_noahmp_glacier.f90 \ - ../noahmp_tables.f90 \ - ../GFS_surface_generic.F90 \ -### Sea Ice Surface - ../sfc_sice.f \ -### PBL - ../moninedmf.f \ - ../mfpbl.f \ - ../tridi.f \ -### satmedmf -### ../satmedmfvdif.F \ - ../satmedmfvdifq.F \ - ../mfpbltq.f \ - ../mfscuq.f \ - ../tridi.f \ -### Orographic Gravity Wave - ../GFS_GWD_generic.F90 \ - ../cires_ugwp.F90 \ - ../gwdps.f \ - ../ugwp_driver_v0.F \ - ../cires_ugwp_triggers.F90 \ - ../cires_ugwp_module.F90 \ - ../cires_ugwp_utils.F90 \ - ../cires_ugwp_solvers.F90 \ - ../cires_ugwp_post.F90 \ -### ../cires_ugwp_initialize.F90 \ - ../cires_vert_wmsdis.F90 \ - ../cires_vert_orodis.F90 \ - ../cires_vert_lsatdis.F90 \ -### Rayleigh Dampling - ../rayleigh_damp.f \ -### Prognostic Ozone - ../ozphys_2015.f \ -### ../ozphys.f \ -### stratospheric h2o - ../h2ophys.f \ -### Deep Convection - ../samfdeepcnv.f \ -### Convective Gravity Wave -### ../gwdc.f \ -### Shallow Convection - ../samfshalcnv.f \ - ../cnvc90.f \ -### Microphysics -### ../gscond.f \ -### ../precpd.f \ - ../module_bfmicrophysics.f \ -### GFDL cloud MP - ../gfdl_cloud_microphys.F90 \ - ../module_gfdl_cloud_microphys.F90 \ - ../GFS_MP_generic.F90 \ - ../calpreciptype.f90 \ -### stochy - ../GFS_stochastics.F90 \ -### ../surface_perturbation.F90 \ -### ../../stochastic_physics/stochastic_physics.F90 \ -### CPT - ../m_micro.F90 \ - ../m_micro_interstitial.F90 \ -### ../micro_mg2_0.F90 \ - ../micro_mg3_0.F90 \ - ../micro_mg_utils.F90 \ - ../cldmacro.F \ - ../aer_cloud.F \ - ../cldwat2m_micro.F \ - ../wv_saturation.F \ - ../cs_conv_aw_adj.F90 \ - ../cs_conv.F90 \ - ../cu_gf_driver.F90 \ - ../cu_gf_driver_pre.F90 \ - ../cu_gf_deep.F90 \ - ../cu_gf_sh.F90 \ - ../module_MYNNPBL_wrapper.F90 \ - ../module_bl_mynn.F90 \ -### ../module_MYNNSFC_wrapper.F90 \ -### ../module_sf_mynn.F90 \ - ../sfc_drv_ruc.F90 \ - ../module_sf_ruclsm.F90 \ - ../namelist_soilveg_ruc.F90 \ - ../set_soilveg_ruc.F90 \ - ../module_soil_pre.F90 \ - ../mp_thompson_pre.F90 \ - ../module_mp_thompson_make_number_concentrations.F90 \ - ../mp_thompson.F90 \ - ../module_mp_thompson.F90 \ - ../module_mp_radar.F90 \ - ../mp_thompson_post.F90 \ -### utils - ../funcphys.f90 \ - ../physparam.f \ - ../physcons.F90 \ - ../radcons.f90 \ - ../mersenne_twister.f -INPUT_ENCODING = UTF-8 -FILE_PATTERNS = *.f \ - *.F \ - *.F90 \ - *.f90 \ - *.nml \ - *.txt -RECURSIVE = YES -EXCLUDE = -EXCLUDE_SYMLINKS = NO -EXCLUDE_PATTERNS = -EXCLUDE_SYMBOLS = -EXAMPLE_PATH = ./ -EXAMPLE_PATTERNS = -EXAMPLE_RECURSIVE = NO -IMAGE_PATH = img -INPUT_FILTER = -FILTER_PATTERNS = -FILTER_SOURCE_FILES = NO -FILTER_SOURCE_PATTERNS = -USE_MDFILE_AS_MAINPAGE = -SOURCE_BROWSER = NO -INLINE_SOURCES = NO -STRIP_CODE_COMMENTS = YES -REFERENCED_BY_RELATION = YES -REFERENCES_RELATION = YES -REFERENCES_LINK_SOURCE = YES -SOURCE_TOOLTIPS = YES -USE_HTAGS = NO -VERBATIM_HEADERS = YES -#CLANG_ASSISTED_PARSING = NO -#CLANG_OPTIONS = -ALPHABETICAL_INDEX = NO -COLS_IN_ALPHA_INDEX = 5 -IGNORE_PREFIX = -GENERATE_HTML = YES -HTML_OUTPUT = html -HTML_FILE_EXTENSION = .html -HTML_HEADER = -HTML_FOOTER = -HTML_STYLESHEET = -HTML_EXTRA_STYLESHEET = ccpp_dox_extra_style.css -HTML_EXTRA_FILES = -HTML_COLORSTYLE_HUE = 220 -HTML_COLORSTYLE_SAT = 100 -HTML_COLORSTYLE_GAMMA = 80 -HTML_TIMESTAMP = NO -HTML_DYNAMIC_SECTIONS = NO -HTML_INDEX_NUM_ENTRIES = 100 -GENERATE_DOCSET = NO -DOCSET_FEEDNAME = "Doxygen generated docs" -DOCSET_BUNDLE_ID = org.doxygen.Project -DOCSET_PUBLISHER_ID = org.doxygen.Publisher -DOCSET_PUBLISHER_NAME = Publisher -GENERATE_HTMLHELP = NO -CHM_FILE = -HHC_LOCATION = -GENERATE_CHI = NO -CHM_INDEX_ENCODING = -BINARY_TOC = NO -TOC_EXPAND = NO -GENERATE_QHP = NO -QCH_FILE = -QHP_NAMESPACE = org.doxygen.Project -QHP_VIRTUAL_FOLDER = doc -QHP_CUST_FILTER_NAME = -QHP_CUST_FILTER_ATTRS = -QHP_SECT_FILTER_ATTRS = -QHG_LOCATION = -GENERATE_ECLIPSEHELP = NO -ECLIPSE_DOC_ID = org.doxygen.Project -DISABLE_INDEX = YES -GENERATE_TREEVIEW = YES -ENUM_VALUES_PER_LINE = 4 -TREEVIEW_WIDTH = 250 -EXT_LINKS_IN_WINDOW = NO -FORMULA_FONTSIZE = 10 -FORMULA_TRANSPARENT = YES -USE_MATHJAX = YES -MATHJAX_FORMAT = HTML-CSS -MATHJAX_RELPATH = https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.2 -MATHJAX_EXTENSIONS = -MATHJAX_CODEFILE = -SEARCHENGINE = YES -SERVER_BASED_SEARCH = NO -EXTERNAL_SEARCH = NO -SEARCHENGINE_URL = -SEARCHDATA_FILE = searchdata.xml -EXTERNAL_SEARCH_ID = -EXTRA_SEARCH_MAPPINGS = -GENERATE_LATEX = YES -LATEX_OUTPUT = latex -LATEX_CMD_NAME = latex -MAKEINDEX_CMD_NAME = makeindex -COMPACT_LATEX = YES -PAPER_TYPE = a4 -EXTRA_PACKAGES = amsmath -LATEX_HEADER = -LATEX_FOOTER = -LATEX_EXTRA_STYLESHEET = -LATEX_EXTRA_FILES = -PDF_HYPERLINKS = YES -USE_PDFLATEX = YES -LATEX_BATCHMODE = NO -LATEX_HIDE_INDICES = YES -LATEX_SOURCE_CODE = NO - -LATEX_BIB_STYLE = plainnat - -LATEX_TIMESTAMP = NO - -GENERATE_RTF = NO - -RTF_OUTPUT = rtf -COMPACT_RTF = NO -RTF_HYPERLINKS = NO -RTF_STYLESHEET_FILE = -RTF_EXTENSIONS_FILE = -RTF_SOURCE_CODE = NO -GENERATE_MAN = NO -MAN_OUTPUT = man -MAN_EXTENSION = .3 -MAN_SUBDIR = -MAN_LINKS = NO -GENERATE_XML = NO -XML_OUTPUT = xml -XML_PROGRAMLISTING = YES -GENERATE_DOCBOOK = NO -DOCBOOK_OUTPUT = docbook -DOCBOOK_PROGRAMLISTING = NO -GENERATE_AUTOGEN_DEF = NO -GENERATE_PERLMOD = NO -PERLMOD_LATEX = NO -PERLMOD_PRETTY = YES -PERLMOD_MAKEVAR_PREFIX = -ENABLE_PREPROCESSING = NO -MACRO_EXPANSION = NO -EXPAND_ONLY_PREDEF = NO -SEARCH_INCLUDES = YES -INCLUDE_PATH = -INCLUDE_FILE_PATTERNS = -PREDEFINED = CCPP \ - MULTI_GASES \ - 0 -EXPAND_AS_DEFINED = -SKIP_FUNCTION_MACROS = YES -TAGFILES = -GENERATE_TAGFILE = -ALLEXTERNALS = NO -EXTERNAL_GROUPS = YES -EXTERNAL_PAGES = YES -PERL_PATH = /usr/bin/perl -CLASS_DIAGRAMS = YES -MSCGEN_PATH = -DIA_PATH = -HIDE_UNDOC_RELATIONS = NO -HAVE_DOT = YES -DOT_NUM_THREADS = 0 -DOT_FONTNAME = Helvetica -DOT_FONTSIZE = 10 -DOT_FONTPATH = -CLASS_GRAPH = NO -COLLABORATION_GRAPH = NO -GROUP_GRAPHS = YES -UML_LOOK = YES -UML_LIMIT_NUM_FIELDS = 10 -TEMPLATE_RELATIONS = NO -INCLUDE_GRAPH = YES -INCLUDED_BY_GRAPH = NO -CALL_GRAPH = YES -CALLER_GRAPH = NO -GRAPHICAL_HIERARCHY = YES -DIRECTORY_GRAPH = YES -DOT_IMAGE_FORMAT = svg -INTERACTIVE_SVG = NO -DOT_PATH = -DOTFILE_DIRS = -MSCFILE_DIRS = -DIAFILE_DIRS = -PLANTUML_JAR_PATH = -PLANTUML_INCLUDE_PATH = -DOT_GRAPH_MAX_NODES = 200 -MAX_DOT_GRAPH_DEPTH = 0 -DOT_TRANSPARENT = NO -DOT_MULTI_TARGETS = YES -GENERATE_LEGEND = YES -DOT_CLEANUP = YES diff --git a/physics/docs/library.bib b/physics/docs/library.bib index 2ee46aac9..c04666a0b 100644 --- a/physics/docs/library.bib +++ b/physics/docs/library.bib @@ -1,3351 +1,3656 @@ %% This BibTeX bibliography file was created using BibDesk. -%% http://bibdesk.sourceforge.net/ +%% https://bibdesk.sourceforge.io/ -%% Created for Man Zhang at 2021-02-03 14:24:42 -0700 +%% Created for Man Zhang at 2022-05-13 16:18:03 -0600 %% Saved with string encoding Unicode (UTF-8) +@conference{beck_et_al_2022, + author = {Beck, J. and J. Wolff and L. Carson and W. Li and M. Harrold and W. Mayfield and K. Y. Wong and J. Berner and P. Pegion and C. R. Alexander and J. R. Carley}, + booktitle = {12th Conference on Transition of Research to Operations}, + date-added = {2022-05-13 16:13:59 -0600}, + date-modified = {2022-05-13 16:18:02 -0600}, + number = {7B.6}, + organization = {102nd AMS Annual Meeting}, + title = {Implementation and testing of stochastic physics within FV3-LAM and RRFS prototype ensembles using the Common Community Physics Package (CCPP)}, + year = {2022}} + +@article{he_et_al_2021, + author = {He S. and T. G. Smirnova and S. G. Benjamin}, + date-added = {2022-05-12 15:16:26 -0600}, + date-modified = {2022-05-12 15:18:44 -0600}, + journal = {Water Resources Research}, + number = {8}, + title = {Single-Column validation of a snow subgrid parameterization in the Rapid Update Cycle Land-Surface Model (RUC LSM)}, + volume = {57}, + year = {2021}} + +@article{essery_et_al_2020, + author = {Essery, R. and Kim, H. and Wang, L. and Bartlett, P. and Boone, A. and Brutel-Vuilmet, C. and Burke, E. and Cuntz, M. and Decharme, B. and Dutra, E. and Fang, X. and Gusev, Y. and Hagemann, S. and Haverd, V. and Kontu, A. and Krinner, G. and Lafaysse, M. and Lejeune, Y. and Marke, T. and Marks, D. and Marty, C. and Menard, C. B. and Nasonova, O. and Nitta, T. and Pomeroy, J. and Sch\"adler, G. and Semenov, V. and Smirnova, T. and Swenson, S. and Turkov, D. and Wever, N. and Yuan, H.}, + date-modified = {2022-05-12 10:55:34 -0600}, + doi = {10.5194/tc-14-4687-2020}, + journal = {The Cryosphere}, + number = {12}, + pages = {4687--4698}, + title = {Snow cover duration trends observed at sites and predicted by multiple models}, + url = {https://tc.copernicus.org/articles/14/4687/2020/}, + volume = {14}, + year = {2020}, + bdsk-url-1 = {https://tc.copernicus.org/articles/14/4687/2020/}, + bdsk-url-2 = {https://doi.org/10.5194/tc-14-4687-2020}} + +@article{Menard_2021, + author = {Cecile B. Menard and Richard Essery and Gerhard Krinner and Gabriele Arduini and Paul Bartlett and Aaron Boone and Claire Brutel-Vuilmet and Eleanor Burke and Matthias Cuntz and Yongjiu Dai and Bertrand Decharme and Emanuel Dutra and Xing Fang and Charles Fierz and Yeugeniy Gusev and Stefan Hagemann and Vanessa Haverd and Hyungjun Kim and Matthieu Lafaysse and Thomas Marke and Olga Nasonova and Tomoko Nitta and Masashi Niwano and John Pomeroy and Gerd Sch{\"a}dler and Vladimir A. Semenov and Tatiana Smirnova and Ulrich Strasser and Sean Swenson and Dmitry Turkov and Nander Wever and Hua Yuan}, + date-added = {2022-05-12 10:51:40 -0600}, + date-modified = {2022-05-12 10:51:40 -0600}, + journal = {Bulletin of the American Meteorological Society}, + month = {Jan}, + number = {1}, + pages = {E61--E79}, + publisher = {American Meteorological Society}, + title = {Scientific and Human Errors in a Snow Model Intercomparison}, + url = {https://doi.org/10.1175%2Fbams-d-19-0329.1}, + volume = {102}, + year = 2021, + bdsk-url-1 = {https://doi.org/10.1175%2Fbams-d-19-0329.1}, + bdsk-url-2 = {https://doi.org/10.1175/bams-d-19-0329.1}} + +@article{sakaguchi_and_zeng_2009, + author = {Sakaguchi, K. and X. Zeng}, + date-added = {2022-05-12 10:16:42 -0600}, + date-modified = {2022-05-12 10:20:22 -0600}, + journal = {J. Geophys. Res.}, + number = {D01107}, + title = {Effects of soil wetness, plant litter, and under-canopy atmospheric stability on ground evaporation in the Community Land Model (CLM3.5)}, + volume = {114}, + year = {2009}} + +@article{https://doi.org/10.25923/n9wm-be49, + author = {Olson, J. B. and Kenyon, Jaymes S. and Angevine, Wayne. A. and Brown, John M. and Pagowski, Mariusz and Su\u{s}elj, Kay}, + date-added = {2022-05-06 09:15:53 -0600}, + date-modified = {2022-05-06 09:15:53 -0600}, + publisher = {Earth System Research Laboratory (U.S.), Global Systems Division}, + title = {A Description of the MYNN-EDMF Scheme and the Coupling to Other Components in WRF--ARW}, + url = {https://repository.library.noaa.gov/view/noaa/19837}, + year = {2019}, + bdsk-url-1 = {https://repository.library.noaa.gov/view/noaa/19837}, + bdsk-url-2 = {https://doi.org/10.25923/N9WM-BE49}} + +@article{lee_and_feingold_2010, + author = {Lee, S.-S. and G. Feingold}, + date-added = {2022-05-02 15:01:07 -0600}, + date-modified = {2022-05-02 15:04:13 -0600}, + journal = {Geophysical Research Letters}, + number = {L23806}, + title = {Precipitating cloud-system response to aerosol perturbations}, + volume = {37}, + year = {2010}} + +@article{freitas_et_al_2021, + author = {Freitas, Saulo R. and G.A. Grell and H. Li}, + date-added = {2022-05-02 14:43:11 -0600}, + date-modified = {2022-05-02 14:44:42 -0600}, + journal = {Geoscientific Model Development}, + pages = {5393-5411}, + title = {The Grell-Freitas (GF) convection parameterization: recent development, extensions, and applications}, + volume = {14}, + year = {2021}} + +@article{Shin_2013, + author = {Hyeyum Hailey Shin and Song-You Hong}, + date-added = {2022-04-29 09:18:19 -0600}, + date-modified = {2022-04-29 09:18:19 -0600}, + doi = {10.1175/jas-d-12-0290.1}, + journal = {Journal of the Atmospheric Sciences}, + month = {oct}, + number = {10}, + pages = {3248--3261}, + publisher = {American Meteorological Society}, + title = {Analysis of Resolved and Parameterized Vertical Transports in Convective Boundary Layers at Gray-Zone Resolutions}, + url = {https://doi.org/10.1175%2Fjas-d-12-0290.1}, + volume = {70}, + year = 2013, + bdsk-url-1 = {https://doi.org/10.1175%2Fjas-d-12-0290.1}, + bdsk-url-2 = {https://doi.org/10.1175/jas-d-12-0290.1}} + +@article{Honnert_2011, + author = {Rachel Honnert and Val{\'{e}}ry Masson and Fleur Couvreux}, + date-added = {2022-04-29 09:17:12 -0600}, + date-modified = {2022-04-29 09:17:12 -0600}, + doi = {10.1175/jas-d-11-061.1}, + journal = {Journal of the Atmospheric Sciences}, + month = {dec}, + number = {12}, + pages = {3112--3131}, + publisher = {American Meteorological Society}, + title = {A Diagnostic for Evaluating the Representation of Turbulence in Atmospheric Models at the Kilometric Scale}, + url = {https://doi.org/10.1175%2Fjas-d-11-061.1}, + volume = {68}, + year = 2011, + bdsk-url-1 = {https://doi.org/10.1175%2Fjas-d-11-061.1}, + bdsk-url-2 = {https://doi.org/10.1175/jas-d-11-061.1}} + +@article{Oreopoulos_2012, + author = {L. Oreopoulos and D. Lee and Y. C. Sud and M. J. Suarez}, + date-added = {2022-04-28 11:27:32 -0600}, + date-modified = {2022-04-28 11:27:32 -0600}, + doi = {10.5194/acp-12-9097-2012}, + journal = {Atmospheric Chemistry and Physics}, + month = {oct}, + number = {19}, + pages = {9097--9111}, + publisher = {Copernicus {GmbH}}, + title = {Radiative impacts of cloud heterogeneity and overlap in an atmospheric General Circulation Model}, + url = {https://doi.org/10.5194%2Facp-12-9097-2012}, + volume = {12}, + year = 2012, + bdsk-url-1 = {https://doi.org/10.5194%2Facp-12-9097-2012}, + bdsk-url-2 = {https://doi.org/10.5194/acp-12-9097-2012}} + +@article{shonk_et_al_2010, + author = {Shonk J.K.P. and R.J. Hogan and J.M. Edwards and G.G. Mace}, + date-added = {2022-04-28 11:20:38 -0600}, + date-modified = {2022-04-28 11:25:07 -0600}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + number = {119101204}, + title = {Effect of improving representation of horizontal and vertical cloud structure on the Earth's global radiation budget. Part I: Review and parametrization}, + volume = {136}, + year = {2010}} + +@article{Henry_Juang_2010, + author = {Hann-Ming Henry Juang and Song-You Hong}, + date-added = {2022-04-20 20:26:00 -0600}, + date-modified = {2022-04-20 20:26:00 -0600}, + doi = {10.1175/2009mwr3109.1}, + journal = {Monthly Weather Review}, + month = {may}, + number = {5}, + pages = {1778--1791}, + publisher = {American Meteorological Society}, + title = {Forward Semi-Lagrangian Advection with Mass Conservation and Positive Definiteness for Falling Hydrometeors}, + url = {https://doi.org/10.1175%2F2009mwr3109.1}, + volume = {138}, + year = 2010, + bdsk-url-1 = {https://doi.org/10.1175%2F2009mwr3109.1}, + bdsk-url-2 = {https://doi.org/10.1175/2009mwr3109.1}} + +@article{https://doi.org/10.25923/5051-3r70, + author = {Han, Jongil}, + date-added = {2022-04-14 18:24:47 -0600}, + date-modified = {2022-04-14 18:24:47 -0600}, + publisher = {National Centers for Environmental Prediction (U.S.)}, + title = {Implementation of a positive definite mass-flux scheme and a method for removing the negative tracers in the NCEP GFS planetary boundary layer and cumulus convection schemes}, + url = {https://repository.library.noaa.gov/view/noaa/36734}, + year = {2022}, + bdsk-url-1 = {https://repository.library.noaa.gov/view/noaa/36734}, + bdsk-url-2 = {https://doi.org/10.25923/5051-3R70}} + +@article{https://doi.org/10.25923/cybh-w893, + author = {Han, Jongil}, + date-added = {2022-04-14 18:17:43 -0600}, + date-modified = {2022-04-14 18:17:43 -0600}, + publisher = {National Centers for Environmental Prediction (U.S.)}, + title = {Updates in the NCEP GFS Cumulus Convection, Vertical Turbulent Mixing, and Surface Layer Physics}, + url = {https://repository.library.noaa.gov/view/noaa/33881}, + year = {2021}, + bdsk-url-1 = {https://repository.library.noaa.gov/view/noaa/33881}, + bdsk-url-2 = {https://doi.org/10.25923/CYBH-W893}} + +@book{Chopard_1998, + author = {Bastien Chopard and Michel Droz}, + date-added = {2022-04-14 16:19:17 -0600}, + date-modified = {2022-04-14 16:19:17 -0600}, + doi = {10.1017/cbo9780511549755}, + month = {dec}, + publisher = {Cambridge University Press}, + title = {Cellular Automata Modeling of Physical Systems}, + url = {https://doi.org/10.1017%2Fcbo9780511549755}, + year = 1998, + bdsk-url-1 = {https://doi.org/10.1017%2Fcbo9780511549755}, + bdsk-url-2 = {https://doi.org/10.1017/cbo9780511549755}} + +@article{bengtsson_et_al_2021, + author = {Bengtsson, L and J. Dias and S. Tulich and M. Gehne and J-W. Bao}, + date-added = {2022-04-14 15:52:49 -0600}, + date-modified = {2022-04-14 15:59:17 -0600}, + journal = {Journal of Advances in Modeling Earth Systems}, + number = {1}, + pages = {21}, + title = {A stochastic parameterization of organized tropical convection using cellular automata for global forecasts in NOAA's Unified Forecast System}, + volume = {13}, + year = {2021}} + +@article{Bengtsson_2011, + author = {Lisa Bengtsson and Heiner K{\"o}rnich and Erland K{\"a}ll{\'{e}}n and Gunilla Svensson}, + date-added = {2022-04-14 15:46:26 -0600}, + date-modified = {2022-04-14 15:46:26 -0600}, + doi = {10.1175/jas-d-10-05028.1}, + journal = {Journal of the Atmospheric Sciences}, + month = {dec}, + number = {12}, + pages = {3132--3144}, + publisher = {American Meteorological Society}, + title = {Large-Scale Dynamical Response to Subgrid-Scale Organization Provided by Cellular Automata}, + url = {https://doi.org/10.1175%2Fjas-d-10-05028.1}, + volume = {68}, + year = 2011, + bdsk-url-1 = {https://doi.org/10.1175%2Fjas-d-10-05028.1}, + bdsk-url-2 = {https://doi.org/10.1175/jas-d-10-05028.1}} + +@article{bengtsson_et_al_2013, + author = {Bengtsson, L and M. Steinheimer and P. Bechtold and J-F. Geleyn}, + date-added = {2022-04-14 15:42:04 -0600}, + date-modified = {2022-04-14 15:44:39 -0600}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + number = {675}, + pages = {1533-1543}, + title = {A stochastic parameterization for deep convection using cellular automata}, + volume = {139}, + year = {2013}} + +@article{bengtsson_and_kornich_2016, + author = {Bengtsson, L and H. Kornich}, + date-added = {2022-04-14 15:31:21 -0600}, + date-modified = {2022-04-14 15:37:47 -0600}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + number = {695}, + pages = {1150-1159}, + title = {Impact of a stochastic parameterization of cumulus convection, using cellular automata, in a meso-scale ensemble prediction sytem}, + volume = {142}, + year = {2016}} + +@article{Bengtsson_2019, + author = {Lisa Bengtsson and Jian-Wen Bao and Philip Pegion and Cecile Penland and Sara Michelson and Jeffrey Whitaker}, + date-added = {2022-04-14 15:24:29 -0600}, + date-modified = {2022-04-14 15:24:29 -0600}, + doi = {10.1175/mwr-d-18-0238.1}, + journal = {Monthly Weather Review}, + month = {feb}, + number = {3}, + pages = {893--911}, + publisher = {American Meteorological Society}, + title = {A Model Framework for Stochastic Representation of Uncertainties Associated with Physical Processes in {NOAA}'s Next Generation Global Prediction System ({NGGPS})}, + url = {https://doi.org/10.1175%2Fmwr-d-18-0238.1}, + volume = {147}, + year = 2019, + bdsk-url-1 = {https://doi.org/10.1175%2Fmwr-d-18-0238.1}, + bdsk-url-2 = {https://doi.org/10.1175/mwr-d-18-0238.1}} + +@article{kim_and_doyle_2005, + author = {Kim, Y.-J. and J. D. Doyle}, + date-added = {2022-04-12 11:06:57 -0600}, + date-modified = {2022-04-12 11:09:13 -0600}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + number = {609}, + pages = {1893-1991}, + title = {Extension of an orographic-drag parametrization scheme to incorporate orographic anisotropy and flow blocking}, + volume = {131}, + year = {2005}} + @article{buchard_et_al_2017, - Author = {V. Buchard and C. A. Randles and A. M. da Silva and et al.}, - Date-Added = {2021-02-01 21:33:58 +0000}, - Date-Modified = {2021-02-01 21:37:20 +0000}, - Journal = {J. Climate}, - Pages = {6851-6872}, - Title = {The {MERRA}-2 aerosol reanalysis, 1980 onward. {P}art {II}: Evaluation and case studies}, - Volume = {30}, - Year = {2017}} + author = {V. Buchard and C. A. Randles and A. M. da Silva and et al.}, + date-added = {2021-02-01 21:33:58 +0000}, + date-modified = {2021-02-01 21:37:20 +0000}, + journal = {J. Climate}, + pages = {6851-6872}, + title = {The {MERRA}-2 aerosol reanalysis, 1980 onward. {P}art {II}: Evaluation and case studies}, + volume = {30}, + year = {2017}} @article{randles_et_al_2017, - Author = {C. A. Randles and A. M. da Silva and V. Buchard and et al.}, - Date-Added = {2021-02-01 21:26:16 +0000}, - Date-Modified = {2021-02-01 21:32:25 +0000}, - Journal = {J. Climate}, - Pages = {6823-6850}, - Title = {The {MERRA}-2 aerosol reanalysis, 1980 onward. {P}art {I}: System description and data assimilation evaluation}, - Volume = {30}, - Year = {2017}} + author = {C. A. Randles and A. M. da Silva and V. Buchard and et al.}, + date-added = {2021-02-01 21:26:16 +0000}, + date-modified = {2021-02-01 21:32:25 +0000}, + journal = {J. Climate}, + pages = {6823-6850}, + title = {The {MERRA}-2 aerosol reanalysis, 1980 onward. {P}art {I}: System description and data assimilation evaluation}, + volume = {30}, + year = {2017}} @article{colarco_et_al_2010, - Author = {P. Colarco and A. da Silva and M. Chin and T. Diehl}, - Date-Added = {2021-02-01 14:20:20 -0700}, - Date-Modified = {2021-02-01 14:23:22 -0700}, - Journal = {Journal of Geophysical Research}, - Number = {D14207}, - Pages = {25}, - Title = {Online simulations of global aerosol distributions in the {NASA} {GOES-4} model and comparisons to satellite and ground-based aerosol optical depth}, - Volume = {115}, - Year = {2010}} + author = {P. Colarco and A. da Silva and M. Chin and T. Diehl}, + date-added = {2021-02-01 14:20:20 -0700}, + date-modified = {2021-02-01 14:23:22 -0700}, + journal = {Journal of Geophysical Research}, + number = {D14207}, + pages = {25}, + title = {Online simulations of global aerosol distributions in the {NASA} {GOES-4} model and comparisons to satellite and ground-based aerosol optical depth}, + volume = {115}, + year = {2010}} @article{zhou_etal_2019, - Author = {L.-J. Zhou and S.-J. Lin and J.-H. Chen and L. M. Harris and X. Chen and S. L. Rees}, - Date-Added = {2021-02-01 21:07:24 +0000}, - Date-Modified = {2021-02-01 21:10:36 +0000}, - Journal = {Bulletin of the American Meteorological Society}, - Pages = {1225-1243}, - Title = {Toward convective-scale prediction within the next generation global prediction system}, - Year = {2019}} + author = {L.-J. Zhou and S.-J. Lin and J.-H. Chen and L. M. Harris and X. Chen and S. L. Rees}, + date-added = {2021-02-01 21:07:24 +0000}, + date-modified = {2021-02-01 21:10:36 +0000}, + journal = {Bulletin of the American Meteorological Society}, + pages = {1225-1243}, + title = {Toward convective-scale prediction within the next generation global prediction system}, + year = {2019}} @article{miguez_et_al_2007, - Author = {G. Miguez-Macho and Y. Fan and C. P. Weaver and R. Walko and A. Robock}, - Date-Added = {2021-01-05 14:42:06 -0700}, - Date-Modified = {2021-01-05 14:50:03 -0700}, - Journal = {Journal of Geophysical Research}, - Number = {D13108}, - Title = {Incorporating water table dynamics in climate modeling: 2. Formulation, validation, and soil moisture simulation}, - Volume = {112}, - Year = {2007}} + author = {G. Miguez-Macho and Y. Fan and C. P. Weaver and R. Walko and A. Robock}, + date-added = {2021-01-05 14:42:06 -0700}, + date-modified = {2021-01-05 14:50:03 -0700}, + journal = {Journal of Geophysical Research}, + number = {D13108}, + title = {Incorporating water table dynamics in climate modeling: 2. Formulation, validation, and soil moisture simulation}, + volume = {112}, + year = {2007}} @article{fan_et_al_2007, - Author = {Y. Fan and G. Miguez-Macho and C. P. Weaver and R. Walko and A. Robock}, - Date-Added = {2021-01-05 14:36:44 -0700}, - Date-Modified = {2021-01-05 14:40:37 -0700}, - Journal = {Journal of Geophysical Research}, - Number = {D10125}, - Title = {Incorporating water table dynamics in climate modeling: 1. Water table observations and equilibrium water table simulations}, - Volume = {112}, - Year = {2007}} + author = {Y. Fan and G. Miguez-Macho and C. P. Weaver and R. Walko and A. Robock}, + date-added = {2021-01-05 14:36:44 -0700}, + date-modified = {2021-01-05 14:40:37 -0700}, + journal = {Journal of Geophysical Research}, + number = {D10125}, + title = {Incorporating water table dynamics in climate modeling: 1. Water table observations and equilibrium water table simulations}, + volume = {112}, + year = {2007}} @article{niu_et_al_2005, - Author = {Niu, G.-Y. and Z.-L Yang and R. E. Dickinson and L. E. Gulden}, - Date-Added = {2021-01-05 14:19:03 -0700}, - Date-Modified = {2021-01-05 14:23:29 -0700}, - Journal = {Climate and Dynamics}, - Number = {D21106}, - Title = {A simple {TOPMODEL}-based runoff parameterization ({SIMTOP}) for use in global climate models}, - Volume = {110}, - Year = {2005}} + author = {Niu, G.-Y. and Z.-L Yang and R. E. Dickinson and L. E. Gulden}, + date-added = {2021-01-05 14:19:03 -0700}, + date-modified = {2021-01-05 14:23:29 -0700}, + journal = {Climate and Dynamics}, + number = {D21106}, + title = {A simple {TOPMODEL}-based runoff parameterization ({SIMTOP}) for use in global climate models}, + volume = {110}, + year = {2005}} @article{monin_and_obukhov_1954, - Author = {A.S.Monin and A.M.Obukhov}, - Date-Added = {2020-11-02 19:17:57 +0000}, - Date-Modified = {2020-11-02 19:19:45 +0000}, - Journal = {Akad. Nauk SSSR}, - Pages = {163-187}, - Title = {Basic laws of turbulent mixing in the atmosphere near the ground}, - Volume = {24}, - Year = {1954}} + author = {A.S.Monin and A.M.Obukhov}, + date-added = {2020-11-02 19:17:57 +0000}, + date-modified = {2020-11-02 19:19:45 +0000}, + journal = {Akad. Nauk SSSR}, + pages = {163-187}, + title = {Basic laws of turbulent mixing in the atmosphere near the ground}, + volume = {24}, + year = {1954}} @article{beljaars_et_al_2004, - Author = {A.C.M. Beljaars and A.R.Brown and N. Wood}, - Date-Added = {2020-11-02 19:13:02 +0000}, - Date-Modified = {2020-11-02 19:15:18 +0000}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Pages = {1327-1347}, - Title = {A new parameterization of turbulent orographic form drag}, - Volume = {130}, - Year = {2004}} + author = {A.C.M. Beljaars and A.R.Brown and N. Wood}, + date-added = {2020-11-02 19:13:02 +0000}, + date-modified = {2020-11-02 19:15:18 +0000}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + pages = {1327-1347}, + title = {A new parameterization of turbulent orographic form drag}, + volume = {130}, + year = {2004}} @article{steeneveld_et_al_2008, - Author = {G.J. Steeneveld and A. A. M. Holtslag and C.J. Nappo and B.J.H. van de Wiel and L. Mahrt}, - Date-Added = {2020-11-02 19:02:29 +0000}, - Date-Modified = {2020-11-02 19:11:00 +0000}, - Journal = {Journal of Applied Meteorology}, - Pages = {2518-2530}, - Title = {Exploring the possible role of small-scale terrain drag on stable boundary layers over land}, - Volume = {47}, - Year = {2008}} + author = {G.J. Steeneveld and A. A. M. Holtslag and C.J. Nappo and B.J.H. van de Wiel and L. Mahrt}, + date-added = {2020-11-02 19:02:29 +0000}, + date-modified = {2020-11-02 19:11:00 +0000}, + journal = {Journal of Applied Meteorology}, + pages = {2518-2530}, + title = {Exploring the possible role of small-scale terrain drag on stable boundary layers over land}, + volume = {47}, + year = {2008}} @article{fitch_et_al_2012, - Author = {A. C. Fitch and J. B. Olson and J. K. Lundquist and J. Dudhia and A.K. Gupta and J. Michalakes and I. Barstad}, - Date-Added = {2020-11-02 11:19:27 -0700}, - Date-Modified = {2020-11-17 15:48:33 +0000}, - Journal = {Monthly Weather Review}, - Number = {9}, - Pages = {3017-3038}, - Title = {Local and mesoscale impacts of wind farms as parameterized in a mesoscale {NWP} model}, - Volume = {140}, - Year = {2012}} + author = {A. C. Fitch and J. B. Olson and J. K. Lundquist and J. Dudhia and A.K. Gupta and J. Michalakes and I. Barstad}, + date-added = {2020-11-02 11:19:27 -0700}, + date-modified = {2020-11-17 15:48:33 +0000}, + journal = {Monthly Weather Review}, + number = {9}, + pages = {3017-3038}, + title = {Local and mesoscale impacts of wind farms as parameterized in a mesoscale {NWP} model}, + volume = {140}, + year = {2012}} @article{niu_and_yang_2006, - Abstract = { Abstract The presence of ice in soil dramatically alters soil hydrologic and thermal properties. Despite this important role, many recent studies show that explicitly including the hydrologic effects of soil ice in land surface models degrades the simulation of runoff in cold regions. This paper addresses this dilemma by employing the Community Land Model version 2.0 (CLM2.0) developed at the National Center for Atmospheric Research (NCAR) and a simple TOPMODEL-based runoff scheme (SIMTOP). CLM2.0/SIMTOP explicitly computes soil ice content and its modifications to soil hydrologic and thermal properties. However, the frozen soil scheme has a tendency to produce a completely frozen soil (100\% ice content) whenever the soil temperature is below 0$\,^{\circ}$C. The frozen ground prevents infiltration of snowmelt or rainfall, thereby resulting in earlier- and higher-than-observed springtime runoff. This paper presents modifications to the above-mentioned frozen soil scheme that produce more accurate magnitude and seasonality of runoff and soil water storage. These modifications include 1) allowing liquid water to coexist with ice in the soil over a wide range of temperatures below 0$\,^{\circ}$C by using the freezing-point depression equation, 2) computing the vertical water fluxes by introducing the concept of a fractional permeable area, which partitions the model grid into an impermeable part (no vertical water flow) and a permeable part, and 3) using the total soil moisture (liquid water and ice) to calculate the soil matric potential and hydraulic conductivity. The performance of CLM2.0/SIMTOP with these changes has been tested using observed data in cold-region river basins of various spatial scales. Compared to the CLM2.0/SIMTOP frozen soil scheme, the modified scheme produces monthly runoff that compares more favorably with that estimated by the University of New Hampshire--Global Runoff Data Center and a terrestrial water storage change that is in closer agreement with that measured by the Gravity Recovery and Climate Experiment (GRACE) satellites. }, - Author = {Niu, G.-Y. and Yang, Z.-L.}, - Date-Added = {2019-10-25 22:35:50 +0000}, - Date-Modified = {2019-10-25 22:36:03 +0000}, - Doi = {10.1175/JHM538.1}, - Eprint = {https://doi.org/10.1175/JHM538.1}, - Journal = {Journal of Hydrometeorology}, - Number = {5}, - Pages = {937-952}, - Title = {Effects of Frozen Soil on Snowmelt Runoff and Soil Water Storage at a Continental Scale}, - Url = {https://doi.org/10.1175/JHM538.1}, - Volume = {7}, - Year = {2006}, - Bdsk-Url-1 = {https://doi.org/10.1175/JHM538.1}} + abstract = { Abstract The presence of ice in soil dramatically alters soil hydrologic and thermal properties. Despite this important role, many recent studies show that explicitly including the hydrologic effects of soil ice in land surface models degrades the simulation of runoff in cold regions. This paper addresses this dilemma by employing the Community Land Model version 2.0 (CLM2.0) developed at the National Center for Atmospheric Research (NCAR) and a simple TOPMODEL-based runoff scheme (SIMTOP). CLM2.0/SIMTOP explicitly computes soil ice content and its modifications to soil hydrologic and thermal properties. However, the frozen soil scheme has a tendency to produce a completely frozen soil (100\% ice content) whenever the soil temperature is below 0$\,^{\circ}$C. The frozen ground prevents infiltration of snowmelt or rainfall, thereby resulting in earlier- and higher-than-observed springtime runoff. This paper presents modifications to the above-mentioned frozen soil scheme that produce more accurate magnitude and seasonality of runoff and soil water storage. These modifications include 1) allowing liquid water to coexist with ice in the soil over a wide range of temperatures below 0$\,^{\circ}$C by using the freezing-point depression equation, 2) computing the vertical water fluxes by introducing the concept of a fractional permeable area, which partitions the model grid into an impermeable part (no vertical water flow) and a permeable part, and 3) using the total soil moisture (liquid water and ice) to calculate the soil matric potential and hydraulic conductivity. The performance of CLM2.0/SIMTOP with these changes has been tested using observed data in cold-region river basins of various spatial scales. Compared to the CLM2.0/SIMTOP frozen soil scheme, the modified scheme produces monthly runoff that compares more favorably with that estimated by the University of New Hampshire--Global Runoff Data Center and a terrestrial water storage change that is in closer agreement with that measured by the Gravity Recovery and Climate Experiment (GRACE) satellites. }, + author = {Niu, G.-Y. and Yang, Z.-L.}, + date-added = {2019-10-25 22:35:50 +0000}, + date-modified = {2019-10-25 22:36:03 +0000}, + doi = {10.1175/JHM538.1}, + eprint = {https://doi.org/10.1175/JHM538.1}, + journal = {Journal of Hydrometeorology}, + number = {5}, + pages = {937-952}, + title = {Effects of Frozen Soil on Snowmelt Runoff and Soil Water Storage at a Continental Scale}, + url = {https://doi.org/10.1175/JHM538.1}, + volume = {7}, + year = {2006}, + bdsk-url-1 = {https://doi.org/10.1175/JHM538.1}} @article{niu_et_al_2007, - Abstract = {Groundwater interacts with soil moisture through the exchanges of water between the unsaturated soil and its underlying aquifer under gravity and capillary forces. Despite its importance, groundwater is not explicitly represented in climate models. This paper developed a simple groundwater model (SIMGM) by representing recharge and discharge processes of the water storage in an unconfined aquifer, which is added as a single integration element below the soil of a land surface model. We evaluated the model against the Gravity Recovery and Climate Experiment (GRACE) terrestrial water storage change (ΔS) data. The modeled total water storage (including unsaturated soil water and groundwater) change agrees fairly well with GRACE estimates. The anomaly of the modeled groundwater storage explains most of the GRACE ΔS anomaly in most river basins where the water storage is not affected by snow water or frozen soil. For this reason, the anomaly of the modeled water table depth agrees well with that converted from the GRACE ΔS in most of the river basins. We also investigated the impacts of groundwater dynamics on soil moisture and evapotranspiration through the comparison of SIMGM to an additional model run using gravitational free drainage (FD) as the model's lower boundary condition. SIMGM produced much wetter soil profiles globally and up to 16\% more annual evapotranspiration than FD, most obviously in arid-to-wet transition regions.}, - Author = {Niu, G.-Y. and Yang, Z.-L. and Dickinson, R. E. and Gulden, L. E. and Su, H.}, - Date-Added = {2019-10-25 22:31:30 +0000}, - Date-Modified = {2019-10-25 22:31:41 +0000}, - Doi = {10.1029/2006JD007522}, - Eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2006JD007522}, - Journal = {Journal of Geophysical Research: Atmospheres}, - Keywords = {Groundwater recharge, groundwater discharge, climate models}, - Number = {D7}, - Title = {Development of a simple groundwater model for use in climate models and evaluation with Gravity Recovery and Climate Experiment data}, - Url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2006JD007522}, - Volume = {112}, - Year = {2007}, - Bdsk-Url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2006JD007522}, - Bdsk-Url-2 = {https://doi.org/10.1029/2006JD007522}} + abstract = {Groundwater interacts with soil moisture through the exchanges of water between the unsaturated soil and its underlying aquifer under gravity and capillary forces. Despite its importance, groundwater is not explicitly represented in climate models. This paper developed a simple groundwater model (SIMGM) by representing recharge and discharge processes of the water storage in an unconfined aquifer, which is added as a single integration element below the soil of a land surface model. We evaluated the model against the Gravity Recovery and Climate Experiment (GRACE) terrestrial water storage change (ΔS) data. The modeled total water storage (including unsaturated soil water and groundwater) change agrees fairly well with GRACE estimates. The anomaly of the modeled groundwater storage explains most of the GRACE ΔS anomaly in most river basins where the water storage is not affected by snow water or frozen soil. For this reason, the anomaly of the modeled water table depth agrees well with that converted from the GRACE ΔS in most of the river basins. We also investigated the impacts of groundwater dynamics on soil moisture and evapotranspiration through the comparison of SIMGM to an additional model run using gravitational free drainage (FD) as the model's lower boundary condition. SIMGM produced much wetter soil profiles globally and up to 16\% more annual evapotranspiration than FD, most obviously in arid-to-wet transition regions.}, + author = {Niu, G.-Y. and Yang, Z.-L. and Dickinson, R. E. and Gulden, L. E. and Su, H.}, + date-added = {2019-10-25 22:31:30 +0000}, + date-modified = {2019-10-25 22:31:41 +0000}, + doi = {10.1029/2006JD007522}, + eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2006JD007522}, + journal = {Journal of Geophysical Research: Atmospheres}, + keywords = {Groundwater recharge, groundwater discharge, climate models}, + number = {D7}, + title = {Development of a simple groundwater model for use in climate models and evaluation with Gravity Recovery and Climate Experiment data}, + url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2006JD007522}, + volume = {112}, + year = {2007}, + bdsk-url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2006JD007522}, + bdsk-url-2 = {https://doi.org/10.1029/2006JD007522}} @article{niu_et_al_2011, - Abstract = {This first paper of the two-part series describes the objectives of the community efforts in improving the Noah land surface model (LSM), documents, through mathematical formulations, the augmented conceptual realism in biophysical and hydrological processes, and introduces a framework for multiple options to parameterize selected processes (Noah-MP). The Noah-MP's performance is evaluated at various local sites using high temporal frequency data sets, and results show the advantages of using multiple optional schemes to interpret the differences in modeling simulations. The second paper focuses on ensemble evaluations with long-term regional (basin) and global scale data sets. The enhanced conceptual realism includes (1) the vegetation canopy energy balance, (2) the layered snowpack, (3) frozen soil and infiltration, (4) soil moisture-groundwater interaction and related runoff production, and (5) vegetation phenology. Sample local-scale validations are conducted over the First International Satellite Land Surface Climatology Project (ISLSCP) Field Experiment (FIFE) site, the W3 catchment of Sleepers River, Vermont, and a French snow observation site. Noah-MP shows apparent improvements in reproducing surface fluxes, skin temperature over dry periods, snow water equivalent (SWE), snow depth, and runoff over Noah LSM version 3.0. Noah-MP improves the SWE simulations due to more accurate simulations of the diurnal variations of the snow skin temperature, which is critical for computing available energy for melting. Noah-MP also improves the simulation of runoff peaks and timing by introducing a more permeable frozen soil and more accurate simulation of snowmelt. We also demonstrate that Noah-MP is an effective research tool by which modeling results for a given process can be interpreted through multiple optional parameterization schemes in the same model framework.}, - Author = {Niu, G.-Y. and Yang, Z.-L. and Mitchell, K. E. and et al.}, - Date-Added = {2019-10-25 21:50:31 +0000}, - Date-Modified = {2019-10-25 21:50:40 +0000}, - Doi = {10.1029/2010JD015139}, - Eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2010JD015139}, - Journal = {Journal of Geophysical Research: Atmospheres}, - Keywords = {Noah, land surface model, local scale, multiphysics, evaluation, validation}, - Number = {D12}, - Title = {The community Noah land surface model with multiparameterization options ({Noah-MP}): 1. Model description and evaluation with local-scale measurements}, - Url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2010JD015139}, - Volume = {116}, - Year = {2011}, - Bdsk-Url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2010JD015139}, - Bdsk-Url-2 = {https://doi.org/10.1029/2010JD015139}} + abstract = {This first paper of the two-part series describes the objectives of the community efforts in improving the Noah land surface model (LSM), documents, through mathematical formulations, the augmented conceptual realism in biophysical and hydrological processes, and introduces a framework for multiple options to parameterize selected processes (Noah-MP). The Noah-MP's performance is evaluated at various local sites using high temporal frequency data sets, and results show the advantages of using multiple optional schemes to interpret the differences in modeling simulations. The second paper focuses on ensemble evaluations with long-term regional (basin) and global scale data sets. The enhanced conceptual realism includes (1) the vegetation canopy energy balance, (2) the layered snowpack, (3) frozen soil and infiltration, (4) soil moisture-groundwater interaction and related runoff production, and (5) vegetation phenology. Sample local-scale validations are conducted over the First International Satellite Land Surface Climatology Project (ISLSCP) Field Experiment (FIFE) site, the W3 catchment of Sleepers River, Vermont, and a French snow observation site. Noah-MP shows apparent improvements in reproducing surface fluxes, skin temperature over dry periods, snow water equivalent (SWE), snow depth, and runoff over Noah LSM version 3.0. Noah-MP improves the SWE simulations due to more accurate simulations of the diurnal variations of the snow skin temperature, which is critical for computing available energy for melting. Noah-MP also improves the simulation of runoff peaks and timing by introducing a more permeable frozen soil and more accurate simulation of snowmelt. We also demonstrate that Noah-MP is an effective research tool by which modeling results for a given process can be interpreted through multiple optional parameterization schemes in the same model framework.}, + author = {Niu, G.-Y. and Yang, Z.-L. and Mitchell, K. E. and et al.}, + date-added = {2019-10-25 21:50:31 +0000}, + date-modified = {2019-10-25 21:50:40 +0000}, + doi = {10.1029/2010JD015139}, + eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2010JD015139}, + journal = {Journal of Geophysical Research: Atmospheres}, + keywords = {Noah, land surface model, local scale, multiphysics, evaluation, validation}, + number = {D12}, + title = {The community Noah land surface model with multiparameterization options ({Noah-MP}): 1. Model description and evaluation with local-scale measurements}, + url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2010JD015139}, + volume = {116}, + year = {2011}, + bdsk-url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2010JD015139}, + bdsk-url-2 = {https://doi.org/10.1029/2010JD015139}} @article{bechtold_et_al_2014, - Author = {P. Bechtold and N. Semane and P. Lopez and J.-P. Chaboureau and A. Beljaars and N. Bormann}, - Date-Added = {2019-06-13 14:29:21 -0600}, - Date-Modified = {2019-06-13 14:38:38 -0600}, - Journal = {J. Atmos. Sci.}, - Pages = {734-753}, - Title = {Representing equilibrium and nonequilibrium convection in large-scale models}, - Volume = {71}, - Year = {2014}} + author = {P. Bechtold and N. Semane and P. Lopez and J.-P. Chaboureau and A. Beljaars and N. Bormann}, + date-added = {2019-06-13 14:29:21 -0600}, + date-modified = {2019-06-13 14:38:38 -0600}, + journal = {J. Atmos. Sci.}, + pages = {734-753}, + title = {Representing equilibrium and nonequilibrium convection in large-scale models}, + volume = {71}, + year = {2014}} @article{freitas_et_al_2018, - Author = {S. R. Freitas and G. A. Grell and A. Molod and et al.}, - Date-Added = {2019-06-13 13:51:50 -0600}, - Date-Modified = {2019-06-13 14:07:37 -0600}, - Journal = {Journal of Advances in Modeling Earth Systems}, - Pages = {1266-1289}, - Title = {Assessing the {G}rell-{F}reitas convection parameterization in the {NASA GEOS} modeling system}, - Volume = {10}, - Year = {2018}} + author = {S. R. Freitas and G. A. Grell and A. Molod and et al.}, + date-added = {2019-06-13 13:51:50 -0600}, + date-modified = {2019-06-13 14:07:37 -0600}, + journal = {Journal of Advances in Modeling Earth Systems}, + pages = {1266-1289}, + title = {Assessing the {G}rell-{F}reitas convection parameterization in the {NASA GEOS} modeling system}, + volume = {10}, + year = {2018}} @article{qu_and_hall_2005, - Author = {X. Qu and A. Hall}, - Date-Added = {2019-06-10 16:41:01 -0600}, - Date-Modified = {2019-06-10 16:42:55 -0600}, - Journal = {J. Climate}, - Pages = {5239-5252}, - Title = {Surface contribution to planetary albedo variability in cryosphere regions}, - Volume = {18}, - Year = {2005}} + author = {X. Qu and A. Hall}, + date-added = {2019-06-10 16:41:01 -0600}, + date-modified = {2019-06-10 16:42:55 -0600}, + journal = {J. Climate}, + pages = {5239-5252}, + title = {Surface contribution to planetary albedo variability in cryosphere regions}, + volume = {18}, + year = {2005}} @article{grant_et_al_2000, - Author = {I.F. Grant and A. J. Prata and R. P.Cechet}, - Date-Added = {2019-06-10 16:30:06 -0600}, - Date-Modified = {2019-06-10 16:33:28 -0600}, - Journal = {Journal of Applied Meteorology}, - Pages = {231-244}, - Title = {The impact of the diurnal variation of albedo on the remote sensing of the daily mean albedo of grassland}, - Volume = {39}, - Year = {2000}} + author = {I.F. Grant and A. J. Prata and R. P.Cechet}, + date-added = {2019-06-10 16:30:06 -0600}, + date-modified = {2019-06-10 16:33:28 -0600}, + journal = {Journal of Applied Meteorology}, + pages = {231-244}, + title = {The impact of the diurnal variation of albedo on the remote sensing of the daily mean albedo of grassland}, + volume = {39}, + year = {2000}} @article{moorthi_and_suarez_1992, - Author = {S. Moorthi and M.J. Suarez}, - Date-Added = {2019-06-06 17:51:50 +0000}, - Date-Modified = {2019-06-06 17:56:00 +0000}, - Journal = {Monthly Weather Review}, - Pages = {978-1002}, - Title = {Relaxed {A}rakawa-{S}chubert. A parameterization of moist convection for general circulation models}, - Volume = {120}, - Year = {1992}} + author = {S. Moorthi and M.J. Suarez}, + date-added = {2019-06-06 17:51:50 +0000}, + date-modified = {2019-06-06 17:56:00 +0000}, + journal = {Monthly Weather Review}, + pages = {978-1002}, + title = {Relaxed {A}rakawa-{S}chubert. A parameterization of moist convection for general circulation models}, + volume = {120}, + year = {1992}} @article{Gettelman_et_al_2019, - Author = {A. Gettelman and H. Morrison and K. Thayer-Calder and C. M. Zarzycki}, - Date-Added = {2019-06-05 16:32:22 +0000}, - Date-Modified = {2019-06-05 16:34:07 +0000}, - Journal = {Journal of Advances in Modeling Earth Systems}, - Title = {The impact of rimed ice hydrometeors on global and regional climate}, - Year = {2019}} + author = {A. Gettelman and H. Morrison and K. Thayer-Calder and C. M. Zarzycki}, + date-added = {2019-06-05 16:32:22 +0000}, + date-modified = {2019-06-05 16:34:07 +0000}, + journal = {Journal of Advances in Modeling Earth Systems}, + title = {The impact of rimed ice hydrometeors on global and regional climate}, + year = {2019}} @article{nakanishi_2000, - Author = {M. Nakanishi}, - Date-Added = {2019-05-31 14:46:02 -0600}, - Date-Modified = {2019-05-31 14:47:32 -0600}, - Journal = {Boundary-Layer Meteorology}, - Pages = {461-493}, - Title = {Large-eddy simulation of radiation fog}, - Volume = {94}, - Year = {2000}} + author = {M. Nakanishi}, + date-added = {2019-05-31 14:46:02 -0600}, + date-modified = {2019-05-31 14:47:32 -0600}, + journal = {Boundary-Layer Meteorology}, + pages = {461-493}, + title = {Large-eddy simulation of radiation fog}, + volume = {94}, + year = {2000}} @article{Gehne_2019, - Author = {Gehne, M. and Hamill, T. M. and Bates, G. T. and Pegion, P. and Kolczynski, W.}, - Date-Added = {2019-05-24 12:46:43 -0600}, - Date-Modified = {2019-05-24 12:46:43 -0600}, - Doi = {10.1175/mwr-d-18-0057.1}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {Apr}, - Number = {4}, - Pages = {1319--1340}, - Publisher = {American Meteorological Society}, - Title = {Land Surface Parameter and State Perturbations in the Global Ensemble Forecast System}, - Url = {http://dx.doi.org/10.1175/MWR-D-18-0057.1}, - Volume = {147}, - Year = {2019}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/MWR-D-18-0057.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/mwr-d-18-0057.1}} + author = {Gehne, M. and Hamill, T. M. and Bates, G. T. and Pegion, P. and Kolczynski, W.}, + date-added = {2019-05-24 12:46:43 -0600}, + date-modified = {2019-05-24 12:46:43 -0600}, + doi = {10.1175/mwr-d-18-0057.1}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {Apr}, + number = {4}, + pages = {1319--1340}, + publisher = {American Meteorological Society}, + title = {Land Surface Parameter and State Perturbations in the Global Ensemble Forecast System}, + url = {http://dx.doi.org/10.1175/MWR-D-18-0057.1}, + volume = {147}, + year = {2019}, + bdsk-url-1 = {http://dx.doi.org/10.1175/MWR-D-18-0057.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/mwr-d-18-0057.1}} @article{Gettelman_2010, - Author = {Gettelman, A. and Liu, X. and Ghan, S. J. and Morrison, H. and Park, S. and Conley, A. J. and Klein, S. A. and Boyle, J. and Mitchell, D. L. and Li, J.-L. F.}, - Date-Added = {2019-05-23 14:07:03 -0600}, - Date-Modified = {2019-05-23 14:07:03 -0600}, - Doi = {10.1029/2009jd013797}, - Issn = {0148-0227}, - Journal = {Journal of Geophysical Research}, - Month = {Sep}, - Number = {D18}, - Publisher = {American Geophysical Union (AGU)}, - Title = {Global simulations of ice nucleation and ice supersaturation with an improved cloud scheme in the Community Atmosphere Model}, - Url = {http://dx.doi.org/10.1029/2009JD013797}, - Volume = {115}, - Year = {2010}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/2009JD013797}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2009jd013797}} + author = {Gettelman, A. and Liu, X. and Ghan, S. J. and Morrison, H. and Park, S. and Conley, A. J. and Klein, S. A. and Boyle, J. and Mitchell, D. L. and Li, J.-L. F.}, + date-added = {2019-05-23 14:07:03 -0600}, + date-modified = {2019-05-23 14:07:03 -0600}, + doi = {10.1029/2009jd013797}, + issn = {0148-0227}, + journal = {Journal of Geophysical Research}, + month = {Sep}, + number = {D18}, + publisher = {American Geophysical Union (AGU)}, + title = {Global simulations of ice nucleation and ice supersaturation with an improved cloud scheme in the Community Atmosphere Model}, + url = {http://dx.doi.org/10.1029/2009JD013797}, + volume = {115}, + year = {2010}, + bdsk-url-1 = {http://dx.doi.org/10.1029/2009JD013797}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2009jd013797}} @article{HOBBS_1974, - Author = {Hobbs, P. V.}, - Date-Added = {2019-05-23 11:07:04 -0600}, - Date-Modified = {2019-05-23 11:07:04 -0600}, - Doi = {10.1038/251694b0}, - Issn = {1476-4687}, - Journal = {Nature}, - Month = {Oct}, - Number = {5477}, - Pages = {694--696}, - Publisher = {Springer Nature}, - Title = {High concentrations of ice particles in a layer cloud}, - Url = {http://dx.doi.org/10.1038/251694b0}, - Volume = {251}, - Year = {1974}, - Bdsk-Url-1 = {http://dx.doi.org/10.1038/251694b0}} + author = {Hobbs, P. V.}, + date-added = {2019-05-23 11:07:04 -0600}, + date-modified = {2019-05-23 11:07:04 -0600}, + doi = {10.1038/251694b0}, + issn = {1476-4687}, + journal = {Nature}, + month = {Oct}, + number = {5477}, + pages = {694--696}, + publisher = {Springer Nature}, + title = {High concentrations of ice particles in a layer cloud}, + url = {http://dx.doi.org/10.1038/251694b0}, + volume = {251}, + year = {1974}, + bdsk-url-1 = {http://dx.doi.org/10.1038/251694b0}} @article{Pichugina_2008, - Author = {Pichugina, Y. L. and Tucker, S. C. and Banta, R. M. and et al.}, - Date-Added = {2019-05-22 11:25:17 -0600}, - Date-Modified = {2019-06-05 15:59:49 +0000}, - Journal = {Journal of Atmospheric and Oceanic Technology}, - Number = {8}, - Pages = {1307--1327}, - Title = {Horizontal-Velocity and Variance Measurements in the Stable Boundary Layer Using Doppler Lidar: Sensitivity to Averaging Procedures}, - Volume = {25}, - Year = {2008}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/2008JTECHA988.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2008jtecha988.1}} + author = {Pichugina, Y. L. and Tucker, S. C. and Banta, R. M. and et al.}, + date-added = {2019-05-22 11:25:17 -0600}, + date-modified = {2019-06-05 15:59:49 +0000}, + journal = {Journal of Atmospheric and Oceanic Technology}, + number = {8}, + pages = {1307--1327}, + title = {Horizontal-Velocity and Variance Measurements in the Stable Boundary Layer Using Doppler Lidar: Sensitivity to Averaging Procedures}, + volume = {25}, + year = {2008}, + bdsk-url-1 = {http://dx.doi.org/10.1175/2008JTECHA988.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2008jtecha988.1}} @article{Nielsen_Gammon_2008, - Author = {Nielsen-Gammon, J. W. and Powell, C. L. and Mahoney, M. J. and et al.}, - Date-Added = {2019-05-22 11:19:45 -0600}, - Date-Modified = {2019-06-05 15:31:19 +0000}, - Journal = {Journal of Applied Meteorology and Climatology}, - Number = {1}, - Pages = {27--43}, - Title = {Multisensor Estimation of Mixing Heights over a Coastal City}, - Volume = {47}, - Year = {2008}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/2007JAMC1503.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2007jamc1503.1}} + author = {Nielsen-Gammon, J. W. and Powell, C. L. and Mahoney, M. J. and et al.}, + date-added = {2019-05-22 11:19:45 -0600}, + date-modified = {2019-06-05 15:31:19 +0000}, + journal = {Journal of Applied Meteorology and Climatology}, + number = {1}, + pages = {27--43}, + title = {Multisensor Estimation of Mixing Heights over a Coastal City}, + volume = {47}, + year = {2008}, + bdsk-url-1 = {http://dx.doi.org/10.1175/2007JAMC1503.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2007jamc1503.1}} @article{Benjamin_2016b, - Author = {Benjamin, S. G. and Brown, J. M. and Smirnova, T. G.}, - Date-Added = {2019-05-20 16:32:47 -0600}, - Date-Modified = {2019-05-20 16:33:32 -0600}, - Doi = {10.1175/waf-d-15-0136.1}, - Issn = {1520-0434}, - Journal = {Weather and Forecasting}, - Month = {Apr}, - Number = {2}, - Pages = {609--619}, - Publisher = {American Meteorological Society}, - Title = {Explicit Precipitation-Type Diagnosis from a Model Using a Mixed-Phase Bulk Cloud--Precipitation Microphysics Parameterization}, - Url = {http://dx.doi.org/10.1175/WAF-D-15-0136.1}, - Volume = {31}, - Year = {2016}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/WAF-D-15-0136.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/waf-d-15-0136.1}} + author = {Benjamin, S. G. and Brown, J. M. and Smirnova, T. G.}, + date-added = {2019-05-20 16:32:47 -0600}, + date-modified = {2019-05-20 16:33:32 -0600}, + doi = {10.1175/waf-d-15-0136.1}, + issn = {1520-0434}, + journal = {Weather and Forecasting}, + month = {Apr}, + number = {2}, + pages = {609--619}, + publisher = {American Meteorological Society}, + title = {Explicit Precipitation-Type Diagnosis from a Model Using a Mixed-Phase Bulk Cloud--Precipitation Microphysics Parameterization}, + url = {http://dx.doi.org/10.1175/WAF-D-15-0136.1}, + volume = {31}, + year = {2016}, + bdsk-url-1 = {http://dx.doi.org/10.1175/WAF-D-15-0136.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/waf-d-15-0136.1}} @article{Grell_2002, - Author = {Grell, G. A. and D{\'e}v{\'e}nyi, D.}, - Date-Added = {2019-05-20 11:19:25 -0600}, - Date-Modified = {2019-05-20 11:19:25 -0600}, - Doi = {10.1029/2002gl015311}, - Issn = {0094-8276}, - Journal = {Geophysical Research Letters}, - Month = {Jul}, - Number = {14}, - Pages = {38--1--38--4}, - Publisher = {American Geophysical Union (AGU)}, - Title = {A generalized approach to parameterizing convection combining ensemble and data assimilation techniques}, - Url = {http://dx.doi.org/10.1029/2002GL015311}, - Volume = {29}, - Year = {2002}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/2002GL015311}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2002gl015311}} + author = {Grell, G. A. and D{\'e}v{\'e}nyi, D.}, + date-added = {2019-05-20 11:19:25 -0600}, + date-modified = {2019-05-20 11:19:25 -0600}, + doi = {10.1029/2002gl015311}, + issn = {0094-8276}, + journal = {Geophysical Research Letters}, + month = {Jul}, + number = {14}, + pages = {38--1--38--4}, + publisher = {American Geophysical Union (AGU)}, + title = {A generalized approach to parameterizing convection combining ensemble and data assimilation techniques}, + url = {http://dx.doi.org/10.1029/2002GL015311}, + volume = {29}, + year = {2002}, + bdsk-url-1 = {http://dx.doi.org/10.1029/2002GL015311}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2002gl015311}} @article{Arakawa_2011, - Author = {Arakawa, A. and Jung, J.-H. and Wu, C.-M.}, - Date-Added = {2019-05-20 11:09:31 -0600}, - Date-Modified = {2019-05-20 11:09:31 -0600}, - Doi = {10.5194/acp-11-3731-2011}, - Issn = {1680-7324}, - Journal = {Atmospheric Chemistry and Physics}, - Month = {Apr}, - Number = {8}, - Pages = {3731--3742}, - Publisher = {Copernicus GmbH}, - Title = {Toward unification of the multiscale modeling of the atmosphere}, - Url = {http://dx.doi.org/10.5194/acp-11-3731-2011}, - Volume = {11}, - Year = {2011}, - Bdsk-Url-1 = {http://dx.doi.org/10.5194/acp-11-3731-2011}} + author = {Arakawa, A. and Jung, J.-H. and Wu, C.-M.}, + date-added = {2019-05-20 11:09:31 -0600}, + date-modified = {2019-05-20 11:09:31 -0600}, + doi = {10.5194/acp-11-3731-2011}, + issn = {1680-7324}, + journal = {Atmospheric Chemistry and Physics}, + month = {Apr}, + number = {8}, + pages = {3731--3742}, + publisher = {Copernicus GmbH}, + title = {Toward unification of the multiscale modeling of the atmosphere}, + url = {http://dx.doi.org/10.5194/acp-11-3731-2011}, + volume = {11}, + year = {2011}, + bdsk-url-1 = {http://dx.doi.org/10.5194/acp-11-3731-2011}} @article{Jiang_2010, - Author = {Jiang, H-L. and Feingold, G. and Sorooshian, A.}, - Date-Added = {2019-05-20 11:01:38 -0600}, - Date-Modified = {2019-05-20 11:01:38 -0600}, - Doi = {10.1175/2010jas3484.1}, - Issn = {1520-0469}, - Journal = {Journal of the Atmospheric Sciences}, - Month = {Nov}, - Number = {11}, - Pages = {3525--3540}, - Publisher = {American Meteorological Society}, - Title = {Effect of Aerosol on the Susceptibility and Efficiency of Precipitation in Warm Trade Cumulus Clouds}, - Url = {http://dx.doi.org/10.1175/2010JAS3484.1}, - Volume = {67}, - Year = {2010}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/2010JAS3484.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2010jas3484.1}} + author = {Jiang, H-L. and Feingold, G. and Sorooshian, A.}, + date-added = {2019-05-20 11:01:38 -0600}, + date-modified = {2019-05-20 11:01:38 -0600}, + doi = {10.1175/2010jas3484.1}, + issn = {1520-0469}, + journal = {Journal of the Atmospheric Sciences}, + month = {Nov}, + number = {11}, + pages = {3525--3540}, + publisher = {American Meteorological Society}, + title = {Effect of Aerosol on the Susceptibility and Efficiency of Precipitation in Warm Trade Cumulus Clouds}, + url = {http://dx.doi.org/10.1175/2010JAS3484.1}, + volume = {67}, + year = {2010}, + bdsk-url-1 = {http://dx.doi.org/10.1175/2010JAS3484.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2010jas3484.1}} @conference{berry_1968, - Address = {Albany, N.Y}, - Author = {E. X. Berry}, - Booktitle = {1st National Conference on Weather Modification}, - Date-Added = {2019-05-20 10:50:44 -0600}, - Date-Modified = {2019-05-20 10:54:39 -0600}, - Editor = {Am. Meteorol. Soc.}, - Title = {Modification of the warm rain process}, - Year = {1968}} + address = {Albany, N.Y}, + author = {E. X. Berry}, + booktitle = {1st National Conference on Weather Modification}, + date-added = {2019-05-20 10:50:44 -0600}, + date-modified = {2022-05-02 14:53:19 -0600}, + editor = {Am. Meteorol. Soc.}, + pages = {81-85}, + title = {Modification of the warm rain process}, + year = {1968}} @article{Wilks_2005, - Author = {Wilks, D. S.}, - Date-Added = {2019-05-08 14:10:09 -0600}, - Date-Modified = {2019-05-08 14:10:09 -0600}, - Doi = {10.1256/qj.04.03}, - Issn = {1477-870X}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Month = {Jan}, - Number = {606}, - Pages = {389--407}, - Publisher = {Wiley}, - Title = {Effects of stochastic parametrizations in the Lorenz '96 system}, - Url = {http://dx.doi.org/10.1256/qj.04.03}, - Volume = {131}, - Year = {2005}, - Bdsk-Url-1 = {http://dx.doi.org/10.1256/qj.04.03}} + author = {Wilks, D. S.}, + date-added = {2019-05-08 14:10:09 -0600}, + date-modified = {2019-05-08 14:10:09 -0600}, + doi = {10.1256/qj.04.03}, + issn = {1477-870X}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + month = {Jan}, + number = {606}, + pages = {389--407}, + publisher = {Wiley}, + title = {Effects of stochastic parametrizations in the Lorenz '96 system}, + url = {http://dx.doi.org/10.1256/qj.04.03}, + volume = {131}, + year = {2005}, + bdsk-url-1 = {http://dx.doi.org/10.1256/qj.04.03}} @article{Han_2019, - Author = {J. Han and C. S. Bretherton}, - Date-Added = {2019-05-06 20:43:06 -0600}, - Date-Modified = {2019-05-06 20:44:39 -0600}, - Journal = {Weather and Forecasting}, - Title = {{TKE}-based Moist Eddy-Diffusivity Mass-Flux ({EDMF}) Parameterization for Vertical Turbulent Mixing}, - Volume = {accepted}, - Year = {2019}} + author = {J. Han and C. S. Bretherton}, + date-added = {2019-05-06 20:43:06 -0600}, + date-modified = {2019-05-06 20:44:39 -0600}, + journal = {Weather and Forecasting}, + title = {{TKE}-based Moist Eddy-Diffusivity Mass-Flux ({EDMF}) Parameterization for Vertical Turbulent Mixing}, + volume = {accepted}, + year = {2019}} @article{Thompson_2014, - Author = {Thompson, G. and Eidhammer, T.}, - Date-Added = {2019-05-06 19:55:25 -0600}, - Date-Modified = {2019-05-06 19:55:25 -0600}, - Doi = {10.1175/jas-d-13-0305.1}, - Issn = {1520-0469}, - Journal = {Journal of the Atmospheric Sciences}, - Month = {Oct}, - Number = {10}, - Pages = {3636--3658}, - Publisher = {American Meteorological Society}, - Title = {A Study of Aerosol Impacts on Clouds and Precipitation Development in a Large Winter Cyclone}, - Url = {http://dx.doi.org/10.1175/JAS-D-13-0305.1}, - Volume = {71}, - Year = {2014}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/JAS-D-13-0305.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/jas-d-13-0305.1}} + author = {Thompson, G. and Eidhammer, T.}, + date-added = {2019-05-06 19:55:25 -0600}, + date-modified = {2019-05-06 19:55:25 -0600}, + doi = {10.1175/jas-d-13-0305.1}, + issn = {1520-0469}, + journal = {Journal of the Atmospheric Sciences}, + month = {Oct}, + number = {10}, + pages = {3636--3658}, + publisher = {American Meteorological Society}, + title = {A Study of Aerosol Impacts on Clouds and Precipitation Development in a Large Winter Cyclone}, + url = {http://dx.doi.org/10.1175/JAS-D-13-0305.1}, + volume = {71}, + year = {2014}, + bdsk-url-1 = {http://dx.doi.org/10.1175/JAS-D-13-0305.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/jas-d-13-0305.1}} @article{Thompson_2008, - Author = {Thompson, G. and Field, P. R. and Rasmussen, R. M. and Hall, W. D.}, - Date-Added = {2019-05-06 19:49:48 -0600}, - Date-Modified = {2019-05-06 19:49:48 -0600}, - Doi = {10.1175/2008mwr2387.1}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {Dec}, - Number = {12}, - Pages = {5095--5115}, - Publisher = {American Meteorological Society}, - Title = {Explicit Forecasts of Winter Precipitation Using an Improved Bulk Microphysics Scheme. {P}art {II}: Implementation of a New Snow Parameterization}, - Url = {http://dx.doi.org/10.1175/2008MWR2387.1}, - Volume = {136}, - Year = {2008}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/2008MWR2387.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2008mwr2387.1}} + author = {Thompson, G. and Field, P. R. and Rasmussen, R. M. and Hall, W. D.}, + date-added = {2019-05-06 19:49:48 -0600}, + date-modified = {2019-05-06 19:49:48 -0600}, + doi = {10.1175/2008mwr2387.1}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {Dec}, + number = {12}, + pages = {5095--5115}, + publisher = {American Meteorological Society}, + title = {Explicit Forecasts of Winter Precipitation Using an Improved Bulk Microphysics Scheme. {P}art {II}: Implementation of a New Snow Parameterization}, + url = {http://dx.doi.org/10.1175/2008MWR2387.1}, + volume = {136}, + year = {2008}, + bdsk-url-1 = {http://dx.doi.org/10.1175/2008MWR2387.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2008mwr2387.1}} @article{Krinner_2018, - Author = {Krinner, G. and Derksen, C. and Essery, R. and et al.}, - Date-Added = {2019-05-06 14:22:35 -0600}, - Date-Modified = {2019-05-06 14:22:35 -0600}, - Doi = {10.5194/gmd-11-5027-2018}, - Issn = {1991-9603}, - Journal = {Geoscientific Model Development}, - Month = {Dec}, - Number = {12}, - Pages = {5027--5049}, - Publisher = {Copernicus GmbH}, - Title = {{ESM-SnowMIP}: assessing snow models and quantifying snow-related climate feedbacks}, - Url = {http://dx.doi.org/10.5194/gmd-11-5027-2018}, - Volume = {11}, - Year = {2018}, - Bdsk-Url-1 = {http://dx.doi.org/10.5194/gmd-11-5027-2018}} + author = {Krinner, G. and Derksen, C. and Essery, R. and et al.}, + date-added = {2019-05-06 14:22:35 -0600}, + date-modified = {2019-05-06 14:22:35 -0600}, + doi = {10.5194/gmd-11-5027-2018}, + issn = {1991-9603}, + journal = {Geoscientific Model Development}, + month = {Dec}, + number = {12}, + pages = {5027--5049}, + publisher = {Copernicus GmbH}, + title = {{ESM-SnowMIP}: assessing snow models and quantifying snow-related climate feedbacks}, + url = {http://dx.doi.org/10.5194/gmd-11-5027-2018}, + volume = {11}, + year = {2018}, + bdsk-url-1 = {http://dx.doi.org/10.5194/gmd-11-5027-2018}} @article{Rutter_2009, - Author = {Rutter, N. and Essery, R. and Pomeroy, J. and et al.}, - Date-Added = {2019-05-06 14:22:28 -0600}, - Date-Modified = {2019-05-06 14:22:28 -0600}, - Doi = {10.1029/2008jd011063}, - Issn = {0148-0227}, - Journal = {Journal of Geophysical Research}, - Month = {Mar}, - Number = {D6}, - Publisher = {American Geophysical Union (AGU)}, - Title = {Evaluation of forest snow processes models ({SnowMIP2})}, - Url = {http://dx.doi.org/10.1029/2008JD011063}, - Volume = {114}, - Year = {2009}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/2008JD011063}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2008jd011063}} + author = {Rutter, N. and Essery, R. and Pomeroy, J. and et al.}, + date-added = {2019-05-06 14:22:28 -0600}, + date-modified = {2019-05-06 14:22:28 -0600}, + doi = {10.1029/2008jd011063}, + issn = {0148-0227}, + journal = {Journal of Geophysical Research}, + month = {Mar}, + number = {D6}, + publisher = {American Geophysical Union (AGU)}, + title = {Evaluation of forest snow processes models ({SnowMIP2})}, + url = {http://dx.doi.org/10.1029/2008JD011063}, + volume = {114}, + year = {2009}, + bdsk-url-1 = {http://dx.doi.org/10.1029/2008JD011063}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2008jd011063}} @article{Essery_2009, - Author = {Essery, R. and Rutter, N. and Pomeroy, J. and et al.}, - Date-Added = {2019-05-06 14:20:27 -0600}, - Date-Modified = {2019-06-05 16:01:14 +0000}, - Journal = {Bulletin of the American Meteorological Society}, - Number = {8}, - Pages = {1120-1136}, - Title = {{SNOWMIP2}: An Evaluation of Forest Snow Process Simulations}, - Volume = {90}, - Year = {2009}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/2009BAMS2629.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2009bams2629.1}} + author = {Essery, R. and Rutter, N. and Pomeroy, J. and et al.}, + date-added = {2019-05-06 14:20:27 -0600}, + date-modified = {2019-06-05 16:01:14 +0000}, + journal = {Bulletin of the American Meteorological Society}, + number = {8}, + pages = {1120-1136}, + title = {{SNOWMIP2}: An Evaluation of Forest Snow Process Simulations}, + volume = {90}, + year = {2009}, + bdsk-url-1 = {http://dx.doi.org/10.1175/2009BAMS2629.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2009bams2629.1}} @proceedings{Etchevers_2002, - Address = {Victoria, B.C.}, - Date-Added = {2019-05-06 14:16:14 -0600}, - Date-Modified = {2019-05-06 14:19:37 -0600}, - Editor = {International Snow Science Workshop}, - Month = {29 September-4 October}, - Organization = {B.C. Ministry of Transportation. Snow Avalance Programs}, - Publisher = {In Stevens, J.R.}, - Title = {Snow MIP, and intercomparson of snow-cover models: first results}, - Year = {2002}} + address = {Victoria, B.C.}, + date-added = {2019-05-06 14:16:14 -0600}, + date-modified = {2019-05-06 14:19:37 -0600}, + editor = {International Snow Science Workshop}, + month = {29 September-4 October}, + organization = {B.C. Ministry of Transportation. Snow Avalance Programs}, + publisher = {In Stevens, J.R.}, + title = {Snow MIP, and intercomparson of snow-cover models: first results}, + year = {2002}} @article{Etchevers_2004, - Author = {Etchevers, P. and Martin, E. and Brown, R. and et al.}, - Date-Added = {2019-05-06 14:16:12 -0600}, - Date-Modified = {2019-05-06 14:16:12 -0600}, - Doi = {10.3189/172756404781814825}, - Issn = {1727-5644}, - Journal = {Annals of Glaciology}, - Pages = {150--158}, - Publisher = {Cambridge University Press (CUP)}, - Title = {Validation of the energy budget of an alpine snowpack simulated by several snow models (Snow {MIP} project)}, - Url = {http://dx.doi.org/10.3189/172756404781814825}, - Volume = {38}, - Year = {2004}, - Bdsk-Url-1 = {http://dx.doi.org/10.3189/172756404781814825}} + author = {Etchevers, P. and Martin, E. and Brown, R. and et al.}, + date-added = {2019-05-06 14:16:12 -0600}, + date-modified = {2019-05-06 14:16:12 -0600}, + doi = {10.3189/172756404781814825}, + issn = {1727-5644}, + journal = {Annals of Glaciology}, + pages = {150--158}, + publisher = {Cambridge University Press (CUP)}, + title = {Validation of the energy budget of an alpine snowpack simulated by several snow models (Snow {MIP} project)}, + url = {http://dx.doi.org/10.3189/172756404781814825}, + volume = {38}, + year = {2004}, + bdsk-url-1 = {http://dx.doi.org/10.3189/172756404781814825}} @article{Luo_2003, - Author = {Luo, L-F. and Robock, A. and Vinnikov, K. Y. and et al.}, - Date-Added = {2019-05-06 14:12:54 -0600}, - Date-Modified = {2019-05-06 14:12:54 -0600}, - Doi = {10.1175/1525-7541(2003)4<334:eofsos>2.0.co;2}, - Issn = {1525-7541}, - Journal = {Journal of Hydrometeorology}, - Month = {Apr}, - Number = {2}, - Pages = {334--351}, - Publisher = {American Meteorological Society}, - Title = {Effects of Frozen Soil on Soil Temperature, Spring Infiltration, and Runoff: Results from the {PILPS} 2(d) Experiment at {V}aldai, {R}ussia}, - Url = {http://dx.doi.org/10.1175/1525-7541(2003)4<334:EOFSOS>2.0.CO;2}, - Volume = {4}, - Year = {2003}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1525-7541(2003)4%3C334:EOFSOS%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1525-7541(2003)4%3C334:eofsos%3E2.0.co;2}} + author = {Luo, L-F. and Robock, A. and Vinnikov, K. Y. and et al.}, + date-added = {2019-05-06 14:12:54 -0600}, + date-modified = {2019-05-06 14:12:54 -0600}, + doi = {10.1175/1525-7541(2003)4<334:eofsos>2.0.co;2}, + issn = {1525-7541}, + journal = {Journal of Hydrometeorology}, + month = {Apr}, + number = {2}, + pages = {334--351}, + publisher = {American Meteorological Society}, + title = {Effects of Frozen Soil on Soil Temperature, Spring Infiltration, and Runoff: Results from the {PILPS} 2(d) Experiment at {V}aldai, {R}ussia}, + url = {http://dx.doi.org/10.1175/1525-7541(2003)4<334:EOFSOS>2.0.CO;2}, + volume = {4}, + year = {2003}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1525-7541(2003)4%3C334:EOFSOS%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1525-7541(2003)4%3C334:eofsos%3E2.0.co;2}} @article{Slater_2001, - Author = {Slater, A. G. and Schlosser, C. A. and Desborough, C. E. and et al.}, - Date-Added = {2019-05-06 14:11:52 -0600}, - Date-Modified = {2019-05-06 14:11:52 -0600}, - Doi = {10.1175/1525-7541(2001)002<0007:trosil>2.0.co;2}, - Issn = {1525-7541}, - Journal = {Journal of Hydrometeorology}, - Month = {Feb}, - Number = {1}, - Pages = {7--25}, - Publisher = {American Meteorological Society}, - Title = {The Representation of Snow in Land Surface Schemes: Results from {PILPS} 2(d)}, - Url = {http://dx.doi.org/10.1175/1525-7541(2001)002<0007:TROSIL>2.0.CO;2}, - Volume = {2}, - Year = {2001}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1525-7541(2001)002%3C0007:TROSIL%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1525-7541(2001)002%3C0007:trosil%3E2.0.co;2}} + author = {Slater, A. G. and Schlosser, C. A. and Desborough, C. E. and et al.}, + date-added = {2019-05-06 14:11:52 -0600}, + date-modified = {2019-05-06 14:11:52 -0600}, + doi = {10.1175/1525-7541(2001)002<0007:trosil>2.0.co;2}, + issn = {1525-7541}, + journal = {Journal of Hydrometeorology}, + month = {Feb}, + number = {1}, + pages = {7--25}, + publisher = {American Meteorological Society}, + title = {The Representation of Snow in Land Surface Schemes: Results from {PILPS} 2(d)}, + url = {http://dx.doi.org/10.1175/1525-7541(2001)002<0007:TROSIL>2.0.CO;2}, + volume = {2}, + year = {2001}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1525-7541(2001)002%3C0007:TROSIL%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1525-7541(2001)002%3C0007:trosil%3E2.0.co;2}} @article{Schlosser_1997, - Author = {Schlosser, C. A. and Robock, A. and Vinnikov, K. Y. and Speranskaya, N. A. and Xue, Y.-K.}, - Date-Added = {2019-05-06 14:10:42 -0600}, - Date-Modified = {2019-05-06 14:10:42 -0600}, - Doi = {10.1175/1520-0493(1997)125<3279:ylshms>2.0.co;2}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {Dec}, - Number = {12}, - Pages = {3279--3296}, - Publisher = {American Meteorological Society}, - Title = {18-Year Land-Surface Hydrology Model Simulations for a Midlatitude Grassland Catchment in {V}aldai, {R}ussia}, - Url = {http://dx.doi.org/10.1175/1520-0493(1997)125<3279:YLSHMS>2.0.CO;2}, - Volume = {125}, - Year = {1997}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0493(1997)125%3C3279:YLSHMS%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0493(1997)125%3C3279:ylshms%3E2.0.co;2}} + author = {Schlosser, C. A. and Robock, A. and Vinnikov, K. Y. and Speranskaya, N. A. and Xue, Y.-K.}, + date-added = {2019-05-06 14:10:42 -0600}, + date-modified = {2019-05-06 14:10:42 -0600}, + doi = {10.1175/1520-0493(1997)125<3279:ylshms>2.0.co;2}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {Dec}, + number = {12}, + pages = {3279--3296}, + publisher = {American Meteorological Society}, + title = {18-Year Land-Surface Hydrology Model Simulations for a Midlatitude Grassland Catchment in {V}aldai, {R}ussia}, + url = {http://dx.doi.org/10.1175/1520-0493(1997)125<3279:YLSHMS>2.0.CO;2}, + volume = {125}, + year = {1997}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0493(1997)125%3C3279:YLSHMS%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0493(1997)125%3C3279:ylshms%3E2.0.co;2}} @article{Berbery_1999, - Author = {Berbery, E. H. and Mitchell, K. E. and Benjamin, S. and Smirnova, T. and Ritchie, H. and Hogue, R. and Radeva, E.}, - Date-Added = {2019-05-06 14:08:00 -0600}, - Date-Modified = {2019-05-06 14:08:00 -0600}, - Doi = {10.1029/1999jd900128}, - Issn = {0148-0227}, - Journal = {Journal of Geophysical Research: Atmospheres}, - Month = {Aug}, - Number = {D16}, - Pages = {19329--19348}, - Publisher = {American Geophysical Union (AGU)}, - Title = {Assessment of land-surface energy budgets from regional and global models}, - Url = {http://dx.doi.org/10.1029/1999JD900128}, - Volume = {104}, - Year = {1999}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/1999JD900128}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/1999jd900128}} + author = {Berbery, E. H. and Mitchell, K. E. and Benjamin, S. and Smirnova, T. and Ritchie, H. and Hogue, R. and Radeva, E.}, + date-added = {2019-05-06 14:08:00 -0600}, + date-modified = {2019-05-06 14:08:00 -0600}, + doi = {10.1029/1999jd900128}, + issn = {0148-0227}, + journal = {Journal of Geophysical Research: Atmospheres}, + month = {Aug}, + number = {D16}, + pages = {19329--19348}, + publisher = {American Geophysical Union (AGU)}, + title = {Assessment of land-surface energy budgets from regional and global models}, + url = {http://dx.doi.org/10.1029/1999JD900128}, + volume = {104}, + year = {1999}, + bdsk-url-1 = {http://dx.doi.org/10.1029/1999JD900128}, + bdsk-url-2 = {http://dx.doi.org/10.1029/1999jd900128}} @article{Benjamin_2004b, - Author = {Benjamin, S. G. and Grell, G. A. and Brown, J. M. and Smirnova, T. G. and Bleck, R.}, - Date-Added = {2019-05-06 14:05:46 -0600}, - Date-Modified = {2019-05-06 14:06:43 -0600}, - Doi = {10.1175/1520-0493(2004)132<0473:mwpwtr>2.0.co;2}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {Feb}, - Number = {2}, - Pages = {473--494}, - Publisher = {American Meteorological Society}, - Title = {Mesoscale Weather Prediction with the {RUC} Hybrid Isentropic--Terrain-Following Coordinate Model}, - Url = {http://dx.doi.org/10.1175/1520-0493(2004)132<0473:MWPWTR>2.0.CO;2}, - Volume = {132}, - Year = {2004}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0473:MWPWTR%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0473:mwpwtr%3E2.0.co;2}} + author = {Benjamin, S. G. and Grell, G. A. and Brown, J. M. and Smirnova, T. G. and Bleck, R.}, + date-added = {2019-05-06 14:05:46 -0600}, + date-modified = {2019-05-06 14:06:43 -0600}, + doi = {10.1175/1520-0493(2004)132<0473:mwpwtr>2.0.co;2}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {Feb}, + number = {2}, + pages = {473--494}, + publisher = {American Meteorological Society}, + title = {Mesoscale Weather Prediction with the {RUC} Hybrid Isentropic--Terrain-Following Coordinate Model}, + url = {http://dx.doi.org/10.1175/1520-0493(2004)132<0473:MWPWTR>2.0.CO;2}, + volume = {132}, + year = {2004}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0473:MWPWTR%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0473:mwpwtr%3E2.0.co;2}} @article{Benjamin_2004a, - Author = {Benjamin, S. G. and D{\'e}v{\'e}nyi, D. and Weygandt, S. S. and Brundage, K. J. and Brown, J. M. and Grell, G. A. and Kim, D. and Schwartz, B. E. and Smirnova, T. G. and Smith, T. L. and et al.}, - Date-Added = {2019-05-06 14:04:23 -0600}, - Date-Modified = {2019-05-06 14:06:36 -0600}, - Doi = {10.1175/1520-0493(2004)132<0495:ahactr>2.0.co;2}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {Feb}, - Number = {2}, - Pages = {495--518}, - Publisher = {American Meteorological Society}, - Title = {An Hourly Assimilation--Forecast Cycle: The {RUC}}, - Url = {http://dx.doi.org/10.1175/1520-0493(2004)132<0495:AHACTR>2.0.CO;2}, - Volume = {132}, - Year = {2004}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0495:AHACTR%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0495:ahactr%3E2.0.co;2}} + author = {Benjamin, S. G. and D{\'e}v{\'e}nyi, D. and Weygandt, S. S. and Brundage, K. J. and Brown, J. M. and Grell, G. A. and Kim, D. and Schwartz, B. E. and Smirnova, T. G. and Smith, T. L. and et al.}, + date-added = {2019-05-06 14:04:23 -0600}, + date-modified = {2019-05-06 14:06:36 -0600}, + doi = {10.1175/1520-0493(2004)132<0495:ahactr>2.0.co;2}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {Feb}, + number = {2}, + pages = {495--518}, + publisher = {American Meteorological Society}, + title = {An Hourly Assimilation--Forecast Cycle: The {RUC}}, + url = {http://dx.doi.org/10.1175/1520-0493(2004)132<0495:AHACTR>2.0.CO;2}, + volume = {132}, + year = {2004}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0495:AHACTR%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0495:ahactr%3E2.0.co;2}} @article{Smirnova_2000, - Author = {Smirnova, T. G. and Brown, J. M. and Benjamin, S. G. and Kim, D.}, - Date-Modified = {2019-06-05 15:32:20 +0000}, - Journal = {Journal of Geophysical Research: Atmospheres}, - Number = {D3}, - Pages = {4077--4086}, - Title = {Parameterization of cold-season processes in the {MAPS} land-surface scheme}, - Volume = {105}, - Year = {2000}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/1999JD901047}} + author = {Smirnova, T. G. and Brown, J. M. and Benjamin, S. G. and Kim, D.}, + date-modified = {2019-06-05 15:32:20 +0000}, + journal = {Journal of Geophysical Research: Atmospheres}, + number = {D3}, + pages = {4077--4086}, + title = {Parameterization of cold-season processes in the {MAPS} land-surface scheme}, + volume = {105}, + year = {2000}, + bdsk-url-1 = {http://dx.doi.org/10.1029/1999JD901047}} @article{Smirnova_2016, - Author = {Smirnova, T. G. and Brown, J. M. and Benjamin, S. G. and Kenyon, J. S.}, - Date-Added = {2019-05-06 13:55:32 -0600}, - Date-Modified = {2019-05-06 13:55:32 -0600}, - Doi = {10.1175/mwr-d-15-0198.1}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {May}, - Number = {5}, - Pages = {1851--1865}, - Publisher = {American Meteorological Society}, - Title = {Modifications to the Rapid Update Cycle Land Surface Model ({RUC LSM}) Available in the {W}eather {R}esearch and {F}orecasting ({WRF}) Model}, - Url = {http://dx.doi.org/10.1175/MWR-D-15-0198.1}, - Volume = {144}, - Year = {2016}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/MWR-D-15-0198.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/mwr-d-15-0198.1}} + author = {Smirnova, T. G. and Brown, J. M. and Benjamin, S. G. and Kenyon, J. S.}, + date-added = {2019-05-06 13:55:32 -0600}, + date-modified = {2019-05-06 13:55:32 -0600}, + doi = {10.1175/mwr-d-15-0198.1}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {May}, + number = {5}, + pages = {1851--1865}, + publisher = {American Meteorological Society}, + title = {Modifications to the Rapid Update Cycle Land Surface Model ({RUC LSM}) Available in the {W}eather {R}esearch and {F}orecasting ({WRF}) Model}, + url = {http://dx.doi.org/10.1175/MWR-D-15-0198.1}, + volume = {144}, + year = {2016}, + bdsk-url-1 = {http://dx.doi.org/10.1175/MWR-D-15-0198.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/mwr-d-15-0198.1}} @article{Morrison_2008, - Author = {Morrison, H. and Gettelman, A.}, - Date-Added = {2019-05-03 12:49:59 -0600}, - Date-Modified = {2019-05-03 12:49:59 -0600}, - Doi = {10.1175/2008jcli2105.1}, - Issn = {1520-0442}, - Journal = {Journal of Climate}, - Month = {Aug}, - Number = {15}, - Pages = {3642--3659}, - Publisher = {American Meteorological Society}, - Title = {A New Two-Moment Bulk Stratiform Cloud Microphysics Scheme in the {C}ommunity {A}tmosphere {M}odel, {V}ersion 3 ({CAM3}). {P}art {I}: Description and Numerical Tests}, - Url = {http://dx.doi.org/10.1175/2008JCLI2105.1}, - Volume = {21}, - Year = {2008}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/2008JCLI2105.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2008jcli2105.1}} + author = {Morrison, H. and Gettelman, A.}, + date-added = {2019-05-03 12:49:59 -0600}, + date-modified = {2019-05-03 12:49:59 -0600}, + doi = {10.1175/2008jcli2105.1}, + issn = {1520-0442}, + journal = {Journal of Climate}, + month = {Aug}, + number = {15}, + pages = {3642--3659}, + publisher = {American Meteorological Society}, + title = {A New Two-Moment Bulk Stratiform Cloud Microphysics Scheme in the {C}ommunity {A}tmosphere {M}odel, {V}ersion 3 ({CAM3}). {P}art {I}: Description and Numerical Tests}, + url = {http://dx.doi.org/10.1175/2008JCLI2105.1}, + volume = {21}, + year = {2008}, + bdsk-url-1 = {http://dx.doi.org/10.1175/2008JCLI2105.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2008jcli2105.1}} @article{Gettelman_2015_2, - Author = {Gettelman, A. and Morrison, H. and Santos, S. and Bogenschutz, P. and Caldwell, P. M.}, - Date-Added = {2019-05-03 12:20:57 -0600}, - Date-Modified = {2019-05-03 12:23:00 -0600}, - Doi = {10.1175/jcli-d-14-00103.1}, - Issn = {1520-0442}, - Journal = {Journal of Climate}, - Month = {Feb}, - Number = {3}, - Pages = {1288--1307}, - Publisher = {American Meteorological Society}, - Title = {Advanced Two-Moment Bulk Microphysics for Global Models. {P}art {II}: Global Model Solutions and Aerosol--Cloud Interactions}, - Url = {http://dx.doi.org/10.1175/JCLI-D-14-00103.1}, - Volume = {28}, - Year = {2015}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/JCLI-D-14-00103.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/jcli-d-14-00103.1}} + author = {Gettelman, A. and Morrison, H. and Santos, S. and Bogenschutz, P. and Caldwell, P. M.}, + date-added = {2019-05-03 12:20:57 -0600}, + date-modified = {2019-05-03 12:23:00 -0600}, + doi = {10.1175/jcli-d-14-00103.1}, + issn = {1520-0442}, + journal = {Journal of Climate}, + month = {Feb}, + number = {3}, + pages = {1288--1307}, + publisher = {American Meteorological Society}, + title = {Advanced Two-Moment Bulk Microphysics for Global Models. {P}art {II}: Global Model Solutions and Aerosol--Cloud Interactions}, + url = {http://dx.doi.org/10.1175/JCLI-D-14-00103.1}, + volume = {28}, + year = {2015}, + bdsk-url-1 = {http://dx.doi.org/10.1175/JCLI-D-14-00103.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/jcli-d-14-00103.1}} @article{Gettelman_2015_1, - Author = {Gettelman, A. and Morrison, H.}, - Date-Added = {2019-05-03 12:20:24 -0600}, - Date-Modified = {2019-05-03 12:21:23 -0600}, - Doi = {10.1175/jcli-d-14-00102.1}, - Issn = {1520-0442}, - Journal = {Journal of Climate}, - Month = {Feb}, - Number = {3}, - Pages = {1268--1287}, - Publisher = {American Meteorological Society}, - Title = {Advanced Two-Moment Bulk Microphysics for Global Models. {P}art {I}: Off-Line Tests and Comparison with Other Schemes}, - Url = {http://dx.doi.org/10.1175/JCLI-D-14-00102.1}, - Volume = {28}, - Year = {2015}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/JCLI-D-14-00102.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/jcli-d-14-00102.1}} - -@techreport{olson_et_al_2019, - Author = {J. B. Olson and J. S. Kenyon and W. A. Angevine and J. M. Brown and M. Pagowski and K. Suselj}, - Date-Added = {2019-05-01 15:29:00 -0600}, - Date-Modified = {2019-05-01 15:32:09 -0600}, - Institution = {NOAA OAR GSD-61}, - Month = {March}, - Title = {A description of the {MYNN-EDMF} scheme and the coupling to other components in {WRF-ARW}}, - Type = {Technical Memorandum}, - Year = {2019}} + author = {Gettelman, A. and Morrison, H.}, + date-added = {2019-05-03 12:20:24 -0600}, + date-modified = {2019-05-03 12:21:23 -0600}, + doi = {10.1175/jcli-d-14-00102.1}, + issn = {1520-0442}, + journal = {Journal of Climate}, + month = {Feb}, + number = {3}, + pages = {1268--1287}, + publisher = {American Meteorological Society}, + title = {Advanced Two-Moment Bulk Microphysics for Global Models. {P}art {I}: Off-Line Tests and Comparison with Other Schemes}, + url = {http://dx.doi.org/10.1175/JCLI-D-14-00102.1}, + volume = {28}, + year = {2015}, + bdsk-url-1 = {http://dx.doi.org/10.1175/JCLI-D-14-00102.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/jcli-d-14-00102.1}} @conference{olson_and_brown_2009, - Address = {Omaha, Nebraska}, - Author = {J. B. Olson and J. M. Brown}, - Booktitle = {23rd Conf. on Weather Analysis and Forecasting/19th Conf. on Numerical Weather Prediction}, - Date-Added = {2019-05-01 15:13:42 -0600}, - Date-Modified = {2019-05-01 15:18:06 -0600}, - Number = {JP1.13}, - Organization = {Amer. Meteor. Soc.}, - Title = {A comparison of two Mellow-Yamada-based PBL schemes in simulating a hybrid barrier jet}, - Year = {2009}} + address = {Omaha, Nebraska}, + author = {J. B. Olson and J. M. Brown}, + booktitle = {23rd Conf. on Weather Analysis and Forecasting/19th Conf. on Numerical Weather Prediction}, + date-added = {2019-05-01 15:13:42 -0600}, + date-modified = {2019-05-01 15:18:06 -0600}, + number = {JP1.13}, + organization = {Amer. Meteor. Soc.}, + title = {A comparison of two Mellow-Yamada-based PBL schemes in simulating a hybrid barrier jet}, + year = {2009}} @article{Nakanishi_2006, - Author = {Nakanishi, M. and Niino, H.}, - Date-Added = {2019-05-01 15:10:22 -0600}, - Date-Modified = {2019-05-01 15:10:22 -0600}, - Doi = {10.1007/s10546-005-9030-8}, - Issn = {1573-1472}, - Journal = {Boundary-Layer Meteorology}, - Month = {Mar}, - Number = {2}, - Pages = {397--407}, - Publisher = {Springer Nature}, - Title = {An Improved {M}ellor--{Y}amada Level-3 Model: Its Numerical Stability and Application to a Regional Prediction of Advection Fog}, - Url = {http://dx.doi.org/10.1007/s10546-005-9030-8}, - Volume = {119}, - Year = {2006}, - Bdsk-Url-1 = {http://dx.doi.org/10.1007/s10546-005-9030-8}} + author = {Nakanishi, M. and Niino, H.}, + date-added = {2019-05-01 15:10:22 -0600}, + date-modified = {2019-05-01 15:10:22 -0600}, + doi = {10.1007/s10546-005-9030-8}, + issn = {1573-1472}, + journal = {Boundary-Layer Meteorology}, + month = {Mar}, + number = {2}, + pages = {397--407}, + publisher = {Springer Nature}, + title = {An Improved {M}ellor--{Y}amada Level-3 Model: Its Numerical Stability and Application to a Regional Prediction of Advection Fog}, + url = {http://dx.doi.org/10.1007/s10546-005-9030-8}, + volume = {119}, + year = {2006}, + bdsk-url-1 = {http://dx.doi.org/10.1007/s10546-005-9030-8}} @article{Nakanishi_2004, - Author = {Nakanishi, M. and Niino, H.}, - Date-Added = {2019-05-01 15:06:36 -0600}, - Date-Modified = {2019-05-01 15:06:36 -0600}, - Doi = {10.1023/b:boun.0000020164.04146.98}, - Issn = {1573-1472}, - Journal = {Boundary-Layer Meteorology}, - Month = {Jul}, - Number = {1}, - Pages = {1--31}, - Publisher = {Springer Nature}, - Title = {An Improved {M}ellor--{Y}amada Level-3 Model with Condensation Physics: Its Design and Verification}, - Url = {http://dx.doi.org/10.1023/B:BOUN.0000020164.04146.98}, - Volume = {112}, - Year = {2004}, - Bdsk-Url-1 = {http://dx.doi.org/10.1023/B:BOUN.0000020164.04146.98}, - Bdsk-Url-2 = {http://dx.doi.org/10.1023/b:boun.0000020164.04146.98}} + author = {Nakanishi, M. and Niino, H.}, + date-added = {2019-05-01 15:06:36 -0600}, + date-modified = {2019-05-01 15:06:36 -0600}, + doi = {10.1023/b:boun.0000020164.04146.98}, + issn = {1573-1472}, + journal = {Boundary-Layer Meteorology}, + month = {Jul}, + number = {1}, + pages = {1--31}, + publisher = {Springer Nature}, + title = {An Improved {M}ellor--{Y}amada Level-3 Model with Condensation Physics: Its Design and Verification}, + url = {http://dx.doi.org/10.1023/B:BOUN.0000020164.04146.98}, + volume = {112}, + year = {2004}, + bdsk-url-1 = {http://dx.doi.org/10.1023/B:BOUN.0000020164.04146.98}, + bdsk-url-2 = {http://dx.doi.org/10.1023/b:boun.0000020164.04146.98}} @article{Mellor_1982, - Author = {Mellor, G. L. and Yamada, T.}, - Date-Added = {2019-05-01 15:00:12 -0600}, - Date-Modified = {2019-05-01 15:00:12 -0600}, - Doi = {10.1029/rg020i004p00851}, - Issn = {8755-1209}, - Journal = {Reviews of Geophysics}, - Number = {4}, - Pages = {851}, - Publisher = {American Geophysical Union (AGU)}, - Title = {Development of a turbulence closure model for geophysical fluid problems}, - Url = {http://dx.doi.org/10.1029/RG020i004p00851}, - Volume = {20}, - Year = {1982}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/RG020i004p00851}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/rg020i004p00851}} + author = {Mellor, G. L. and Yamada, T.}, + date-added = {2019-05-01 15:00:12 -0600}, + date-modified = {2019-05-01 15:00:12 -0600}, + doi = {10.1029/rg020i004p00851}, + issn = {8755-1209}, + journal = {Reviews of Geophysics}, + number = {4}, + pages = {851}, + publisher = {American Geophysical Union (AGU)}, + title = {Development of a turbulence closure model for geophysical fluid problems}, + url = {http://dx.doi.org/10.1029/RG020i004p00851}, + volume = {20}, + year = {1982}, + bdsk-url-1 = {http://dx.doi.org/10.1029/RG020i004p00851}, + bdsk-url-2 = {http://dx.doi.org/10.1029/rg020i004p00851}} @article{Mellor_1974, - Author = {Mellor, G. L. and Yamada, T.}, - Date-Added = {2019-05-01 14:57:26 -0600}, - Date-Modified = {2019-05-01 14:57:26 -0600}, - Doi = {10.1175/1520-0469(1974)031<1791:ahotcm>2.0.co;2}, - Issn = {1520-0469}, - Journal = {Journal of the Atmospheric Sciences}, - Month = {Oct}, - Number = {7}, - Pages = {1791--1806}, - Publisher = {American Meteorological Society}, - Title = {A Hierarchy of Turbulence Closure Models for Planetary Boundary Layers}, - Url = {http://dx.doi.org/10.1175/1520-0469(1974)031<1791:AHOTCM>2.0.CO;2}, - Volume = {31}, - Year = {1974}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0469(1974)031%3C1791:AHOTCM%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0469(1974)031%3C1791:ahotcm%3E2.0.co;2}} + author = {Mellor, G. L. and Yamada, T.}, + date-added = {2019-05-01 14:57:26 -0600}, + date-modified = {2019-05-01 14:57:26 -0600}, + doi = {10.1175/1520-0469(1974)031<1791:ahotcm>2.0.co;2}, + issn = {1520-0469}, + journal = {Journal of the Atmospheric Sciences}, + month = {Oct}, + number = {7}, + pages = {1791--1806}, + publisher = {American Meteorological Society}, + title = {A Hierarchy of Turbulence Closure Models for Planetary Boundary Layers}, + url = {http://dx.doi.org/10.1175/1520-0469(1974)031<1791:AHOTCM>2.0.CO;2}, + volume = {31}, + year = {1974}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0469(1974)031%3C1791:AHOTCM%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0469(1974)031%3C1791:ahotcm%3E2.0.co;2}} @article{Nakanish_2001, - Author = {Nakanish, M.}, - Date-Added = {2019-04-25 11:08:11 -0600}, - Date-Modified = {2019-04-25 11:08:11 -0600}, - Doi = {10.1023/a:1018915827400}, - Issn = {1573-1472}, - Journal = {Boundary-Layer Meteorology}, - Month = {Jun}, - Number = {3}, - Pages = {349--378}, - Publisher = {Springer Nature}, - Title = {Improvement Of The {M}ellor--{Y}amada Turbulence Closure Model Based On Large-Eddy Simulation Data}, - Url = {http://dx.doi.org/10.1023/A:1018915827400}, - Volume = {99}, - Year = {2001}, - Bdsk-Url-1 = {http://dx.doi.org/10.1023/A:1018915827400}, - Bdsk-Url-2 = {http://dx.doi.org/10.1023/a:1018915827400}} + author = {Nakanish, M.}, + date-added = {2019-04-25 11:08:11 -0600}, + date-modified = {2019-04-25 11:08:11 -0600}, + doi = {10.1023/a:1018915827400}, + issn = {1573-1472}, + journal = {Boundary-Layer Meteorology}, + month = {Jun}, + number = {3}, + pages = {349--378}, + publisher = {Springer Nature}, + title = {Improvement Of The {M}ellor--{Y}amada Turbulence Closure Model Based On Large-Eddy Simulation Data}, + url = {http://dx.doi.org/10.1023/A:1018915827400}, + volume = {99}, + year = {2001}, + bdsk-url-1 = {http://dx.doi.org/10.1023/A:1018915827400}, + bdsk-url-2 = {http://dx.doi.org/10.1023/a:1018915827400}} @article{kennedy_and_shapiro_1980, - Author = {Kennedy, P.J. and Shapiro, M.A.}, - Date-Added = {2019-04-25 09:41:41 -0600}, - Date-Modified = {2019-04-25 09:43:42 -0600}, - Journal = {J. Atmos. Sci.}, - Pages = {986-993}, - Title = {Further encounters with clear air turbulence in research aircraft}, - Volume = {37}, - Year = {1980}} + author = {Kennedy, P.J. and Shapiro, M.A.}, + date-added = {2019-04-25 09:41:41 -0600}, + date-modified = {2019-04-25 09:43:42 -0600}, + journal = {J. Atmos. Sci.}, + pages = {986-993}, + title = {Further encounters with clear air turbulence in research aircraft}, + volume = {37}, + year = {1980}} @article{Siebesma_2007, - Author = {Siebesma, A. P. and Soares, P. M. M. and Teixeira, J.}, - Date-Added = {2019-04-24 12:11:29 -0600}, - Date-Modified = {2019-04-24 12:11:29 -0600}, - Doi = {10.1175/jas3888.1}, - Issn = {1520-0469}, - Journal = {Journal of the Atmospheric Sciences}, - Month = {Apr}, - Number = {4}, - Pages = {1230--1248}, - Publisher = {American Meteorological Society}, - Title = {A Combined Eddy-Diffusivity Mass-Flux Approach for the Convective Boundary Layer}, - Url = {http://dx.doi.org/10.1175/JAS3888.1}, - Volume = {64}, - Year = {2007}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/JAS3888.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/jas3888.1}} + author = {Siebesma, A. P. and Soares, P. M. M. and Teixeira, J.}, + date-added = {2019-04-24 12:11:29 -0600}, + date-modified = {2019-04-24 12:11:29 -0600}, + doi = {10.1175/jas3888.1}, + issn = {1520-0469}, + journal = {Journal of the Atmospheric Sciences}, + month = {Apr}, + number = {4}, + pages = {1230--1248}, + publisher = {American Meteorological Society}, + title = {A Combined Eddy-Diffusivity Mass-Flux Approach for the Convective Boundary Layer}, + url = {http://dx.doi.org/10.1175/JAS3888.1}, + volume = {64}, + year = {2007}, + bdsk-url-1 = {http://dx.doi.org/10.1175/JAS3888.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/jas3888.1}} @article{Han_2016, - Author = {Han, J. and Witek, M. L. and Teixeira, J. and Sun, R. and Pan, H.-L. and Fletcher, J. K. and Bretherton, C. S.}, - Date-Added = {2019-04-24 12:08:21 -0600}, - Date-Modified = {2019-04-24 12:08:21 -0600}, - Doi = {10.1175/waf-d-15-0053.1}, - Issn = {1520-0434}, - Journal = {Weather and Forecasting}, - Month = {Feb}, - Number = {1}, - Pages = {341--352}, - Publisher = {American Meteorological Society}, - Title = {Implementation in the {NCEP} {GFS} of a Hybrid Eddy-Diffusivity Mass-Flux ({EDMF}) Boundary Layer Parameterization with Dissipative Heating and Modified Stable Boundary Layer Mixing}, - Url = {http://dx.doi.org/10.1175/WAF-D-15-0053.1}, - Volume = {31}, - Year = {2016}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/WAF-D-15-0053.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/waf-d-15-0053.1}} + author = {Han, J. and Witek, M. L. and Teixeira, J. and Sun, R. and Pan, H.-L. and Fletcher, J. K. and Bretherton, C. S.}, + date-added = {2019-04-24 12:08:21 -0600}, + date-modified = {2019-04-24 12:08:21 -0600}, + doi = {10.1175/waf-d-15-0053.1}, + issn = {1520-0434}, + journal = {Weather and Forecasting}, + month = {Feb}, + number = {1}, + pages = {341--352}, + publisher = {American Meteorological Society}, + title = {Implementation in the {NCEP} {GFS} of a Hybrid Eddy-Diffusivity Mass-Flux ({EDMF}) Boundary Layer Parameterization with Dissipative Heating and Modified Stable Boundary Layer Mixing}, + url = {http://dx.doi.org/10.1175/WAF-D-15-0053.1}, + volume = {31}, + year = {2016}, + bdsk-url-1 = {http://dx.doi.org/10.1175/WAF-D-15-0053.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/waf-d-15-0053.1}} @article{Vickers_2004, - Author = {Vickers, D. and Mahrt, L.}, - Date-Added = {2019-04-24 09:34:05 -0600}, - Date-Modified = {2019-04-24 09:34:05 -0600}, - Doi = {10.1175/jam2160.1}, - Issn = {1520-0450}, - Journal = {Journal of Applied Meteorology}, - Month = {Nov}, - Number = {11}, - Pages = {1736--1749}, - Publisher = {American Meteorological Society}, - Title = {Evaluating Formulations of Stable Boundary Layer Height}, - Url = {http://dx.doi.org/10.1175/JAM2160.1}, - Volume = {43}, - Year = {2004}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/JAM2160.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/jam2160.1}} + author = {Vickers, D. and Mahrt, L.}, + date-added = {2019-04-24 09:34:05 -0600}, + date-modified = {2019-04-24 09:34:05 -0600}, + doi = {10.1175/jam2160.1}, + issn = {1520-0450}, + journal = {Journal of Applied Meteorology}, + month = {Nov}, + number = {11}, + pages = {1736--1749}, + publisher = {American Meteorological Society}, + title = {Evaluating Formulations of Stable Boundary Layer Height}, + url = {http://dx.doi.org/10.1175/JAM2160.1}, + volume = {43}, + year = {2004}, + bdsk-url-1 = {http://dx.doi.org/10.1175/JAM2160.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/jam2160.1}} @article{Bechtold_1998, - Author = {Bechtold, P. and Siebesma, P.}, - Date-Added = {2019-04-22 11:24:42 -0600}, - Date-Modified = {2019-04-22 11:24:42 -0600}, - Doi = {10.1175/1520-0469(1998)055<0888:oarobl>2.0.co;2}, - Issn = {1520-0469}, - Journal = {Journal of the Atmospheric Sciences}, - Month = {Mar}, - Number = {5}, - Pages = {888--895}, - Publisher = {American Meteorological Society}, - Title = {Organization and Representation of Boundary Layer Clouds}, - Url = {http://dx.doi.org/10.1175/1520-0469(1998)055<0888:OAROBL>2.0.CO;2}, - Volume = {55}, - Year = {1998}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0469(1998)055%3C0888:OAROBL%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0469(1998)055%3C0888:oarobl%3E2.0.co;2}} + author = {Bechtold, P. and Siebesma, P.}, + date-added = {2019-04-22 11:24:42 -0600}, + date-modified = {2019-04-22 11:24:42 -0600}, + doi = {10.1175/1520-0469(1998)055<0888:oarobl>2.0.co;2}, + issn = {1520-0469}, + journal = {Journal of the Atmospheric Sciences}, + month = {Mar}, + number = {5}, + pages = {888--895}, + publisher = {American Meteorological Society}, + title = {Organization and Representation of Boundary Layer Clouds}, + url = {http://dx.doi.org/10.1175/1520-0469(1998)055<0888:OAROBL>2.0.CO;2}, + volume = {55}, + year = {1998}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0469(1998)055%3C0888:OAROBL%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0469(1998)055%3C0888:oarobl%3E2.0.co;2}} @article{Ito_2015, - Author = {Ito, J. and Niino, H. and Nakanishi, M. and Moeng, C-H.}, - Date-Added = {2019-04-22 10:27:42 -0600}, - Date-Modified = {2019-04-22 10:27:42 -0600}, - Doi = {10.1007/s10546-015-0045-5}, - Issn = {1573-1472}, - Journal = {Boundary-Layer Meteorology}, - Month = {Jun}, - Number = {1}, - Pages = {23--43}, - Publisher = {Springer Nature}, - Title = {An Extension of the Mellor--Yamada Model to the Terra Incognita Zone for Dry Convective Mixed Layers in the Free Convection Regime}, - Url = {http://dx.doi.org/10.1007/s10546-015-0045-5}, - Volume = {157}, - Year = {2015}, - Bdsk-Url-1 = {http://dx.doi.org/10.1007/s10546-015-0045-5}} + author = {Ito, J. and Niino, H. and Nakanishi, M. and Moeng, C-H.}, + date-added = {2019-04-22 10:27:42 -0600}, + date-modified = {2019-04-22 10:27:42 -0600}, + doi = {10.1007/s10546-015-0045-5}, + issn = {1573-1472}, + journal = {Boundary-Layer Meteorology}, + month = {Jun}, + number = {1}, + pages = {23--43}, + publisher = {Springer Nature}, + title = {An Extension of the Mellor--Yamada Model to the Terra Incognita Zone for Dry Convective Mixed Layers in the Free Convection Regime}, + url = {http://dx.doi.org/10.1007/s10546-015-0045-5}, + volume = {157}, + year = {2015}, + bdsk-url-1 = {http://dx.doi.org/10.1007/s10546-015-0045-5}} @article{Tripoli_1981, - Author = {Tripoli, G. J. and Cotton, W. R.}, - Date-Added = {2019-04-22 10:18:40 -0600}, - Date-Modified = {2019-04-22 10:18:40 -0600}, - Doi = {10.1175/1520-0493(1981)109<1094:tuollw>2.0.co;2}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {May}, - Number = {5}, - Pages = {1094--1102}, - Publisher = {American Meteorological Society}, - Title = {The Use of lce-Liquid Water Potential Temperature as a Thermodynamic Variable In Deep Atmospheric Models}, - Url = {http://dx.doi.org/10.1175/1520-0493(1981)109<1094:TUOLLW>2.0.CO;2}, - Volume = {109}, - Year = {1981}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0493(1981)109%3C1094:TUOLLW%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0493(1981)109%3C1094:tuollw%3E2.0.co;2}} + author = {Tripoli, G. J. and Cotton, W. R.}, + date-added = {2019-04-22 10:18:40 -0600}, + date-modified = {2019-04-22 10:18:40 -0600}, + doi = {10.1175/1520-0493(1981)109<1094:tuollw>2.0.co;2}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {May}, + number = {5}, + pages = {1094--1102}, + publisher = {American Meteorological Society}, + title = {The Use of lce-Liquid Water Potential Temperature as a Thermodynamic Variable In Deep Atmospheric Models}, + url = {http://dx.doi.org/10.1175/1520-0493(1981)109<1094:TUOLLW>2.0.CO;2}, + volume = {109}, + year = {1981}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0493(1981)109%3C1094:TUOLLW%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0493(1981)109%3C1094:tuollw%3E2.0.co;2}} @article{NAKANISHI_2009, - Author = {Nakanishi, M. and Niino, H.}, - Date-Added = {2019-04-22 10:00:34 -0600}, - Date-Modified = {2019-04-22 10:00:34 -0600}, - Doi = {10.2151/jmsj.87.895}, - Issn = {0026-1165}, - Journal = {Journal of the Meteorological Society of Japan}, - Number = {5}, - Pages = {895--912}, - Publisher = {Meteorological Society of Japan}, - Title = {Development of an Improved Turbulence Closure Model for the Atmospheric Boundary Layer}, - Url = {http://dx.doi.org/10.2151/jmsj.87.895}, - Volume = {87}, - Year = {2009}, - Bdsk-Url-1 = {http://dx.doi.org/10.2151/jmsj.87.895}} + author = {Nakanishi, M. and Niino, H.}, + date-added = {2019-04-22 10:00:34 -0600}, + date-modified = {2019-04-22 10:00:34 -0600}, + doi = {10.2151/jmsj.87.895}, + issn = {0026-1165}, + journal = {Journal of the Meteorological Society of Japan}, + number = {5}, + pages = {895--912}, + publisher = {Meteorological Society of Japan}, + title = {Development of an Improved Turbulence Closure Model for the Atmospheric Boundary Layer}, + url = {http://dx.doi.org/10.2151/jmsj.87.895}, + volume = {87}, + year = {2009}, + bdsk-url-1 = {http://dx.doi.org/10.2151/jmsj.87.895}} @article{Chaboureau_2005, - Author = {Chaboureau, J.-P.}, - Date-Added = {2019-04-21 16:19:12 -0600}, - Date-Modified = {2019-04-21 16:19:12 -0600}, - Doi = {10.1029/2004jd005645}, - Issn = {0148-0227}, - Journal = {Journal of Geophysical Research}, - Number = {D17}, - Publisher = {American Geophysical Union (AGU)}, - Title = {Statistical representation of clouds in a regional model and the impact on the diurnal cycle of convection during Tropical Convection, Cirrus and Nitrogen Oxides ({TROCCINOX})}, - Url = {http://dx.doi.org/10.1029/2004JD005645}, - Volume = {110}, - Year = {2005}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/2004JD005645}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2004jd005645}} + author = {Chaboureau, J.-P. and P. Bechtold}, + date-added = {2019-04-21 16:19:12 -0600}, + date-modified = {2022-05-06 09:01:51 -0600}, + doi = {10.1029/2004jd005645}, + issn = {0148-0227}, + journal = {Journal of Geophysical Research}, + number = {D17}, + publisher = {American Geophysical Union (AGU)}, + title = {Statistical representation of clouds in a regional model and the impact on the diurnal cycle of convection during Tropical Convection, Cirrus and Nitrogen Oxides ({TROCCINOX})}, + url = {http://dx.doi.org/10.1029/2004JD005645}, + volume = {110}, + year = {2005}, + bdsk-url-1 = {http://dx.doi.org/10.1029/2004JD005645}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2004jd005645}} @article{Chaboureau_2002, - Author = {Chaboureau, J.-P. and Bechtold, P.}, - Date-Added = {2019-04-21 16:17:45 -0600}, - Date-Modified = {2019-04-21 16:17:45 -0600}, - Doi = {10.1175/1520-0469(2002)059<2362:ascpdf>2.0.co;2}, - Issn = {1520-0469}, - Journal = {Journal of the Atmospheric Sciences}, - Month = {Aug}, - Number = {15}, - Pages = {2362--2372}, - Publisher = {American Meteorological Society}, - Title = {A Simple Cloud Parameterization Derived from Cloud Resolving Model Data: Diagnostic and Prognostic Applications}, - Url = {http://dx.doi.org/10.1175/1520-0469(2002)059<2362:ASCPDF>2.0.CO;2}, - Volume = {59}, - Year = {2002}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0469(2002)059%3C2362:ASCPDF%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0469(2002)059%3C2362:ascpdf%3E2.0.co;2}} + author = {Chaboureau, J.-P. and Bechtold, P.}, + date-added = {2019-04-21 16:17:45 -0600}, + date-modified = {2019-04-21 16:17:45 -0600}, + doi = {10.1175/1520-0469(2002)059<2362:ascpdf>2.0.co;2}, + issn = {1520-0469}, + journal = {Journal of the Atmospheric Sciences}, + month = {Aug}, + number = {15}, + pages = {2362--2372}, + publisher = {American Meteorological Society}, + title = {A Simple Cloud Parameterization Derived from Cloud Resolving Model Data: Diagnostic and Prognostic Applications}, + url = {http://dx.doi.org/10.1175/1520-0469(2002)059<2362:ASCPDF>2.0.CO;2}, + volume = {59}, + year = {2002}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0469(2002)059%3C2362:ASCPDF%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0469(2002)059%3C2362:ascpdf%3E2.0.co;2}} @article{Kuwano_Yoshida_2010, - Author = {Kuwano-Yoshida, A. and Enomoto, T. and Ohfuchi, W.}, - Date-Added = {2019-04-21 16:12:47 -0600}, - Date-Modified = {2019-04-21 16:12:47 -0600}, - Doi = {10.1002/qj.660}, - Issn = {0035-9009}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Month = {Jul}, - Number = {651}, - Pages = {1583--1597}, - Publisher = {Wiley}, - Title = {An improved {PDF} cloud scheme for climate simulations}, - Url = {http://dx.doi.org/10.1002/qj.660}, - Volume = {136}, - Year = {2010}, - Bdsk-Url-1 = {http://dx.doi.org/10.1002/qj.660}} + author = {Kuwano-Yoshida, A. and Enomoto, T. and Ohfuchi, W.}, + date-added = {2019-04-21 16:12:47 -0600}, + date-modified = {2019-04-21 16:12:47 -0600}, + doi = {10.1002/qj.660}, + issn = {0035-9009}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + month = {Jul}, + number = {651}, + pages = {1583--1597}, + publisher = {Wiley}, + title = {An improved {PDF} cloud scheme for climate simulations}, + url = {http://dx.doi.org/10.1002/qj.660}, + volume = {136}, + year = {2010}, + bdsk-url-1 = {http://dx.doi.org/10.1002/qj.660}} @article{Sommeria_1977, - Author = {Sommeria, G. and Deardorff, J. W.}, - Date-Added = {2019-04-21 16:08:43 -0600}, - Date-Modified = {2019-04-21 16:08:43 -0600}, - Doi = {10.1175/1520-0469(1977)034<0344:sscimo>2.0.co;2}, - Issn = {1520-0469}, - Journal = {Journal of the Atmospheric Sciences}, - Month = {Feb}, - Number = {2}, - Pages = {344--355}, - Publisher = {American Meteorological Society}, - Title = {Subgrid-Scale Condensation in Models of Nonprecipitating Clouds}, - Url = {http://dx.doi.org/10.1175/1520-0469(1977)034<0344:SSCIMO>2.0.CO;2}, - Volume = {34}, - Year = {1977}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0469(1977)034%3C0344:SSCIMO%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0469(1977)034%3C0344:sscimo%3E2.0.co;2}} + author = {Sommeria, G. and Deardorff, J. W.}, + date-added = {2019-04-21 16:08:43 -0600}, + date-modified = {2019-04-21 16:08:43 -0600}, + doi = {10.1175/1520-0469(1977)034<0344:sscimo>2.0.co;2}, + issn = {1520-0469}, + journal = {Journal of the Atmospheric Sciences}, + month = {Feb}, + number = {2}, + pages = {344--355}, + publisher = {American Meteorological Society}, + title = {Subgrid-Scale Condensation in Models of Nonprecipitating Clouds}, + url = {http://dx.doi.org/10.1175/1520-0469(1977)034<0344:SSCIMO>2.0.CO;2}, + volume = {34}, + year = {1977}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0469(1977)034%3C0344:SSCIMO%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0469(1977)034%3C0344:sscimo%3E2.0.co;2}} @article{Benjamin_2016, - Author = {Benjamin, S. G. and Weygandt, S. S. and Brown, J. M. and Hu, M. and Alexander, C. R. and Smirnova, T. G. and Olson, J. B. and James, E. P. and Dowell, D. C. and Grell, G. A. and et al.}, - Date-Added = {2019-04-19 11:32:56 -0600}, - Date-Modified = {2019-04-19 11:32:56 -0600}, - Doi = {10.1175/mwr-d-15-0242.1}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {Apr}, - Number = {4}, - Pages = {1669--1694}, - Publisher = {American Meteorological Society}, - Title = {A North American Hourly Assimilation and Model Forecast Cycle: The Rapid Refresh}, - Url = {http://dx.doi.org/10.1175/MWR-D-15-0242.1}, - Volume = {144}, - Year = {2016}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/MWR-D-15-0242.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/mwr-d-15-0242.1}} + author = {Benjamin, S. G. and Weygandt, S. S. and Brown, J. M. and Hu, M. and Alexander, C. R. and Smirnova, T. G. and Olson, J. B. and James, E. P. and Dowell, D. C. and Grell, G. A. and et al.}, + date-added = {2019-04-19 11:32:56 -0600}, + date-modified = {2019-04-19 11:32:56 -0600}, + doi = {10.1175/mwr-d-15-0242.1}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {Apr}, + number = {4}, + pages = {1669--1694}, + publisher = {American Meteorological Society}, + title = {A North American Hourly Assimilation and Model Forecast Cycle: The Rapid Refresh}, + url = {http://dx.doi.org/10.1175/MWR-D-15-0242.1}, + volume = {144}, + year = {2016}, + bdsk-url-1 = {http://dx.doi.org/10.1175/MWR-D-15-0242.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/mwr-d-15-0242.1}} @article{Arakawa_2004, - Author = {Arakawa, A.}, - Date-Added = {2019-02-01 17:35:16 -0700}, - Date-Modified = {2019-02-01 17:35:16 -0700}, - Doi = {10.1175/1520-0442(2004)017<2493:ratcpp>2.0.co;2}, - Issn = {1520-0442}, - Journal = {Journal of Climate}, - Month = {Jul}, - Number = {13}, - Pages = {2493--2525}, - Publisher = {American Meteorological Society}, - Title = {The Cumulus Parameterization Problem: Past, Present, and Future}, - Url = {http://dx.doi.org/10.1175/1520-0442(2004)017<2493:RATCPP>2.0.CO;2}, - Volume = {17}, - Year = {2004}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0442(2004)017%3C2493:RATCPP%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0442(2004)017%3C2493:ratcpp%3E2.0.co;2}} + author = {Arakawa, A.}, + date-added = {2019-02-01 17:35:16 -0700}, + date-modified = {2019-02-01 17:35:16 -0700}, + doi = {10.1175/1520-0442(2004)017<2493:ratcpp>2.0.co;2}, + issn = {1520-0442}, + journal = {Journal of Climate}, + month = {Jul}, + number = {13}, + pages = {2493--2525}, + publisher = {American Meteorological Society}, + title = {The Cumulus Parameterization Problem: Past, Present, and Future}, + url = {http://dx.doi.org/10.1175/1520-0442(2004)017<2493:RATCPP>2.0.CO;2}, + volume = {17}, + year = {2004}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0442(2004)017%3C2493:RATCPP%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0442(2004)017%3C2493:ratcpp%3E2.0.co;2}} @article{Thompson_2004, - Author = {Thompson, G. and Rasmussen, R. M. and Manning, K.}, - Date-Added = {2019-01-22 16:11:17 -0700}, - Date-Modified = {2019-01-22 16:11:17 -0700}, - Doi = {10.1175/1520-0493(2004)132<0519:efowpu>2.0.co;2}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {Feb}, - Number = {2}, - Pages = {519--542}, - Publisher = {American Meteorological Society}, - Title = {Explicit Forecasts of Winter Precipitation Using an Improved Bulk Microphysics Scheme. {P}art {I}: Description and Sensitivity Analysis}, - Url = {http://dx.doi.org/10.1175/1520-0493(2004)132<0519:EFOWPU>2.0.CO;2}, - Volume = {132}, - Year = {2004}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0519:EFOWPU%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0519:efowpu%3E2.0.co;2}} + author = {Thompson, G. and Rasmussen, R. M. and Manning, K.}, + date-added = {2019-01-22 16:11:17 -0700}, + date-modified = {2019-01-22 16:11:17 -0700}, + doi = {10.1175/1520-0493(2004)132<0519:efowpu>2.0.co;2}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {Feb}, + number = {2}, + pages = {519--542}, + publisher = {American Meteorological Society}, + title = {Explicit Forecasts of Winter Precipitation Using an Improved Bulk Microphysics Scheme. {P}art {I}: Description and Sensitivity Analysis}, + url = {http://dx.doi.org/10.1175/1520-0493(2004)132<0519:EFOWPU>2.0.CO;2}, + volume = {132}, + year = {2004}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0519:EFOWPU%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0493(2004)132%3C0519:efowpu%3E2.0.co;2}} @article{Abdul_Razzak_2000, - Author = {Abdul-Razzak, H. and Ghan, S. J.}, - Date-Added = {2019-01-22 11:02:36 -0700}, - Date-Modified = {2019-06-05 15:28:16 +0000}, - Journal = {Journal of Geophysical Research: Atmospheres}, - Number = {D5}, - Pages = {6837-6844}, - Title = {A parameterization of aerosol activation: 2. Multiple aerosol types}, - Volume = {105}, - Year = {2000}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/1999JD901161}} + author = {Abdul-Razzak, H. and Ghan, S. J.}, + date-added = {2019-01-22 11:02:36 -0700}, + date-modified = {2019-06-05 15:28:16 +0000}, + journal = {Journal of Geophysical Research: Atmospheres}, + number = {D5}, + pages = {6837-6844}, + title = {A parameterization of aerosol activation: 2. Multiple aerosol types}, + volume = {105}, + year = {2000}, + bdsk-url-1 = {http://dx.doi.org/10.1029/1999JD901161}} @article{Barahona_2014, - Author = {Barahona, D. and Molod, A. and Bacmeister, J. and et al.}, - Date-Added = {2019-01-22 10:47:07 -0700}, - Date-Modified = {2019-01-22 10:47:07 -0700}, - Doi = {10.5194/gmd-7-1733-2014}, - Issn = {1991-9603}, - Journal = {Geoscientific Model Development}, - Month = {Aug}, - Number = {4}, - Pages = {1733--1766}, - Publisher = {Copernicus GmbH}, - Title = {Development of two-moment cloud microphysics for liquid and ice within the NASA Goddard Earth Observing System Model ({GEOS-5})}, - Url = {http://dx.doi.org/10.5194/gmd-7-1733-2014}, - Volume = {7}, - Year = {2014}, - Bdsk-Url-1 = {http://dx.doi.org/10.5194/gmd-7-1733-2014}} + author = {Barahona, D. and Molod, A. and Bacmeister, J. and et al.}, + date-added = {2019-01-22 10:47:07 -0700}, + date-modified = {2019-01-22 10:47:07 -0700}, + doi = {10.5194/gmd-7-1733-2014}, + issn = {1991-9603}, + journal = {Geoscientific Model Development}, + month = {Aug}, + number = {4}, + pages = {1733--1766}, + publisher = {Copernicus GmbH}, + title = {Development of two-moment cloud microphysics for liquid and ice within the NASA Goddard Earth Observing System Model ({GEOS-5})}, + url = {http://dx.doi.org/10.5194/gmd-7-1733-2014}, + volume = {7}, + year = {2014}, + bdsk-url-1 = {http://dx.doi.org/10.5194/gmd-7-1733-2014}} @article{Barahona_2008, - Author = {Barahona, D. and Nenes, A.}, - Date-Added = {2019-01-22 10:12:34 -0700}, - Date-Modified = {2019-01-22 10:12:34 -0700}, - Doi = {10.1029/2007jd009355}, - Issn = {0148-0227}, - Journal = {Journal of Geophysical Research}, - Month = {Jun}, - Number = {D11}, - Publisher = {American Geophysical Union (AGU)}, - Title = {Parameterization of cirrus cloud formation in large-scale models: Homogeneous nucleation}, - Url = {http://dx.doi.org/10.1029/2007JD009355}, - Volume = {113}, - Year = {2008}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/2007JD009355}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2007jd009355}} + author = {Barahona, D. and Nenes, A.}, + date-added = {2019-01-22 10:12:34 -0700}, + date-modified = {2019-01-22 10:12:34 -0700}, + doi = {10.1029/2007jd009355}, + issn = {0148-0227}, + journal = {Journal of Geophysical Research}, + month = {Jun}, + number = {D11}, + publisher = {American Geophysical Union (AGU)}, + title = {Parameterization of cirrus cloud formation in large-scale models: Homogeneous nucleation}, + url = {http://dx.doi.org/10.1029/2007JD009355}, + volume = {113}, + year = {2008}, + bdsk-url-1 = {http://dx.doi.org/10.1029/2007JD009355}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2007jd009355}} @article{Fountoukis_2005, - Author = {Fountoukis, C.}, - Date-Added = {2019-01-22 10:07:41 -0700}, - Date-Modified = {2019-01-22 10:07:41 -0700}, - Doi = {10.1029/2004jd005591}, - Issn = {0148-0227}, - Journal = {Journal of Geophysical Research}, - Number = {D11}, - Publisher = {American Geophysical Union (AGU)}, - Title = {Continued development of a cloud droplet formation parameterization for global climate models}, - Url = {http://dx.doi.org/10.1029/2004JD005591}, - Volume = {110}, - Year = {2005}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/2004JD005591}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2004jd005591}} + author = {Fountoukis, C.}, + date-added = {2019-01-22 10:07:41 -0700}, + date-modified = {2019-01-22 10:07:41 -0700}, + doi = {10.1029/2004jd005591}, + issn = {0148-0227}, + journal = {Journal of Geophysical Research}, + number = {D11}, + publisher = {American Geophysical Union (AGU)}, + title = {Continued development of a cloud droplet formation parameterization for global climate models}, + url = {http://dx.doi.org/10.1029/2004JD005591}, + volume = {110}, + year = {2005}, + bdsk-url-1 = {http://dx.doi.org/10.1029/2004JD005591}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2004jd005591}} @article{Nenes_2003, - Author = {Nenes, A.}, - Date-Added = {2019-01-22 10:02:59 -0700}, - Date-Modified = {2019-01-22 10:02:59 -0700}, - Doi = {10.1029/2002jd002911}, - Issn = {0148-0227}, - Journal = {Journal of Geophysical Research}, - Number = {D14}, - Publisher = {American Geophysical Union (AGU)}, - Title = {Parameterization of cloud droplet formation in global climate models}, - Url = {http://dx.doi.org/10.1029/2002JD002911}, - Volume = {108}, - Year = {2003}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/2002JD002911}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2002jd002911}} + author = {Nenes, A.}, + date-added = {2019-01-22 10:02:59 -0700}, + date-modified = {2019-01-22 10:02:59 -0700}, + doi = {10.1029/2002jd002911}, + issn = {0148-0227}, + journal = {Journal of Geophysical Research}, + number = {D14}, + publisher = {American Geophysical Union (AGU)}, + title = {Parameterization of cloud droplet formation in global climate models}, + url = {http://dx.doi.org/10.1029/2002JD002911}, + volume = {108}, + year = {2003}, + bdsk-url-1 = {http://dx.doi.org/10.1029/2002JD002911}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2002jd002911}} @article{Barahona_2009, - Author = {Barahona, D. and Nenes, A.}, - Date-Added = {2019-01-22 09:36:04 -0700}, - Date-Modified = {2019-01-22 09:36:04 -0700}, - Doi = {10.5194/acp-9-369-2009}, - Issn = {1680-7324}, - Journal = {Atmospheric Chemistry and Physics}, - Month = {Jan}, - Number = {2}, - Pages = {369--381}, - Publisher = {Copernicus GmbH}, - Title = {Parameterizing the competition between homogeneous and heterogeneous freezing in cirrus cloud formation -- monodisperse ice nuclei}, - Url = {http://dx.doi.org/10.5194/acp-9-369-2009}, - Volume = {9}, - Year = {2009}, - Bdsk-Url-1 = {http://dx.doi.org/10.5194/acp-9-369-2009}} + author = {Barahona, D. and Nenes, A.}, + date-added = {2019-01-22 09:36:04 -0700}, + date-modified = {2019-01-22 09:36:04 -0700}, + doi = {10.5194/acp-9-369-2009}, + issn = {1680-7324}, + journal = {Atmospheric Chemistry and Physics}, + month = {Jan}, + number = {2}, + pages = {369--381}, + publisher = {Copernicus GmbH}, + title = {Parameterizing the competition between homogeneous and heterogeneous freezing in cirrus cloud formation -- monodisperse ice nuclei}, + url = {http://dx.doi.org/10.5194/acp-9-369-2009}, + volume = {9}, + year = {2009}, + bdsk-url-1 = {http://dx.doi.org/10.5194/acp-9-369-2009}} @article{Smirnova_1997, - Author = {Smirnova, T. G. and Brown, J. M. and Benjamin, S. G.}, - Date-Added = {2019-01-14 15:20:01 -0700}, - Date-Modified = {2019-01-14 15:20:01 -0700}, - Doi = {10.1175/1520-0493(1997)125<1870:podsmc>2.0.co;2}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {Aug}, - Number = {8}, - Pages = {1870--1884}, - Publisher = {American Meteorological Society}, - Title = {Performance of Different Soil Model Configurations in Simulating Ground Surface Temperature and Surface Fluxes}, - Url = {http://dx.doi.org/10.1175/1520-0493(1997)125<1870:PODSMC>2.0.CO;2}, - Volume = {125}, - Year = {1997}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0493(1997)125%3C1870:PODSMC%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0493(1997)125%3C1870:podsmc%3E2.0.co;2}} + author = {Smirnova, T. G. and Brown, J. M. and Benjamin, S. G.}, + date-added = {2019-01-14 15:20:01 -0700}, + date-modified = {2019-01-14 15:20:01 -0700}, + doi = {10.1175/1520-0493(1997)125<1870:podsmc>2.0.co;2}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {Aug}, + number = {8}, + pages = {1870--1884}, + publisher = {American Meteorological Society}, + title = {Performance of Different Soil Model Configurations in Simulating Ground Surface Temperature and Surface Fluxes}, + url = {http://dx.doi.org/10.1175/1520-0493(1997)125<1870:PODSMC>2.0.CO;2}, + volume = {125}, + year = {1997}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0493(1997)125%3C1870:PODSMC%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0493(1997)125%3C1870:podsmc%3E2.0.co;2}} @article{Gregory_2001, - Author = {Gregory, D.}, - Date-Added = {2018-11-06 11:45:59 -0700}, - Date-Modified = {2018-11-06 11:45:59 -0700}, - Doi = {10.1002/qj.49712757104}, - Issn = {1477-870X}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Month = {Jan}, - Number = {571}, - Pages = {53--72}, - Publisher = {Wiley}, - Title = {Estimation of entrainment rate in simple models of convective clouds}, - Url = {http://dx.doi.org/10.1002/qj.49712757104}, - Volume = {127}, - Year = {2001}, - Bdsk-Url-1 = {http://dx.doi.org/10.1002/qj.49712757104}} + author = {Gregory, D.}, + date-added = {2018-11-06 11:45:59 -0700}, + date-modified = {2018-11-06 11:45:59 -0700}, + doi = {10.1002/qj.49712757104}, + issn = {1477-870X}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + month = {Jan}, + number = {571}, + pages = {53--72}, + publisher = {Wiley}, + title = {Estimation of entrainment rate in simple models of convective clouds}, + url = {http://dx.doi.org/10.1002/qj.49712757104}, + volume = {127}, + year = {2001}, + bdsk-url-1 = {http://dx.doi.org/10.1002/qj.49712757104}} @article{Pan_1998, - Author = {Pan, D.-M. and Randall, D. A.}, - Date-Added = {2018-11-06 11:43:33 -0700}, - Date-Modified = {2018-11-06 11:43:33 -0700}, - Doi = {10.1002/qj.49712454714}, - Issn = {1477-870X}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Month = {Apr}, - Number = {547}, - Pages = {949--981}, - Publisher = {Wiley}, - Title = {A cumulus parameterization with a prognostic closure}, - Url = {http://dx.doi.org/10.1002/qj.49712454714}, - Volume = {124}, - Year = {1998}, - Bdsk-Url-1 = {http://dx.doi.org/10.1002/qj.49712454714}} + author = {Pan, D.-M. and Randall, D. A.}, + date-added = {2018-11-06 11:43:33 -0700}, + date-modified = {2018-11-06 11:43:33 -0700}, + doi = {10.1002/qj.49712454714}, + issn = {1477-870X}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + month = {Apr}, + number = {547}, + pages = {949--981}, + publisher = {Wiley}, + title = {A cumulus parameterization with a prognostic closure}, + url = {http://dx.doi.org/10.1002/qj.49712454714}, + volume = {124}, + year = {1998}, + bdsk-url-1 = {http://dx.doi.org/10.1002/qj.49712454714}} @article{Arakawa_2013, - Author = {Arakawa, A. and Wu, C.-M.}, - Date-Added = {2018-11-06 11:41:28 -0700}, - Date-Modified = {2018-11-06 11:41:28 -0700}, - Doi = {10.1175/jas-d-12-0330.1}, - Issn = {1520-0469}, - Journal = {Journal of the Atmospheric Sciences}, - Month = {Jul}, - Number = {7}, - Pages = {1977--1992}, - Publisher = {American Meteorological Society}, - Title = {A Unified Representation of Deep Moist Convection in Numerical Modeling of the Atmosphere. {P}art {I}}, - Url = {http://dx.doi.org/10.1175/JAS-D-12-0330.1}, - Volume = {70}, - Year = {2013}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/JAS-D-12-0330.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/jas-d-12-0330.1}} + author = {Arakawa, A. and Wu, C.-M.}, + date-added = {2018-11-06 11:41:28 -0700}, + date-modified = {2018-11-06 11:41:28 -0700}, + doi = {10.1175/jas-d-12-0330.1}, + issn = {1520-0469}, + journal = {Journal of the Atmospheric Sciences}, + month = {Jul}, + number = {7}, + pages = {1977--1992}, + publisher = {American Meteorological Society}, + title = {A Unified Representation of Deep Moist Convection in Numerical Modeling of the Atmosphere. {P}art {I}}, + url = {http://dx.doi.org/10.1175/JAS-D-12-0330.1}, + volume = {70}, + year = {2013}, + bdsk-url-1 = {http://dx.doi.org/10.1175/JAS-D-12-0330.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/jas-d-12-0330.1}} @article{Chikira_2010, - Author = {Chikira, M. and Sugiyama, M.}, - Date-Added = {2018-11-06 11:35:55 -0700}, - Date-Modified = {2018-11-06 11:35:55 -0700}, - Doi = {10.1175/2010jas3316.1}, - Issn = {1520-0469}, - Journal = {Journal of the Atmospheric Sciences}, - Month = {Jul}, - Number = {7}, - Pages = {2171--2193}, - Publisher = {American Meteorological Society}, - Title = {A Cumulus Parameterization with State-Dependent Entrainment Rate. {P}art {I}: Description and Sensitivity to Temperature and Humidity Profiles}, - Url = {http://dx.doi.org/10.1175/2010JAS3316.1}, - Volume = {67}, - Year = {2010}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/2010JAS3316.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2010jas3316.1}} + author = {Chikira, M. and Sugiyama, M.}, + date-added = {2018-11-06 11:35:55 -0700}, + date-modified = {2018-11-06 11:35:55 -0700}, + doi = {10.1175/2010jas3316.1}, + issn = {1520-0469}, + journal = {Journal of the Atmospheric Sciences}, + month = {Jul}, + number = {7}, + pages = {2171--2193}, + publisher = {American Meteorological Society}, + title = {A Cumulus Parameterization with State-Dependent Entrainment Rate. {P}art {I}: Description and Sensitivity to Temperature and Humidity Profiles}, + url = {http://dx.doi.org/10.1175/2010JAS3316.1}, + volume = {67}, + year = {2010}, + bdsk-url-1 = {http://dx.doi.org/10.1175/2010JAS3316.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2010jas3316.1}} @article{Lewis_2005, - Author = {Lewis, J. M.}, - Date-Added = {2018-09-21 11:27:20 -0600}, - Date-Modified = {2018-09-21 11:27:20 -0600}, - Doi = {10.1175/mwr2949.1}, - Issn = {1520-0493}, - Journal = {Monthly Weather Review}, - Month = {Jul}, - Number = {7}, - Pages = {1865--1885}, - Publisher = {American Meteorological Society}, - Title = {Roots of Ensemble Forecasting}, - Url = {http://dx.doi.org/10.1175/MWR2949.1}, - Volume = {133}, - Year = {2005}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/MWR2949.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/mwr2949.1}} + author = {Lewis, J. M.}, + date-added = {2018-09-21 11:27:20 -0600}, + date-modified = {2018-09-21 11:27:20 -0600}, + doi = {10.1175/mwr2949.1}, + issn = {1520-0493}, + journal = {Monthly Weather Review}, + month = {Jul}, + number = {7}, + pages = {1865--1885}, + publisher = {American Meteorological Society}, + title = {Roots of Ensemble Forecasting}, + url = {http://dx.doi.org/10.1175/MWR2949.1}, + volume = {133}, + year = {2005}, + bdsk-url-1 = {http://dx.doi.org/10.1175/MWR2949.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/mwr2949.1}} @article{Zhu_2018, - Author = {Zhu, Y. and Zhou, X. and Li, W. and Hou, D. and Melhauser, C. and Sinsky, E. and Pe{\~n}a, M. and Fu, B. and Guan, H. and Kolczynski, W. and et al.}, - Date-Added = {2018-09-07 11:48:50 -0600}, - Date-Modified = {2019-06-05 15:33:03 +0000}, - Journal = {Journal of Geophysical Research: Atmospheres}, - Number = {13}, - Pages = {6732--6745}, - Title = {Toward the Improvement of Subseasonal Prediction in the National Centers for Environmental Prediction Global Ensemble Forecast System}, - Volume = {123}, - Year = {2018}, - Bdsk-Url-1 = {http://dx.doi.org/10.1029/2018JD028506}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2018jd028506}} + author = {Zhu, Y. and Zhou, X. and Li, W. and Hou, D. and Melhauser, C. and Sinsky, E. and Pe{\~n}a, M. and Fu, B. and Guan, H. and Kolczynski, W. and et al.}, + date-added = {2018-09-07 11:48:50 -0600}, + date-modified = {2019-06-05 15:33:03 +0000}, + journal = {Journal of Geophysical Research: Atmospheres}, + number = {13}, + pages = {6732--6745}, + title = {Toward the Improvement of Subseasonal Prediction in the National Centers for Environmental Prediction Global Ensemble Forecast System}, + volume = {123}, + year = {2018}, + bdsk-url-1 = {http://dx.doi.org/10.1029/2018JD028506}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2018jd028506}} @article{Shutts_2005, - Author = {Shutts, G.}, - Date-Added = {2018-09-07 11:46:20 -0600}, - Date-Modified = {2018-09-07 11:46:20 -0600}, - Doi = {10.1256/qj.04.106}, - Issn = {1477-870X}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Month = {Oct}, - Number = {612}, - Pages = {3079--3102}, - Publisher = {Wiley}, - Title = {A kinetic energy backscatter algorithm for use in ensemble prediction systems}, - Url = {http://dx.doi.org/10.1256/qj.04.106}, - Volume = {131}, - Year = {2005}, - Bdsk-Url-1 = {http://dx.doi.org/10.1256/qj.04.106}} + author = {Shutts, G.}, + date-added = {2018-09-07 11:46:20 -0600}, + date-modified = {2018-09-07 11:46:20 -0600}, + doi = {10.1256/qj.04.106}, + issn = {1477-870X}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + month = {Oct}, + number = {612}, + pages = {3079--3102}, + publisher = {Wiley}, + title = {A kinetic energy backscatter algorithm for use in ensemble prediction systems}, + url = {http://dx.doi.org/10.1256/qj.04.106}, + volume = {131}, + year = {2005}, + bdsk-url-1 = {http://dx.doi.org/10.1256/qj.04.106}} @article{Palmer_2001, - Author = {Palmer, T. N.}, - Date-Added = {2018-09-07 11:41:56 -0600}, - Date-Modified = {2018-09-07 11:41:56 -0600}, - Doi = {10.1002/qj.49712757202}, - Issn = {1477-870X}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Month = {Jan}, - Number = {572}, - Pages = {279--304}, - Publisher = {Wiley}, - Title = {A nonlinear dynamical perspective on model error: A proposal for non-local stochastic-dynamic parametrization in weather and climate prediction models}, - Url = {http://dx.doi.org/10.1002/qj.49712757202}, - Volume = {127}, - Year = {2001}, - Bdsk-Url-1 = {http://dx.doi.org/10.1002/qj.49712757202}} + author = {Palmer, T. N.}, + date-added = {2018-09-07 11:41:56 -0600}, + date-modified = {2018-09-07 11:41:56 -0600}, + doi = {10.1002/qj.49712757202}, + issn = {1477-870X}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + month = {Jan}, + number = {572}, + pages = {279--304}, + publisher = {Wiley}, + title = {A nonlinear dynamical perspective on model error: A proposal for non-local stochastic-dynamic parametrization in weather and climate prediction models}, + url = {http://dx.doi.org/10.1002/qj.49712757202}, + volume = {127}, + year = {2001}, + bdsk-url-1 = {http://dx.doi.org/10.1002/qj.49712757202}} @conference{palmer_1997, - Address = {Reading, United Kingdom}, - Author = {T.N. Palmer}, - Booktitle = {Workshop on New Insights and Approaches to Convective Parametrization}, - Date-Added = {2018-09-07 11:23:58 -0600}, - Date-Modified = {2018-09-07 11:37:57 -0600}, - Organization = {ECMWF}, - Pages = {328-337}, - Title = {On parametrizing scales that are only somewhat smaller than the smallest resolved scales, with application to convection and orography.}, - Year = {1997}} + address = {Reading, United Kingdom}, + author = {T.N. Palmer}, + booktitle = {Workshop on New Insights and Approaches to Convective Parametrization}, + date-added = {2018-09-07 11:23:58 -0600}, + date-modified = {2018-09-07 11:37:57 -0600}, + organization = {ECMWF}, + pages = {328-337}, + title = {On parametrizing scales that are only somewhat smaller than the smallest resolved scales, with application to convection and orography.}, + year = {1997}} @article{buizza_et_al_1999, - Author = {R. Buizza and M. Miller and T.N.Palmer}, - Date-Added = {2018-09-05 13:39:12 -0600}, - Date-Modified = {2018-09-05 13:43:07 -0600}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Pages = {2887-2908}, - Title = {Stochastic representation of model uncertainties in the {ECMWF} ensemble prediction system}, - Volume = {125}, - Year = {1999}} + author = {R. Buizza and M. Miller and T.N.Palmer}, + date-added = {2018-09-05 13:39:12 -0600}, + date-modified = {2018-09-05 13:43:07 -0600}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + pages = {2887-2908}, + title = {Stochastic representation of model uncertainties in the {ECMWF} ensemble prediction system}, + volume = {125}, + year = {1999}} @article{donahue_and_caldwell_2018, - Author = {A. S. Donahue and P. M. Caldwell}, - Date-Added = {2018-08-22 11:38:12 -0600}, - Date-Modified = {2018-08-22 11:42:12 -0600}, - Journal = {Journal of Advances in Modeling Earth Systems}, - Number = {10.1002/2017MS001067}, - Pages = {481-499}, - Title = {Impact of physics parameterization ordering in a global atmosphere model}, - Year = {2018}} + author = {A. S. Donahue and P. M. Caldwell}, + date-added = {2018-08-22 11:38:12 -0600}, + date-modified = {2018-08-22 11:42:12 -0600}, + journal = {Journal of Advances in Modeling Earth Systems}, + number = {10.1002/2017MS001067}, + pages = {481-499}, + title = {Impact of physics parameterization ordering in a global atmosphere model}, + year = {2018}} @article{tompkins_and_berner_2008, - Author = {A. M. Tompkins and J. Berner}, - Date-Added = {2018-08-21 16:39:36 -0600}, - Date-Modified = {2018-08-21 20:28:30 -0600}, - Journal = {J. Geophys. Res.}, - Number = {D18101}, - Title = {A stochastic convective approach to account for model uncertainty due to unresolved humidity variability}, - Volume = {113}, - Year = {2008}} + author = {A. M. Tompkins and J. Berner}, + date-added = {2018-08-21 16:39:36 -0600}, + date-modified = {2018-08-21 20:28:30 -0600}, + journal = {J. Geophys. Res.}, + number = {D18101}, + title = {A stochastic convective approach to account for model uncertainty due to unresolved humidity variability}, + volume = {113}, + year = {2008}} @techreport{palmer_et_al_2009, - Author = {T. N. Palmer and R. Buizza and F. Doblas-Reyes and T. Jung and M. Leutbecher and G. J. Shutts and M. Steinheimer and A. Weisheimer}, - Date-Added = {2018-08-21 16:35:56 -0600}, - Date-Modified = {2018-08-21 16:39:32 -0600}, - Institution = {ECMWF}, - Number = {598}, - Title = {Stochastic parameterization and model uncertainty}, - Type = {Tech. Memo}, - Year = {2009}} + author = {T. N. Palmer and R. Buizza and F. Doblas-Reyes and T. Jung and M. Leutbecher and G. J. Shutts and M. Steinheimer and A. Weisheimer}, + date-added = {2018-08-21 16:35:56 -0600}, + date-modified = {2018-08-21 16:39:32 -0600}, + institution = {ECMWF}, + number = {598}, + title = {Stochastic parameterization and model uncertainty}, + type = {Tech. Memo}, + year = {2009}} @article{berner_et_al_2009, - Author = {J. Berner and G. Shutts and M. Leutbecher and T. Palmer}, - Date-Added = {2018-08-21 16:31:08 -0600}, - Date-Modified = {2018-08-21 16:33:44 -0600}, - Journal = {J. Atmos. Sci.}, - Pages = {603-626}, - Title = {A spectral stochastic kinetic energy backscatter scheme and its impact on flow-dependent predictability in the {ECMWF} ensemble prediction system}, - Volume = {66}, - Year = {2009}} + author = {J. Berner and G. Shutts and M. Leutbecher and T. Palmer}, + date-added = {2018-08-21 16:31:08 -0600}, + date-modified = {2018-08-21 16:33:44 -0600}, + journal = {J. Atmos. Sci.}, + pages = {603-626}, + title = {A spectral stochastic kinetic energy backscatter scheme and its impact on flow-dependent predictability in the {ECMWF} ensemble prediction system}, + volume = {66}, + year = {2009}} @article{schuur_et_al_2012, - Author = {T.J. Schuur and H.-S. Park and A.V. Ryzhkov and H.D. Reeves}, - Date-Added = {2018-08-21 10:37:16 -0600}, - Date-Modified = {2018-08-21 10:40:09 -0600}, - Journal = {Journal of Applied Meteorology and Climatology}, - Pages = {763-779}, - Title = {Classification of precipitation types during transitional winter weather using the {RUC} model and polarimetric radar retrievals}, - Volume = {51}, - Year = {2012}} + author = {T.J. Schuur and H.-S. Park and A.V. Ryzhkov and H.D. Reeves}, + date-added = {2018-08-21 10:37:16 -0600}, + date-modified = {2018-08-21 10:40:09 -0600}, + journal = {Journal of Applied Meteorology and Climatology}, + pages = {763-779}, + title = {Classification of precipitation types during transitional winter weather using the {RUC} model and polarimetric radar retrievals}, + volume = {51}, + year = {2012}} @article{wandishin_et_al_2005, - Author = {M.S. Wandishin and M. E. Baldwin and S.L. Mullen and J.V. Cortinas Jr.}, - Date-Added = {2018-08-21 10:17:31 -0600}, - Date-Modified = {2018-08-21 10:20:08 -0600}, - Journal = {Weather and Forecasting}, - Month = {August}, - Pages = {609-626}, - Title = {Short-range ensemble forecasts of precipitation type}, - Volume = {20}, - Year = {2005}} + author = {M.S. Wandishin and M. E. Baldwin and S.L. Mullen and J.V. Cortinas Jr.}, + date-added = {2018-08-21 10:17:31 -0600}, + date-modified = {2018-08-21 10:20:08 -0600}, + journal = {Weather and Forecasting}, + month = {August}, + pages = {609-626}, + title = {Short-range ensemble forecasts of precipitation type}, + volume = {20}, + year = {2005}} @article{bourgouin_2000, - Author = {P. Bourgouin}, - Date-Added = {2018-08-21 10:05:02 -0600}, - Date-Modified = {2018-08-21 10:08:08 -0600}, - Journal = {Weather and Forecasting}, - Month = {October}, - Pages = {583-592}, - Title = {A method to determine precipitation types}, - Volume = {15}, - Year = {2000}} + author = {P. Bourgouin}, + date-added = {2018-08-21 10:05:02 -0600}, + date-modified = {2018-08-21 10:08:08 -0600}, + journal = {Weather and Forecasting}, + month = {October}, + pages = {583-592}, + title = {A method to determine precipitation types}, + volume = {15}, + year = {2000}} @conference{ramer_1993, - Address = {Vienna, VA}, - Author = {J. Ramer}, - Booktitle = {Preprints. Fifth Int. Conf. on Aviation Weather Systems}, - Date-Added = {2018-08-21 10:02:23 -0600}, - Date-Modified = {2018-08-21 10:04:46 -0600}, - Organization = {Amer. Meteor. Soc.}, - Pages = {227-230}, - Title = {An empirical technique for diagnosing precipitation type from model output}, - Year = {1993}} + address = {Vienna, VA}, + author = {J. Ramer}, + booktitle = {Preprints. Fifth Int. Conf. on Aviation Weather Systems}, + date-added = {2018-08-21 10:02:23 -0600}, + date-modified = {2018-08-21 10:04:46 -0600}, + organization = {Amer. Meteor. Soc.}, + pages = {227-230}, + title = {An empirical technique for diagnosing precipitation type from model output}, + year = {1993}} @conference{baldwin_et_al_1994, - Address = {Portland, OR}, - Author = {M. Baldwin and R. Treadon and S. Contorno}, - Booktitle = {Preprints. 10th Conf. on Numerical Weather Prediction}, - Date-Added = {2018-08-21 09:58:34 -0600}, - Date-Modified = {2018-08-21 10:01:46 -0600}, - Organization = {Amer. Meteor. Soc.}, - Pages = {30-31}, - Title = {Precipitation type prediction using a decision tree approach with {NMC}'s mesoscale {E}ta Model}, - Year = {1994}} + address = {Portland, OR}, + author = {M. Baldwin and R. Treadon and S. Contorno}, + booktitle = {Preprints. 10th Conf. on Numerical Weather Prediction}, + date-added = {2018-08-21 09:58:34 -0600}, + date-modified = {2018-08-21 10:01:46 -0600}, + organization = {Amer. Meteor. Soc.}, + pages = {30-31}, + title = {Precipitation type prediction using a decision tree approach with {NMC}'s mesoscale {E}ta Model}, + year = {1994}} @techreport{cullen_and_salmond_2002, - Author = {M.J.P. Cullen and D.J. Salmond}, - Date-Added = {2018-08-02 20:05:47 +0000}, - Date-Modified = {2018-08-02 20:08:03 +0000}, - Institution = {ECMWF}, - Number = {357}, - Title = {On the use of a predictor-corrector scheme to couple the dynamics with the physical parametrizations in the {ECMWF} model}, - Type = {Tech. Memo}, - Year = {2002}} + author = {M.J.P. Cullen and D.J. Salmond}, + date-added = {2018-08-02 20:05:47 +0000}, + date-modified = {2018-08-02 20:08:03 +0000}, + institution = {ECMWF}, + number = {357}, + title = {On the use of a predictor-corrector scheme to couple the dynamics with the physical parametrizations in the {ECMWF} model}, + type = {Tech. Memo}, + year = {2002}} @techreport{wedi_1999, - Author = {N.P. Wedi}, - Date-Added = {2018-08-02 20:03:45 +0000}, - Date-Modified = {2018-08-02 20:05:42 +0000}, - Institution = {ECMWF}, - Number = {274}, - Title = {The numerical coupling of the physical parametrization to the "dynamical" equations in a forecast model}, - Type = {Tech. Memo}, - Year = {1999}} + author = {N.P. Wedi}, + date-added = {2018-08-02 20:03:45 +0000}, + date-modified = {2018-08-02 20:05:42 +0000}, + institution = {ECMWF}, + number = {274}, + title = {The numerical coupling of the physical parametrization to the "dynamical" equations in a forecast model}, + type = {Tech. Memo}, + year = {1999}} @proceedings{beljaars_1991, - Address = {Reading, United Kingdom}, - Author = {A. Beljaars}, - Date-Added = {2018-07-27 22:06:59 +0000}, - Date-Modified = {2018-07-27 22:30:21 +0000}, - Organization = {ECMWF}, - Publisher = {the {ECMWF} Seminar on Numerical Methods in Atmospheric Models}, - Title = {Numerical schemes for parameterizations}, - Year = {1991}} + address = {Reading, United Kingdom}, + author = {A. Beljaars}, + date-added = {2018-07-27 22:06:59 +0000}, + date-modified = {2018-07-27 22:30:21 +0000}, + organization = {ECMWF}, + publisher = {the {ECMWF} Seminar on Numerical Methods in Atmospheric Models}, + title = {Numerical schemes for parameterizations}, + year = {1991}} @article{ern_et_al_2004, - Author = {M.P. Ern and P. Preusse and C.D. Warner}, - Date-Added = {2018-07-26 22:42:42 +0000}, - Date-Modified = {2018-07-26 22:44:11 +0000}, - Journal = {J. Geophys. Res.}, - Number = {D20103}, - Title = {Absolute values of gravity wave momentum flux derived from satellite data}, - Year = {2004}} + author = {M.P. Ern and P. Preusse and C.D. Warner}, + date-added = {2018-07-26 22:42:42 +0000}, + date-modified = {2018-07-26 22:44:11 +0000}, + journal = {J. Geophys. Res.}, + number = {D20103}, + title = {Absolute values of gravity wave momentum flux derived from satellite data}, + year = {2004}} @article{fritts_and_nastrom_1980, - Author = {D. C. Fritts and D.D. Nastrom}, - Date-Added = {2018-07-26 22:40:22 +0000}, - Date-Modified = {2018-07-26 22:42:09 +0000}, - Journal = {J. Atmos. Sci.}, - Pages = {111-127}, - Title = {Sources of mesoscale variability of gravity waves. {P}art {II}: frontal, convective, and jet stream excitation}, - Volume = {49}, - Year = {1980}} + author = {D. C. Fritts and D.D. Nastrom}, + date-added = {2018-07-26 22:40:22 +0000}, + date-modified = {2018-07-26 22:42:09 +0000}, + journal = {J. Atmos. Sci.}, + pages = {111-127}, + title = {Sources of mesoscale variability of gravity waves. {P}art {II}: frontal, convective, and jet stream excitation}, + volume = {49}, + year = {1980}} @proceedings{wmo_greenhouse_gas_bulletin_2017, - Date-Added = {2018-07-25 22:56:52 +0000}, - Date-Modified = {2018-07-25 22:59:49 +0000}, - Month = {October 2017}, - Number = {13}, - Organization = {World Meteorological Organization}, - Title = {{WMO} greenhouse gas bulletin}, - Year = {2017}} + date-added = {2018-07-25 22:56:52 +0000}, + date-modified = {2018-07-25 22:59:49 +0000}, + month = {October 2017}, + number = {13}, + organization = {World Meteorological Organization}, + title = {{WMO} greenhouse gas bulletin}, + year = {2017}} @article{soloviev_and_vershinsky_1982, - Author = {A. V. Soloviev and N. V. Vershinsky}, - Date-Added = {2018-07-22 01:43:03 +0000}, - Date-Modified = {2018-07-22 01:47:32 +0000}, - Journal = {Deep Sea Research {P}art {A}. Oceanographic Research Papers}, - Number = {12}, - Pages = {1437-1449}, - Title = {The vertical structure of the thin surface layer of the ocean under conditions of low wind speed}, - Volume = {29}, - Year = {1982}} + author = {A. V. Soloviev and N. V. Vershinsky}, + date-added = {2018-07-22 01:43:03 +0000}, + date-modified = {2018-07-22 01:47:32 +0000}, + journal = {Deep Sea Research {P}art {A}. Oceanographic Research Papers}, + number = {12}, + pages = {1437-1449}, + title = {The vertical structure of the thin surface layer of the ocean under conditions of low wind speed}, + volume = {29}, + year = {1982}} @article{zeng_and_beljaars_2005, - Author = {X. Zeng and A. Beljaars}, - Date-Added = {2018-07-21 22:41:35 +0000}, - Date-Modified = {2018-07-21 22:44:54 +0000}, - Journal = {Geophysical Research Letters}, - Number = {14}, - Pages = {1-4}, - Title = {A prognostic scheme of sea surface skin temperature for modeling and data assimilation}, - Volume = {32}, - Year = {2005}} + author = {X. Zeng and A. Beljaars}, + date-added = {2018-07-21 22:41:35 +0000}, + date-modified = {2018-07-21 22:44:54 +0000}, + journal = {Geophysical Research Letters}, + number = {14}, + pages = {1-4}, + title = {A prognostic scheme of sea surface skin temperature for modeling and data assimilation}, + volume = {32}, + year = {2005}} @article{mccormack_et_al_2008, - Author = {J. P. McCormack and K. W. Hoppel and D. E. Siskind}, - Date-Added = {2018-07-20 17:19:45 +0000}, - Date-Modified = {2018-07-20 17:22:12 +0000}, - Journal = {Atmos. Chem. Phys.}, - Pages = {7519-7532}, - Title = {Parameterization of middle atmospheric water vapor photochemistry for high-altitude {NWP} and data assimilation}, - Volume = {8}, - Year = {2008}} + author = {J. P. McCormack and K. W. Hoppel and D. E. Siskind}, + date-added = {2018-07-20 17:19:45 +0000}, + date-modified = {2018-07-20 17:22:12 +0000}, + journal = {Atmos. Chem. Phys.}, + pages = {7519-7532}, + title = {Parameterization of middle atmospheric water vapor photochemistry for high-altitude {NWP} and data assimilation}, + volume = {8}, + year = {2008}} @techreport{long_1986, - Author = {P. J. Long}, - Date-Added = {2018-07-18 22:00:29 +0000}, - Date-Modified = {2018-07-18 22:03:03 +0000}, - Institution = {U.S. Department of Commerce, National Oceanic and Atmospheric Administration, National Weather Service, National Meteorological Center}, - Number = {321}, - Title = {An economical and compatible scheme for parameterizing the stable surface layer in the medium-range forecast model}, - Type = {Office Note}, - Year = {1986}} + author = {P. J. Long}, + date-added = {2018-07-18 22:00:29 +0000}, + date-modified = {2018-07-18 22:03:03 +0000}, + institution = {U.S. Department of Commerce, National Oceanic and Atmospheric Administration, National Weather Service, National Meteorological Center}, + number = {321}, + title = {An economical and compatible scheme for parameterizing the stable surface layer in the medium-range forecast model}, + type = {Office Note}, + year = {1986}} @techreport{long_1984, - Author = {P. J. Long}, - Date-Added = {2018-07-18 21:57:22 +0000}, - Date-Modified = {2018-07-18 22:00:25 +0000}, - Institution = {U.S. Department of Commerce, National Oceanic and Atmospheric Administration, National Weather Service, National Meteorological Center}, - Number = {302}, - Title = {An general unified similarity theory for the calculation of turbulent fluxes in the numerical weather prediction models for unstable condition}, - Type = {Office Note}, - Year = {1984}} + author = {P. J. Long}, + date-added = {2018-07-18 21:57:22 +0000}, + date-modified = {2018-07-18 22:00:25 +0000}, + institution = {U.S. Department of Commerce, National Oceanic and Atmospheric Administration, National Weather Service, National Meteorological Center}, + number = {302}, + title = {An general unified similarity theory for the calculation of turbulent fluxes in the numerical weather prediction models for unstable condition}, + type = {Office Note}, + year = {1984}} @manual{miyakoda_and_sirutis_1986, - Author = {K. Miyakoda and J. Sirutis}, - Date-Added = {2018-07-18 21:44:00 +0000}, - Date-Modified = {2018-07-18 21:56:51 +0000}, - Organization = {Princeton University Press}, - Title = {Manual of the E-physics}, - Year = {1986}} + author = {K. Miyakoda and J. Sirutis}, + date-added = {2018-07-18 21:44:00 +0000}, + date-modified = {2018-07-18 21:56:51 +0000}, + organization = {Princeton University Press}, + title = {Manual of the E-physics}, + year = {1986}} @article{chen_and_lin_2011, - Author = {J.-H. Chen and S.-J. Lin}, - Date-Added = {2018-07-18 19:04:23 +0000}, - Date-Modified = {2018-07-18 19:10:04 +0000}, - Journal = {Geophysical Research Letters}, - Number = {L11804}, - Pages = {6}, - Title = {The remarkable predictability of inter-annual variability of Atlantic hurricanes during the past decade}, - Volume = {38}, - Year = {2011}} + author = {J.-H. Chen and S.-J. Lin}, + date-added = {2018-07-18 19:04:23 +0000}, + date-modified = {2018-07-18 19:10:04 +0000}, + journal = {Geophysical Research Letters}, + number = {L11804}, + pages = {6}, + title = {The remarkable predictability of inter-annual variability of Atlantic hurricanes during the past decade}, + volume = {38}, + year = {2011}} @article{lord_et_al_1984, - Author = {S. J. Lord and H. E. Willoughby and J. M. Piotrowicz}, - Date-Added = {2018-07-18 18:50:27 +0000}, - Date-Modified = {2018-07-18 18:54:09 +0000}, - Journal = {J. Atmos. Sci.}, - Month = {October}, - Number = {19}, - Pages = {2836-2848}, - Title = {Role of a parameterized ice-phase microphysics in an axisymmetric, nonhydrostatic tropical cyclone model}, - Volume = {41}, - Year = {1984}} + author = {S. J. Lord and H. E. Willoughby and J. M. Piotrowicz}, + date-added = {2018-07-18 18:50:27 +0000}, + date-modified = {2018-07-18 18:54:09 +0000}, + journal = {J. Atmos. Sci.}, + month = {October}, + number = {19}, + pages = {2836-2848}, + title = {Role of a parameterized ice-phase microphysics in an axisymmetric, nonhydrostatic tropical cyclone model}, + volume = {41}, + year = {1984}} @article{krueger_et_al_1995, - Author = {S. K. Krueger and Q. Fu and K. N. Liou and H.-N. S. Chin}, - Date-Added = {2018-07-18 18:46:23 +0000}, - Date-Modified = {2018-07-18 18:49:52 +0000}, - Journal = {Journal of Applied Meteorology}, - Month = {January}, - Pages = {281-287}, - Title = {Improvement of an ice-phase microphysics parameterization for use in numerical simulations of tropical convection}, - Volume = {34}, - Year = {1995}} + author = {S. K. Krueger and Q. Fu and K. N. Liou and H.-N. S. Chin}, + date-added = {2018-07-18 18:46:23 +0000}, + date-modified = {2018-07-18 18:49:52 +0000}, + journal = {Journal of Applied Meteorology}, + month = {January}, + pages = {281-287}, + title = {Improvement of an ice-phase microphysics parameterization for use in numerical simulations of tropical convection}, + volume = {34}, + year = {1995}} @article{zheng_et_al_2017, - Author = {W. Zheng and M. Ek and K. Mitchell and H. Wei and J. Meng}, - Date-Added = {2018-07-18 17:39:49 +0000}, - Date-Modified = {2018-07-18 17:45:38 +0000}, - Journal = {Monthly Weather Review}, - Pages = {3969-3987}, - Title = {Improving the stable surface layer in the {NCEP} {G}lobal {F}orecast {S}ystem}, - Volume = {145}, - Year = {2017}} + author = {W. Zheng and M. Ek and K. Mitchell and H. Wei and J. Meng}, + date-added = {2018-07-18 17:39:49 +0000}, + date-modified = {2018-07-18 17:45:38 +0000}, + journal = {Monthly Weather Review}, + pages = {3969-3987}, + title = {Improving the stable surface layer in the {NCEP} {G}lobal {F}orecast {S}ystem}, + volume = {145}, + year = {2017}} @article{hong_et_al_2004, - Author = {S-Y. Hong and J. Dudhia and S.-H. Chen}, - Date-Added = {2018-07-06 19:29:40 +0000}, - Date-Modified = {2018-07-06 19:36:23 +0000}, - Journal = {Monthly Weather Review}, - Pages = {103-120}, - Title = {A revised approach to ice microphysical processes for the bulk parameterization of clouds and precipitation}, - Volume = {132}, - Year = {2004}} + author = {S-Y. Hong and J. Dudhia and S.-H. Chen}, + date-added = {2018-07-06 19:29:40 +0000}, + date-modified = {2018-07-06 19:36:23 +0000}, + journal = {Monthly Weather Review}, + pages = {103-120}, + title = {A revised approach to ice microphysical processes for the bulk parameterization of clouds and precipitation}, + volume = {132}, + year = {2004}} @article{heymsfield_and_donner_1990, - Author = {A. J. Heymsfield and L. J. Donner}, - Date-Added = {2018-07-06 18:58:01 +0000}, - Date-Modified = {2018-07-06 19:00:50 +0000}, - Journal = {J. Atmos. Sci.}, - Number = {15}, - Pages = {1865-1877}, - Title = {A scheme for parameterizing ice-cloud water content in general circulation models}, - Volume = {47}, - Year = {1990}} + author = {A. J. Heymsfield and L. J. Donner}, + date-added = {2018-07-06 18:58:01 +0000}, + date-modified = {2018-07-06 19:00:50 +0000}, + journal = {J. Atmos. Sci.}, + number = {15}, + pages = {1865-1877}, + title = {A scheme for parameterizing ice-cloud water content in general circulation models}, + volume = {47}, + year = {1990}} @article{deng_and_mace_2008, - Author = {M. Deng and G. G. Mace}, - Date-Added = {2018-07-06 18:54:13 +0000}, - Date-Modified = {2018-07-06 19:01:59 +0000}, - Journal = {Geophysical Research Letters}, - Number = {L17808}, - Title = {Cirrus cloud microphysical properties and air motion statistics using cloud radar {D}oppler moments: water content, partical size, and sedimentation relationships}, - Volume = {35}, - Year = {2008}} + author = {M. Deng and G. G. Mace}, + date-added = {2018-07-06 18:54:13 +0000}, + date-modified = {2018-07-06 19:01:59 +0000}, + journal = {Geophysical Research Letters}, + number = {L17808}, + title = {Cirrus cloud microphysical properties and air motion statistics using cloud radar {D}oppler moments: water content, partical size, and sedimentation relationships}, + volume = {35}, + year = {2008}} @article{lin_et_al_1994, - Author = {S-J. Lin and W. C. Chao and Y. C. Sud and G. K. Walker}, - Date-Added = {2018-07-05 22:55:30 +0000}, - Date-Modified = {2018-07-06 19:01:30 +0000}, - Journal = {Monthly Weather Review}, - Pages = {1575-1593}, - Title = {A class of the van {L}eer-type transport schemes and its application to the moisture transport in a general circulation model}, - Volume = {122}, - Year = {1994}} + author = {S-J. Lin and W. C. Chao and Y. C. Sud and G. K. Walker}, + date-added = {2018-07-05 22:55:30 +0000}, + date-modified = {2018-07-06 19:01:30 +0000}, + journal = {Monthly Weather Review}, + pages = {1575-1593}, + title = {A class of the van {L}eer-type transport schemes and its application to the moisture transport in a general circulation model}, + volume = {122}, + year = {1994}} @article{rutledge_and_hobbs_1984, - Author = {S. A. Rutledge and P. V. Hobbs}, - Date-Added = {2018-07-05 16:45:48 +0000}, - Date-Modified = {2018-07-05 16:49:04 +0000}, - Journal = {J. Atmos. Sci.}, - Number = {20}, - Pages = {2949-2972}, - Title = {The mesoscale and microscale structure and organization of clouds and precipitation in midlatitude cyclones. {XII}: a diagnostic modeling study of precipitation development in narrow cold-frontal rainbands}, - Volume = {41}, - Year = {1984}} + author = {S. A. Rutledge and P. V. Hobbs}, + date-added = {2018-07-05 16:45:48 +0000}, + date-modified = {2018-07-05 16:49:04 +0000}, + journal = {J. Atmos. Sci.}, + number = {20}, + pages = {2949-2972}, + title = {The mesoscale and microscale structure and organization of clouds and precipitation in midlatitude cyclones. {XII}: a diagnostic modeling study of precipitation development in narrow cold-frontal rainbands}, + volume = {41}, + year = {1984}} @article{chen_and_lin_2013, - Author = {J.-H. Chen and S.-J. Lin}, - Date-Added = {2018-07-03 18:13:27 +0000}, - Date-Modified = {2018-07-03 18:17:40 +0000}, - Journal = {J. Climate}, - Number = {2}, - Pages = {380-398}, - Title = {Seasonal predictions of Tropical Cyclones Using a 25-km-resolution general circulation model}, - Volume = {26}, - Year = {2013}} + author = {J.-H. Chen and S.-J. Lin}, + date-added = {2018-07-03 18:13:27 +0000}, + date-modified = {2018-07-03 18:17:40 +0000}, + journal = {J. Climate}, + number = {2}, + pages = {380-398}, + title = {Seasonal predictions of Tropical Cyclones Using a 25-km-resolution general circulation model}, + volume = {26}, + year = {2013}} @inproceedings{untch_et_al_1999, - Author = {A. Untch and A. J. Simmons and M. Hortal and C. Jakob}, - Booktitle = {Proceedings of the SODA Workshop}, - Date-Added = {2018-02-28 15:47:49 +0000}, - Date-Modified = {2018-02-28 15:50:58 +0000}, - Pages = {45-52}, - Publisher = {Netherlands}, - Title = {Increased stratospheric resolution in the {ECMWF} forecasting system}, - Year = {1999}} + author = {A. Untch and A. J. Simmons and M. Hortal and C. Jakob}, + booktitle = {Proceedings of the SODA Workshop}, + date-added = {2018-02-28 15:47:49 +0000}, + date-modified = {2018-02-28 15:50:58 +0000}, + pages = {45-52}, + publisher = {Netherlands}, + title = {Increased stratospheric resolution in the {ECMWF} forecasting system}, + year = {1999}} @article{dethof_and_holm_2004, - Author = {A. Dethof and E. V. Holm}, - Date-Added = {2018-02-26 22:54:54 +0000}, - Date-Modified = {2018-02-26 22:56:19 +0000}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Pages = {2851-2872}, - Title = {Ozone assimilation in the {ERA-40} reanalysis project}, - Volume = {130}, - Year = {2004}} + author = {A. Dethof and E. V. Holm}, + date-added = {2018-02-26 22:54:54 +0000}, + date-modified = {2018-02-26 22:56:19 +0000}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + pages = {2851-2872}, + title = {Ozone assimilation in the {ERA-40} reanalysis project}, + volume = {130}, + year = {2004}} @techreport{jackson_and_saunders_2002, - Author = {D. R. Jackson and R. Saunders}, - Date-Added = {2018-02-26 22:46:33 +0000}, - Date-Modified = {2018-02-26 22:49:04 +0000}, - Institution = {Met Office}, - Number = {394}, - Title = {Ozone data assimilation: preliminary system}, - Type = {Forecasting Research Technical Report}, - Year = {2002}} + author = {D. R. Jackson and R. Saunders}, + date-added = {2018-02-26 22:46:33 +0000}, + date-modified = {2018-02-26 22:49:04 +0000}, + institution = {Met Office}, + number = {394}, + title = {Ozone data assimilation: preliminary system}, + type = {Forecasting Research Technical Report}, + year = {2002}} @article{riishojgaard_1996, - Author = {L. P. Riishojgaard}, - Date-Added = {2018-02-26 22:43:38 +0000}, - Date-Modified = {2018-02-26 22:45:36 +0000}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Pages = {1545-1571}, - Title = {On four-dimensional variational assimilation of ozone data in weather-prediction models}, - Volume = {122}, - Year = {1996}} + author = {L. P. Riishojgaard}, + date-added = {2018-02-26 22:43:38 +0000}, + date-modified = {2018-02-26 22:45:36 +0000}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + pages = {1545-1571}, + title = {On four-dimensional variational assimilation of ozone data in weather-prediction models}, + volume = {122}, + year = {1996}} @article{john_and_buehler_2004, - Author = {V. O. John and S. A. Buehler}, - Date-Added = {2018-02-26 22:38:57 +0000}, - Date-Modified = {2018-02-26 22:41:05 +0000}, - Journal = {Geophysical Research Letters}, - Title = {The impact of ozone lines on {AMSU-B} radiances}, - Volume = {31}, - Year = {2004}} + author = {V. O. John and S. A. Buehler}, + date-added = {2018-02-26 22:38:57 +0000}, + date-modified = {2018-02-26 22:41:05 +0000}, + journal = {Geophysical Research Letters}, + title = {The impact of ozone lines on {AMSU-B} radiances}, + volume = {31}, + year = {2004}} @article{derber_and_wu_1998, - Author = {J. C. Derber and W.-S. Wu}, - Date-Added = {2018-02-26 22:35:19 +0000}, - Date-Modified = {2018-02-26 22:37:30 +0000}, - Journal = {Monthly Weather Review}, - Pages = {2287-2299}, - Title = {The use of {TOVS} cloud-cleared radiances in the {NCEP} {SSI} analysis system}, - Volume = {126}, - Year = {1998}} + author = {J. C. Derber and W.-S. Wu}, + date-added = {2018-02-26 22:35:19 +0000}, + date-modified = {2018-02-26 22:37:30 +0000}, + journal = {Monthly Weather Review}, + pages = {2287-2299}, + title = {The use of {TOVS} cloud-cleared radiances in the {NCEP} {SSI} analysis system}, + volume = {126}, + year = {1998}} @inbook{hooke_1986, - Author = {W.H. Hooke}, - Chapter = {Gravity Waves}, - Date-Added = {2018-02-23 17:06:35 +0000}, - Date-Modified = {2018-02-23 17:10:25 +0000}, - Editor = {P. S. Ray}, - Number = {12}, - Pages = {272-288}, - Publisher = {American Meteorological Society}, - Title = {Mesoscale meteorology and forecasting}, - Year = {1986}} + author = {W.H. Hooke}, + chapter = {Gravity Waves}, + date-added = {2018-02-23 17:06:35 +0000}, + date-modified = {2018-02-23 17:10:25 +0000}, + editor = {P. S. Ray}, + number = {12}, + pages = {272-288}, + publisher = {American Meteorological Society}, + title = {Mesoscale meteorology and forecasting}, + year = {1986}} @article{kim_et_al_2003, - Author = {Y.-J. Kim and S. D. Eckermann and H.-Y. Chun}, - Date-Added = {2018-02-23 16:59:17 +0000}, - Date-Modified = {2018-02-23 17:02:12 +0000}, - Journal = {Atmosphere-Ocean}, - Number = {1}, - Pages = {65-98}, - Title = {An overview of the past, present and future of gravity-wave drag parameterization for numerical climate and weather prediction models}, - Volume = {41}, - Year = {2003}} + author = {Y.-J. Kim and S. D. Eckermann and H.-Y. Chun}, + date-added = {2018-02-23 16:59:17 +0000}, + date-modified = {2018-02-23 17:02:12 +0000}, + journal = {Atmosphere-Ocean}, + number = {1}, + pages = {65-98}, + title = {An overview of the past, present and future of gravity-wave drag parameterization for numerical climate and weather prediction models}, + volume = {41}, + year = {2003}} @article{paulson_and_simpson_1981, - Author = {C.A. Paulson and J.J. Simpson}, - Date-Added = {2018-02-21 23:47:11 +0000}, - Date-Modified = {2018-02-21 23:50:29 +0000}, - Journal = {J. Geophys. Res.}, - Number = {C11}, - Pages = {2156-2202}, - Title = {The temperature difference across the cool skin of the ocean}, - Volume = {86}, - Year = {1981}} + author = {C.A. Paulson and J.J. Simpson}, + date-added = {2018-02-21 23:47:11 +0000}, + date-modified = {2018-02-21 23:50:29 +0000}, + journal = {J. Geophys. Res.}, + number = {C11}, + pages = {2156-2202}, + title = {The temperature difference across the cool skin of the ocean}, + volume = {86}, + year = {1981}} @article{peters-lidard_et_al_1997, - Author = {C. D. Peters-Lidard and M. S. Zion and E. F. Wood}, - Date-Added = {2018-02-20 19:44:29 +0000}, - Date-Modified = {2018-02-20 19:46:55 +0000}, - Journal = {J. Geophys. Res.}, - Number = {D4}, - Pages = {4303-4324}, - Title = {A soil-vegetation-atmosphere transfer sheme for modeling spatially variable water and energy balance processes}, - Volume = {102}, - Year = {1997}} + author = {C. D. Peters-Lidard and M. S. Zion and E. F. Wood}, + date-added = {2018-02-20 19:44:29 +0000}, + date-modified = {2018-02-20 19:46:55 +0000}, + journal = {J. Geophys. Res.}, + number = {D4}, + pages = {4303-4324}, + title = {A soil-vegetation-atmosphere transfer sheme for modeling spatially variable water and energy balance processes}, + volume = {102}, + year = {1997}} @article{peters-lidard_et_al_1998, - Author = {C. D. Peters-Lidard and E. Blackburn and X. Liang and E. F. Wood}, - Date-Added = {2018-02-20 19:28:47 +0000}, - Date-Modified = {2018-02-20 19:31:50 +0000}, - Journal = {J. Atmos. Sci.}, - Pages = {1209-1224}, - Title = {The effect of soil thermal conductivity parameterization on surface energy fluxes and temperatures}, - Volume = {55}, - Year = {1998}} + author = {C. D. Peters-Lidard and E. Blackburn and X. Liang and E. F. Wood}, + date-added = {2018-02-20 19:28:47 +0000}, + date-modified = {2018-02-20 19:31:50 +0000}, + journal = {J. Atmos. Sci.}, + pages = {1209-1224}, + title = {The effect of soil thermal conductivity parameterization on surface energy fluxes and temperatures}, + volume = {55}, + year = {1998}} @book{pond_and_pickard_1983, - Author = {S. Pond and G.L. Pickard}, - Date-Added = {2018-02-14 21:57:02 +0000}, - Date-Modified = {2018-02-14 22:00:44 +0000}, - Edition = {2nd}, - Publisher = {Pergamon Press}, - Title = {Introductory dynamical oceanography}, - Year = {1983}} + author = {S. Pond and G.L. Pickard}, + date-added = {2018-02-14 21:57:02 +0000}, + date-modified = {2018-02-14 22:00:44 +0000}, + edition = {2nd}, + publisher = {Pergamon Press}, + title = {Introductory dynamical oceanography}, + year = {1983}} @article{zeng_et_al_1998, - Author = {X. Zeng and M. Zhao and R. E. Dickinson}, - Date-Added = {2018-02-13 23:09:56 +0000}, - Date-Modified = {2018-02-13 23:12:08 +0000}, - Journal = {J. Climate}, - Pages = {2628-2644}, - Title = {Intercomparison of bulk aerodynamic algorithm for the comutation of sea surface Fluxes using {TOGA} {COARE} and {TAO} data}, - Volume = {11}, - Year = {1998}} + author = {X. Zeng and M. Zhao and R. E. Dickinson}, + date-added = {2018-02-13 23:09:56 +0000}, + date-modified = {2018-02-13 23:12:08 +0000}, + journal = {J. Climate}, + pages = {2628-2644}, + title = {Intercomparison of bulk aerodynamic algorithm for the comutation of sea surface Fluxes using {TOGA} {COARE} and {TAO} data}, + volume = {11}, + year = {1998}} @article{dorman_and_sellers_1989, - Author = {J. L. Dorman and P. J. Sellers}, - Date-Added = {2018-01-31 23:58:04 +0000}, - Date-Modified = {2018-02-01 00:02:39 +0000}, - Journal = {Journal of Applied Meteorology}, - Pages = {833-855}, - Title = {A global climatology of albedo, roughness length and stomatal resistance for atmospheric general circulation models as represented by the simple biosphere model ({S}i{B})}, - Volume = {28}, - Year = {1989}} + author = {J. L. Dorman and P. J. Sellers}, + date-added = {2018-01-31 23:58:04 +0000}, + date-modified = {2018-02-01 00:02:39 +0000}, + journal = {Journal of Applied Meteorology}, + pages = {833-855}, + title = {A global climatology of albedo, roughness length and stomatal resistance for atmospheric general circulation models as represented by the simple biosphere model ({S}i{B})}, + volume = {28}, + year = {1989}} @misc{zobler_1999, - Author = {Oak Ridge National Laboratory Distributed Active Archive Center}, - Date-Added = {2018-01-31 23:52:28 +0000}, - Date-Modified = {2018-01-31 23:56:02 +0000}, - Howpublished = {Available on-line [http://www.daac.ornl.gov]}, - Month = {1999}, - Title = {Global soil types, 1-Degree Grid ({Z}obler). Dataset}} + author = {Oak Ridge National Laboratory Distributed Active Archive Center}, + date-added = {2018-01-31 23:52:28 +0000}, + date-modified = {2018-01-31 23:56:02 +0000}, + howpublished = {Available on-line [http://www.daac.ornl.gov]}, + month = {1999}, + title = {Global soil types, 1-Degree Grid ({Z}obler). Dataset}} @techreport{zobler_1986, - Address = {New York, New York, USA}, - Author = {L. Zobler}, - Date-Added = {2018-01-31 23:47:42 +0000}, - Date-Modified = {2018-01-31 23:57:41 +0000}, - Institution = {NASA Goddard Institute for Space Studies}, - Number = {NASA Technical Memorandum 87802}, - Title = {A world soil file for global climate modelling}, - Year = {1986}} + address = {New York, New York, USA}, + author = {L. Zobler}, + date-added = {2018-01-31 23:47:42 +0000}, + date-modified = {2018-01-31 23:57:41 +0000}, + institution = {NASA Goddard Institute for Space Studies}, + number = {NASA Technical Memorandum 87802}, + title = {A world soil file for global climate modelling}, + year = {1986}} @article{hirsch_et_al_2015, - Author = {A. L. Hirsch and A. J. Pitman and J. Kala and R. Lorenz and M. G. Donat}, - Date-Added = {2018-01-31 23:30:18 +0000}, - Date-Modified = {2018-01-31 23:32:47 +0000}, - Journal = {Earth Interactions}, - Number = {12}, - Pages = {1-24}, - Title = {Modulation of land-use change impacts on temperature extremes via land-atmosphere coupling over {A}ustralia}, - Volume = {19}, - Year = {2015}} + author = {A. L. Hirsch and A. J. Pitman and J. Kala and R. Lorenz and M. G. Donat}, + date-added = {2018-01-31 23:30:18 +0000}, + date-modified = {2018-01-31 23:32:47 +0000}, + journal = {Earth Interactions}, + number = {12}, + pages = {1-24}, + title = {Modulation of land-use change impacts on temperature extremes via land-atmosphere coupling over {A}ustralia}, + volume = {19}, + year = {2015}} @article{findell_et_al_2017, - Author = {K. L. Findell and A. Berg and P. Gentine and J. P. Krasting and B. R. Lintner and S. Malyshev and J. A. Santanello and Jr. Shevliakova and E. Shevliakova}, - Date-Added = {2018-01-31 23:23:37 +0000}, - Date-Modified = {2018-01-31 23:27:28 +0000}, - Journal = {Nature Communications}, - Number = {989}, - Title = {The impact of anthropogenic land use and land cover change on regional climate extremes}, - Volume = {8}, - Year = {2017}} + author = {K. L. Findell and A. Berg and P. Gentine and J. P. Krasting and B. R. Lintner and S. Malyshev and J. A. Santanello and Jr. Shevliakova and E. Shevliakova}, + date-added = {2018-01-31 23:23:37 +0000}, + date-modified = {2018-01-31 23:27:28 +0000}, + journal = {Nature Communications}, + number = {989}, + title = {The impact of anthropogenic land use and land cover change on regional climate extremes}, + volume = {8}, + year = {2017}} @article{koster_et_al_2014, - Author = {R. D. Koster and Y. Chang and S. D. Schubert}, - Date-Added = {2018-01-31 23:14:32 +0000}, - Date-Modified = {2018-01-31 23:18:15 +0000}, - Journal = {J. Climate}, - Pages = {9290-9301}, - Title = {A mechanism for land-atmosphere feedback involving planetary wave structures}, - Volume = {27}, - Year = {2014}} + author = {R. D. Koster and Y. Chang and S. D. Schubert}, + date-added = {2018-01-31 23:14:32 +0000}, + date-modified = {2018-01-31 23:18:15 +0000}, + journal = {J. Climate}, + pages = {9290-9301}, + title = {A mechanism for land-atmosphere feedback involving planetary wave structures}, + volume = {27}, + year = {2014}} @article{hsu_et_al_2017, - Author = {H. Hsu and M.-H. Lo and B. P. Guillod and D. G. Miralles and S. Kumar}, - Date-Added = {2018-01-31 23:06:25 +0000}, - Date-Modified = {2018-01-31 23:12:23 +0000}, - Journal = {J. Geophys. Res. Atmos.}, - Pages = {6319-6328}, - Title = {Relation between precipitation location and antecedent/subsequent soil moisture spatial patterns}, - Volume = {122}, - Year = {2017}} + author = {H. Hsu and M.-H. Lo and B. P. Guillod and D. G. Miralles and S. Kumar}, + date-added = {2018-01-31 23:06:25 +0000}, + date-modified = {2018-01-31 23:12:23 +0000}, + journal = {J. Geophys. Res. Atmos.}, + pages = {6319-6328}, + title = {Relation between precipitation location and antecedent/subsequent soil moisture spatial patterns}, + volume = {122}, + year = {2017}} @article{andersen_and_shepherd_2014, - Author = {T. K. Andersen and J. M. Shepherd}, - Date-Added = {2018-01-31 22:57:14 +0000}, - Date-Modified = {2018-01-31 23:04:07 +0000}, - Journal = {International Journal of Climatology}, - Pages = {391-402}, - Title = {A global spatiotemporal analysis of inland tropical cyclone maintenance or intensification}, - Volume = {34}, - Year = {2014}} + author = {T. K. Andersen and J. M. Shepherd}, + date-added = {2018-01-31 22:57:14 +0000}, + date-modified = {2018-01-31 23:04:07 +0000}, + journal = {International Journal of Climatology}, + pages = {391-402}, + title = {A global spatiotemporal analysis of inland tropical cyclone maintenance or intensification}, + volume = {34}, + year = {2014}} @article{guillod_et_al_2015, - Author = {B. P. Guillod and B. Orlowsky and D. G. Miralles and A. J. Teuling and S. I. Seneviratne}, - Date-Added = {2018-01-31 22:46:31 +0000}, - Date-Modified = {2018-01-31 22:55:08 +0000}, - Journal = {Nature Communications}, - Number = {6443}, - Title = {Reconciling spatial and temporal soil moisture effects on afternoon rainfall}, - Volume = {6}, - Year = {2015}} + author = {B. P. Guillod and B. Orlowsky and D. G. Miralles and A. J. Teuling and S. I. Seneviratne}, + date-added = {2018-01-31 22:46:31 +0000}, + date-modified = {2018-01-31 22:55:08 +0000}, + journal = {Nature Communications}, + number = {6443}, + title = {Reconciling spatial and temporal soil moisture effects on afternoon rainfall}, + volume = {6}, + year = {2015}} @article{milovac_et_al_2016, - Author = {J. Milovac and K. Warrach-Sagi and A. Behrendt and F. Spath and J. Ingwersen and V. Wulfmeryer}, - Date-Added = {2018-01-31 22:35:04 +0000}, - Date-Modified = {2018-01-31 22:43:31 +0000}, - Journal = {J. Geophys. Res. Atmos.}, - Pages = {624-649}, - Title = {Investigation of {PBL} schemes combining the {WRF} model simulations with scanning waver vapor differential absorption lidar measurements}, - Volume = {121}, - Year = {2016}} + author = {J. Milovac and K. Warrach-Sagi and A. Behrendt and F. Spath and J. Ingwersen and V. Wulfmeryer}, + date-added = {2018-01-31 22:35:04 +0000}, + date-modified = {2018-01-31 22:43:31 +0000}, + journal = {J. Geophys. Res. Atmos.}, + pages = {624-649}, + title = {Investigation of {PBL} schemes combining the {WRF} model simulations with scanning waver vapor differential absorption lidar measurements}, + volume = {121}, + year = {2016}} @article{paimazumder_and_done_2016, - Author = {D. PaiMazumder and J. M. Done}, - Date-Added = {2018-01-31 22:30:34 +0000}, - Date-Modified = {2018-01-31 22:33:52 +0000}, - Journal = {J. Geophys. Res. Atmos.}, - Pages = {12581-12592}, - Title = {Potential predictability sources of the 2012 {U.S.} drought in observations and a regional model ensemble}, - Volume = {121}, - Year = {2016}} + author = {D. PaiMazumder and J. M. Done}, + date-added = {2018-01-31 22:30:34 +0000}, + date-modified = {2018-01-31 22:33:52 +0000}, + journal = {J. Geophys. Res. Atmos.}, + pages = {12581-12592}, + title = {Potential predictability sources of the 2012 {U.S.} drought in observations and a regional model ensemble}, + volume = {121}, + year = {2016}} @article{betts_et_al_2017, - Author = {A. K. Betts and A. B. Tawfik and R. L. Desjardins}, - Date-Added = {2018-01-31 18:31:50 +0000}, - Date-Modified = {2018-01-31 18:35:17 +0000}, - Journal = {J. Hydrometeorol.}, - Number = {939-955}, - Title = {Revisiting hydrometeorology using cloud and climate observations}, - Volume = {18}, - Year = {2017}} + author = {A. K. Betts and A. B. Tawfik and R. L. Desjardins}, + date-added = {2018-01-31 18:31:50 +0000}, + date-modified = {2018-01-31 18:35:17 +0000}, + journal = {J. Hydrometeorol.}, + number = {939-955}, + title = {Revisiting hydrometeorology using cloud and climate observations}, + volume = {18}, + year = {2017}} @article{ek_and_holtslag_2004, - Author = {M. B. Ek and A. A. M. Holtslag}, - Date-Added = {2018-01-31 17:43:57 +0000}, - Date-Modified = {2018-01-31 17:47:18 +0000}, - Journal = {J. Hydrometeorol.}, - Pages = {86-99}, - Title = {Influence of soil moisture on boundary layer cloud development}, - Volume = {5}, - Year = {2004}} + author = {M. B. Ek and A. A. M. Holtslag}, + date-added = {2018-01-31 17:43:57 +0000}, + date-modified = {2018-01-31 17:47:18 +0000}, + journal = {J. Hydrometeorol.}, + pages = {86-99}, + title = {Influence of soil moisture on boundary layer cloud development}, + volume = {5}, + year = {2004}} @article{ek_and_mahrt_1994, - Author = {M. B. Ek and L. Mahrt}, - Date-Added = {2018-01-31 17:41:59 +0000}, - Date-Modified = {2018-01-31 17:43:53 +0000}, - Journal = {Monthly Weather Review}, - Pages = {2709-2721}, - Title = {Daytime evolution of relative-humidity at the boundary-layer top}, - Volume = {122}, - Year = {1994}} + author = {M. B. Ek and L. Mahrt}, + date-added = {2018-01-31 17:41:59 +0000}, + date-modified = {2018-01-31 17:43:53 +0000}, + journal = {Monthly Weather Review}, + pages = {2709-2721}, + title = {Daytime evolution of relative-humidity at the boundary-layer top}, + volume = {122}, + year = {1994}} @article{zheng_et_al_2012, - Author = {W. Zheng and H. Wei and Z. Wang and X. Zeng and J. Meng and M. Ek and K. Mitchell and J. Derber}, - Date-Added = {2018-01-29 23:48:13 +0000}, - Date-Modified = {2018-01-29 23:51:19 +0000}, - Journal = {J. Geophys. Res.}, - Number = {D06117}, - Title = {Improvement of daytime land surface skin temperature over arid regions in the {NCEP} {GFS} model and its impact on satellite data assimilation}, - Volume = {117}, - Year = {2012}} + author = {W. Zheng and H. Wei and Z. Wang and X. Zeng and J. Meng and M. Ek and K. Mitchell and J. Derber}, + date-added = {2018-01-29 23:48:13 +0000}, + date-modified = {2018-01-29 23:51:19 +0000}, + journal = {J. Geophys. Res.}, + number = {D06117}, + title = {Improvement of daytime land surface skin temperature over arid regions in the {NCEP} {GFS} model and its impact on satellite data assimilation}, + volume = {117}, + year = {2012}} @article{zeng_and_dickinson_1998, - Author = {X. Zeng and R. E. Dickinson}, - Date-Added = {2018-01-29 23:46:03 +0000}, - Date-Modified = {2018-01-29 23:47:43 +0000}, - Journal = {J. Climate}, - Pages = {537-550}, - Title = {Effect of surface sublayer on surface skin temperature and fluxes}, - Volume = {11}, - Year = {1998}} + author = {X. Zeng and R. E. Dickinson}, + date-added = {2018-01-29 23:46:03 +0000}, + date-modified = {2018-01-29 23:47:43 +0000}, + journal = {J. Climate}, + pages = {537-550}, + title = {Effect of surface sublayer on surface skin temperature and fluxes}, + volume = {11}, + year = {1998}} @conference{zheng_et_al_2009, - Address = {Omaha, Nebraska}, - Author = {W. Zheng and H. Wei and J. Meng and M. Ek and K. Mitchell and J. Derber and X. Zeng and Z. Wang}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBWLi4vLi4vLi4vLi4vLi4vRGVza3RvcC9OT0FIX0xTTS9JbXByb3ZlbWVudF9vZl9MYW5kX1N1cmZhY2VfU2tpbl9UZW1wZXJhdHVyZV9pbl9OQy5wZGZPEQIgAAAAAAIgAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADT4djXSCsAAANl5rUfSW1wcm92ZW1lbnRfb2ZfTGFuZCMzNjVGRjBGLnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA2X/D9aQ780AAAAAAAAAAAAFAAMAAAkgAAAAAAAAAAAAAAAAAAAACE5PQUhfTFNNABAACAAA0+ItNwAAABEACAAA1pFSPQAAAAEAEANl5rUAD8YgAA/GDwAGL94AAgBRTWFjaW50b3NoIEhEOlVzZXJzOgBtYW4uemhhbmc6AERlc2t0b3A6AE5PQUhfTFNNOgBJbXByb3ZlbWVudF9vZl9MYW5kIzM2NUZGMEYucGRmAAAOAG4ANgBJAG0AcAByAG8AdgBlAG0AZQBuAHQAXwBvAGYAXwBMAGEAbgBkAF8AUwB1AHIAZgBhAGMAZQBfAFMAawBpAG4AXwBUAGUAbQBwAGUAcgBhAHQAdQByAGUAXwBpAG4AXwBOAEMALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAFdVc2Vycy9tYW4uemhhbmcvRGVza3RvcC9OT0FIX0xTTS9JbXByb3ZlbWVudF9vZl9MYW5kX1N1cmZhY2VfU2tpbl9UZW1wZXJhdHVyZV9pbl9OQy5wZGYAABMAAS8AABUAAgAQ//8AAAAIAA0AGgAkAH0AAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACoQ==}, - Date-Added = {2018-01-26 22:19:06 +0000}, - Date-Modified = {2018-01-29 23:51:37 +0000}, - Organization = {The 23rd Conference on Weather Analysis and Forecasting ({WAF})/19th Conference on Numerical Weather Prediction({NWP})}, - Title = {Improvement of land surface skin temperature in {NCEP} Operational {NWP} models and its impact on satellite Data Assimilation}, - Year = {2009}} + address = {Omaha, Nebraska}, + author = {W. Zheng and H. Wei and J. Meng and M. Ek and K. Mitchell and J. Derber and X. Zeng and Z. Wang}, + date-added = {2018-01-26 22:19:06 +0000}, + date-modified = {2018-01-29 23:51:37 +0000}, + organization = {The 23rd Conference on Weather Analysis and Forecasting ({WAF})/19th Conference on Numerical Weather Prediction({NWP})}, + title = {Improvement of land surface skin temperature in {NCEP} Operational {NWP} models and its impact on satellite Data Assimilation}, + year = {2009}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBWLi4vLi4vLi4vLi4vLi4vRGVza3RvcC9OT0FIX0xTTS9JbXByb3ZlbWVudF9vZl9MYW5kX1N1cmZhY2VfU2tpbl9UZW1wZXJhdHVyZV9pbl9OQy5wZGZPEQIgAAAAAAIgAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADT4djXSCsAAANl5rUfSW1wcm92ZW1lbnRfb2ZfTGFuZCMzNjVGRjBGLnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAA2X/D9aQ780AAAAAAAAAAAAFAAMAAAkgAAAAAAAAAAAAAAAAAAAACE5PQUhfTFNNABAACAAA0+ItNwAAABEACAAA1pFSPQAAAAEAEANl5rUAD8YgAA/GDwAGL94AAgBRTWFjaW50b3NoIEhEOlVzZXJzOgBtYW4uemhhbmc6AERlc2t0b3A6AE5PQUhfTFNNOgBJbXByb3ZlbWVudF9vZl9MYW5kIzM2NUZGMEYucGRmAAAOAG4ANgBJAG0AcAByAG8AdgBlAG0AZQBuAHQAXwBvAGYAXwBMAGEAbgBkAF8AUwB1AHIAZgBhAGMAZQBfAFMAawBpAG4AXwBUAGUAbQBwAGUAcgBhAHQAdQByAGUAXwBpAG4AXwBOAEMALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAFdVc2Vycy9tYW4uemhhbmcvRGVza3RvcC9OT0FIX0xTTS9JbXByb3ZlbWVudF9vZl9MYW5kX1N1cmZhY2VfU2tpbl9UZW1wZXJhdHVyZV9pbl9OQy5wZGYAABMAAS8AABUAAgAQ//8AAAAIAA0AGgAkAH0AAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACoQ==}} @article{chen_et_al_1997, - Author = {F. Chen and Z. Janjic and K. Mitchell}, - Date-Added = {2018-01-25 03:23:50 +0000}, - Date-Modified = {2018-01-25 03:26:47 +0000}, - Journal = {Boundary-Layer Meteorology}, - Number = {3}, - Pages = {391-421}, - Title = {Impact of atmospheric surface-layer parameterizations in the new land-surface scheme of the {NCEP} mesoscale {E}ta model}, - Volume = {85}, - Year = {1997}} + author = {F. Chen and Z. Janjic and K. Mitchell}, + date-added = {2018-01-25 03:23:50 +0000}, + date-modified = {2018-01-25 03:26:47 +0000}, + journal = {Boundary-Layer Meteorology}, + number = {3}, + pages = {391-421}, + title = {Impact of atmospheric surface-layer parameterizations in the new land-surface scheme of the {NCEP} mesoscale {E}ta model}, + volume = {85}, + year = {1997}} @article{winton_2000, - Author = {M. Winton}, - Date-Added = {2018-01-24 21:34:39 +0000}, - Date-Modified = {2018-01-24 21:41:05 +0000}, - Journal = {J. Atmos. Oceanic Tech.}, - Pages = {525-531}, - Title = {A reformulated three-layer sea ice model}, - Volume = {17}, - Year = {2000}} + author = {M. Winton}, + date-added = {2018-01-24 21:34:39 +0000}, + date-modified = {2018-01-24 21:41:05 +0000}, + journal = {J. Atmos. Oceanic Tech.}, + pages = {525-531}, + title = {A reformulated three-layer sea ice model}, + volume = {17}, + year = {2000}} @phdthesis{Lim_2011, - Address = {Seoul, South Korea}, - Author = {K.-S. S. Lim}, - Date-Added = {2018-01-24 18:58:17 +0000}, - Date-Modified = {2018-01-24 18:59:50 +0000}, - School = {Yonsei University}, - Title = {Investigation of aerosol indirect effects on simulated moist convections.}, - Year = {2011}} + address = {Seoul, South Korea}, + author = {K.-S. S. Lim}, + date-added = {2018-01-24 18:58:17 +0000}, + date-modified = {2018-01-24 18:59:50 +0000}, + school = {Yonsei University}, + title = {Investigation of aerosol indirect effects on simulated moist convections.}, + year = {2011}} @article{arakawa_and_wu_2013, - Author = {A. Arakawa and C.-M. Wu}, - Date-Added = {2018-01-24 18:54:08 +0000}, - Date-Modified = {2018-01-24 18:57:10 +0000}, - Journal = {J. Atmos. Sci.}, - Pages = {1977-1992}, - Title = {A unified representation of deep moist convection in numerical modeling of the atmosphere. {P}art {I}}, - Volume = {70}, - Year = {2013}} + author = {A. Arakawa and C.-M. Wu}, + date-added = {2018-01-24 18:54:08 +0000}, + date-modified = {2018-01-24 18:57:10 +0000}, + journal = {J. Atmos. Sci.}, + pages = {1977-1992}, + title = {A unified representation of deep moist convection in numerical modeling of the atmosphere. {P}art {I}}, + volume = {70}, + year = {2013}} @article{han_et_al_2017, - Author = {J. Han and W. Wang and Y. C. Kwon and S.-Y. Hong and V. Tallapragada and F. Yang}, - Date-Added = {2018-01-24 18:48:52 +0000}, - Date-Modified = {2018-01-24 18:53:21 +0000}, - Journal = {Weather and Forecasting}, - Pages = {2005-2017}, - Title = {Updates in the {NCEP} {GFS} cumulus convective schemes with scale and aerosol awareness}, - Volume = {32}, - Year = {2017}} + author = {J. Han and W. Wang and Y. C. Kwon and S.-Y. Hong and V. Tallapragada and F. Yang}, + date-added = {2018-01-24 18:48:52 +0000}, + date-modified = {2018-01-24 18:53:21 +0000}, + journal = {Weather and Forecasting}, + pages = {2005-2017}, + title = {Updates in the {NCEP} {GFS} cumulus convective schemes with scale and aerosol awareness}, + volume = {32}, + year = {2017}} @article{grell_and_freitas_2014, - Author = {G. A. Grell and S. R. Freitas}, - Date-Added = {2018-01-24 18:44:56 +0000}, - Date-Modified = {2018-01-24 18:47:21 +0000}, - Journal = {Atmos. Chem. Phys.}, - Pages = {5233-5250}, - Title = {A scale and aerosol aware stochastic convective parameterization for weather and air quality modeling}, - Volume = {14}, - Year = {2014}} + author = {G. A. Grell and S. R. Freitas}, + date-added = {2018-01-24 18:44:56 +0000}, + date-modified = {2018-01-24 18:47:21 +0000}, + journal = {Atmos. Chem. Phys.}, + pages = {5233-5250}, + title = {A scale and aerosol aware stochastic convective parameterization for weather and air quality modeling}, + volume = {14}, + year = {2014}} @article{Koren_et_al_1999, - Author = {V. Koren and J. Schaake and K. Mitchell and Q.-Y. Duan and F. Chen and J. Baker}, - Date-Added = {2018-01-24 18:41:34 +0000}, - Date-Modified = {2018-01-24 18:43:55 +0000}, - Journal = {J. Geophys. Res.}, - Number = {D16}, - Pages = {19569-19585}, - Title = {A parameterization of snowpack and frozen ground intended for {NCEP} weather and climate models}, - Volume = {104}, - Year = {1999}} + author = {V. Koren and J. Schaake and K. Mitchell and Q.-Y. Duan and F. Chen and J. Baker}, + date-added = {2018-01-24 18:41:34 +0000}, + date-modified = {2018-01-24 18:43:55 +0000}, + journal = {J. Geophys. Res.}, + number = {D16}, + pages = {19569-19585}, + title = {A parameterization of snowpack and frozen ground intended for {NCEP} weather and climate models}, + volume = {104}, + year = {1999}} @article{ek_et_al_2003, - Author = {M. B. Ek and K. E. Mitchell and Y. Lin and E. Rogers and P. Grunmann and V. Koren and G. Gayno and J. D. Tarpley}, - Date-Added = {2018-01-24 18:35:48 +0000}, - Date-Modified = {2018-01-24 18:39:48 +0000}, - Journal = {J. Geophys. Res.}, - Number = {D22}, - Pages = {8851}, - Title = {Implementation of {N}oah land-surface model advances in the {NCEP} operational mesoscale {E}ta model}, - Volume = {108}, - Year = {2003}} + author = {M. B. Ek and K. E. Mitchell and Y. Lin and E. Rogers and P. Grunmann and V. Koren and G. Gayno and J. D. Tarpley}, + date-added = {2018-01-24 18:35:48 +0000}, + date-modified = {2018-01-24 18:39:48 +0000}, + journal = {J. Geophys. Res.}, + number = {D22}, + pages = {8851}, + title = {Implementation of {N}oah land-surface model advances in the {NCEP} operational mesoscale {E}ta model}, + volume = {108}, + year = {2003}} @article{chen_et_al_1996, - Author = {F. Chen and K. Mitchell and J. Schaake and Y. Xue and H.-L. Pan and V. Koren and Q.-Y. Duan and M. Ek and A. Betts}, - Date-Added = {2018-01-24 18:31:48 +0000}, - Date-Modified = {2018-01-24 18:35:18 +0000}, - Journal = {J. Geophys. Res.}, - Number = {D3}, - Pages = {7251-7268}, - Title = {Modeling of land-surface evaporation by four schemes and comparison with observations}, - Volume = {101}, - Year = {1996}} + author = {F. Chen and K. Mitchell and J. Schaake and Y. Xue and H.-L. Pan and V. Koren and Q.-Y. Duan and M. Ek and A. Betts}, + date-added = {2018-01-24 18:31:48 +0000}, + date-modified = {2018-01-24 18:35:18 +0000}, + journal = {J. Geophys. Res.}, + number = {D3}, + pages = {7251-7268}, + title = {Modeling of land-surface evaporation by four schemes and comparison with observations}, + volume = {101}, + year = {1996}} @article{raisanen_and_barker_2004, - Author = {P. Raisanen and H.W. Barker}, - Date-Added = {2016-10-11 20:51:22 +0000}, - Date-Modified = {2016-10-11 20:53:35 +0000}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Pages = {2069-2085}, - Title = {Evaluation and optimization of sampling errors for the {M}onte {C}arlo {I}ndependent {C}olumn {A}pproximation}, - Volume = {130}, - Year = {2004}} + author = {P. Raisanen and H.W. Barker}, + date-added = {2016-10-11 20:51:22 +0000}, + date-modified = {2016-10-11 20:53:35 +0000}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + pages = {2069-2085}, + title = {Evaluation and optimization of sampling errors for the {M}onte {C}arlo {I}ndependent {C}olumn {A}pproximation}, + volume = {130}, + year = {2004}} @article{pincus_et_al_2003, - Annote = {DOI: 10.1029/2002JD003322}, - Author = {R. Pincus and H.W. Barker and J.-J. Morcrette}, - Date-Added = {2016-10-11 20:43:58 +0000}, - Date-Modified = {2016-10-11 20:49:03 +0000}, - Journal = {J. Geophys. Res.}, - Rss-Description = {DOI: 10.1029/2002JD003322}, - Title = {A fast, flexible, approximate technique for computing radiative transfer in inhomogeneous cloud fields}, - Volume = {108}, - Year = {2003}} + annote = {DOI: 10.1029/2002JD003322}, + author = {R. Pincus and H.W. Barker and J.-J. Morcrette}, + date-added = {2016-10-11 20:43:58 +0000}, + date-modified = {2016-10-11 20:49:03 +0000}, + journal = {J. Geophys. Res.}, + rss-description = {DOI: 10.1029/2002JD003322}, + title = {A fast, flexible, approximate technique for computing radiative transfer in inhomogeneous cloud fields}, + volume = {108}, + year = {2003}} @article{barker_et_al_2015, - Author = {H.W. Barker and J.N.S. Cole and J. Li and B. Yi and P. Yang}, - Date-Added = {2016-10-11 20:41:36 +0000}, - Date-Modified = {2016-10-11 20:43:49 +0000}, - Journal = {J. Atmos. Sci.}, - Pages = {4053-4074}, - Title = {Estimation of errors in two-stream approximations of the solar radiative transfer equation for cloudy-sky conditions}, - Volume = {72}, - Year = {2015}} + author = {H.W. Barker and J.N.S. Cole and J. Li and B. Yi and P. Yang}, + date-added = {2016-10-11 20:41:36 +0000}, + date-modified = {2016-10-11 20:43:49 +0000}, + journal = {J. Atmos. Sci.}, + pages = {4053-4074}, + title = {Estimation of errors in two-stream approximations of the solar radiative transfer equation for cloudy-sky conditions}, + volume = {72}, + year = {2015}} @article{raisanen_2002, - Author = {P. Raisanen}, - Date-Added = {2016-10-11 20:39:27 +0000}, - Date-Modified = {2016-10-11 20:41:23 +0000}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Pages = {2397-2416}, - Title = {Two-stream approximations revisited: A new improvement and tests with {GCM} data}, - Volume = {128}, - Year = {2002}} + author = {P. Raisanen}, + date-added = {2016-10-11 20:39:27 +0000}, + date-modified = {2016-10-11 20:41:23 +0000}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + pages = {2397-2416}, + title = {Two-stream approximations revisited: A new improvement and tests with {GCM} data}, + volume = {128}, + year = {2002}} @article{king_and_harshvardhan_1986, - Author = {M.D. King and Harshvardhan}, - Date-Added = {2016-10-11 20:33:56 +0000}, - Date-Modified = {2016-10-11 20:37:59 +0000}, - Journal = {J. Atmos. Sci.}, - Pages = {784-801}, - Title = {Comparative accuracy of selected multiple scattering approximations}, - Volume = {43}, - Year = {1986}} + author = {M.D. King and Harshvardhan}, + date-added = {2016-10-11 20:33:56 +0000}, + date-modified = {2016-10-11 20:37:59 +0000}, + journal = {J. Atmos. Sci.}, + pages = {784-801}, + title = {Comparative accuracy of selected multiple scattering approximations}, + volume = {43}, + year = {1986}} @url{Li_2015, - Author = {X. Li}, - Title = {The development of the NSST within the NCEP GFS/CFS}, - Url = {http://cpo.noaa.gov/sites/cpo/MAPP/workshops/rtf_technical_ws/presentations/21_Xu_Li.pdf}, - Bdsk-Url-1 = {http://cpo.noaa.gov/sites/cpo/MAPP/workshops/rtf_technical_ws/presentations/21_Xu_Li.pdf}} + author = {X. Li}, + title = {The development of the NSST within the NCEP GFS/CFS}, + url = {http://cpo.noaa.gov/sites/cpo/MAPP/workshops/rtf_technical_ws/presentations/21_Xu_Li.pdf}, + bdsk-url-1 = {http://cpo.noaa.gov/sites/cpo/MAPP/workshops/rtf_technical_ws/presentations/21_Xu_Li.pdf}} @webpage{li_and_derber_2009, - Author = {X. Li and J. Derber}, - Date-Modified = {2020-02-24 17:06:35 +0000}, - Title = {Near Sea Surface Temperatures (NSST) Analysis in NCEP GFS}, - Url = {http://data.jcsda.org/Workshops/6th-workshop-onDA/Session-4/JCSDA_2008_Li.pdf}, - Bdsk-Url-1 = {https://www.jcsda.noaa.gov/documents/meetings/wkshp2008/4/JCSDA_2008_Li.pdf}} + author = {X. Li and J. Derber}, + date-modified = {2020-02-24 17:06:35 +0000}, + title = {Near Sea Surface Temperatures (NSST) Analysis in NCEP GFS}, + url = {http://data.jcsda.org/Workshops/6th-workshop-onDA/Session-4/JCSDA_2008_Li.pdf}, + bdsk-url-1 = {https://www.jcsda.noaa.gov/documents/meetings/wkshp2008/4/JCSDA_2008_Li.pdf}} @article{Fairall_et_al_1996, - Author = {C. W. Fairall and E. F. Bradley and J. S. Godfrey and G. A. Wick and J. B. Edson and G. S. Young}, - Date-Modified = {2018-02-21 22:01:48 +0000}, - Journal = {J. Geophys. Res.}, - Pages = {1295-1308}, - Title = {Cool-skin and warm-layer effects on sea surface temperature}, - Volume = {101(C1)}, - Year = {1996}} + author = {C. W. Fairall and E. F. Bradley and J. S. Godfrey and G. A. Wick and J. B. Edson and G. S. Young}, + date-modified = {2018-02-21 22:01:48 +0000}, + journal = {J. Geophys. Res.}, + pages = {1295-1308}, + title = {Cool-skin and warm-layer effects on sea surface temperature}, + volume = {101(C1)}, + year = {1996}} @url{key_2002, - Address = {Madison, Wisconsin}, - Author = {J.R. Key}, - Date-Added = {2016-10-05 15:09:28 +0000}, - Date-Modified = {2016-10-05 15:12:26 +0000}, - Organization = {Cooptical. NOAA/NESDIS}, - Title = {Streamer User's Guide}, - Urldate = {https://stratus.ssec.wisc.edu/streamer/userman.pdf)}} + address = {Madison, Wisconsin}, + author = {J.R. Key}, + date-added = {2016-10-05 15:09:28 +0000}, + date-modified = {2016-10-05 15:12:26 +0000}, + organization = {Cooptical. NOAA/NESDIS}, + title = {Streamer User's Guide}, + urldate = {https://stratus.ssec.wisc.edu/streamer/userman.pdf)}} @article{fu_et_al_1998, - Author = {Q. Fu and P. Yang and W. B. Sun}, - Date-Added = {2016-06-21 19:58:59 +0000}, - Date-Modified = {2016-06-21 20:00:51 +0000}, - Journal = {J. Climate}, - Pages = {2223-2237}, - Title = {An accurate parameterization of the infrared radiative properties of cirrus clouds for climate models}, - Volume = {11}, - Year = {1998}} + author = {Q. Fu and P. Yang and W. B. Sun}, + date-added = {2016-06-21 19:58:59 +0000}, + date-modified = {2016-06-21 20:00:51 +0000}, + journal = {J. Climate}, + pages = {2223-2237}, + title = {An accurate parameterization of the infrared radiative properties of cirrus clouds for climate models}, + volume = {11}, + year = {1998}} @techreport{key_2001, - Author = {J. Key}, - Date-Added = {2016-06-21 17:33:34 +0000}, - Date-Modified = {2016-06-21 17:41:46 +0000}, - Institution = {Cooperative Institute for Meteorological Satellite Studies, University of Wisconsin}, - Number = {96pp}, - Title = {Streamer User's Guide}, - Year = {2001}} + author = {J. Key}, + date-added = {2016-06-21 17:33:34 +0000}, + date-modified = {2016-06-21 17:41:46 +0000}, + institution = {Cooperative Institute for Meteorological Satellite Studies, University of Wisconsin}, + number = {96pp}, + title = {Streamer User's Guide}, + year = {2001}} @article{liou_1973, - Author = {K. N. Liou}, - Date-Added = {2016-06-21 17:20:02 +0000}, - Date-Modified = {2016-06-21 17:22:03 +0000}, - Journal = {Journal of the Atmospheric Sciences}, - Pages = {1303-1326}, - Title = {A numerical experiment on {C}handrasekhar's discrete-ordinate method for radiative transfer: Applications to cloudy and hazy atmospheres}, - Volume = {30}, - Year = {1973}} + author = {K. N. Liou}, + date-added = {2016-06-21 17:20:02 +0000}, + date-modified = {2016-06-21 17:22:03 +0000}, + journal = {Journal of the Atmospheric Sciences}, + pages = {1303-1326}, + title = {A numerical experiment on {C}handrasekhar's discrete-ordinate method for radiative transfer: Applications to cloudy and hazy atmospheres}, + volume = {30}, + year = {1973}} @article{zdunkowski_et_al_1980, - Author = {W. G. Zdunkowski and R. M. Welch and G. Korb}, - Date-Added = {2016-06-21 16:52:12 +0000}, - Date-Modified = {2016-06-21 16:55:04 +0000}, - Journal = {Beitr. Phys. Atmos.}, - Pages = {147-166}, - Title = {An investigation of the structure of typical two-stream methods for the calculation of solar fluxes and heating rates in clouds}, - Volume = {53}, - Year = {1980}} + author = {W. G. Zdunkowski and R. M. Welch and G. Korb}, + date-added = {2016-06-21 16:52:12 +0000}, + date-modified = {2016-06-21 16:55:04 +0000}, + journal = {Beitr. Phys. Atmos.}, + pages = {147-166}, + title = {An investigation of the structure of typical two-stream methods for the calculation of solar fluxes and heating rates in clouds}, + volume = {53}, + year = {1980}} @article{joseph_et_al_1976, - Author = {J. H. Joseph and W. J. Wiscombe and J. A. Weinman}, - Date-Added = {2016-06-21 16:48:05 +0000}, - Date-Modified = {2016-06-21 16:50:31 +0000}, - Journal = {Journal of the Atmospheric Sciences}, - Pages = {2452-2459}, - Title = {The {D}elta-{E}ddington approximation for radiative flux transfer}, - Volume = {33}, - Year = {1976}} + author = {J. H. Joseph and W. J. Wiscombe and J. A. Weinman}, + date-added = {2016-06-21 16:48:05 +0000}, + date-modified = {2016-06-21 16:50:31 +0000}, + journal = {Journal of the Atmospheric Sciences}, + pages = {2452-2459}, + title = {The {D}elta-{E}ddington approximation for radiative flux transfer}, + volume = {33}, + year = {1976}} @article{iacono_et_al_2008, - Annote = {doi:10.1029/2008JD009944}, - Author = {M. J. Iacono and J. S. Delamere and E. J. Mlawer and M. W. Shephard and S. A. Clough and W. D. Collins}, - Date-Added = {2016-06-19 23:25:28 +0000}, - Date-Modified = {2016-06-19 23:32:46 +0000}, - Journal = {J. Geophys. Res.}, - Title = {Radiative forcing by long-lived greenhouse gases: Calculations with the {AER} radiative transfer models}, - Volume = {113}, - Year = {2008}} + annote = {doi:10.1029/2008JD009944}, + author = {M. J. Iacono and J. S. Delamere and E. J. Mlawer and M. W. Shephard and S. A. Clough and W. D. Collins}, + date-added = {2016-06-19 23:25:28 +0000}, + date-modified = {2016-06-19 23:32:46 +0000}, + journal = {J. Geophys. Res.}, + title = {Radiative forcing by long-lived greenhouse gases: Calculations with the {AER} radiative transfer models}, + volume = {113}, + year = {2008}} @article{grant_2001, - Abstract = {A closure for the fluxes of mass, heat, and moisture at cloud base in the cumulus-capped boundary layer is developed. The cloud-base mass flux is obtained from a simplifed turbulence kinetic energy (TKE) budget for the sub-cloud layer, in which cumulus convection is assumed to be associated with a transport of TKE from the sub-cloud layer to the cloud layer.The heat and moisture fluxes are obtained from a jump model based on the virtual-potential-temperature equation. A key part of this parametrization is the parametrization of the virtual-temperature flux at the top of the transition zone between the sub-cloud and cloud layers.It is argued that pressure fluctuations must be responsible for the transport of TKE from the cloud layer to the sub-cloud layer.}, - Author = {A. L. M. Grant}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvR3JhbnQvMjAwMS5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAoiV4IMjAwMS5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAARgJuNOHLk4AAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAABUdyYW50AAAQAAgAANHneLIAAAARAAgAANOHgq4AAAABABgAKIleAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AEdyYW50OgAyMDAxLnBkZgAADgASAAgAMgAwADAAMQAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9HcmFudC8yMDAxLnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, - Date-Added = {2016-06-15 22:11:22 +0000}, - Date-Modified = {2018-07-06 19:02:34 +0000}, - Doi = {10.1002/qj.49712757209}, - Issn = {1477-870X}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Keywords = {Cloud-base closure, Convection, Fluxes, Jump model, Shallow cumulus, Turbulence kinetic energy}, - Number = {572}, - Pages = {407--421}, - Publisher = {John Wiley & Sons, Ltd}, - Title = {Cloud-base fluxes in the cumulus-capped boundary layer}, - Url = {http://dx.doi.org/10.1002/qj.49712757209}, - Volume = {127}, - Year = {2001}, - Bdsk-Url-1 = {http://dx.doi.org/10.1002/qj.49712757209}} + abstract = {A closure for the fluxes of mass, heat, and moisture at cloud base in the cumulus-capped boundary layer is developed. The cloud-base mass flux is obtained from a simplifed turbulence kinetic energy (TKE) budget for the sub-cloud layer, in which cumulus convection is assumed to be associated with a transport of TKE from the sub-cloud layer to the cloud layer.The heat and moisture fluxes are obtained from a jump model based on the virtual-potential-temperature equation. A key part of this parametrization is the parametrization of the virtual-temperature flux at the top of the transition zone between the sub-cloud and cloud layers.It is argued that pressure fluctuations must be responsible for the transport of TKE from the cloud layer to the sub-cloud layer.}, + author = {A. L. M. Grant}, + date-added = {2016-06-15 22:11:22 +0000}, + date-modified = {2018-07-06 19:02:34 +0000}, + doi = {10.1002/qj.49712757209}, + issn = {1477-870X}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + keywords = {Cloud-base closure, Convection, Fluxes, Jump model, Shallow cumulus, Turbulence kinetic energy}, + number = {572}, + pages = {407--421}, + publisher = {John Wiley & Sons, Ltd}, + title = {Cloud-base fluxes in the cumulus-capped boundary layer}, + url = {http://dx.doi.org/10.1002/qj.49712757209}, + volume = {127}, + year = {2001}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvR3JhbnQvMjAwMS5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAoiV4IMjAwMS5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAARgJuNOHLk4AAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAABUdyYW50AAAQAAgAANHneLIAAAARAAgAANOHgq4AAAABABgAKIleAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AEdyYW50OgAyMDAxLnBkZgAADgASAAgAMgAwADAAMQAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9HcmFudC8yMDAxLnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, + bdsk-url-1 = {http://dx.doi.org/10.1002/qj.49712757209}} @article{zhang_and_wu_2003, - Abstract = {Abstract This study uses a 2D cloud-resolving model to investigate the vertical transport of horizontal momentum and to understand the role of a convection-generated perturbation pressure field in the momentum transport by convective systems during part of the Tropical Ocean and Global Atmosphere Coupled Ocean?Atmosphere Response Experiment (TOGA COARE) Intensive Observation Period. It shows that convective updrafts transport a significant amount of momentum vertically. This transport is downgradient in the easterly wind regime, but upgradient during a westerly wind burst. The differences in convective momentum transport between easterly and westerly wind regimes are examined. The perturbation pressure gradient accounts for an important part of the apparent momentum source. In general it is opposite in sign to the product of cloud mass flux and the vertical wind shear, with smaller magnitude. Examination of the dynamic forcing to the pressure field demonstrates that the linear forcing representing the interaction between the convective updrafts and the large-scale wind shear is the dominant term, while the nonlinear forcing is of secondary importance. Thus, parameterization schemes taking into account the linear interaction between the convective updrafts and the large-scale wind shear can capture the essential features of the perturbation pressure field. The parameterization scheme for momentum transport by Zhang and Cho is evaluated using the model simulation data. The parameterized pressure gradient force using the scheme is in excellent agreement with the simulated one. The parameterized apparent momentum source is also in good agreement with the model simulation. Other parameterization methods for the pressure gradient are also discussed.}, - Annote = {doi: 10.1175/1520-0469(2003)060<1120:CMTAPP>2.0.CO;2}, - Author = {Zhang, G. J. and Wu, X. Q.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvWmhhbmcvMjAwMy5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAqjuYIMjAwMy5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFrUP9K0L8MAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAABVpoYW5nAAAQAAgAANHneLIAAAARAAgAANK0kjMAAAABABgAKo7mAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AFpoYW5nOgAyMDAzLnBkZgAADgASAAgAMgAwADAAMwAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9aaGFuZy8yMDAzLnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, - Booktitle = {Journal of the Atmospheric Sciences}, - Da = {2003/05/01}, - Date-Added = {2016-06-14 23:39:50 +0000}, - Date-Modified = {2016-06-16 15:30:17 +0000}, - Doi = {10.1175/1520-0469(2003)060<1120:CMTAPP>2.0.CO;2}, - Isbn = {0022-4928}, - Journal = {Journal of the Atmospheric Sciences}, - Journal1 = {J. Atmos. Sci.}, - M3 = {doi: 10.1175/1520-0469(2003)060<1120:CMTAPP>2.0.CO;2}, - N2 = {Abstract This study uses a 2D cloud-resolving model to investigate the vertical transport of horizontal momentum and to understand the role of a convection-generated perturbation pressure field in the momentum transport by convective systems during part of the Tropical Ocean and Global Atmosphere Coupled Ocean?Atmosphere Response Experiment (TOGA COARE) Intensive Observation Period. It shows that convective updrafts transport a significant amount of momentum vertically. This transport is downgradient in the easterly wind regime, but upgradient during a westerly wind burst. The differences in convective momentum transport between easterly and westerly wind regimes are examined. The perturbation pressure gradient accounts for an important part of the apparent momentum source. In general it is opposite in sign to the product of cloud mass flux and the vertical wind shear, with smaller magnitude. Examination of the dynamic forcing to the pressure field demonstrates that the linear forcing representing the interaction between the convective updrafts and the large-scale wind shear is the dominant term, while the nonlinear forcing is of secondary importance. Thus, parameterization schemes taking into account the linear interaction between the convective updrafts and the large-scale wind shear can capture the essential features of the perturbation pressure field. The parameterization scheme for momentum transport by Zhang and Cho is evaluated using the model simulation data. The parameterized pressure gradient force using the scheme is in excellent agreement with the simulated one. The parameterized apparent momentum source is also in good agreement with the model simulation. Other parameterization methods for the pressure gradient are also discussed.}, - Number = {9}, - Pages = {1120--1139}, - Publisher = {American Meteorological Society}, - Title = {Convective Momentum Transport and Perturbation Pressure Field from a Cloud-Resolving Model Simulation}, - Ty = {JOUR}, - Url = {http://dx.doi.org/10.1175/1520-0469(2003)060<1120:CMTAPP>2.0.CO;2}, - Volume = {60}, - Year = {2003}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0469(2003)060%3C1120:CMTAPP%3E2.0.CO;2}} + abstract = {Abstract This study uses a 2D cloud-resolving model to investigate the vertical transport of horizontal momentum and to understand the role of a convection-generated perturbation pressure field in the momentum transport by convective systems during part of the Tropical Ocean and Global Atmosphere Coupled Ocean?Atmosphere Response Experiment (TOGA COARE) Intensive Observation Period. It shows that convective updrafts transport a significant amount of momentum vertically. This transport is downgradient in the easterly wind regime, but upgradient during a westerly wind burst. The differences in convective momentum transport between easterly and westerly wind regimes are examined. The perturbation pressure gradient accounts for an important part of the apparent momentum source. In general it is opposite in sign to the product of cloud mass flux and the vertical wind shear, with smaller magnitude. Examination of the dynamic forcing to the pressure field demonstrates that the linear forcing representing the interaction between the convective updrafts and the large-scale wind shear is the dominant term, while the nonlinear forcing is of secondary importance. Thus, parameterization schemes taking into account the linear interaction between the convective updrafts and the large-scale wind shear can capture the essential features of the perturbation pressure field. The parameterization scheme for momentum transport by Zhang and Cho is evaluated using the model simulation data. The parameterized pressure gradient force using the scheme is in excellent agreement with the simulated one. The parameterized apparent momentum source is also in good agreement with the model simulation. Other parameterization methods for the pressure gradient are also discussed.}, + annote = {doi: 10.1175/1520-0469(2003)060<1120:CMTAPP>2.0.CO;2}, + author = {Zhang, G. J. and Wu, X. Q.}, + booktitle = {Journal of the Atmospheric Sciences}, + da = {2003/05/01}, + date-added = {2016-06-14 23:39:50 +0000}, + date-modified = {2016-06-16 15:30:17 +0000}, + doi = {10.1175/1520-0469(2003)060<1120:CMTAPP>2.0.CO;2}, + isbn = {0022-4928}, + journal = {Journal of the Atmospheric Sciences}, + journal1 = {J. Atmos. Sci.}, + m3 = {doi: 10.1175/1520-0469(2003)060<1120:CMTAPP>2.0.CO;2}, + n2 = {Abstract This study uses a 2D cloud-resolving model to investigate the vertical transport of horizontal momentum and to understand the role of a convection-generated perturbation pressure field in the momentum transport by convective systems during part of the Tropical Ocean and Global Atmosphere Coupled Ocean?Atmosphere Response Experiment (TOGA COARE) Intensive Observation Period. It shows that convective updrafts transport a significant amount of momentum vertically. This transport is downgradient in the easterly wind regime, but upgradient during a westerly wind burst. The differences in convective momentum transport between easterly and westerly wind regimes are examined. The perturbation pressure gradient accounts for an important part of the apparent momentum source. In general it is opposite in sign to the product of cloud mass flux and the vertical wind shear, with smaller magnitude. Examination of the dynamic forcing to the pressure field demonstrates that the linear forcing representing the interaction between the convective updrafts and the large-scale wind shear is the dominant term, while the nonlinear forcing is of secondary importance. Thus, parameterization schemes taking into account the linear interaction between the convective updrafts and the large-scale wind shear can capture the essential features of the perturbation pressure field. The parameterization scheme for momentum transport by Zhang and Cho is evaluated using the model simulation data. The parameterized pressure gradient force using the scheme is in excellent agreement with the simulated one. The parameterized apparent momentum source is also in good agreement with the model simulation. Other parameterization methods for the pressure gradient are also discussed.}, + number = {9}, + pages = {1120--1139}, + publisher = {American Meteorological Society}, + title = {Convective Momentum Transport and Perturbation Pressure Field from a Cloud-Resolving Model Simulation}, + ty = {JOUR}, + url = {http://dx.doi.org/10.1175/1520-0469(2003)060<1120:CMTAPP>2.0.CO;2}, + volume = {60}, + year = {2003}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvWmhhbmcvMjAwMy5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAqjuYIMjAwMy5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAFrUP9K0L8MAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAABVpoYW5nAAAQAAgAANHneLIAAAARAAgAANK0kjMAAAABABgAKo7mAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AFpoYW5nOgAyMDAzLnBkZgAADgASAAgAMgAwADAAMwAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9aaGFuZy8yMDAzLnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0469(2003)060%3C1120:CMTAPP%3E2.0.CO;2}} @article{fritsch_and_chappell_1980, - Abstract = {Abstract A parameterization formulation for incorporating the effects of midlatitude deep convection into mesoscale-numerical models is presented. The formulation is based on the hypothesis that the buoyant energy available to a parcel, in combination with a prescribed period of time for the convection to remove that energy, can be used to regulate the amount of convection in a mesoscale numerical model grid element. Individual clouds are represented as entraining moist updraft and downdraft plumes. The fraction of updraft condensate evaporated in moist downdrafts is determined from an empirical relationship between the vertical shear of the horizontal wind and precipitation efficiency. Vertical transports of horizontal momentum and warming by compensating subsidence are included in the parameterization. Since updraft and downdraft areas are sometimes a substantial fraction of mesoscale model grid-element areas, grid-point temperatures (adjusted for convection) are an area-weighted mean of updraft, downdraft and environmental temperatures.}, - Annote = {doi: 10.1175/1520-0469(1980)037<1722:NPOCDM>2.0.CO;2}, - Author = {Fritsch, J. M. and Chappell, C. F.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBDLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvRnJpdHNjaC8xOTgwLnBkZk8RAcoAAAAAAcoAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAARCuMwgxOTgwLnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABEKs103xvpgAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAHRnJpdHNjaAAAEAAIAADR53iyAAAAEQAIAADTfMQGAAAAAQAYARCuMwAobJYAKGyLAChnewAbXgcAAphcAAIAXU1hY2ludG9zaCBIRDpVc2VyczoAZ3JhbnRmOgBDbG91ZFN0YXRpb246AGZpcmxfbGlicmFyeToAZmlybF9saWJyYXJ5X2ZpbGVzOgBGcml0c2NoOgAxOTgwLnBkZgAADgASAAgAMQA5ADgAMAAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9Gcml0c2NoLzE5ODAucGRmABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGoAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOA==}, - Booktitle = {Journal of the Atmospheric Sciences}, - Da = {1980/08/01}, - Date = {1980/08/01}, - Date-Added = {2016-06-14 23:18:40 +0000}, - Date-Modified = {2016-06-16 15:29:09 +0000}, - Doi = {10.1175/1520-0469(1980)037<1722:NPOCDM>2.0.CO;2}, - Isbn = {0022-4928}, - Journal = {Journal of the Atmospheric Sciences}, - Journal1 = {J. Atmos. Sci.}, - M3 = {doi: 10.1175/1520-0469(1980)037<1722:NPOCDM>2.0.CO;2}, - N2 = {Abstract A parameterization formulation for incorporating the effects of midlatitude deep convection into mesoscale-numerical models is presented. The formulation is based on the hypothesis that the buoyant energy available to a parcel, in combination with a prescribed period of time for the convection to remove that energy, can be used to regulate the amount of convection in a mesoscale numerical model grid element. Individual clouds are represented as entraining moist updraft and downdraft plumes. The fraction of updraft condensate evaporated in moist downdrafts is determined from an empirical relationship between the vertical shear of the horizontal wind and precipitation efficiency. Vertical transports of horizontal momentum and warming by compensating subsidence are included in the parameterization. Since updraft and downdraft areas are sometimes a substantial fraction of mesoscale model grid-element areas, grid-point temperatures (adjusted for convection) are an area-weighted mean of updraft, downdraft and environmental temperatures.}, - Number = {8}, - Pages = {1722--1733}, - Publisher = {American Meteorological Society}, - Title = {Numerical Prediction of Convectively Driven Mesoscale Pressure Systems. {P}art {I}: Convective Parameterization}, - Ty = {JOUR}, - Url = {http://dx.doi.org/10.1175/1520-0469(1980)037<1722:NPOCDM>2.0.CO;2}, - Volume = {37}, - Year = {1980}, - Year1 = {1980}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0469(1980)037%3C1722:NPOCDM%3E2.0.CO;2}} + abstract = {Abstract A parameterization formulation for incorporating the effects of midlatitude deep convection into mesoscale-numerical models is presented. The formulation is based on the hypothesis that the buoyant energy available to a parcel, in combination with a prescribed period of time for the convection to remove that energy, can be used to regulate the amount of convection in a mesoscale numerical model grid element. Individual clouds are represented as entraining moist updraft and downdraft plumes. The fraction of updraft condensate evaporated in moist downdrafts is determined from an empirical relationship between the vertical shear of the horizontal wind and precipitation efficiency. Vertical transports of horizontal momentum and warming by compensating subsidence are included in the parameterization. Since updraft and downdraft areas are sometimes a substantial fraction of mesoscale model grid-element areas, grid-point temperatures (adjusted for convection) are an area-weighted mean of updraft, downdraft and environmental temperatures.}, + annote = {doi: 10.1175/1520-0469(1980)037<1722:NPOCDM>2.0.CO;2}, + author = {Fritsch, J. M. and Chappell, C. F.}, + booktitle = {Journal of the Atmospheric Sciences}, + da = {1980/08/01}, + date = {1980/08/01}, + date-added = {2016-06-14 23:18:40 +0000}, + date-modified = {2016-06-16 15:29:09 +0000}, + doi = {10.1175/1520-0469(1980)037<1722:NPOCDM>2.0.CO;2}, + isbn = {0022-4928}, + journal = {Journal of the Atmospheric Sciences}, + journal1 = {J. Atmos. Sci.}, + m3 = {doi: 10.1175/1520-0469(1980)037<1722:NPOCDM>2.0.CO;2}, + n2 = {Abstract A parameterization formulation for incorporating the effects of midlatitude deep convection into mesoscale-numerical models is presented. The formulation is based on the hypothesis that the buoyant energy available to a parcel, in combination with a prescribed period of time for the convection to remove that energy, can be used to regulate the amount of convection in a mesoscale numerical model grid element. Individual clouds are represented as entraining moist updraft and downdraft plumes. The fraction of updraft condensate evaporated in moist downdrafts is determined from an empirical relationship between the vertical shear of the horizontal wind and precipitation efficiency. Vertical transports of horizontal momentum and warming by compensating subsidence are included in the parameterization. Since updraft and downdraft areas are sometimes a substantial fraction of mesoscale model grid-element areas, grid-point temperatures (adjusted for convection) are an area-weighted mean of updraft, downdraft and environmental temperatures.}, + number = {8}, + pages = {1722--1733}, + publisher = {American Meteorological Society}, + title = {Numerical Prediction of Convectively Driven Mesoscale Pressure Systems. {P}art {I}: Convective Parameterization}, + ty = {JOUR}, + url = {http://dx.doi.org/10.1175/1520-0469(1980)037<1722:NPOCDM>2.0.CO;2}, + volume = {37}, + year = {1980}, + year1 = {1980}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBDLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvRnJpdHNjaC8xOTgwLnBkZk8RAcoAAAAAAcoAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAARCuMwgxOTgwLnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABEKs103xvpgAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAHRnJpdHNjaAAAEAAIAADR53iyAAAAEQAIAADTfMQGAAAAAQAYARCuMwAobJYAKGyLAChnewAbXgcAAphcAAIAXU1hY2ludG9zaCBIRDpVc2VyczoAZ3JhbnRmOgBDbG91ZFN0YXRpb246AGZpcmxfbGlicmFyeToAZmlybF9saWJyYXJ5X2ZpbGVzOgBGcml0c2NoOgAxOTgwLnBkZgAADgASAAgAMQA5ADgAMAAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9Gcml0c2NoLzE5ODAucGRmABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGoAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOA==}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0469(1980)037%3C1722:NPOCDM%3E2.0.CO;2}} @article{bechtold_et_al_2008, - Abstract = {Advances in simulating atmospheric variability with the {ECMWF} model are presented that stem from revisions of the convection and diffusion parametrizations. The revisions concern in particular the introduction of a variable convective adjustment time-scale, a convective entrainment rate proportional to the environmental relative humidity, as well as free tropospheric diffusion coefficients for heat and momentum based on Monin--Obukhov functional dependencies.The forecasting system is evaluated against analyses and observations using high-resolution medium-range deterministic and ensemble forecasts, monthly and seasonal integrations, and decadal integrations with coupled atmosphere-ocean models. The results show a significantly higher and more realistic level of model activity in terms of the amplitude of tropical and extratropical mesoscale, synoptic and planetary perturbations. Importantly, with the higher variability and reduced bias not only the probabilistic scores are improved, but also the midlatitude deterministic scores in the short and medium ranges. Furthermore, for the first time the model is able to represent a realistic spectrum of convectively coupled equatorial Kelvin and Rossby waves, and maintains a realistic amplitude of the Madden--Julian oscillation (MJO) during monthly forecasts. However, the propagation speed of the MJO is slower than observed. The higher tropical tropospheric wave activity also results in better stratospheric temperatures and winds through the deposition of momentum.The partitioning between convective and resolved precipitation is unaffected by the model changes with roughly 62% of the total global precipitation being of the convective type. Finally, the changes in convection and diffusion parametrizations resulted in a larger spread of the ensemble forecasts, which allowed the amplitude of the initial perturbations in the ensemble prediction system to decrease by 30%. Copyright {\copyright} 2008 Royal Meteorological Society}, - Author = {Bechtold, P. and K{\"o}hler, M. and Jung, T. and Doblas-Reyes, F. and Leutbecher, M. and Rodwell, M. J. and Vitart, F. and Balsamo, G.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBELi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQmVjaHRvbGQvMjAwOC5wZGZPEQHMAAAAAAHMAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAobfkIMjAwOC5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAARZce9OEjEwAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAACEJlY2h0b2xkABAACAAA0ed4sgAAABEACAAA04TgrAAAAAEAGAAobfkAKGyWAChsiwAoZ3sAG14HAAKYXAACAF5NYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoAQmVjaHRvbGQ6ADIwMDgucGRmAA4AEgAIADIAMAAwADgALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEtVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQmVjaHRvbGQvMjAwOC5wZGYAABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGsAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOw==}, - Date-Added = {2016-06-14 23:11:58 +0000}, - Date-Modified = {2016-06-14 23:11:58 +0000}, - Doi = {10.1002/qj.289}, - Issn = {1477-870X}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Keywords = {atmospheric variability, model climate, tropical waves, convection, vertical diffusion, numerical weather prediction}, - Number = {634}, - Pages = {1337--1351}, - Publisher = {John Wiley & Sons, Ltd.}, - Title = {Advances in simulating atmospheric variability with the {ECMWF} model: From synoptic to decadal time-scales}, - Url = {http://dx.doi.org/10.1002/qj.289}, - Volume = {134}, - Year = {2008}, - Bdsk-Url-1 = {http://dx.doi.org/10.1002/qj.289}} + abstract = {Advances in simulating atmospheric variability with the {ECMWF} model are presented that stem from revisions of the convection and diffusion parametrizations. The revisions concern in particular the introduction of a variable convective adjustment time-scale, a convective entrainment rate proportional to the environmental relative humidity, as well as free tropospheric diffusion coefficients for heat and momentum based on Monin--Obukhov functional dependencies.The forecasting system is evaluated against analyses and observations using high-resolution medium-range deterministic and ensemble forecasts, monthly and seasonal integrations, and decadal integrations with coupled atmosphere-ocean models. The results show a significantly higher and more realistic level of model activity in terms of the amplitude of tropical and extratropical mesoscale, synoptic and planetary perturbations. Importantly, with the higher variability and reduced bias not only the probabilistic scores are improved, but also the midlatitude deterministic scores in the short and medium ranges. Furthermore, for the first time the model is able to represent a realistic spectrum of convectively coupled equatorial Kelvin and Rossby waves, and maintains a realistic amplitude of the Madden--Julian oscillation (MJO) during monthly forecasts. However, the propagation speed of the MJO is slower than observed. The higher tropical tropospheric wave activity also results in better stratospheric temperatures and winds through the deposition of momentum.The partitioning between convective and resolved precipitation is unaffected by the model changes with roughly 62% of the total global precipitation being of the convective type. Finally, the changes in convection and diffusion parametrizations resulted in a larger spread of the ensemble forecasts, which allowed the amplitude of the initial perturbations in the ensemble prediction system to decrease by 30%. Copyright {\copyright} 2008 Royal Meteorological Society}, + author = {Bechtold, P. and K{\"o}hler, M. and Jung, T. and Doblas-Reyes, F. and Leutbecher, M. and Rodwell, M. J. and Vitart, F. and Balsamo, G.}, + date-added = {2016-06-14 23:11:58 +0000}, + date-modified = {2016-06-14 23:11:58 +0000}, + doi = {10.1002/qj.289}, + issn = {1477-870X}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + keywords = {atmospheric variability, model climate, tropical waves, convection, vertical diffusion, numerical weather prediction}, + number = {634}, + pages = {1337--1351}, + publisher = {John Wiley & Sons, Ltd.}, + title = {Advances in simulating atmospheric variability with the {ECMWF} model: From synoptic to decadal time-scales}, + url = {http://dx.doi.org/10.1002/qj.289}, + volume = {134}, + year = {2008}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBELi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQmVjaHRvbGQvMjAwOC5wZGZPEQHMAAAAAAHMAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAobfkIMjAwOC5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAARZce9OEjEwAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAACEJlY2h0b2xkABAACAAA0ed4sgAAABEACAAA04TgrAAAAAEAGAAobfkAKGyWAChsiwAoZ3sAG14HAAKYXAACAF5NYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoAQmVjaHRvbGQ6ADIwMDgucGRmAA4AEgAIADIAMAAwADgALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEtVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQmVjaHRvbGQvMjAwOC5wZGYAABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGsAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOw==}, + bdsk-url-1 = {http://dx.doi.org/10.1002/qj.289}} @article{han_and_pan_2011, - Annote = {doi: 10.1175/WAF-D-10-05038.1}, - Author = {Han, J. and Pan, H.-L.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxA/Li4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvSGFuLzIwMTEucGRmTxEBvgAAAAABvgACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAA0eckUkgrAAAAWsT5CDIwMTEucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADC1cfTGvlvAAAAAAAAAAAAAgAFAAAJIAAAAAAAAAAAAAAAAAAAAANIYW4AABAACAAA0ed4sgAAABEACAAA0xtNzwAAAAEAGABaxPkAKGyWAChsiwAoZ3sAG14HAAKYXAACAFlNYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoASGFuOgAyMDExLnBkZgAADgASAAgAMgAwADEAMQAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIARlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9IYW4vMjAxMS5wZGYAEwABLwAAFQACAA3//wAAAAgADQAaACQAZgAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIo}, - Booktitle = {Weather and Forecasting}, - Da = {2011/08/01}, - Date = {2011/08/01}, - Date-Added = {2016-06-14 23:07:16 +0000}, - Date-Modified = {2016-06-14 23:07:16 +0000}, - Doi = {10.1175/WAF-D-10-05038.1}, - Isbn = {0882-8156}, - Journal = {Weather and Forecasting}, - Journal1 = {Wea. Forecasting}, - M3 = {doi: 10.1175/WAF-D-10-05038.1}, - Month = {2016/03/25}, - Number = {4}, - Pages = {520--533}, - Publisher = {American Meteorological Society}, - Title = {Revision of Convection and Vertical Diffusion Schemes in the {NCEP} {G}lobal {F}orecast {S}ystem}, - Ty = {JOUR}, - Url = {http://dx.doi.org/10.1175/WAF-D-10-05038.1}, - Volume = {26}, - Year = {2011}, - Year1 = {2011}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/WAF-D-10-05038.1}} + annote = {doi: 10.1175/WAF-D-10-05038.1}, + author = {Han, J. and Pan, H.-L.}, + booktitle = {Weather and Forecasting}, + da = {2011/08/01}, + date = {2011/08/01}, + date-added = {2016-06-14 23:07:16 +0000}, + date-modified = {2016-06-14 23:07:16 +0000}, + doi = {10.1175/WAF-D-10-05038.1}, + isbn = {0882-8156}, + journal = {Weather and Forecasting}, + journal1 = {Wea. Forecasting}, + m3 = {doi: 10.1175/WAF-D-10-05038.1}, + month = {2016/03/25}, + number = {4}, + pages = {520--533}, + publisher = {American Meteorological Society}, + title = {Revision of Convection and Vertical Diffusion Schemes in the {NCEP} {G}lobal {F}orecast {S}ystem}, + ty = {JOUR}, + url = {http://dx.doi.org/10.1175/WAF-D-10-05038.1}, + volume = {26}, + year = {2011}, + year1 = {2011}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxA/Li4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvSGFuLzIwMTEucGRmTxEBvgAAAAABvgACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAA0eckUkgrAAAAWsT5CDIwMTEucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADC1cfTGvlvAAAAAAAAAAAAAgAFAAAJIAAAAAAAAAAAAAAAAAAAAANIYW4AABAACAAA0ed4sgAAABEACAAA0xtNzwAAAAEAGABaxPkAKGyWAChsiwAoZ3sAG14HAAKYXAACAFlNYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoASGFuOgAyMDExLnBkZgAADgASAAgAMgAwADEAMQAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIARlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9IYW4vMjAxMS5wZGYAEwABLwAAFQACAA3//wAAAAgADQAaACQAZgAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIo}, + bdsk-url-1 = {http://dx.doi.org/10.1175/WAF-D-10-05038.1}} @article{pan_and_wu_1995, - Author = {Pan, H.-L. and W.-S. Wu}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxA/Li4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvUGFuLzE5OTUucGRmTxEBvgAAAAABvgACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAA0eckUkgrAAAAwtTNCDE5OTUucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADCtU/TGvMJAAAAAAAAAAAAAgAFAAAJIAAAAAAAAAAAAAAAAAAAAANQYW4AABAACAAA0ed4sgAAABEACAAA0xtHaQAAAAEAGADC1M0AKGyWAChsiwAoZ3sAG14HAAKYXAACAFlNYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoAUGFuOgAxOTk1LnBkZgAADgASAAgAMQA5ADkANQAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIARlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9QYW4vMTk5NS5wZGYAEwABLwAAFQACAA3//wAAAAgADQAaACQAZgAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIo}, - Date-Added = {2016-06-14 23:06:41 +0000}, - Date-Modified = {2016-06-14 23:06:41 +0000}, - Journal = {NMC Office Note, No. 409}, - Pages = {40pp}, - Title = {Implementing a Mass Flux Convection Parameterization Package for the {NMC} Medium-Range Forecast Model}, - Year = {1995}} + author = {Pan, H.-L. and W.-S. Wu}, + date-added = {2016-06-14 23:06:41 +0000}, + date-modified = {2016-06-14 23:06:41 +0000}, + journal = {NMC Office Note, No. 409}, + pages = {40pp}, + title = {Implementing a Mass Flux Convection Parameterization Package for the {NMC} Medium-Range Forecast Model}, + year = {1995}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxA/Li4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvUGFuLzE5OTUucGRmTxEBvgAAAAABvgACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAA0eckUkgrAAAAwtTNCDE5OTUucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAADCtU/TGvMJAAAAAAAAAAAAAgAFAAAJIAAAAAAAAAAAAAAAAAAAAANQYW4AABAACAAA0ed4sgAAABEACAAA0xtHaQAAAAEAGADC1M0AKGyWAChsiwAoZ3sAG14HAAKYXAACAFlNYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoAUGFuOgAxOTk1LnBkZgAADgASAAgAMQA5ADkANQAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIARlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9QYW4vMTk5NS5wZGYAEwABLwAAFQACAA3//wAAAAgADQAaACQAZgAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIo}} @article{grell_1993, - Annote = {doi: 10.1175/1520-0493(1993)121<0764:PEOAUB>2.0.CO;2}, - Author = {Grell, G. A.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvR3JlbGwvMTk5My5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAoie0IMTk5My5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMK4dtMa9LMAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAABUdyZWxsAAAQAAgAANHneLIAAAARAAgAANMbSRMAAAABABgAKIntAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AEdyZWxsOgAxOTkzLnBkZgAADgASAAgAMQA5ADkAMwAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9HcmVsbC8xOTkzLnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, - Booktitle = {Monthly Weather Review}, - Da = {1993/03/01}, - Date = {1993/03/01}, - Date-Added = {2016-06-14 23:06:02 +0000}, - Date-Modified = {2016-06-14 23:06:02 +0000}, - Doi = {10.1175/1520-0493(1993)121<0764:PEOAUB>2.0.CO;2}, - Isbn = {0027-0644}, - Journal = {Monthly Weather Review}, - Journal1 = {Mon. Wea. Rev.}, - M3 = {doi: 10.1175/1520-0493(1993)121<0764:PEOAUB>2.0.CO;2}, - Month = {2016/03/25}, - Number = {3}, - Pages = {764--787}, - Publisher = {American Meteorological Society}, - Title = {Prognostic Evaluation of Assumptions Used by Cumulus Parameterizations}, - Ty = {JOUR}, - Url = {http://dx.doi.org/10.1175/1520-0493(1993)121<0764:PEOAUB>2.0.CO;2}, - Volume = {121}, - Year = {1993}, - Year1 = {1993}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0493(1993)121%3C0764:PEOAUB%3E2.0.CO;2}} + annote = {doi: 10.1175/1520-0493(1993)121<0764:PEOAUB>2.0.CO;2}, + author = {Grell, G. A.}, + booktitle = {Monthly Weather Review}, + da = {1993/03/01}, + date = {1993/03/01}, + date-added = {2016-06-14 23:06:02 +0000}, + date-modified = {2016-06-14 23:06:02 +0000}, + doi = {10.1175/1520-0493(1993)121<0764:PEOAUB>2.0.CO;2}, + isbn = {0027-0644}, + journal = {Monthly Weather Review}, + journal1 = {Mon. Wea. Rev.}, + m3 = {doi: 10.1175/1520-0493(1993)121<0764:PEOAUB>2.0.CO;2}, + month = {2016/03/25}, + number = {3}, + pages = {764--787}, + publisher = {American Meteorological Society}, + title = {Prognostic Evaluation of Assumptions Used by Cumulus Parameterizations}, + ty = {JOUR}, + url = {http://dx.doi.org/10.1175/1520-0493(1993)121<0764:PEOAUB>2.0.CO;2}, + volume = {121}, + year = {1993}, + year1 = {1993}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvR3JlbGwvMTk5My5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAoie0IMTk5My5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAMK4dtMa9LMAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAABUdyZWxsAAAQAAgAANHneLIAAAARAAgAANMbSRMAAAABABgAKIntAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AEdyZWxsOgAxOTkzLnBkZgAADgASAAgAMQA5ADkAMwAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9HcmVsbC8xOTkzLnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0493(1993)121%3C0764:PEOAUB%3E2.0.CO;2}} @article{arakawa_and_schubert_1974, - Author = {Arakawa, A. and Schubert, W. H.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBDLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQXJha2F3YS8xOTc0LnBkZk8RAcoAAAAAAcoAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAAChtVQgxOTc0LnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKG1ctM8h9AAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAHQXJha2F3YQAAEAAIAADR53iyAAAAEQAIAAC0z4RkAAAAAQAYAChtVQAobJYAKGyLAChnewAbXgcAAphcAAIAXU1hY2ludG9zaCBIRDpVc2VyczoAZ3JhbnRmOgBDbG91ZFN0YXRpb246AGZpcmxfbGlicmFyeToAZmlybF9saWJyYXJ5X2ZpbGVzOgBBcmFrYXdhOgAxOTc0LnBkZgAADgASAAgAMQA5ADcANAAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9BcmFrYXdhLzE5NzQucGRmABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGoAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOA==}, - Date-Added = {2016-06-14 23:04:30 +0000}, - Date-Modified = {2018-07-18 19:00:17 +0000}, - Isi = {A1974S778800004}, - Isi-Recid = {24736409}, - Isi-Ref-Recids = {24736410 23263039 23263040 24736411 15230512 21078942 22066681 13999272 6131549 20808007 23263032 22546570 1962258 24736412 24736413 9042903 16367418 21296696 23263044 21323290 23263019 4978012 10294413 15490227 23900510 23900511 23263046 8901065 2093366 6656763 11547033 18049905 22066680 16333678 24736414 7439245 23900506 20768916 13675076 14800951 23065740 15230507 18858907 24736415 5605133 6656847 24736416 19667767 16976778 19116793 10788368 19758747 21930663 23263053 23263035 8901222 23263054 9041925 23263055}, - Iso-Source-Abbreviation = {J Atmos Sci}, - Journal = {Journal of the Atmospheric Sciences}, - Pages = {674--701}, - Times-Cited = {1300}, - Title = {Interaction of a cumulus cloud ensemble with the large-scale environment, {P}art {I}}, - Volume = {31}, - Year = {1974}, - Bdsk-Url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/A1974S778800004}} + author = {Arakawa, A. and Schubert, W. H.}, + date-added = {2016-06-14 23:04:30 +0000}, + date-modified = {2018-07-18 19:00:17 +0000}, + isi = {A1974S778800004}, + isi-recid = {24736409}, + isi-ref-recids = {24736410 23263039 23263040 24736411 15230512 21078942 22066681 13999272 6131549 20808007 23263032 22546570 1962258 24736412 24736413 9042903 16367418 21296696 23263044 21323290 23263019 4978012 10294413 15490227 23900510 23900511 23263046 8901065 2093366 6656763 11547033 18049905 22066680 16333678 24736414 7439245 23900506 20768916 13675076 14800951 23065740 15230507 18858907 24736415 5605133 6656847 24736416 19667767 16976778 19116793 10788368 19758747 21930663 23263053 23263035 8901222 23263054 9041925 23263055}, + iso-source-abbreviation = {J Atmos Sci}, + journal = {Journal of the Atmospheric Sciences}, + pages = {674--701}, + times-cited = {1300}, + title = {Interaction of a cumulus cloud ensemble with the large-scale environment, {P}art {I}}, + volume = {31}, + year = {1974}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBDLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQXJha2F3YS8xOTc0LnBkZk8RAcoAAAAAAcoAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAAChtVQgxOTc0LnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKG1ctM8h9AAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAHQXJha2F3YQAAEAAIAADR53iyAAAAEQAIAAC0z4RkAAAAAQAYAChtVQAobJYAKGyLAChnewAbXgcAAphcAAIAXU1hY2ludG9zaCBIRDpVc2VyczoAZ3JhbnRmOgBDbG91ZFN0YXRpb246AGZpcmxfbGlicmFyeToAZmlybF9saWJyYXJ5X2ZpbGVzOgBBcmFrYXdhOgAxOTc0LnBkZgAADgASAAgAMQA5ADcANAAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9BcmFrYXdhLzE5NzQucGRmABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGoAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOA==}, + bdsk-url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/A1974S778800004}} @article{harshvardhan_et_al_1989, - Author = {Harshvardhan and D. A. Randall and T. G. Corsetti and D. A. Dazlich}, - Date-Added = {2016-06-08 21:28:55 +0000}, - Date-Modified = {2016-06-08 21:32:23 +0000}, - Journal = {J. Atmos. Sci.}, - Number = {13}, - Pages = {1922-1942}, - Title = {Earth radiation budget and cloudiness simulations with a general circulation model}, - Volume = {46}, - Year = {1989}} + author = {Harshvardhan and D. A. Randall and T. G. Corsetti and D. A. Dazlich}, + date-added = {2016-06-08 21:28:55 +0000}, + date-modified = {2016-06-08 21:32:23 +0000}, + journal = {J. Atmos. Sci.}, + number = {13}, + pages = {1922-1942}, + title = {Earth radiation budget and cloudiness simulations with a general circulation model}, + volume = {46}, + year = {1989}} @article{yang_et_al_2008, - Author = {F. Yang and K. Mitchell and Y. Hou and Y. Dai and X. Zeng and Z. Wang and X. Liang}, - Date-Added = {2016-06-08 16:52:08 +0000}, - Date-Modified = {2016-06-08 16:55:40 +0000}, - Journal = {Journal of Applied Meteorology and Climatology}, - Number = {11}, - Pages = {2963-2982}, - Title = {Dependence of land surface albedo on solar zenith angle: Observations and model parameterizations}, - Volume = {47}, - Year = {2008}} + author = {F. Yang and K. Mitchell and Y. Hou and Y. Dai and X. Zeng and Z. Wang and X. Liang}, + date-added = {2016-06-08 16:52:08 +0000}, + date-modified = {2016-06-08 16:55:40 +0000}, + journal = {Journal of Applied Meteorology and Climatology}, + number = {11}, + pages = {2963-2982}, + title = {Dependence of land surface albedo on solar zenith angle: Observations and model parameterizations}, + volume = {47}, + year = {2008}} @article{mccormack_et_al_2006, - Author = {J. P. McCormack and S. D. Eckermann and D. E. Siskind and T. J. McGee}, - Date-Added = {2016-06-06 17:33:25 +0000}, - Date-Modified = {2016-06-06 17:37:45 +0000}, - Journal = {Atmos. Chem. Phys.}, - Pages = {4943-4972}, - Title = {{CHEM2D-OPP}: A new linearized gas-phase ozone photochemistry parameterization for high-altitude {NWP} and climate models}, - Volume = {6}, - Year = {2006}} + author = {J. P. McCormack and S. D. Eckermann and D. E. Siskind and T. J. McGee}, + date-added = {2016-06-06 17:33:25 +0000}, + date-modified = {2016-06-06 17:37:45 +0000}, + journal = {Atmos. Chem. Phys.}, + pages = {4943-4972}, + title = {{CHEM2D-OPP}: A new linearized gas-phase ozone photochemistry parameterization for high-altitude {NWP} and climate models}, + volume = {6}, + year = {2006}} @article{kim_1996, - Author = {Y.-J. Kim}, - Date-Added = {2016-06-01 20:18:51 +0000}, - Date-Modified = {2016-06-01 20:21:44 +0000}, - Journal = {J. Climate}, - Pages = {2698-2717}, - Title = {Representation of subgrid-scale orographic effects in a general circulation model. {P}art {I}: Impact on the dynamics of simulated January climate}, - Volume = {9}, - Year = {1996}} + author = {Y.-J. Kim}, + date-added = {2016-06-01 20:18:51 +0000}, + date-modified = {2016-06-01 20:21:44 +0000}, + journal = {J. Climate}, + pages = {2698-2717}, + title = {Representation of subgrid-scale orographic effects in a general circulation model. {P}art {I}: Impact on the dynamics of simulated January climate}, + volume = {9}, + year = {1996}} @article{palmer_et_al_1986, - Author = {T. N. Palmer and G. J. Shutts and R. Swinbank}, - Date-Added = {2016-05-31 22:08:22 +0000}, - Date-Modified = {2016-05-31 22:11:18 +0000}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Pages = {1001-1039}, - Title = {Alleviation of a systematic westerly bias in circulation and numerical weather prediction model through an orographic gravity wave drag parameterization}, - Volume = {112}, - Year = {1986}} + author = {T. N. Palmer and G. J. Shutts and R. Swinbank}, + date-added = {2016-05-31 22:08:22 +0000}, + date-modified = {2016-05-31 22:11:18 +0000}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + pages = {1001-1039}, + title = {Alleviation of a systematic westerly bias in circulation and numerical weather prediction model through an orographic gravity wave drag parameterization}, + volume = {112}, + year = {1986}} @article{fritts_1984, - Author = {D. C. Fritts}, - Date-Added = {2016-05-31 22:05:39 +0000}, - Date-Modified = {2016-05-31 22:07:46 +0000}, - Journal = {Rev. Geophys. Space Phys.}, - Pages = {275-308}, - Title = {Gravity wave saturation in the middle atmosphere: A review of theory and observations}, - Volume = {22}, - Year = {1984}} + author = {D. C. Fritts}, + date-added = {2016-05-31 22:05:39 +0000}, + date-modified = {2016-05-31 22:07:46 +0000}, + journal = {Rev. Geophys. Space Phys.}, + pages = {275-308}, + title = {Gravity wave saturation in the middle atmosphere: A review of theory and observations}, + volume = {22}, + year = {1984}} @techreport{baines_and_palmer_1990, - Author = {P. G. Baines and T. N. Palmer}, - Date-Added = {2016-05-25 19:56:51 +0000}, - Date-Modified = {2016-05-25 21:40:15 +0000}, - Institution = {European Centre for Medium Range Weather Forecasts}, - Number = {169}, - Title = {Rationale for a new physically based parametrization of sub-grid scale orographic effects}, - Type = {Technical Memorandum}, - Year = {1990}} + author = {P. G. Baines and T. N. Palmer}, + date-added = {2016-05-25 19:56:51 +0000}, + date-modified = {2016-05-25 21:40:15 +0000}, + institution = {European Centre for Medium Range Weather Forecasts}, + number = {169}, + title = {Rationale for a new physically based parametrization of sub-grid scale orographic effects}, + type = {Technical Memorandum}, + year = {1990}} @techreport{hong_1999, - Author = {S-Y. Hong}, - Date-Added = {2016-05-25 17:36:09 +0000}, - Date-Modified = {2016-05-25 17:38:50 +0000}, - Institution = {National Centers for Environmental Predicition}, - Number = {424}, - Title = {New global orograhy data sets}, - Type = {Office note}, - Year = {1999}} + author = {S-Y. Hong}, + date-added = {2016-05-25 17:36:09 +0000}, + date-modified = {2016-05-25 17:38:50 +0000}, + institution = {National Centers for Environmental Predicition}, + number = {424}, + title = {New global orograhy data sets}, + type = {Office note}, + year = {1999}} @article{lott_and_miller_1997, - Author = {F. Lott and M. J. Miller}, - Date-Added = {2016-05-24 21:29:18 +0000}, - Date-Modified = {2016-05-24 21:31:09 +0000}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Pages = {101-127}, - Title = {A new subgrid-scale orographic drag parametrization: Its formulation and testing}, - Volume = {123}, - Year = {1997}} + author = {F. Lott and M. J. Miller}, + date-added = {2016-05-24 21:29:18 +0000}, + date-modified = {2016-05-24 21:31:09 +0000}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + pages = {101-127}, + title = {A new subgrid-scale orographic drag parametrization: Its formulation and testing}, + volume = {123}, + year = {1997}} @article{lindzen_1981, - Author = {R. S. Lindzen}, - Date-Added = {2016-05-24 17:23:58 +0000}, - Date-Modified = {2016-05-24 17:26:01 +0000}, - Journal = {J. Geophys. Res.}, - Pages = {9707-9714}, - Title = {Turbulence and stress due to gravity wave and tidal breakdown}, - Volume = {86}, - Year = {1981}} + author = {R. S. Lindzen}, + date-added = {2016-05-24 17:23:58 +0000}, + date-modified = {2016-05-24 17:26:01 +0000}, + journal = {J. Geophys. Res.}, + pages = {9707-9714}, + title = {Turbulence and stress due to gravity wave and tidal breakdown}, + volume = {86}, + year = {1981}} @conference{pierrehumbert_1986, - Author = {R. T. Pierrehumbert}, - Booktitle = {Seminar/Workshop on Observation, Theory and Modelling of Orographic effect. Seminar: 15-19 September 1986, Workshop: 19-20 September 1986}, - Date-Added = {2016-05-24 17:20:08 +0000}, - Date-Modified = {2018-08-31 14:14:25 -0600}, - Institution = {European Centre for Medium Range Weather Forecasts, Reading, UK}, - Organization = {ECMWF}, - Pages = {251-282}, - Publisher = {ECMWF}, - Title = {An essay on the parameterization of orographic wave drag. Observation, Theory, and Modelling of Orographic Effects}, - Volume = {1}, - Year = {1986}} + author = {R. T. Pierrehumbert}, + booktitle = {Seminar/Workshop on Observation, Theory and Modelling of Orographic effect. Seminar: 15-19 September 1986, Workshop: 19-20 September 1986}, + date-added = {2016-05-24 17:20:08 +0000}, + date-modified = {2018-08-31 14:14:25 -0600}, + institution = {European Centre for Medium Range Weather Forecasts, Reading, UK}, + organization = {ECMWF}, + pages = {251-282}, + publisher = {ECMWF}, + title = {An essay on the parameterization of orographic wave drag. Observation, Theory, and Modelling of Orographic Effects}, + volume = {1}, + year = {1986}} @inbook{sundqvist_1988, - Author = {H. Sundqvist}, - Chapter = {Parameterization of condensation and associated clouds in models for weather prediction and general circulation simulation}, - Date-Added = {2016-05-24 04:23:10 +0000}, - Date-Modified = {2016-05-24 23:03:22 +0000}, - Pages = {433-461}, - Publisher = {M. E. Schlesinger, Ed., Reidel}, - Title = {Physically-based modeling and simulation of climate and climatic changes, {P}art {I}}, - Year = {1988}} + author = {H. Sundqvist}, + chapter = {Parameterization of condensation and associated clouds in models for weather prediction and general circulation simulation}, + date-added = {2016-05-24 04:23:10 +0000}, + date-modified = {2016-05-24 23:03:22 +0000}, + pages = {433-461}, + publisher = {M. E. Schlesinger, Ed., Reidel}, + title = {Physically-based modeling and simulation of climate and climatic changes, {P}art {I}}, + year = {1988}} @misc{Rogers_1979, - Author = {R. R. Rogers}, - Date-Added = {2016-05-24 04:20:01 +0000}, - Date-Modified = {2016-05-24 04:22:28 +0000}, - Edition = {2}, - Publisher = {Pergamon Press}, - Title = {A short course in cloud physics}, - Year = {1979}} + author = {R. R. Rogers}, + date-added = {2016-05-24 04:20:01 +0000}, + date-modified = {2016-05-24 04:22:28 +0000}, + edition = {2}, + publisher = {Pergamon Press}, + title = {A short course in cloud physics}, + year = {1979}} @article{lin_et_al_1983, - Author = {Y.-L. Lin and R. D. Farley and H. D. Orville}, - Date-Added = {2016-05-24 04:16:35 +0000}, - Date-Modified = {2016-05-24 04:19:19 +0000}, - Journal = {J. Climate Appl. Meteor.}, - Pages = {1065-1092}, - Title = {Bulk parameterization of the snow field in a cloud model}, - Volume = {22}, - Year = {1983}} + author = {Y.-L. Lin and R. D. Farley and H. D. Orville}, + date-added = {2016-05-24 04:16:35 +0000}, + date-modified = {2016-05-24 04:19:19 +0000}, + journal = {J. Climate Appl. Meteor.}, + pages = {1065-1092}, + title = {Bulk parameterization of the snow field in a cloud model}, + volume = {22}, + year = {1983}} @booklet{kessler_1969, - Author = {E. Kessler}, - Date-Added = {2016-05-24 04:11:05 +0000}, - Date-Modified = {2016-05-24 04:16:10 +0000}, - Howpublished = {Amer. Meteor. Soc.}, - Journal = {Meteor. Monogr.}, - Number = {32}, - Pages = {84pp}, - Title = {On the distribution and continuity of water substance in atmospheric circulations}, - Year = {1969}} + author = {E. Kessler}, + date-added = {2016-05-24 04:11:05 +0000}, + date-modified = {2016-05-24 04:16:10 +0000}, + howpublished = {Amer. Meteor. Soc.}, + journal = {Meteor. Monogr.}, + number = {32}, + pages = {84pp}, + title = {On the distribution and continuity of water substance in atmospheric circulations}, + year = {1969}} @article{rutledge_and_hobbs_1983, - Author = {S. A. Rutledge and P. V. Hobbs}, - Date-Added = {2016-05-24 04:07:48 +0000}, - Date-Modified = {2016-05-24 04:10:43 +0000}, - Journal = {J. Atmos. Sci.}, - Pages = {1185-1206}, - Title = {The mesoscale and microscale structure and organization of clouds and precipitation in mid-latitude cyclones. {VIII}: A model for the 'seeder-feeder' process in warm-frontal rainbands}, - Volume = {40}, - Year = {1983}} + author = {S. A. Rutledge and P. V. Hobbs}, + date-added = {2016-05-24 04:07:48 +0000}, + date-modified = {2016-05-24 04:10:43 +0000}, + journal = {J. Atmos. Sci.}, + pages = {1185-1206}, + title = {The mesoscale and microscale structure and organization of clouds and precipitation in mid-latitude cyclones. {VIII}: A model for the 'seeder-feeder' process in warm-frontal rainbands}, + volume = {40}, + year = {1983}} @article{zhao_and_carr_1997, - Author = {Q. Zhao and F. H. Carr}, - Date-Added = {2016-05-24 03:57:40 +0000}, - Date-Modified = {2016-05-24 04:02:27 +0000}, - Journal = {Monthly Weather Review}, - Pages = {1931-1953}, - Title = {A prognostic cloud scheme for operational {NWP} models}, - Volume = {125}, - Year = {1997}} + author = {Q. Zhao and F. H. Carr}, + date-added = {2016-05-24 03:57:40 +0000}, + date-modified = {2016-05-24 04:02:27 +0000}, + journal = {Monthly Weather Review}, + pages = {1931-1953}, + title = {A prognostic cloud scheme for operational {NWP} models}, + volume = {125}, + year = {1997}} @article{sundqvist_et_al_1989, - Author = {H. Sundqvist and E. Berge and J.E. Kristjansson}, - Date-Added = {2016-05-24 03:56:22 +0000}, - Date-Modified = {2016-05-24 18:05:06 +0000}, - Journal = {Monthly Weather Review}, - Pages = {1641-1657}, - Title = {Condensation and cloud studies with a mesoscale numerical weather prediction model}, - Volume = {117}, - Year = {1989}} + author = {H. Sundqvist and E. Berge and J.E. Kristjansson}, + date-added = {2016-05-24 03:56:22 +0000}, + date-modified = {2016-05-24 18:05:06 +0000}, + journal = {Monthly Weather Review}, + pages = {1641-1657}, + title = {Condensation and cloud studies with a mesoscale numerical weather prediction model}, + volume = {117}, + year = {1989}} @article{chun_et_al_2001, - Author = {H.-Y. Chun and M.-D. Song and J.-W. Kim and J.-J. Baik}, - Date-Added = {2016-05-20 22:19:31 +0000}, - Date-Modified = {2016-05-20 22:21:45 +0000}, - Journal = {J. Atmos. Sci.}, - Keywords = {convective gwd}, - Pages = {302-319}, - Title = {Effects of gravity wave drag induced by cumulus convection on the atmospheric general circulation}, - Volume = {58}, - Year = {2001}} + author = {H.-Y. Chun and M.-D. Song and J.-W. Kim and J.-J. Baik}, + date-added = {2016-05-20 22:19:31 +0000}, + date-modified = {2016-05-20 22:21:45 +0000}, + journal = {J. Atmos. Sci.}, + keywords = {convective gwd}, + pages = {302-319}, + title = {Effects of gravity wave drag induced by cumulus convection on the atmospheric general circulation}, + volume = {58}, + year = {2001}} @article{chun_et_al_2004, - Author = {H.-Y. Chun and I.-S. Song and J.-J. Baik and Y.-J. Kim}, - Date-Added = {2016-05-20 22:16:39 +0000}, - Date-Modified = {2016-05-20 22:19:24 +0000}, - Journal = {J. Climate}, - Keywords = {convective gwd}, - Pages = {3530-3547}, - Title = {Impact of a convectively forced gravity wave drag parameterization in {NCAR CCM3}}, - Volume = {17}, - Year = {2004}} + author = {H.-Y. Chun and I.-S. Song and J.-J. Baik and Y.-J. Kim}, + date-added = {2016-05-20 22:16:39 +0000}, + date-modified = {2016-05-20 22:19:24 +0000}, + journal = {J. Climate}, + keywords = {convective gwd}, + pages = {3530-3547}, + title = {Impact of a convectively forced gravity wave drag parameterization in {NCAR CCM3}}, + volume = {17}, + year = {2004}} @article{chun_and_baik_1998, - Author = {H.-Y. Chun and J.-J. Baik}, - Date-Added = {2016-05-20 22:11:32 +0000}, - Date-Modified = {2016-05-20 22:15:06 +0000}, - Journal = {J. Atmos. Sci.}, - Keywords = {convective gwd}, - Pages = {3299-3310}, - Title = {Momentum flux by thermally induced internal gravity waves and its approximation for large-scale models}, - Volume = {55}, - Year = {1998}} + author = {H.-Y. Chun and J.-J. Baik}, + date-added = {2016-05-20 22:11:32 +0000}, + date-modified = {2016-05-20 22:15:06 +0000}, + journal = {J. Atmos. Sci.}, + keywords = {convective gwd}, + pages = {3299-3310}, + title = {Momentum flux by thermally induced internal gravity waves and its approximation for large-scale models}, + volume = {55}, + year = {1998}} @article{akmaev_1991, - Author = {R. A. Akmaev}, - Date-Added = {2016-05-20 20:41:25 +0000}, - Date-Modified = {2016-05-20 20:44:22 +0000}, - Journal = {Monthly Weather Review}, - Pages = {2499-2504}, - Title = {A direct algorithm for convective adjustment of the vertical temperature profile for an arbitrary critical lapse rate}, - Volume = {119}, - Year = {1991}} + author = {R. A. Akmaev}, + date-added = {2016-05-20 20:41:25 +0000}, + date-modified = {2016-05-20 20:44:22 +0000}, + journal = {Monthly Weather Review}, + pages = {2499-2504}, + title = {A direct algorithm for convective adjustment of the vertical temperature profile for an arbitrary critical lapse rate}, + volume = {119}, + year = {1991}} @article{siebesma_et_al_2007, - Abstract = {A better conceptual understanding and more realistic parameterizations of convective boundary layers in climate and weather prediction models have been major challenges in meteorological research. In particular, parameterizations of the dry convective boundary layer, in spite of the absence of water phase-changes and its consequent simplicity as compared to moist convection, typically suffer from problems in attempting to represent realistically the boundary layer growth and what is often referred to as countergradient fluxes. The eddy-diffusivity (ED) approach has been relatively successful in representing some characteristics of neutral boundary layers and surface layers in general. The mass-flux (MF) approach, on the other hand, has been used for the parameterization of shallow and deep moist convection. In this paper, a new approach that relies on a combination of the ED and MF parameterizations (EDMF) is proposed for the dry convective boundary layer. It is shown that the EDMF approach follows naturally from a decomposition of the turbulent fluxes into 1) a part that includes strong organized updrafts, and 2) a remaining turbulent field. At the basis of the EDMF approach is the concept that nonlocal subgrid transport due to the strong updrafts is taken into account by the MF approach, while the remaining transport is taken into account by an ED closure. Large-eddy simulation (LES) results of the dry convective boundary layer are used to support the theoretical framework of this new approach and to determine the parameters of the EDMF model. The performance of the new formulation is evaluated against LES results, and it is shown that the EDMF closure is able to reproduce the main properties of dry convective boundary layers in a realistic manner. Furthermore, it will be shown that this approach has strong advantages over the more traditional countergradient approach, especially in the entrainment layer. As a result, this EDMF approach opens the way to parameterize the clear and cumulus-topped boundary layer in a simple and unified way.}, - Author = {Siebesma, A. P. and Soares, P. M. M. and Teixeira, J.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBELi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvU2llYmVzbWEvMjAwNy5wZGZPEQHMAAAAAAHMAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAqYEwIMjAwNy5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACphyMc7+4hQREYgQ0FSTwACAAUAAAkgAAAAAAAAAAAAAAAAAAAACFNpZWJlc21hABAACAAA0ed4sgAAABEACAAAxzxd+AAAAAEAGAAqYEwAKGyWAChsiwAoZ3sAG14HAAKYXAACAF5NYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoAU2llYmVzbWE6ADIwMDcucGRmAA4AEgAIADIAMAAwADcALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEtVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvU2llYmVzbWEvMjAwNy5wZGYAABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGsAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOw==}, - Date-Added = {2016-05-20 17:17:49 +0000}, - Date-Modified = {2016-05-20 17:17:49 +0000}, - Doi = {DOI 10.1175/JAS3888.1}, - Isi = {000245742600011}, - Isi-Recid = {155740544}, - Isi-Ref-Recids = {115014593 127680992 155740545 133137768 72045051 119371807 118686109 113234126 94069283 76955063 85219981 132018694 107966278 155740546 131396353 120868636 120868639 29141512 142871054 41570940 124456950 137282089 93259654 23900506 108293652 81292629 77285327 132368713 90793545 129381436 97209359 16976778 142871103 120666841 114648984 68302965 107133693 119331008 137282122 142871106 65959905 60433145 105313074 155740547 71456809 80400802 23263035}, - Iso-Source-Abbreviation = {J Atmos Sci}, - Journal = {Journal of the Atmospheric Sciences}, - Pages = {1230--1248}, - Times-Cited = {32}, - Title = {A combined eddy-diffusivity mass-flux approach for the convective boundary layer}, - Volume = {64}, - Year = {2007}, - Bdsk-Url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/000245742600011}} + abstract = {A better conceptual understanding and more realistic parameterizations of convective boundary layers in climate and weather prediction models have been major challenges in meteorological research. In particular, parameterizations of the dry convective boundary layer, in spite of the absence of water phase-changes and its consequent simplicity as compared to moist convection, typically suffer from problems in attempting to represent realistically the boundary layer growth and what is often referred to as countergradient fluxes. The eddy-diffusivity (ED) approach has been relatively successful in representing some characteristics of neutral boundary layers and surface layers in general. The mass-flux (MF) approach, on the other hand, has been used for the parameterization of shallow and deep moist convection. In this paper, a new approach that relies on a combination of the ED and MF parameterizations (EDMF) is proposed for the dry convective boundary layer. It is shown that the EDMF approach follows naturally from a decomposition of the turbulent fluxes into 1) a part that includes strong organized updrafts, and 2) a remaining turbulent field. At the basis of the EDMF approach is the concept that nonlocal subgrid transport due to the strong updrafts is taken into account by the MF approach, while the remaining transport is taken into account by an ED closure. Large-eddy simulation (LES) results of the dry convective boundary layer are used to support the theoretical framework of this new approach and to determine the parameters of the EDMF model. The performance of the new formulation is evaluated against LES results, and it is shown that the EDMF closure is able to reproduce the main properties of dry convective boundary layers in a realistic manner. Furthermore, it will be shown that this approach has strong advantages over the more traditional countergradient approach, especially in the entrainment layer. As a result, this EDMF approach opens the way to parameterize the clear and cumulus-topped boundary layer in a simple and unified way.}, + author = {Siebesma, A. P. and Soares, P. M. M. and Teixeira, J.}, + date-added = {2016-05-20 17:17:49 +0000}, + date-modified = {2016-05-20 17:17:49 +0000}, + doi = {DOI 10.1175/JAS3888.1}, + isi = {000245742600011}, + isi-recid = {155740544}, + isi-ref-recids = {115014593 127680992 155740545 133137768 72045051 119371807 118686109 113234126 94069283 76955063 85219981 132018694 107966278 155740546 131396353 120868636 120868639 29141512 142871054 41570940 124456950 137282089 93259654 23900506 108293652 81292629 77285327 132368713 90793545 129381436 97209359 16976778 142871103 120666841 114648984 68302965 107133693 119331008 137282122 142871106 65959905 60433145 105313074 155740547 71456809 80400802 23263035}, + iso-source-abbreviation = {J Atmos Sci}, + journal = {Journal of the Atmospheric Sciences}, + pages = {1230--1248}, + times-cited = {32}, + title = {A combined eddy-diffusivity mass-flux approach for the convective boundary layer}, + volume = {64}, + year = {2007}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBELi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvU2llYmVzbWEvMjAwNy5wZGZPEQHMAAAAAAHMAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAqYEwIMjAwNy5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACphyMc7+4hQREYgQ0FSTwACAAUAAAkgAAAAAAAAAAAAAAAAAAAACFNpZWJlc21hABAACAAA0ed4sgAAABEACAAAxzxd+AAAAAEAGAAqYEwAKGyWAChsiwAoZ3sAG14HAAKYXAACAF5NYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoAU2llYmVzbWE6ADIwMDcucGRmAA4AEgAIADIAMAAwADcALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEtVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvU2llYmVzbWEvMjAwNy5wZGYAABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGsAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOw==}, + bdsk-url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/000245742600011}} @article{soares_et_al_2004, - Abstract = {Recently, a new consistent way of parametrizing simultaneously local and non-local turbulent transport for the convective atmospheric boundary layer has been proposed and tested for the clear boundary layer. This approach assumes that in the convective boundary layer the subgrid-scale fluxes result from two different mixing scales: small eddies, that are parametrized by an eddy-diffusivity approach, and thermals, which are represented by a mass-flux contribution. Since the interaction between the cloud layer and the underlying sub-cloud layer predominantly takes place through strong updraughts, this approach offers an interesting avenue of establishing a unified description of the turbulent transport in the cumulus-topped boundary layer. This paper explores the possibility of such a new approach for the cumulus-topped boundary layer. In the sub-cloud and cloud layers, the mass-flux term represents the effect of strong updraughts. These are modelled by a simple entraining parcel, which determines the mean properties of the strong updraughts, the boundary-layer height, the lifting condensation level and cloud top. The residual smaller-scale turbulent transport is parametrized with an eddy-diffusivity approach that uses a turbulent kinetic energy closure. The new scheme is implemented and tested in the research model MesoNH. Copyright {\copyright} 2004 Royal Meteorological Society}, - Author = {Soares, P. M. M. and Miranda, P. M. A. and Siebesma, A. P. and Teixeira, J.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBCLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvU29hcmVzLzIwMDQucGRmTxEBxgAAAAABxgACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAA0eckUkgrAAAAWIC2CDIwMDQucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABYf6DSsqNwAAAAAAAAAAAAAgAFAAAJIAAAAAAAAAAAAAAAAAAAAAZTb2FyZXMAEAAIAADR53iyAAAAEQAIAADSswXgAAAAAQAYAFiAtgAobJYAKGyLAChnewAbXgcAAphcAAIAXE1hY2ludG9zaCBIRDpVc2VyczoAZ3JhbnRmOgBDbG91ZFN0YXRpb246AGZpcmxfbGlicmFyeToAZmlybF9saWJyYXJ5X2ZpbGVzOgBTb2FyZXM6ADIwMDQucGRmAA4AEgAIADIAMAAwADQALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAElVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvU29hcmVzLzIwMDQucGRmAAATAAEvAAAVAAIADf//AAAACAANABoAJABpAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjM=}, - Date-Added = {2016-05-20 17:17:49 +0000}, - Date-Modified = {2016-05-20 17:17:49 +0000}, - Doi = {10.1256/qj.03.223}, - Issn = {1477-870X}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Keywords = {Boundary layer, Clouds, Turbulence}, - Number = {604}, - Pages = {3365--3383}, - Publisher = {John Wiley & Sons, Ltd.}, - Title = {An eddy-diffusivity/mass-flux parametrization for dry and shallow cumulus convection}, - Url = {http://dx.doi.org/10.1256/qj.03.223}, - Volume = {130}, - Year = {2004}, - Bdsk-Url-1 = {http://dx.doi.org/10.1256/qj.03.223}} + abstract = {Recently, a new consistent way of parametrizing simultaneously local and non-local turbulent transport for the convective atmospheric boundary layer has been proposed and tested for the clear boundary layer. This approach assumes that in the convective boundary layer the subgrid-scale fluxes result from two different mixing scales: small eddies, that are parametrized by an eddy-diffusivity approach, and thermals, which are represented by a mass-flux contribution. Since the interaction between the cloud layer and the underlying sub-cloud layer predominantly takes place through strong updraughts, this approach offers an interesting avenue of establishing a unified description of the turbulent transport in the cumulus-topped boundary layer. This paper explores the possibility of such a new approach for the cumulus-topped boundary layer. In the sub-cloud and cloud layers, the mass-flux term represents the effect of strong updraughts. These are modelled by a simple entraining parcel, which determines the mean properties of the strong updraughts, the boundary-layer height, the lifting condensation level and cloud top. The residual smaller-scale turbulent transport is parametrized with an eddy-diffusivity approach that uses a turbulent kinetic energy closure. The new scheme is implemented and tested in the research model MesoNH. Copyright {\copyright} 2004 Royal Meteorological Society}, + author = {Soares, P. M. M. and Miranda, P. M. A. and Siebesma, A. P. and Teixeira, J.}, + date-added = {2016-05-20 17:17:49 +0000}, + date-modified = {2016-05-20 17:17:49 +0000}, + doi = {10.1256/qj.03.223}, + issn = {1477-870X}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + keywords = {Boundary layer, Clouds, Turbulence}, + number = {604}, + pages = {3365--3383}, + publisher = {John Wiley & Sons, Ltd.}, + title = {An eddy-diffusivity/mass-flux parametrization for dry and shallow cumulus convection}, + url = {http://dx.doi.org/10.1256/qj.03.223}, + volume = {130}, + year = {2004}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBCLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvU29hcmVzLzIwMDQucGRmTxEBxgAAAAABxgACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAA0eckUkgrAAAAWIC2CDIwMDQucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABYf6DSsqNwAAAAAAAAAAAAAgAFAAAJIAAAAAAAAAAAAAAAAAAAAAZTb2FyZXMAEAAIAADR53iyAAAAEQAIAADSswXgAAAAAQAYAFiAtgAobJYAKGyLAChnewAbXgcAAphcAAIAXE1hY2ludG9zaCBIRDpVc2VyczoAZ3JhbnRmOgBDbG91ZFN0YXRpb246AGZpcmxfbGlicmFyeToAZmlybF9saWJyYXJ5X2ZpbGVzOgBTb2FyZXM6ADIwMDQucGRmAA4AEgAIADIAMAAwADQALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAElVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvU29hcmVzLzIwMDQucGRmAAATAAEvAAAVAAIADf//AAAACAANABoAJABpAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjM=}, + bdsk-url-1 = {http://dx.doi.org/10.1256/qj.03.223}} @article{troen_and_mahrt_1986, - Author = {Troen, I. B. and Mahrt, L.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvVHJvZW4vMTk4Ni5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAABNeegIMTk4Ni5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAE13kNKUWwUAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAABVRyb2VuAAAQAAgAANHneLIAAAARAAgAANKUvXUAAAABABgATXnoAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AFRyb2VuOgAxOTg2LnBkZgAADgASAAgAMQA5ADgANgAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9Ucm9lbi8xOTg2LnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, - Date-Added = {2016-05-20 17:17:49 +0000}, - Date-Modified = {2016-05-20 17:17:49 +0000}, - Doi = {10.1007/BF00122760}, - Issn = {0006-8314}, - Journal = {Boundary-Layer Meteorology}, - Language = {English}, - Number = {1-2}, - Pages = {129-148}, - Publisher = {Kluwer Academic Publishers}, - Title = {A simple model of the atmospheric boundary layer; sensitivity to surface evaporation}, - Url = {http://dx.doi.org/10.1007/BF00122760}, - Volume = {37}, - Year = {1986}, - Bdsk-Url-1 = {http://dx.doi.org/10.1007/BF00122760}} + author = {Troen, I. B. and Mahrt, L.}, + date-added = {2016-05-20 17:17:49 +0000}, + date-modified = {2016-05-20 17:17:49 +0000}, + doi = {10.1007/BF00122760}, + issn = {0006-8314}, + journal = {Boundary-Layer Meteorology}, + language = {English}, + number = {1-2}, + pages = {129-148}, + publisher = {Kluwer Academic Publishers}, + title = {A simple model of the atmospheric boundary layer; sensitivity to surface evaporation}, + url = {http://dx.doi.org/10.1007/BF00122760}, + volume = {37}, + year = {1986}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvVHJvZW4vMTk4Ni5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAABNeegIMTk4Ni5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAE13kNKUWwUAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAABVRyb2VuAAAQAAgAANHneLIAAAARAAgAANKUvXUAAAABABgATXnoAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AFRyb2VuOgAxOTg2LnBkZgAADgASAAgAMQA5ADgANgAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9Ucm9lbi8xOTg2LnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, + bdsk-url-1 = {http://dx.doi.org/10.1007/BF00122760}} @article{macvean_and_mason_1990, - Abstract = {Abstract In a recent paper, Kuo and Schubert demonstrated the lack of observational support for the relevance of the criterion for cloud-top entrainment instability proposed by Randall and by Deardorff. Here we derive a new criterion, based on a model of the instability as resulting from the energy released close to cloud top, by Mixing between saturated boundary-layer air and unsaturated air from above the capping inversion. The condition is derived by considering the net conversion from potential to kinetic energy in a system consisting of two layers of fluid straddling cloud-top, when a small amount of mixing occurs between these layers. This contrasts with previous analyses, which only considered the change in buoyancy of the cloud layer when unsaturated air is mixed into it. In its most general form, this new criterion depends on the ratio of the depths of the layers involved in the mixing. It is argued that, for a self-sustaining instability, there must be a net release of kinetic energy on the same depth and time scales as the entrainment process itself. There are two plausible ways in which this requirement may be satisfied. Either one takes the depths of the layers involved in the mixing to each be comparable to the vertical scale of the entrainment process, which is typically of order tens of meters or less, or alternatively, one must allow for the efficiency with which energy released by mixing through a much deeper lower layer becomes available to initiate further entrainment. In both cases the same criterion for instability results. This criterion is much more restrictive than that proposed by Randall and by Deardorff; furthermore, the observational data is then consistent with the predictions of the current theory. Further analysis provides estimates of the turbulent fluxes associated with cloud-top entrainment instability. This analysis effectively constitutes an energetically consistent turbulence closure for models of boundary layers with cloud. The implications for such numerical models are discussed. Comparisons are also made with other possible criteria for cloud-top entrainment instability which have recently been suggested.}, - Annote = {doi: 10.1175/1520-0469(1990)047<1012:CTEITS>2.0.CO;2}, - Author = {MacVean, M. K. and Mason, P. J.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBDLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvTWFjVmVhbi8xOTkwLnBkZk8RAcoAAAAAAcoAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAAFx8zwgxOTkwLnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAXHyn0rkkRQAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAHTWFjVmVhbgAAEAAIAADR53iyAAAAEQAIAADSuYa1AAAAAQAYAFx8zwAobJYAKGyLAChnewAbXgcAAphcAAIAXU1hY2ludG9zaCBIRDpVc2VyczoAZ3JhbnRmOgBDbG91ZFN0YXRpb246AGZpcmxfbGlicmFyeToAZmlybF9saWJyYXJ5X2ZpbGVzOgBNYWNWZWFuOgAxOTkwLnBkZgAADgASAAgAMQA5ADkAMAAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9NYWNWZWFuLzE5OTAucGRmABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGoAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOA==}, - Booktitle = {Journal of the Atmospheric Sciences}, - Da = {1990/04/01}, - Date-Added = {2016-05-20 17:16:05 +0000}, - Date-Modified = {2016-05-20 17:16:05 +0000}, - Doi = {10.1175/1520-0469(1990)047<1012:CTEITS>2.0.CO;2}, - Isbn = {0022-4928}, - Journal = {Journal of the Atmospheric Sciences}, - Journal1 = {J. Atmos. Sci.}, - M3 = {doi: 10.1175/1520-0469(1990)047<1012:CTEITS>2.0.CO;2}, - N2 = {Abstract In a recent paper, Kuo and Schubert demonstrated the lack of observational support for the relevance of the criterion for cloud-top entrainment instability proposed by Randall and by Deardorff. Here we derive a new criterion, based on a model of the instability as resulting from the energy released close to cloud top, by Mixing between saturated boundary-layer air and unsaturated air from above the capping inversion. The condition is derived by considering the net conversion from potential to kinetic energy in a system consisting of two layers of fluid straddling cloud-top, when a small amount of mixing occurs between these layers. This contrasts with previous analyses, which only considered the change in buoyancy of the cloud layer when unsaturated air is mixed into it. In its most general form, this new criterion depends on the ratio of the depths of the layers involved in the mixing. It is argued that, for a self-sustaining instability, there must be a net release of kinetic energy on the same depth and time scales as the entrainment process itself. There are two plausible ways in which this requirement may be satisfied. Either one takes the depths of the layers involved in the mixing to each be comparable to the vertical scale of the entrainment process, which is typically of order tens of meters or less, or alternatively, one must allow for the efficiency with which energy released by mixing through a much deeper lower layer becomes available to initiate further entrainment. In both cases the same criterion for instability results. This criterion is much more restrictive than that proposed by Randall and by Deardorff; furthermore, the observational data is then consistent with the predictions of the current theory. Further analysis provides estimates of the turbulent fluxes associated with cloud-top entrainment instability. This analysis effectively constitutes an energetically consistent turbulence closure for models of boundary layers with cloud. The implications for such numerical models are discussed. Comparisons are also made with other possible criteria for cloud-top entrainment instability which have recently been suggested.}, - Number = {8}, - Pages = {1012--1030}, - Publisher = {American Meteorological Society}, - Title = {Cloud-Top Entrainment Instability through Small-Scale Mixing and Its Parameterization in Numerical Models}, - Ty = {JOUR}, - Url = {http://dx.doi.org/10.1175/1520-0469(1990)047<1012:CTEITS>2.0.CO;2}, - Volume = {47}, - Year = {1990}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0469(1990)047%3C1012:CTEITS%3E2.0.CO;2}} + abstract = {Abstract In a recent paper, Kuo and Schubert demonstrated the lack of observational support for the relevance of the criterion for cloud-top entrainment instability proposed by Randall and by Deardorff. Here we derive a new criterion, based on a model of the instability as resulting from the energy released close to cloud top, by Mixing between saturated boundary-layer air and unsaturated air from above the capping inversion. The condition is derived by considering the net conversion from potential to kinetic energy in a system consisting of two layers of fluid straddling cloud-top, when a small amount of mixing occurs between these layers. This contrasts with previous analyses, which only considered the change in buoyancy of the cloud layer when unsaturated air is mixed into it. In its most general form, this new criterion depends on the ratio of the depths of the layers involved in the mixing. It is argued that, for a self-sustaining instability, there must be a net release of kinetic energy on the same depth and time scales as the entrainment process itself. There are two plausible ways in which this requirement may be satisfied. Either one takes the depths of the layers involved in the mixing to each be comparable to the vertical scale of the entrainment process, which is typically of order tens of meters or less, or alternatively, one must allow for the efficiency with which energy released by mixing through a much deeper lower layer becomes available to initiate further entrainment. In both cases the same criterion for instability results. This criterion is much more restrictive than that proposed by Randall and by Deardorff; furthermore, the observational data is then consistent with the predictions of the current theory. Further analysis provides estimates of the turbulent fluxes associated with cloud-top entrainment instability. This analysis effectively constitutes an energetically consistent turbulence closure for models of boundary layers with cloud. The implications for such numerical models are discussed. Comparisons are also made with other possible criteria for cloud-top entrainment instability which have recently been suggested.}, + annote = {doi: 10.1175/1520-0469(1990)047<1012:CTEITS>2.0.CO;2}, + author = {MacVean, M. K. and Mason, P. J.}, + booktitle = {Journal of the Atmospheric Sciences}, + da = {1990/04/01}, + date-added = {2016-05-20 17:16:05 +0000}, + date-modified = {2016-05-20 17:16:05 +0000}, + doi = {10.1175/1520-0469(1990)047<1012:CTEITS>2.0.CO;2}, + isbn = {0022-4928}, + journal = {Journal of the Atmospheric Sciences}, + journal1 = {J. Atmos. Sci.}, + m3 = {doi: 10.1175/1520-0469(1990)047<1012:CTEITS>2.0.CO;2}, + n2 = {Abstract In a recent paper, Kuo and Schubert demonstrated the lack of observational support for the relevance of the criterion for cloud-top entrainment instability proposed by Randall and by Deardorff. Here we derive a new criterion, based on a model of the instability as resulting from the energy released close to cloud top, by Mixing between saturated boundary-layer air and unsaturated air from above the capping inversion. The condition is derived by considering the net conversion from potential to kinetic energy in a system consisting of two layers of fluid straddling cloud-top, when a small amount of mixing occurs between these layers. This contrasts with previous analyses, which only considered the change in buoyancy of the cloud layer when unsaturated air is mixed into it. In its most general form, this new criterion depends on the ratio of the depths of the layers involved in the mixing. It is argued that, for a self-sustaining instability, there must be a net release of kinetic energy on the same depth and time scales as the entrainment process itself. There are two plausible ways in which this requirement may be satisfied. Either one takes the depths of the layers involved in the mixing to each be comparable to the vertical scale of the entrainment process, which is typically of order tens of meters or less, or alternatively, one must allow for the efficiency with which energy released by mixing through a much deeper lower layer becomes available to initiate further entrainment. In both cases the same criterion for instability results. This criterion is much more restrictive than that proposed by Randall and by Deardorff; furthermore, the observational data is then consistent with the predictions of the current theory. Further analysis provides estimates of the turbulent fluxes associated with cloud-top entrainment instability. This analysis effectively constitutes an energetically consistent turbulence closure for models of boundary layers with cloud. The implications for such numerical models are discussed. Comparisons are also made with other possible criteria for cloud-top entrainment instability which have recently been suggested.}, + number = {8}, + pages = {1012--1030}, + publisher = {American Meteorological Society}, + title = {Cloud-Top Entrainment Instability through Small-Scale Mixing and Its Parameterization in Numerical Models}, + ty = {JOUR}, + url = {http://dx.doi.org/10.1175/1520-0469(1990)047<1012:CTEITS>2.0.CO;2}, + volume = {47}, + year = {1990}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBDLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvTWFjVmVhbi8xOTkwLnBkZk8RAcoAAAAAAcoAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAAFx8zwgxOTkwLnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAXHyn0rkkRQAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAHTWFjVmVhbgAAEAAIAADR53iyAAAAEQAIAADSuYa1AAAAAQAYAFx8zwAobJYAKGyLAChnewAbXgcAAphcAAIAXU1hY2ludG9zaCBIRDpVc2VyczoAZ3JhbnRmOgBDbG91ZFN0YXRpb246AGZpcmxfbGlicmFyeToAZmlybF9saWJyYXJ5X2ZpbGVzOgBNYWNWZWFuOgAxOTkwLnBkZgAADgASAAgAMQA5ADkAMAAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9NYWNWZWFuLzE5OTAucGRmABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGoAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOA==}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0469(1990)047%3C1012:CTEITS%3E2.0.CO;2}} @article{louis_1979, - Author = {Louis, J. F.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvTG91aXMvMTk3OS5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAonogIMTk3OS5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACiej8FuU4pQREYgQ0FSTwACAAUAAAkgAAAAAAAAAAAAAAAAAAAABUxvdWlzAAAQAAgAANHneLIAAAARAAgAAMFutfoAAAABABgAKJ6IAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AExvdWlzOgAxOTc5LnBkZgAADgASAAgAMQA5ADcAOQAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9Mb3Vpcy8xOTc5LnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, - Date-Added = {2016-05-20 17:15:52 +0000}, - Date-Modified = {2016-05-20 17:15:52 +0000}, - Isi = {A1979HT69700004}, - Isi-Recid = {38589235}, - Isi-Ref-Recids = {32937272 27172655 27973995 38589236 29980755 19632344 38589237 19828140 34242210 21296696 19828138 27480279 38589238 29798585 34762259 10294413 6132564 31988234 6116967 38589239 19944180 20358801 11541869}, - Iso-Source-Abbreviation = {Bound-Lay Meteorol}, - Journal = {Boundary-Layer Meteorology}, - Pages = {187--202}, - Times-Cited = {1308}, - Title = {A PARAMETRIC MODEL OF VERTICAL EDDY FLUXES IN THE ATMOSPHERE}, - Volume = {17}, - Year = {1979}, - Bdsk-Url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/A1979HT69700004}} + author = {Louis, J. F.}, + date-added = {2016-05-20 17:15:52 +0000}, + date-modified = {2016-05-20 17:15:52 +0000}, + isi = {A1979HT69700004}, + isi-recid = {38589235}, + isi-ref-recids = {32937272 27172655 27973995 38589236 29980755 19632344 38589237 19828140 34242210 21296696 19828138 27480279 38589238 29798585 34762259 10294413 6132564 31988234 6116967 38589239 19944180 20358801 11541869}, + iso-source-abbreviation = {Bound-Lay Meteorol}, + journal = {Boundary-Layer Meteorology}, + pages = {187--202}, + times-cited = {1308}, + title = {A PARAMETRIC MODEL OF VERTICAL EDDY FLUXES IN THE ATMOSPHERE}, + volume = {17}, + year = {1979}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBBLi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvTG91aXMvMTk3OS5wZGZPEQHEAAAAAAHEAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAonogIMTk3OS5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACiej8FuU4pQREYgQ0FSTwACAAUAAAkgAAAAAAAAAAAAAAAAAAAABUxvdWlzAAAQAAgAANHneLIAAAARAAgAAMFutfoAAAABABgAKJ6IAChslgAobIsAKGd7ABteBwACmFwAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AExvdWlzOgAxOTc5LnBkZgAADgASAAgAMQA5ADcAOQAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIASFVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9Mb3Vpcy8xOTc5LnBkZgATAAEvAAAVAAIADf//AAAACAANABoAJABoAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAjA=}, + bdsk-url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/A1979HT69700004}} @article{lock_et_al_2000, - Abstract = {A new boundary layer turbulent mixing scheme has been developed for use in the UKMO weather forecasting and climate prediction models. This includes a representation of nonlocal mixing (driven by both surface fluxes and cloud-top processes) in unstable layers, either coupled to or decoupled from the surface, and an explicit entrainment parameterization. The scheme is formulated in moist conserved variables so that it can treat both dry and cloudy layers. Details of the scheme and examples of its performance in single-column model tests are presented.}, - Author = {Lock, A. P. and Brown, A. R. and Bush, M. R. and Martin, G. M. and Smith, R.N.B.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBALi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvTG9jay8yMDAwLnBkZk8RAcAAAAAAAcAAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAACibewgyMDAwLnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKJuLywPrPAAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAETG9jawAQAAgAANHneLIAAAARAAgAAMsETawAAAABABgAKJt7AChslgAobIsAKGd7ABteBwACmFwAAgBaTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AExvY2s6ADIwMDAucGRmAA4AEgAIADIAMAAwADAALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEdVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvTG9jay8yMDAwLnBkZgAAEwABLwAAFQACAA3//wAAAAgADQAaACQAZwAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIr}, - Date-Added = {2016-05-20 17:15:36 +0000}, - Date-Modified = {2016-05-20 17:15:36 +0000}, - Isi = {000089461100008}, - Isi-Recid = {116839422}, - Isi-Ref-Recids = {66113175 96966405 98903448 97216236 59908706 113485125 109411221 98903447 103672714 101890728 47069286 95806864 73121798 76563289 85219981 116839423 108520240 38589235 30293075 116839425 92736669 109796435 83200873 90793545 72956034 72311841 44393377 60433145 63750105 105313074 98909959 27148086}, - Iso-Source-Abbreviation = {Mon Weather Rev}, - Journal = {Monthly Weather Review}, - Pages = {3187--3199}, - Times-Cited = {195}, - Title = {A new boundary layer mixing scheme. {P}art {I}: Scheme description and single-column model tests}, - Volume = {128}, - Year = {2000}, - Bdsk-Url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/000089461100008}} + abstract = {A new boundary layer turbulent mixing scheme has been developed for use in the UKMO weather forecasting and climate prediction models. This includes a representation of nonlocal mixing (driven by both surface fluxes and cloud-top processes) in unstable layers, either coupled to or decoupled from the surface, and an explicit entrainment parameterization. The scheme is formulated in moist conserved variables so that it can treat both dry and cloudy layers. Details of the scheme and examples of its performance in single-column model tests are presented.}, + author = {Lock, A. P. and Brown, A. R. and Bush, M. R. and Martin, G. M. and Smith, R.N.B.}, + date-added = {2016-05-20 17:15:36 +0000}, + date-modified = {2016-05-20 17:15:36 +0000}, + isi = {000089461100008}, + isi-recid = {116839422}, + isi-ref-recids = {66113175 96966405 98903448 97216236 59908706 113485125 109411221 98903447 103672714 101890728 47069286 95806864 73121798 76563289 85219981 116839423 108520240 38589235 30293075 116839425 92736669 109796435 83200873 90793545 72956034 72311841 44393377 60433145 63750105 105313074 98909959 27148086}, + iso-source-abbreviation = {Mon Weather Rev}, + journal = {Monthly Weather Review}, + pages = {3187--3199}, + times-cited = {195}, + title = {A new boundary layer mixing scheme. {P}art {I}: Scheme description and single-column model tests}, + volume = {128}, + year = {2000}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBALi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvTG9jay8yMDAwLnBkZk8RAcAAAAAAAcAAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAACibewgyMDAwLnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAKJuLywPrPAAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAETG9jawAQAAgAANHneLIAAAARAAgAAMsETawAAAABABgAKJt7AChslgAobIsAKGd7ABteBwACmFwAAgBaTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AExvY2s6ADIwMDAucGRmAA4AEgAIADIAMAAwADAALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEdVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvTG9jay8yMDAwLnBkZgAAEwABLwAAFQACAA3//wAAAAgADQAaACQAZwAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIr}, + bdsk-url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/000089461100008}} @article{hong_and_pan_1996, - Abstract = {Abstract In this paper, the incorporation of a simple atmospheric boundary layer diffusion scheme into the NCEP Medium-Range Forecast Model is described. A boundary layer diffusion package based on the Troen and Mahrt nonlocal diffusion concept has been tested for possible operational implementation. The results from this approach are compared with those from the local diffusion approach, which is the current operational scheme, and verified against FIFE observations during 9?10 August 1987. The comparisons between local and nonlocal approaches are extended to the forecast for a heavy rain case of 15?17 May 1995. The sensitivity of both the boundary layer development and the precipitation forecast to the tuning parameters in the nonlocal diffusion scheme is also investigated. Special attention is given to the interaction of boundary layer processes with precipitation physics. Some results of parallel runs during August 1995 are also presented.}, - Annote = {doi: 10.1175/1520-0493(1996)124<2322:NBLVDI>2.0.CO;2}, - Author = {Hong, S.-Y. and Pan, H.-L.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBALi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvSG9uZy8xOTk2LnBkZk8RAcAAAAAAAcAAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAAE18FggxOTk2LnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAATXvY0pRb8QAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAESG9uZwAQAAgAANHneLIAAAARAAgAANKUvmEAAAABABgATXwWAChslgAobIsAKGd7ABteBwACmFwAAgBaTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AEhvbmc6ADE5OTYucGRmAA4AEgAIADEAOQA5ADYALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEdVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvSG9uZy8xOTk2LnBkZgAAEwABLwAAFQACAA3//wAAAAgADQAaACQAZwAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIr}, - Booktitle = {Monthly Weather Review}, - Da = {1996/10/01}, - Date = {1996/10/01}, - Date-Added = {2016-05-20 17:14:38 +0000}, - Date-Modified = {2016-05-20 17:14:38 +0000}, - Doi = {10.1175/1520-0493(1996)124<2322:NBLVDI>2.0.CO;2}, - Isbn = {0027-0644}, - Journal = {Monthly Weather Review}, - Journal1 = {Mon. Wea. Rev.}, - M3 = {doi: 10.1175/1520-0493(1996)124<2322:NBLVDI>2.0.CO;2}, - N2 = {Abstract In this paper, the incorporation of a simple atmospheric boundary layer diffusion scheme into the NCEP Medium-Range Forecast Model is described. A boundary layer diffusion package based on the Troen and Mahrt nonlocal diffusion concept has been tested for possible operational implementation. The results from this approach are compared with those from the local diffusion approach, which is the current operational scheme, and verified against FIFE observations during 9?10 August 1987. The comparisons between local and nonlocal approaches are extended to the forecast for a heavy rain case of 15?17 May 1995. The sensitivity of both the boundary layer development and the precipitation forecast to the tuning parameters in the nonlocal diffusion scheme is also investigated. Special attention is given to the interaction of boundary layer processes with precipitation physics. Some results of parallel runs during August 1995 are also presented.}, - Number = {10}, - Pages = {2322--2339}, - Publisher = {American Meteorological Society}, - Title = {Nonlocal Boundary Layer Vertical Diffusion in a Medium-Range Forecast Model}, - Ty = {JOUR}, - Url = {http://dx.doi.org/10.1175/1520-0493(1996)124<2322:NBLVDI>2.0.CO;2}, - Volume = {124}, - Year = {1996}, - Year1 = {1996}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/1520-0493(1996)124%3C2322:NBLVDI%3E2.0.CO;2}} + abstract = {Abstract In this paper, the incorporation of a simple atmospheric boundary layer diffusion scheme into the NCEP Medium-Range Forecast Model is described. A boundary layer diffusion package based on the Troen and Mahrt nonlocal diffusion concept has been tested for possible operational implementation. The results from this approach are compared with those from the local diffusion approach, which is the current operational scheme, and verified against FIFE observations during 9?10 August 1987. The comparisons between local and nonlocal approaches are extended to the forecast for a heavy rain case of 15?17 May 1995. The sensitivity of both the boundary layer development and the precipitation forecast to the tuning parameters in the nonlocal diffusion scheme is also investigated. Special attention is given to the interaction of boundary layer processes with precipitation physics. Some results of parallel runs during August 1995 are also presented.}, + annote = {doi: 10.1175/1520-0493(1996)124<2322:NBLVDI>2.0.CO;2}, + author = {Hong, S.-Y. and Pan, H.-L.}, + booktitle = {Monthly Weather Review}, + da = {1996/10/01}, + date = {1996/10/01}, + date-added = {2016-05-20 17:14:38 +0000}, + date-modified = {2016-05-20 17:14:38 +0000}, + doi = {10.1175/1520-0493(1996)124<2322:NBLVDI>2.0.CO;2}, + isbn = {0027-0644}, + journal = {Monthly Weather Review}, + journal1 = {Mon. Wea. Rev.}, + m3 = {doi: 10.1175/1520-0493(1996)124<2322:NBLVDI>2.0.CO;2}, + n2 = {Abstract In this paper, the incorporation of a simple atmospheric boundary layer diffusion scheme into the NCEP Medium-Range Forecast Model is described. A boundary layer diffusion package based on the Troen and Mahrt nonlocal diffusion concept has been tested for possible operational implementation. The results from this approach are compared with those from the local diffusion approach, which is the current operational scheme, and verified against FIFE observations during 9?10 August 1987. The comparisons between local and nonlocal approaches are extended to the forecast for a heavy rain case of 15?17 May 1995. The sensitivity of both the boundary layer development and the precipitation forecast to the tuning parameters in the nonlocal diffusion scheme is also investigated. Special attention is given to the interaction of boundary layer processes with precipitation physics. Some results of parallel runs during August 1995 are also presented.}, + number = {10}, + pages = {2322--2339}, + publisher = {American Meteorological Society}, + title = {Nonlocal Boundary Layer Vertical Diffusion in a Medium-Range Forecast Model}, + ty = {JOUR}, + url = {http://dx.doi.org/10.1175/1520-0493(1996)124<2322:NBLVDI>2.0.CO;2}, + volume = {124}, + year = {1996}, + year1 = {1996}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBALi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvSG9uZy8xOTk2LnBkZk8RAcAAAAAAAcAAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAANHnJFJIKwAAAE18FggxOTk2LnBkZgAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAATXvY0pRb8QAAAAAAAAAAAAIABQAACSAAAAAAAAAAAAAAAAAAAAAESG9uZwAQAAgAANHneLIAAAARAAgAANKUvmEAAAABABgATXwWAChslgAobIsAKGd7ABteBwACmFwAAgBaTWFjaW50b3NoIEhEOlVzZXJzOgBncmFudGY6AENsb3VkU3RhdGlvbjoAZmlybF9saWJyYXJ5OgBmaXJsX2xpYnJhcnlfZmlsZXM6AEhvbmc6ADE5OTYucGRmAA4AEgAIADEAOQA5ADYALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEdVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvSG9uZy8xOTk2LnBkZgAAEwABLwAAFQACAA3//wAAAAgADQAaACQAZwAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIr}, + bdsk-url-1 = {http://dx.doi.org/10.1175/1520-0493(1996)124%3C2322:NBLVDI%3E2.0.CO;2}} @article{han_and_pan_2006, - Abstract = {Abstract A parameterization of the convection-induced pressure gradient force (PGF) in convective momentum transport (CMT) is tested for hurricane intensity forecasting using NCEP's operational Global Forecast System (GFS) and its nested Regional Spectral Model (RSM). In the parameterization the PGF is assumed to be proportional to the product of the cloud mass flux and vertical wind shear. Compared to control forecasts using the present operational GFS and RSM where the PGF effect in CMT is taken into account empirically, the new PGF parameterization helps increase hurricane intensity by reducing the vertical momentum exchange, giving rise to a closer comparison to the observations. In addition, the new PGF parameterization forecasts not only show more realistically organized precipitation patterns with enhanced hurricane intensity but also reduce the forecast track error. Nevertheless, the model forecasts with the new PGF parameterization still largely underpredict the observed intensity. One of the many possible reasons for the large underprediction may be the absence of hurricane initialization in the models.}, - Annote = {doi: 10.1175/MWR3090.1}, - Author = {Han, J. and Pan, H.-L.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxA/Li4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvSGFuLzIwMDYucGRmTxEBvgAAAAABvgACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAA0eckUkgrAAAAWsT5CDIwMDYucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABazFjStCvVAAAAAAAAAAAAAgAFAAAJIAAAAAAAAAAAAAAAAAAAAANIYW4AABAACAAA0ed4sgAAABEACAAA0rSORQAAAAEAGABaxPkAKGyWAChsiwAoZ3sAG14HAAKYXAACAFlNYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoASGFuOgAyMDA2LnBkZgAADgASAAgAMgAwADAANgAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIARlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9IYW4vMjAwNi5wZGYAEwABLwAAFQACAA3//wAAAAgADQAaACQAZgAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIo}, - Booktitle = {Monthly Weather Review}, - Da = {2006/02/01}, - Date-Added = {2016-05-20 17:11:17 +0000}, - Date-Modified = {2016-05-20 17:11:17 +0000}, - Doi = {10.1175/MWR3090.1}, - Isbn = {0027-0644}, - Journal = {Monthly Weather Review}, - Journal1 = {Mon. Wea. Rev.}, - M3 = {doi: 10.1175/MWR3090.1}, - N2 = {Abstract A parameterization of the convection-induced pressure gradient force (PGF) in convective momentum transport (CMT) is tested for hurricane intensity forecasting using NCEP's operational Global Forecast System (GFS) and its nested Regional Spectral Model (RSM). In the parameterization the PGF is assumed to be proportional to the product of the cloud mass flux and vertical wind shear. Compared to control forecasts using the present operational GFS and RSM where the PGF effect in CMT is taken into account empirically, the new PGF parameterization helps increase hurricane intensity by reducing the vertical momentum exchange, giving rise to a closer comparison to the observations. In addition, the new PGF parameterization forecasts not only show more realistically organized precipitation patterns with enhanced hurricane intensity but also reduce the forecast track error. Nevertheless, the model forecasts with the new PGF parameterization still largely underpredict the observed intensity. One of the many possible reasons for the large underprediction may be the absence of hurricane initialization in the models.}, - Number = {2}, - Pages = {664--674}, - Publisher = {American Meteorological Society}, - Title = {Sensitivity of Hurricane Intensity Forecast to Convective Momentum Transport Parameterization}, - Ty = {JOUR}, - Url = {http://dx.doi.org/10.1175/MWR3090.1}, - Volume = {134}, - Year = {2006}, - Bdsk-Url-1 = {http://dx.doi.org/10.1175/MWR3090.1}} + abstract = {Abstract A parameterization of the convection-induced pressure gradient force (PGF) in convective momentum transport (CMT) is tested for hurricane intensity forecasting using NCEP's operational Global Forecast System (GFS) and its nested Regional Spectral Model (RSM). In the parameterization the PGF is assumed to be proportional to the product of the cloud mass flux and vertical wind shear. Compared to control forecasts using the present operational GFS and RSM where the PGF effect in CMT is taken into account empirically, the new PGF parameterization helps increase hurricane intensity by reducing the vertical momentum exchange, giving rise to a closer comparison to the observations. In addition, the new PGF parameterization forecasts not only show more realistically organized precipitation patterns with enhanced hurricane intensity but also reduce the forecast track error. Nevertheless, the model forecasts with the new PGF parameterization still largely underpredict the observed intensity. One of the many possible reasons for the large underprediction may be the absence of hurricane initialization in the models.}, + annote = {doi: 10.1175/MWR3090.1}, + author = {Han, J. and Pan, H.-L.}, + booktitle = {Monthly Weather Review}, + da = {2006/02/01}, + date-added = {2016-05-20 17:11:17 +0000}, + date-modified = {2016-05-20 17:11:17 +0000}, + doi = {10.1175/MWR3090.1}, + isbn = {0027-0644}, + journal = {Monthly Weather Review}, + journal1 = {Mon. Wea. Rev.}, + m3 = {doi: 10.1175/MWR3090.1}, + n2 = {Abstract A parameterization of the convection-induced pressure gradient force (PGF) in convective momentum transport (CMT) is tested for hurricane intensity forecasting using NCEP's operational Global Forecast System (GFS) and its nested Regional Spectral Model (RSM). In the parameterization the PGF is assumed to be proportional to the product of the cloud mass flux and vertical wind shear. Compared to control forecasts using the present operational GFS and RSM where the PGF effect in CMT is taken into account empirically, the new PGF parameterization helps increase hurricane intensity by reducing the vertical momentum exchange, giving rise to a closer comparison to the observations. In addition, the new PGF parameterization forecasts not only show more realistically organized precipitation patterns with enhanced hurricane intensity but also reduce the forecast track error. Nevertheless, the model forecasts with the new PGF parameterization still largely underpredict the observed intensity. One of the many possible reasons for the large underprediction may be the absence of hurricane initialization in the models.}, + number = {2}, + pages = {664--674}, + publisher = {American Meteorological Society}, + title = {Sensitivity of Hurricane Intensity Forecast to Convective Momentum Transport Parameterization}, + ty = {JOUR}, + url = {http://dx.doi.org/10.1175/MWR3090.1}, + volume = {134}, + year = {2006}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxA/Li4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvSGFuLzIwMDYucGRmTxEBvgAAAAABvgACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAA0eckUkgrAAAAWsT5CDIwMDYucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABazFjStCvVAAAAAAAAAAAAAgAFAAAJIAAAAAAAAAAAAAAAAAAAAANIYW4AABAACAAA0ed4sgAAABEACAAA0rSORQAAAAEAGABaxPkAKGyWAChsiwAoZ3sAG14HAAKYXAACAFlNYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoASGFuOgAyMDA2LnBkZgAADgASAAgAMgAwADAANgAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIARlVzZXJzL2dyYW50Zi9DbG91ZFN0YXRpb24vZmlybF9saWJyYXJ5L2ZpcmxfbGlicmFyeV9maWxlcy9IYW4vMjAwNi5wZGYAEwABLwAAFQACAA3//wAAAAgADQAaACQAZgAAAAAAAAIBAAAAAAAAAAUAAAAAAAAAAAAAAAAAAAIo}, + bdsk-url-1 = {http://dx.doi.org/10.1175/MWR3090.1}} @article{businger_et_al_1971, - Author = {Businger, J. A. and Wyngaard, J. C. and Izumi, Y. and Bradley, E. F.}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBELi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQnVzaW5nZXIvMTk3MS5wZGZPEQHMAAAAAAHMAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAodUUIMTk3MS5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACh1cbTPIxwAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAACEJ1c2luZ2VyABAACAAA0ed4sgAAABEACAAAtM+FjAAAAAEAGAAodUUAKGyWAChsiwAoZ3sAG14HAAKYXAACAF5NYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoAQnVzaW5nZXI6ADE5NzEucGRmAA4AEgAIADEAOQA3ADEALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEtVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQnVzaW5nZXIvMTk3MS5wZGYAABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGsAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOw==}, - Date-Added = {2016-05-20 17:10:50 +0000}, - Date-Modified = {2018-07-18 18:58:08 +0000}, - Isi = {A1971I822800004}, - Isi-Recid = {19632344}, - Isi-Ref-Recids = {16272216 16824421 15490261 18767713 13407665 19632345 10481101 14142571 12686164 19632346 18858658 6152690 19632347 13839218 13839220 16272206 8976449 16824425 5541689 5062496 12462060 8185394 19632348 773111 19632349 19632350 19632351 8997317 15704607 15542957 18734229}, - Iso-Source-Abbreviation = {J Atmos Sci}, - Journal = {Journal of the Atmospheric Sciences}, - Pages = {181-189}, - Times-Cited = {1862}, - Title = {Flux-profile relationships in the atmospheric surface layer}, - Volume = {28}, - Year = {1971}, - Bdsk-Url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/A1971I822800004}} + author = {Businger, J. A. and Wyngaard, J. C. and Izumi, Y. and Bradley, E. F.}, + date-added = {2016-05-20 17:10:50 +0000}, + date-modified = {2018-07-18 18:58:08 +0000}, + isi = {A1971I822800004}, + isi-recid = {19632344}, + isi-ref-recids = {16272216 16824421 15490261 18767713 13407665 19632345 10481101 14142571 12686164 19632346 18858658 6152690 19632347 13839218 13839220 16272206 8976449 16824425 5541689 5062496 12462060 8185394 19632348 773111 19632349 19632350 19632351 8997317 15704607 15542957 18734229}, + iso-source-abbreviation = {J Atmos Sci}, + journal = {Journal of the Atmospheric Sciences}, + pages = {181-189}, + times-cited = {1862}, + title = {Flux-profile relationships in the atmospheric surface layer}, + volume = {28}, + year = {1971}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxBELi4vLi4vQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQnVzaW5nZXIvMTk3MS5wZGZPEQHMAAAAAAHMAAIAAAxNYWNpbnRvc2ggSEQAAAAAAAAAAAAAAAAAAADR5yRSSCsAAAAodUUIMTk3MS5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAACh1cbTPIxwAAAAAAAAAAAACAAUAAAkgAAAAAAAAAAAAAAAAAAAACEJ1c2luZ2VyABAACAAA0ed4sgAAABEACAAAtM+FjAAAAAEAGAAodUUAKGyWAChsiwAoZ3sAG14HAAKYXAACAF5NYWNpbnRvc2ggSEQ6VXNlcnM6AGdyYW50ZjoAQ2xvdWRTdGF0aW9uOgBmaXJsX2xpYnJhcnk6AGZpcmxfbGlicmFyeV9maWxlczoAQnVzaW5nZXI6ADE5NzEucGRmAA4AEgAIADEAOQA3ADEALgBwAGQAZgAPABoADABNAGEAYwBpAG4AdABvAHMAaAAgAEgARAASAEtVc2Vycy9ncmFudGYvQ2xvdWRTdGF0aW9uL2ZpcmxfbGlicmFyeS9maXJsX2xpYnJhcnlfZmlsZXMvQnVzaW5nZXIvMTk3MS5wZGYAABMAAS8AABUAAgAN//8AAAAIAA0AGgAkAGsAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACOw==}, + bdsk-url-1 = {http://ws.isiknowledge.com/cps/openurl/service?url_ver=Z39.88-2004&rft_id=info:ut/A1971I822800004}} @article{xu_and_randall_1996, - Author = {K.-M. Xu and D. A. Randall}, - Date-Added = {2016-05-20 16:22:45 +0000}, - Date-Modified = {2016-05-20 16:24:47 +0000}, - Journal = {J. Atmos. Sci.}, - Month = {3102}, - Number = {21}, - Pages = {3084}, - Title = {A semiempirical cloudiness parameterization for use in climate models}, - Volume = {53}, - Year = {1996}} + author = {K.-M. Xu and D. A. Randall}, + date-added = {2016-05-20 16:22:45 +0000}, + date-modified = {2016-05-20 16:24:47 +0000}, + journal = {J. Atmos. Sci.}, + month = {3102}, + number = {21}, + pages = {3084}, + title = {A semiempirical cloudiness parameterization for use in climate models}, + volume = {53}, + year = {1996}} @article{clough_et_al_1992, - Author = {S. A. Clough and M. J. Iacono and J. L. Moncet}, - Date-Added = {2016-05-20 15:32:24 +0000}, - Date-Modified = {2016-05-20 15:36:33 +0000}, - Journal = {J. Geophys. Res.}, - Month = {October}, - Number = {D14}, - Pages = {15761-15785}, - Title = {Line-by-line calculation of atmospheric fluxes and cooling rates: Application to water vapor}, - Volume = {97}, - Year = {1992}} + author = {S. A. Clough and M. J. Iacono and J. L. Moncet}, + date-added = {2016-05-20 15:32:24 +0000}, + date-modified = {2016-05-20 15:36:33 +0000}, + journal = {J. Geophys. Res.}, + month = {October}, + number = {D14}, + pages = {15761-15785}, + title = {Line-by-line calculation of atmospheric fluxes and cooling rates: Application to water vapor}, + volume = {97}, + year = {1992}} @techreport{chou_and_suarez_1999, - Author = {M. D. Chou and M. J. Suarez}, - Date-Added = {2016-05-20 15:27:31 +0000}, - Date-Modified = {2016-05-20 15:30:02 +0000}, - Institution = {NASA}, - Number = {15}, - Title = {A solar radiation parameterization for atmospheric studies}, - Type = {Technical Memorandum}, - Year = {1999}} + author = {M. D. Chou and M. J. Suarez}, + date-added = {2016-05-20 15:27:31 +0000}, + date-modified = {2016-05-20 15:30:02 +0000}, + institution = {NASA}, + number = {15}, + title = {A solar radiation parameterization for atmospheric studies}, + type = {Technical Memorandum}, + year = {1999}} @article{sato_et_al_1993, - Author = {M. Sato and J. E. Hansan and M. P. McCormick and J. B. Pollack}, - Date-Added = {2016-05-20 04:23:08 +0000}, - Date-Modified = {2018-02-20 19:58:29 +0000}, - Journal = {J. Geophys. Res.}, - Number = {D12}, - Pages = {22987-22994}, - Title = {Stratospheric aerosol optical depth, 1985-1990}, - Volume = {98}, - Year = {1993}} + author = {M. Sato and J. E. Hansan and M. P. McCormick and J. B. Pollack}, + date-added = {2016-05-20 04:23:08 +0000}, + date-modified = {2018-02-20 19:58:29 +0000}, + journal = {J. Geophys. Res.}, + number = {D12}, + pages = {22987-22994}, + title = {Stratospheric aerosol optical depth, 1985-1990}, + volume = {98}, + year = {1993}} @article{chin_et_al_2000, - Author = {M. Chin and R. B. Rood and S-J. Lin and J-F. Muller and A. M. Thompson}, - Date-Added = {2016-05-20 04:18:03 +0000}, - Date-Modified = {2016-05-20 15:07:33 +0000}, - Journal = {J. Geophys. Res.}, - Month = {October}, - Number = {D20}, - Pages = {24671-24687}, - Title = {Atmospheric sulfur cycle simulated in the global model {GOCART}: Model description and global properties}, - Volume = {105}, - Year = {2000}} + author = {M. Chin and R. B. Rood and S-J. Lin and J-F. Muller and A. M. Thompson}, + date-added = {2016-05-20 04:18:03 +0000}, + date-modified = {2016-05-20 15:07:33 +0000}, + journal = {J. Geophys. Res.}, + month = {October}, + number = {D20}, + pages = {24671-24687}, + title = {Atmospheric sulfur cycle simulated in the global model {GOCART}: Model description and global properties}, + volume = {105}, + year = {2000}} @article{hess_et_al_1998, - Author = {M. Hess and P. Koepke and I. Schult}, - Date-Added = {2016-05-20 04:06:58 +0000}, - Date-Modified = {2016-05-20 15:08:21 +0000}, - Journal = {Bull. Am. Meteor. Soc.}, - Pages = {831-844}, - Title = {Optical properties of aerosols and clouds: The software package {OPAC}}, - Volume = {79}, - Year = {1998}} + author = {M. Hess and P. Koepke and I. Schult}, + date-added = {2016-05-20 04:06:58 +0000}, + date-modified = {2016-05-20 15:08:21 +0000}, + journal = {Bull. Am. Meteor. Soc.}, + pages = {831-844}, + title = {Optical properties of aerosols and clouds: The software package {OPAC}}, + volume = {79}, + year = {1998}} @article{iacono_et_al_2000, - Author = {M. J. Iacono and E. J. Mlawer and S. A. Clough and J.-J. Morcrette}, - Date-Added = {2016-05-20 03:45:26 +0000}, - Date-Modified = {2016-05-20 15:08:59 +0000}, - Journal = {J. Geophys. Res.}, - Pages = {14873-14890}, - Title = {Impact of an improved longwave radiation model, {RRTM}, on the energy budget and thermodynamic properties of the {NCAR} community climate model, {CCM3}}, - Volume = {105}, - Year = {2000}} + author = {M. J. Iacono and E. J. Mlawer and S. A. Clough and J.-J. Morcrette}, + date-added = {2016-05-20 03:45:26 +0000}, + date-modified = {2016-05-20 15:08:59 +0000}, + journal = {J. Geophys. Res.}, + pages = {14873-14890}, + title = {Impact of an improved longwave radiation model, {RRTM}, on the energy budget and thermodynamic properties of the {NCAR} community climate model, {CCM3}}, + volume = {105}, + year = {2000}} @article{clough_et_al_2005, - Author = {S. A. Clough and M. W. Shephard and E. J. Mlawer and J.S. Delamere and M. J. Iacono and K. Cady-Pereira and S. Boukabara and P. D. Brown}, - Date-Added = {2016-05-20 03:39:46 +0000}, - Date-Modified = {2016-05-20 15:10:30 +0000}, - Journal = {J. Quant. Spectrosc. Radiat. Transfer}, - Pages = {233-244}, - Title = {Atmospheric radiative transfer modeling: A summary of the {AER} codes}, - Volume = {91}, - Year = {2005}} + author = {S. A. Clough and M. W. Shephard and E. J. Mlawer and J.S. Delamere and M. J. Iacono and K. Cady-Pereira and S. Boukabara and P. D. Brown}, + date-added = {2016-05-20 03:39:46 +0000}, + date-modified = {2016-05-20 15:10:30 +0000}, + journal = {J. Quant. Spectrosc. Radiat. Transfer}, + pages = {233-244}, + title = {Atmospheric radiative transfer modeling: A summary of the {AER} codes}, + volume = {91}, + year = {2005}} @article{heymsfield_and_mcfarquhar_1996, - Author = {A. J. Heymsfield and G. M. McFarquhar}, - Date-Added = {2016-05-20 03:35:53 +0000}, - Date-Modified = {2016-05-24 17:35:50 +0000}, - Journal = {J. Atmos. Sci.}, - Pages = {2424-2451}, - Title = {High albedos of cirrus in the tropical {P}acific warm pool: Microphysical interpretations from {CEPEX} and from {K}wajalein, {M}arshall {I}slands}, - Volume = {53}, - Year = {1996}} + author = {A. J. Heymsfield and G. M. McFarquhar}, + date-added = {2016-05-20 03:35:53 +0000}, + date-modified = {2016-05-24 17:35:50 +0000}, + journal = {J. Atmos. Sci.}, + pages = {2424-2451}, + title = {High albedos of cirrus in the tropical {P}acific warm pool: Microphysical interpretations from {CEPEX} and from {K}wajalein, {M}arshall {I}slands}, + volume = {53}, + year = {1996}} @article{mlawer_et_al_1997, - Author = {E. J. Mlawer and S. J. Taubman and P. D. Brown and M. J. Iacono and S. A. Clough}, - Date-Added = {2016-05-20 03:32:32 +0000}, - Date-Modified = {2016-05-20 15:12:05 +0000}, - Journal = {J. Geophys. Res.}, - Number = {16663-16682}, - Title = {Radiative transfer for inhomogenerous atmospheres: {RRTM}, a validated correlated-k model for the longwave}, - Volume = {102}, - Year = {1997}} + author = {E. J. Mlawer and S. J. Taubman and P. D. Brown and M. J. Iacono and S. A. Clough}, + date-added = {2016-05-20 03:32:32 +0000}, + date-modified = {2016-05-20 15:12:05 +0000}, + journal = {J. Geophys. Res.}, + number = {16663-16682}, + title = {Radiative transfer for inhomogenerous atmospheres: {RRTM}, a validated correlated-k model for the longwave}, + volume = {102}, + year = {1997}} @article{Schwarzkopf_and_Fels_1991, - Author = {M. D. Schwarzkopf and S. B. Fels}, - Date-Added = {2016-05-20 03:29:16 +0000}, - Date-Modified = {2016-05-20 15:12:19 +0000}, - Journal = {J. Geophys. Res.}, - Pages = {9075-9096}, - Title = {The simplified exchange method revisited: An accurate, rapid method for computation of infrared cooling rates and fluxes}, - Volume = {96}, - Year = {1991}} + author = {M. D. Schwarzkopf and S. B. Fels}, + date-added = {2016-05-20 03:29:16 +0000}, + date-modified = {2016-05-20 15:12:19 +0000}, + journal = {J. Geophys. Res.}, + pages = {9075-9096}, + title = {The simplified exchange method revisited: An accurate, rapid method for computation of infrared cooling rates and fluxes}, + volume = {96}, + year = {1991}} @article{briegleb_1992, - Author = {B. P. Briegleb}, - Date-Added = {2016-05-20 03:09:50 +0000}, - Date-Modified = {2016-05-20 15:12:27 +0000}, - Journal = {J. Geophys. Res.}, - Pages = {7603-7612}, - Title = {Delta-Eddington approximation for solar radiation in the {NCAR} community climate model}, - Volume = {97}, - Year = {1992}} + author = {B. P. Briegleb}, + date-added = {2016-05-20 03:09:50 +0000}, + date-modified = {2016-05-20 15:12:27 +0000}, + journal = {J. Geophys. Res.}, + pages = {7603-7612}, + title = {Delta-Eddington approximation for solar radiation in the {NCAR} community climate model}, + volume = {97}, + year = {1992}} @conference{alpert_et_al_1988, - Address = {Baltimore, MD}, - Author = {J. C. Alpert and M. Kanamitsu and P. M. Caplan and J. G. Sela and G. H. White and E. Kalnay}, - Date-Added = {2016-05-19 22:40:01 +0000}, - Date-Modified = {2018-10-26 15:54:19 -0600}, - Organization = {Eighth Conf. on Numerical Weather Prediction, Amer. Meteor. Soc.}, - Pages = {726-733}, - Title = {Mountain induced gravity wave drag parameterization in the {NMC} medium-range forecast model}, - Year = {1988}} + address = {Baltimore, MD}, + author = {J. C. Alpert and M. Kanamitsu and P. M. Caplan and J. G. Sela and G. H. White and E. Kalnay}, + date-added = {2016-05-19 22:40:01 +0000}, + date-modified = {2018-10-26 15:54:19 -0600}, + organization = {Eighth Conf. on Numerical Weather Prediction, Amer. Meteor. Soc.}, + pages = {726-733}, + title = {Mountain induced gravity wave drag parameterization in the {NMC} medium-range forecast model}, + year = {1988}} @conference{alpert_et_al_1996, - Address = {Norfolk}, - Author = {J. C. Alpert and S-Y. Hong and Y-J. Kim}, - Date-Added = {2016-05-19 22:36:02 +0000}, - Date-Modified = {2016-05-20 15:14:15 +0000}, - Organization = {11 Conf. on NWP}, - Pages = {322-323}, - Title = {Sensitivity of cyclogenesis to lower troposphere enhancement of gravity wave drag using the {EMC MRF}}, - Year = {1996}} + address = {Norfolk}, + author = {J. C. Alpert and S-Y. Hong and Y-J. Kim}, + date-added = {2016-05-19 22:36:02 +0000}, + date-modified = {2016-05-20 15:14:15 +0000}, + organization = {11 Conf. on NWP}, + pages = {322-323}, + title = {Sensitivity of cyclogenesis to lower troposphere enhancement of gravity wave drag using the {EMC MRF}}, + year = {1996}} @conference{alpert_2006, - Author = {J. C. Alpert}, - Booktitle = {20th Conf. WAF/16 Conf. NWP}, - Date-Added = {2016-05-19 21:24:23 +0000}, - Date-Modified = {2016-05-20 15:14:34 +0000}, - Number = {P2.4}, - Title = {Sub-grid scale mountain blocking at {NCEP}}, - Year = {2006}} + author = {J. C. Alpert}, + booktitle = {20th Conf. WAF/16 Conf. NWP}, + date-added = {2016-05-19 21:24:23 +0000}, + date-modified = {2016-05-20 15:14:34 +0000}, + number = {P2.4}, + title = {Sub-grid scale mountain blocking at {NCEP}}, + year = {2006}} @article{ebert_and_curry_1992, - Author = {E. E. Ebert and J. A. Curry}, - Date-Added = {2016-05-19 21:19:00 +0000}, - Date-Modified = {2016-05-20 15:12:43 +0000}, - Journal = {J. Geophys. Res.}, - Pages = {3831-3836}, - Title = {A parameterization of ice cloud optical properties for climate models}, - Volume = {97}, - Year = {1992}} + author = {E. E. Ebert and J. A. Curry}, + date-added = {2016-05-19 21:19:00 +0000}, + date-modified = {2016-05-20 15:12:43 +0000}, + journal = {J. Geophys. Res.}, + pages = {3831-3836}, + title = {A parameterization of ice cloud optical properties for climate models}, + volume = {97}, + year = {1992}} @article{fu_1996, - Author = {Q. Fu}, - Date-Added = {2016-05-19 21:16:22 +0000}, - Date-Modified = {2016-05-20 15:12:51 +0000}, - Journal = {J. Climate}, - Pages = {2058-2082}, - Title = {An accurate parameterization of the solar radiative properties of cirrus clouds for climate models}, - Volume = {9}, - Year = {1996}} + author = {Q. Fu}, + date-added = {2016-05-19 21:16:22 +0000}, + date-modified = {2016-05-20 15:12:51 +0000}, + journal = {J. Climate}, + pages = {2058-2082}, + title = {An accurate parameterization of the solar radiative properties of cirrus clouds for climate models}, + volume = {9}, + year = {1996}} @article{kim_and_arakawa_1995, - Author = {Y.-J. Kim and A. Arakawa}, - Date-Added = {2016-05-19 21:06:13 +0000}, - Date-Modified = {2018-03-28 22:14:20 +0000}, - Journal = {J. Atmos. Sci.}, - Pages = {1875-1902}, - Title = {Improvement of orographic gravity wave parameterization using a mesoscale gravity-wave model}, - Volume = {52}, - Year = {1995}} + author = {Y.-J. Kim and A. Arakawa}, + date-added = {2016-05-19 21:06:13 +0000}, + date-modified = {2018-03-28 22:14:20 +0000}, + journal = {J. Atmos. Sci.}, + pages = {1875-1902}, + title = {Improvement of orographic gravity wave parameterization using a mesoscale gravity-wave model}, + volume = {52}, + year = {1995}} @techreport{hou_et_al_2002, - Author = {Y. Hou and S. Moorthi and K. Campana}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxAiLi4vLi4vemhhbmctbGliL2hvdV9ldF9hbF8yMDAyLnBkZk8RAdwAAAAAAdwAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAAM/T1mZIKwAAAFKkjRJob3VfZXRfYWxfMjAwMi5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAUqai02OGCgAAAAAAAAAAAAIAAgAACSAAAAAAAAAAAAAAAAAAAAAJemhhbmctbGliAAAQAAgAAM/UKsYAAAARAAgAANNj2moAAAABABgAUqSNAE1lSgAj19QACTbFAAk2xAACZvkAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBtYW56aGFuZzoARG9jdW1lbnRzOgBNYW4uWmhhbmc6AGdtdGItZG9jOgB6aGFuZy1saWI6AGhvdV9ldF9hbF8yMDAyLnBkZgAADgAmABIAaABvAHUAXwBlAHQAXwBhAGwAXwAyADAAMAAyAC4AcABkAGYADwAaAAwATQBhAGMAaQBuAHQAbwBzAGgAIABIAEQAEgBIVXNlcnMvbWFuemhhbmcvRG9jdW1lbnRzL01hbi5aaGFuZy9nbXRiLWRvYy96aGFuZy1saWIvaG91X2V0X2FsXzIwMDIucGRmABMAAS8AABUAAgAP//8AAAAIAA0AGgAkAEkAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACKQ==}, - Date-Added = {2016-05-19 19:52:22 +0000}, - Date-Modified = {2016-05-20 15:14:59 +0000}, - Institution = {NCEP}, - Number = {441}, - Title = {Parameterization of Solar Radiation Transfer}, - Type = {office note}, - Year = {2002}} + author = {Y. Hou and S. Moorthi and K. Campana}, + date-added = {2016-05-19 19:52:22 +0000}, + date-modified = {2016-05-20 15:14:59 +0000}, + institution = {NCEP}, + number = {441}, + title = {Parameterization of Solar Radiation Transfer}, + type = {office note}, + year = {2002}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxAiLi4vLi4vemhhbmctbGliL2hvdV9ldF9hbF8yMDAyLnBkZk8RAdwAAAAAAdwAAgAADE1hY2ludG9zaCBIRAAAAAAAAAAAAAAAAAAAAM/T1mZIKwAAAFKkjRJob3VfZXRfYWxfMjAwMi5wZGYAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAUqai02OGCgAAAAAAAAAAAAIAAgAACSAAAAAAAAAAAAAAAAAAAAAJemhhbmctbGliAAAQAAgAAM/UKsYAAAARAAgAANNj2moAAAABABgAUqSNAE1lSgAj19QACTbFAAk2xAACZvkAAgBbTWFjaW50b3NoIEhEOlVzZXJzOgBtYW56aGFuZzoARG9jdW1lbnRzOgBNYW4uWmhhbmc6AGdtdGItZG9jOgB6aGFuZy1saWI6AGhvdV9ldF9hbF8yMDAyLnBkZgAADgAmABIAaABvAHUAXwBlAHQAXwBhAGwAXwAyADAAMAAyAC4AcABkAGYADwAaAAwATQBhAGMAaQBuAHQAbwBzAGgAIABIAEQAEgBIVXNlcnMvbWFuemhhbmcvRG9jdW1lbnRzL01hbi5aaGFuZy9nbXRiLWRvYy96aGFuZy1saWIvaG91X2V0X2FsXzIwMDIucGRmABMAAS8AABUAAgAP//8AAAAIAA0AGgAkAEkAAAAAAAACAQAAAAAAAAAFAAAAAAAAAAAAAAAAAAACKQ==}} @article{hu_and_stamnes_1993, - Author = {Y. X. Hu and K. Stamnes}, - Bdsk-File-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxAnLi4vLi4vemhhbmctbGliL2h1X2FuZF9zdGFtbmVzXzE5OTMucGRmTxEB8AAAAAAB8AACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAAz9PWZkgrAAAAUqSNF2h1X2FuZF9zdGFtbmVzXzE5OTMucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABSpJHTY3R+AAAAAAAAAAAAAgACAAAJIAAAAAAAAAAAAAAAAAAAAAl6aGFuZy1saWIAABAACAAAz9QqxgAAABEACAAA02PI3gAAAAEAGABSpI0ATWVKACPX1AAJNsUACTbEAAJm+QACAGBNYWNpbnRvc2ggSEQ6VXNlcnM6AG1hbnpoYW5nOgBEb2N1bWVudHM6AE1hbi5aaGFuZzoAZ210Yi1kb2M6AHpoYW5nLWxpYjoAaHVfYW5kX3N0YW1uZXNfMTk5My5wZGYADgAwABcAaAB1AF8AYQBuAGQAXwBzAHQAYQBtAG4AZQBzAF8AMQA5ADkAMwAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIATVVzZXJzL21hbnpoYW5nL0RvY3VtZW50cy9NYW4uWmhhbmcvZ210Yi1kb2MvemhhbmctbGliL2h1X2FuZF9zdGFtbmVzXzE5OTMucGRmAAATAAEvAAAVAAIAD///AAAACAANABoAJABOAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAkI=}, - Date-Added = {2016-05-19 19:31:56 +0000}, - Date-Modified = {2016-05-20 15:13:12 +0000}, - Journal = {J. Climate}, - Month = {April}, - Pages = {728-742}, - Title = {An accurate parameterization of the radiative properties of water clouds suitable for use in climate models}, - Volume = {6}, - Year = {1993}} + author = {Y. X. Hu and K. Stamnes}, + date-added = {2016-05-19 19:31:56 +0000}, + date-modified = {2016-05-20 15:13:12 +0000}, + journal = {J. Climate}, + month = {April}, + pages = {728-742}, + title = {An accurate parameterization of the radiative properties of water clouds suitable for use in climate models}, + volume = {6}, + year = {1993}, + bdsk-file-1 = {YnBsaXN0MDDSAQIDBFxyZWxhdGl2ZVBhdGhZYWxpYXNEYXRhXxAnLi4vLi4vemhhbmctbGliL2h1X2FuZF9zdGFtbmVzXzE5OTMucGRmTxEB8AAAAAAB8AACAAAMTWFjaW50b3NoIEhEAAAAAAAAAAAAAAAAAAAAz9PWZkgrAAAAUqSNF2h1X2FuZF9zdGFtbmVzXzE5OTMucGRmAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAAABSpJHTY3R+AAAAAAAAAAAAAgACAAAJIAAAAAAAAAAAAAAAAAAAAAl6aGFuZy1saWIAABAACAAAz9QqxgAAABEACAAA02PI3gAAAAEAGABSpI0ATWVKACPX1AAJNsUACTbEAAJm+QACAGBNYWNpbnRvc2ggSEQ6VXNlcnM6AG1hbnpoYW5nOgBEb2N1bWVudHM6AE1hbi5aaGFuZzoAZ210Yi1kb2M6AHpoYW5nLWxpYjoAaHVfYW5kX3N0YW1uZXNfMTk5My5wZGYADgAwABcAaAB1AF8AYQBuAGQAXwBzAHQAYQBtAG4AZQBzAF8AMQA5ADkAMwAuAHAAZABmAA8AGgAMAE0AYQBjAGkAbgB0AG8AcwBoACAASABEABIATVVzZXJzL21hbnpoYW5nL0RvY3VtZW50cy9NYW4uWmhhbmcvZ210Yi1kb2MvemhhbmctbGliL2h1X2FuZF9zdGFtbmVzXzE5OTMucGRmAAATAAEvAAAVAAIAD///AAAACAANABoAJABOAAAAAAAAAgEAAAAAAAAABQAAAAAAAAAAAAAAAAAAAkI=}} @article{alexander_et_al_2010, - Author = {Alexander, M. J. and Geller, M. and McLandress, C. and et al.}, - Doi = {10.1002/qj.637}, - Eprint = {https://rmets.onlinelibrary.wiley.com/doi/pdf/10.1002/qj.637}, - Journal = {Quarterly Journal of the Royal Meteorological Society}, - Keywords = {atmosphere, gravity wave, momentum flux, drag, force, wind tendency, climate, global model}, - Number = {650}, - Pages = {1103-1124}, - Title = {Recent developments in gravity-wave effects in climate models and the global distribution of gravity-wave momentum flux from observations and models}, - Url = {https://rmets.onlinelibrary.wiley.com/doi/abs/10.1002/qj.637}, - Volume = {136}, - Year = {2010}, - Bdsk-Url-1 = {https://rmets.onlinelibrary.wiley.com/doi/abs/10.1002/qj.637}, - Bdsk-Url-2 = {http://dx.doi.org/10.1002/qj.637}} + author = {Alexander, M. J. and Geller, M. and McLandress, C. and et al.}, + doi = {10.1002/qj.637}, + eprint = {https://rmets.onlinelibrary.wiley.com/doi/pdf/10.1002/qj.637}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + keywords = {atmosphere, gravity wave, momentum flux, drag, force, wind tendency, climate, global model}, + number = {650}, + pages = {1103-1124}, + title = {Recent developments in gravity-wave effects in climate models and the global distribution of gravity-wave momentum flux from observations and models}, + url = {https://rmets.onlinelibrary.wiley.com/doi/abs/10.1002/qj.637}, + volume = {136}, + year = {2010}, + bdsk-url-1 = {https://rmets.onlinelibrary.wiley.com/doi/abs/10.1002/qj.637}, + bdsk-url-2 = {http://dx.doi.org/10.1002/qj.637}} @article{plougonven_and_zhang_2014, - Author = {Plougonven, R. and Zhang, F.}, - Doi = {10.1002/2012RG000419}, - Eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1002/2012RG000419}, - Journal = {Reviews of Geophysics}, - Keywords = {gravity waves, stratosphere, atmosphere, jets, fronts, weather}, - Number = {1}, - Pages = {33-76}, - Title = {Internal gravity waves from atmospheric jets and fronts}, - Url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1002/2012RG000419}, - Volume = {52}, - Year = {2014}, - Bdsk-Url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1002/2012RG000419}, - Bdsk-Url-2 = {http://dx.doi.org/10.1002/2012RG000419}} + author = {Plougonven, R. and Zhang, F.}, + doi = {10.1002/2012RG000419}, + eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1002/2012RG000419}, + journal = {Reviews of Geophysics}, + keywords = {gravity waves, stratosphere, atmosphere, jets, fronts, weather}, + number = {1}, + pages = {33-76}, + title = {Internal gravity waves from atmospheric jets and fronts}, + url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1002/2012RG000419}, + volume = {52}, + year = {2014}, + bdsk-url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1002/2012RG000419}, + bdsk-url-2 = {http://dx.doi.org/10.1002/2012RG000419}} @article{weinstock_1984, - Author = {Weinstock, J.}, - Doi = {10.1029/JA089iA01p00345}, - Eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/JA089iA01p00345}, - Journal = {Journal of Geophysical Research: Space Physics}, - Number = {A1}, - Pages = {345-350}, - Title = {Simplified derivation of an algorithm for nonlinear gravity waves}, - Url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/JA089iA01p00345}, - Volume = {89}, - Year = {1984}, - Bdsk-Url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/JA089iA01p00345}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/JA089iA01p00345}} + author = {Weinstock, J.}, + doi = {10.1029/JA089iA01p00345}, + eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/JA089iA01p00345}, + journal = {Journal of Geophysical Research: Space Physics}, + number = {A1}, + pages = {345-350}, + title = {Simplified derivation of an algorithm for nonlinear gravity waves}, + url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/JA089iA01p00345}, + volume = {89}, + year = {1984}, + bdsk-url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/JA089iA01p00345}, + bdsk-url-2 = {http://dx.doi.org/10.1029/JA089iA01p00345}} @article{holton_1983, - Author = {Holton, J. R.}, - Doi = {10.1175/1520-0469(1983)040<2497:TIOGWB>2.0.CO;2}, - Eprint = {https://doi.org/10.1175/1520-0469(1983)040<2497:TIOGWB>2.0.CO;2}, - Journal = {Journal of the Atmospheric Sciences}, - Number = {10}, - Pages = {2497-2507}, - Title = {The Influence of Gravity Wave Breaking on the General Circulation of the Middle Atmosphere}, - Url = {https://doi.org/10.1175/1520-0469(1983)040<2497:TIOGWB>2.0.CO;2}, - Volume = {40}, - Year = {1983}, - Bdsk-Url-1 = {https://doi.org/10.1175/1520-0469(1983)040%3C2497:TIOGWB%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0469(1983)040%3C2497:TIOGWB%3E2.0.CO;2}} + author = {Holton, J. R.}, + doi = {10.1175/1520-0469(1983)040<2497:TIOGWB>2.0.CO;2}, + eprint = {https://doi.org/10.1175/1520-0469(1983)040<2497:TIOGWB>2.0.CO;2}, + journal = {Journal of the Atmospheric Sciences}, + number = {10}, + pages = {2497-2507}, + title = {The Influence of Gravity Wave Breaking on the General Circulation of the Middle Atmosphere}, + url = {https://doi.org/10.1175/1520-0469(1983)040<2497:TIOGWB>2.0.CO;2}, + volume = {40}, + year = {1983}, + bdsk-url-1 = {https://doi.org/10.1175/1520-0469(1983)040%3C2497:TIOGWB%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0469(1983)040%3C2497:TIOGWB%3E2.0.CO;2}} @article{geller_et_al_2013, - Author = {Geller, M. A. and Alexander, M. J. and Love, P. T. and et al.}, - Doi = {10.1175/JCLI-D-12-00545.1}, - Eprint = {https://doi.org/10.1175/JCLI-D-12-00545.1}, - Journal = {Journal of Climate}, - Number = {17}, - Pages = {6383-6405}, - Title = {A Comparison between Gravity Wave Momentum Fluxes in Observations and Climate Models}, - Url = {https://doi.org/10.1175/JCLI-D-12-00545.1}, - Volume = {26}, - Year = {2013}, - Bdsk-Url-1 = {https://doi.org/10.1175/JCLI-D-12-00545.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/JCLI-D-12-00545.1}} + author = {Geller, M. A. and Alexander, M. J. and Love, P. T. and et al.}, + doi = {10.1175/JCLI-D-12-00545.1}, + eprint = {https://doi.org/10.1175/JCLI-D-12-00545.1}, + journal = {Journal of Climate}, + number = {17}, + pages = {6383-6405}, + title = {A Comparison between Gravity Wave Momentum Fluxes in Observations and Climate Models}, + url = {https://doi.org/10.1175/JCLI-D-12-00545.1}, + volume = {26}, + year = {2013}, + bdsk-url-1 = {https://doi.org/10.1175/JCLI-D-12-00545.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/JCLI-D-12-00545.1}} @article{garcia_et_al_2017, - Author = {Garcia, R. R. and Smith, A. K. and Kinnison, D. E. and C{\'a}mara, {\'A}. and Murphy, D. J.}, - Doi = {10.1175/JAS-D-16-0104.1}, - Eprint = {https://doi.org/10.1175/JAS-D-16-0104.1}, - Journal = {Journal of the Atmospheric Sciences}, - Number = {1}, - Pages = {275-291}, - Title = {Modification of the Gravity Wave Parameterization in the Whole Atmosphere Community Climate Model: Motivation and Results}, - Url = {https://doi.org/10.1175/JAS-D-16-0104.1}, - Volume = {74}, - Year = {2017}, - Bdsk-Url-1 = {https://doi.org/10.1175/JAS-D-16-0104.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/JAS-D-16-0104.1}} + author = {Garcia, R. R. and Smith, A. K. and Kinnison, D. E. and C{\'a}mara, {\'A}. and Murphy, D. J.}, + doi = {10.1175/JAS-D-16-0104.1}, + eprint = {https://doi.org/10.1175/JAS-D-16-0104.1}, + journal = {Journal of the Atmospheric Sciences}, + number = {1}, + pages = {275-291}, + title = {Modification of the Gravity Wave Parameterization in the Whole Atmosphere Community Climate Model: Motivation and Results}, + url = {https://doi.org/10.1175/JAS-D-16-0104.1}, + volume = {74}, + year = {2017}, + bdsk-url-1 = {https://doi.org/10.1175/JAS-D-16-0104.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/JAS-D-16-0104.1}} @inproceedings{yudin_et_al_2016, - Author = {Yudin, V. A. and Akmaev, R. A. and Fuller-Rowell, T. J. and Alpert, J. C.}, - Booktitle = {International SPARC Gravity Wave Symposium}, - Number = {1}, - Pages = {012024}, - Title = {Gravity wave physics in the {NOAA} Environmental Modeling System}, - Volume = {48}, - Year = {2016}} + author = {Yudin, V. A. and Akmaev, R. A. and Fuller-Rowell, T. J. and Alpert, J. C.}, + booktitle = {International SPARC Gravity Wave Symposium}, + number = {1}, + pages = {012024}, + title = {Gravity wave physics in the {NOAA} Environmental Modeling System}, + volume = {48}, + year = {2016}} @inproceedings{alpert_et_al_2018, - Author = {Alpert, J. C. and Yudin, V. A. and Fuller-Rowell, T. J. and Akmaev, R. A.}, - Booktitle = {98th American Meteorological Society Annual Meeting}, - Organization = {AMS}, - Title = {Integrating Unified Gravity Wave Physics Research into the Next Generation Global Prediction System for {NCEP} Research to Operations}, - Year = {2018}} + author = {Alpert, J. C. and Yudin, V. A. and Fuller-Rowell, T. J. and Akmaev, R. A.}, + booktitle = {98th American Meteorological Society Annual Meeting}, + organization = {AMS}, + title = {Integrating Unified Gravity Wave Physics Research into the Next Generation Global Prediction System for {NCEP} Research to Operations}, + year = {2018}} @article{eckermann_2011, - Author = {Eckermann, S. D.}, - Doi = {10.1175/2011JAS3684.1}, - Eprint = {https://doi.org/10.1175/2011JAS3684.1}, - Journal = {Journal of the Atmospheric Sciences}, - Number = {8}, - Pages = {1749-1765}, - Title = {Explicitly Stochastic Parameterization of Nonorographic Gravity Wave Drag}, - Url = {https://doi.org/10.1175/2011JAS3684.1}, - Volume = {68}, - Year = {2011}, - Bdsk-Url-1 = {https://doi.org/10.1175/2011JAS3684.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2011JAS3684.1}} + author = {Eckermann, S. D.}, + doi = {10.1175/2011JAS3684.1}, + eprint = {https://doi.org/10.1175/2011JAS3684.1}, + journal = {Journal of the Atmospheric Sciences}, + number = {8}, + pages = {1749-1765}, + title = {Explicitly Stochastic Parameterization of Nonorographic Gravity Wave Drag}, + url = {https://doi.org/10.1175/2011JAS3684.1}, + volume = {68}, + year = {2011}, + bdsk-url-1 = {https://doi.org/10.1175/2011JAS3684.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2011JAS3684.1}} @article{lott_et_al_2012, - Author = {Lott, F. and Guez, L. and Maury, P.}, - Doi = {10.1029/2012GL051001}, - Eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2012GL051001}, - Journal = {Geophysical Research Letters}, - Keywords = {Quasi-Biennial Oscillation, Rossby-gravity waves, gravity waves, stochastic parameterization, stratospheric dynamics}, - Number = {6}, - Title = {A stochastic parameterization of non-orographic gravity waves: Formalism and impact on the equatorial stratosphere}, - Url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2012GL051001}, - Volume = {39}, - Year = {2012}, - Bdsk-Url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2012GL051001}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2012GL051001}} + author = {Lott, F. and Guez, L. and Maury, P.}, + doi = {10.1029/2012GL051001}, + eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2012GL051001}, + journal = {Geophysical Research Letters}, + keywords = {Quasi-Biennial Oscillation, Rossby-gravity waves, gravity waves, stochastic parameterization, stratospheric dynamics}, + number = {6}, + title = {A stochastic parameterization of non-orographic gravity waves: Formalism and impact on the equatorial stratosphere}, + url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2012GL051001}, + volume = {39}, + year = {2012}, + bdsk-url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2012GL051001}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2012GL051001}} @conference{yudin_et_al_2018, - Author = {Yudin, V. A. and Akmaev, R. A. and Alpert, J. C. and Fuller-Rowell T. J., and Karol S. I.}, - Booktitle = {25th Conference on Numerical Weather Prediction}, - Date-Added = {2018-06-04 10:50:44 -0600}, - Date-Modified = {2018-06-04 10:54:39 -0600}, - Editor = {Am. Meteorol. Soc.}, - Title = {Gravity Wave Physics and Dynamics in the {FV3}-based Atmosphere Models Extended into the Mesosphere}, - Year = {2018}} + author = {Yudin, V. A. and Akmaev, R. A. and Alpert, J. C. and Fuller-Rowell T. J., and Karol S. I.}, + booktitle = {25th Conference on Numerical Weather Prediction}, + date-added = {2018-06-04 10:50:44 -0600}, + date-modified = {2018-06-04 10:54:39 -0600}, + editor = {Am. Meteorol. Soc.}, + title = {Gravity Wave Physics and Dynamics in the {FV3}-based Atmosphere Models Extended into the Mesosphere}, + year = {2018}} @article{hines_1997, - Author = {C. O. Hines}, - Doi = {https://doi.org/10.1016/S1364-6826(96)00080-6}, - Issn = {1364-6826}, - Journal = {Journal of Atmospheric and Solar-Terrestrial Physics}, - Number = {4}, - Pages = {387 - 400}, - Title = {Doppler-spread parameterization of gravity-wave momentum deposition in the middle atmosphere. {P}art {II}: Broad and quasi monochromatic spectra, and implementation}, - Url = {http://www.sciencedirect.com/science/article/pii/S1364682696000806}, - Volume = {59}, - Year = {1997}, - Bdsk-Url-1 = {http://www.sciencedirect.com/science/article/pii/S1364682696000806}, - Bdsk-Url-2 = {https://doi.org/10.1016/S1364-6826(96)00080-6}} + author = {C. O. Hines}, + doi = {https://doi.org/10.1016/S1364-6826(96)00080-6}, + issn = {1364-6826}, + journal = {Journal of Atmospheric and Solar-Terrestrial Physics}, + number = {4}, + pages = {387 - 400}, + title = {Doppler-spread parameterization of gravity-wave momentum deposition in the middle atmosphere. {P}art {II}: Broad and quasi monochromatic spectra, and implementation}, + url = {http://www.sciencedirect.com/science/article/pii/S1364682696000806}, + volume = {59}, + year = {1997}, + bdsk-url-1 = {http://www.sciencedirect.com/science/article/pii/S1364682696000806}, + bdsk-url-2 = {https://doi.org/10.1016/S1364-6826(96)00080-6}} @article{alexander_and_dunkerton_1999, - Author = {Alexander, M. J. and Dunkerton, T. J.}, - Doi = {10.1175/1520-0469(1999)056<4167:ASPOMF>2.0.CO;2}, - Eprint = {https://doi.org/10.1175/1520-0469(1999)056<4167:ASPOMF>2.0.CO;2}, - Journal = {Journal of the Atmospheric Sciences}, - Number = {24}, - Pages = {4167-4182}, - Title = {A Spectral Parameterization of Mean-Flow Forcing due to Breaking Gravity Waves}, - Url = {https://doi.org/10.1175/1520-0469(1999)056<4167:ASPOMF>2.0.CO;2}, - Volume = {56}, - Year = {1999}, - Bdsk-Url-1 = {https://doi.org/10.1175/1520-0469(1999)056%3C4167:ASPOMF%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0469(1999)056%3C4167:ASPOMF%3E2.0.CO;2}} + author = {Alexander, M. J. and Dunkerton, T. J.}, + doi = {10.1175/1520-0469(1999)056<4167:ASPOMF>2.0.CO;2}, + eprint = {https://doi.org/10.1175/1520-0469(1999)056<4167:ASPOMF>2.0.CO;2}, + journal = {Journal of the Atmospheric Sciences}, + number = {24}, + pages = {4167-4182}, + title = {A Spectral Parameterization of Mean-Flow Forcing due to Breaking Gravity Waves}, + url = {https://doi.org/10.1175/1520-0469(1999)056<4167:ASPOMF>2.0.CO;2}, + volume = {56}, + year = {1999}, + bdsk-url-1 = {https://doi.org/10.1175/1520-0469(1999)056%3C4167:ASPOMF%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0469(1999)056%3C4167:ASPOMF%3E2.0.CO;2}} @article{scinocca_2003, - Author = {Scinocca, J. F.}, - Doi = {10.1175/1520-0469(2003)060<0667:AASNGW>2.0.CO;2}, - Eprint = {https://doi.org/10.1175/1520-0469(2003)060<0667:AASNGW>2.0.CO;2}, - Journal = {Journal of the Atmospheric Sciences}, - Number = {4}, - Pages = {667-682}, - Title = {An Accurate Spectral Nonorographic Gravity Wave Drag Parameterization for General Circulation Models}, - Url = {https://doi.org/10.1175/1520-0469(2003)060<0667:AASNGW>2.0.CO;2}, - Volume = {60}, - Year = {2003}, - Bdsk-Url-1 = {https://doi.org/10.1175/1520-0469(2003)060%3C0667:AASNGW%3E2.0.CO;2}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/1520-0469(2003)060%3C0667:AASNGW%3E2.0.CO;2}} + author = {Scinocca, J. F.}, + doi = {10.1175/1520-0469(2003)060<0667:AASNGW>2.0.CO;2}, + eprint = {https://doi.org/10.1175/1520-0469(2003)060<0667:AASNGW>2.0.CO;2}, + journal = {Journal of the Atmospheric Sciences}, + number = {4}, + pages = {667-682}, + title = {An Accurate Spectral Nonorographic Gravity Wave Drag Parameterization for General Circulation Models}, + url = {https://doi.org/10.1175/1520-0469(2003)060<0667:AASNGW>2.0.CO;2}, + volume = {60}, + year = {2003}, + bdsk-url-1 = {https://doi.org/10.1175/1520-0469(2003)060%3C0667:AASNGW%3E2.0.CO;2}, + bdsk-url-2 = {http://dx.doi.org/10.1175/1520-0469(2003)060%3C0667:AASNGW%3E2.0.CO;2}} @article{shaw_and_shepherd_2009, - Author = {Shaw, T. A. and Shepherd, T. G.}, - Doi = {10.1175/2009JAS3051.1}, - Eprint = {https://doi.org/10.1175/2009JAS3051.1}, - Journal = {Journal of the Atmospheric Sciences}, - Number = {10}, - Pages = {3095-3114}, - Title = {A Theoretical Framework for Energy and Momentum Consistency in Subgrid-Scale Parameterization for Climate Models}, - Url = {https://doi.org/10.1175/2009JAS3051.1}, - Volume = {66}, - Year = {2009}, - Bdsk-Url-1 = {https://doi.org/10.1175/2009JAS3051.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2009JAS3051.1}} + author = {Shaw, T. A. and Shepherd, T. G.}, + doi = {10.1175/2009JAS3051.1}, + eprint = {https://doi.org/10.1175/2009JAS3051.1}, + journal = {Journal of the Atmospheric Sciences}, + number = {10}, + pages = {3095-3114}, + title = {A Theoretical Framework for Energy and Momentum Consistency in Subgrid-Scale Parameterization for Climate Models}, + url = {https://doi.org/10.1175/2009JAS3051.1}, + volume = {66}, + year = {2009}, + bdsk-url-1 = {https://doi.org/10.1175/2009JAS3051.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2009JAS3051.1}} @article{molod_et_al_2015, - Author = {Molod, A. and Takacs, L. and Suarez, M. and Bacmeister, J.}, - Doi = {10.5194/gmd-8-1339-2015}, - Journal = {Geoscientific Model Development}, - Number = {5}, - Pages = {1339--1356}, - Title = {Development of the {GEOS-5} atmospheric general circulation model: evolution from {MERRA} to {MERRA2}}, - Url = {https://www.geosci-model-dev.net/8/1339/2015/}, - Volume = {8}, - Year = {2015}, - Bdsk-Url-1 = {https://www.geosci-model-dev.net/8/1339/2015/}, - Bdsk-Url-2 = {http://dx.doi.org/10.5194/gmd-8-1339-2015}} + author = {Molod, A. and Takacs, L. and Suarez, M. and Bacmeister, J.}, + doi = {10.5194/gmd-8-1339-2015}, + journal = {Geoscientific Model Development}, + number = {5}, + pages = {1339--1356}, + title = {Development of the {GEOS-5} atmospheric general circulation model: evolution from {MERRA} to {MERRA2}}, + url = {https://www.geosci-model-dev.net/8/1339/2015/}, + volume = {8}, + year = {2015}, + bdsk-url-1 = {https://www.geosci-model-dev.net/8/1339/2015/}, + bdsk-url-2 = {http://dx.doi.org/10.5194/gmd-8-1339-2015}} @article{richter_et_al_2010, - Author = {Richter, J. H. and Sassi, F. and Garcia, R. R.}, - Doi = {10.1175/2009JAS3112.1}, - Eprint = {https://doi.org/10.1175/2009JAS3112.1}, - Journal = {Journal of the Atmospheric Sciences}, - Number = {1}, - Pages = {136-156}, - Title = {Toward a Physically Based Gravity Wave Source Parameterization in a General Circulation Model}, - Url = {https://doi.org/10.1175/2009JAS3112.1}, - Volume = {67}, - Year = {2010}, - Bdsk-Url-1 = {https://doi.org/10.1175/2009JAS3112.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/2009JAS3112.1}} + author = {Richter, J. H. and Sassi, F. and Garcia, R. R.}, + doi = {10.1175/2009JAS3112.1}, + eprint = {https://doi.org/10.1175/2009JAS3112.1}, + journal = {Journal of the Atmospheric Sciences}, + number = {1}, + pages = {136-156}, + title = {Toward a Physically Based Gravity Wave Source Parameterization in a General Circulation Model}, + url = {https://doi.org/10.1175/2009JAS3112.1}, + volume = {67}, + year = {2010}, + bdsk-url-1 = {https://doi.org/10.1175/2009JAS3112.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/2009JAS3112.1}} @article{richter_et_al_2014, - Author = {Richter, J. H. and Solomon, A. and Bacmeister, J. T.}, - Doi = {10.1002/2013MS000303}, - Eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1002/2013MS000303}, - Journal = {Journal of Advances in Modeling Earth Systems}, - Keywords = {climate modeling, vertical resolution, modeling, climate, global circulation model, general circulation model}, - Number = {2}, - Pages = {357-383}, - Title = {Effects of vertical resolution and nonorographic gravity wave drag on the simulated climate in the {C}ommunity {A}tmosphere {M}odel, version 5}, - Url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1002/2013MS000303}, - Volume = {6}, - Year = {2014}, - Bdsk-Url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1002/2013MS000303}, - Bdsk-Url-2 = {http://dx.doi.org/10.1002/2013MS000303}} + author = {Richter, J. H. and Solomon, A. and Bacmeister, J. T.}, + doi = {10.1002/2013MS000303}, + eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1002/2013MS000303}, + journal = {Journal of Advances in Modeling Earth Systems}, + keywords = {climate modeling, vertical resolution, modeling, climate, global circulation model, general circulation model}, + number = {2}, + pages = {357-383}, + title = {Effects of vertical resolution and nonorographic gravity wave drag on the simulated climate in the {C}ommunity {A}tmosphere {M}odel, version 5}, + url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1002/2013MS000303}, + volume = {6}, + year = {2014}, + bdsk-url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1002/2013MS000303}, + bdsk-url-2 = {http://dx.doi.org/10.1002/2013MS000303}} @article{gelaro_et_al_2017, - Author = {R. Gelaro and W. McCarty and M. J. Suarez and R. Todling and et al.}, - Date-Modified = {2021-02-03 21:24:37 +0000}, - Doi = {10.1175/JCLI-D-16-0758.1}, - Eprint = {https://doi.org/10.1175/JCLI-D-16-0758.1}, - Journal = {Journal of Climate}, - Number = {14}, - Pages = {5419-5454}, - Title = {The {M}odern-{E}ra {R}etrospective {A}nalysis for {R}esearch and {A}pplications, {V}ersion 2 ({MERRA-2})}, - Url = {https://doi.org/10.1175/JCLI-D-16-0758.1}, - Volume = {30}, - Year = {2017}, - Bdsk-Url-1 = {https://doi.org/10.1175/JCLI-D-16-0758.1}, - Bdsk-Url-2 = {http://dx.doi.org/10.1175/JCLI-D-16-0758.1}} + author = {R. Gelaro and W. McCarty and M. J. Suarez and R. Todling and et al.}, + date-modified = {2021-02-03 21:24:37 +0000}, + doi = {10.1175/JCLI-D-16-0758.1}, + eprint = {https://doi.org/10.1175/JCLI-D-16-0758.1}, + journal = {Journal of Climate}, + number = {14}, + pages = {5419-5454}, + title = {The {M}odern-{E}ra {R}etrospective {A}nalysis for {R}esearch and {A}pplications, {V}ersion 2 ({MERRA-2})}, + url = {https://doi.org/10.1175/JCLI-D-16-0758.1}, + volume = {30}, + year = {2017}, + bdsk-url-1 = {https://doi.org/10.1175/JCLI-D-16-0758.1}, + bdsk-url-2 = {http://dx.doi.org/10.1175/JCLI-D-16-0758.1}} @article{garcia_et_al_2007, - Author = {Garcia, R. R. and Marsh, D. R. and Kinnison, D. E. and Boville, B. A. and Sassi, F.}, - Doi = {10.1029/2006JD007485}, - Eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2006JD007485}, - Journal = {Journal of Geophysical Research: Atmospheres}, - Keywords = {global change, ozone depletion, water vapor trends, temperature trends}, - Number = {D9}, - Title = {Simulation of secular trends in the middle atmosphere, 1950--2003}, - Url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2006JD007485}, - Volume = {112}, - Year = {2007}, - Bdsk-Url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2006JD007485}, - Bdsk-Url-2 = {http://dx.doi.org/10.1029/2006JD007485}} + author = {Garcia, R. R. and Marsh, D. R. and Kinnison, D. E. and Boville, B. A. and Sassi, F.}, + doi = {10.1029/2006JD007485}, + eprint = {https://agupubs.onlinelibrary.wiley.com/doi/pdf/10.1029/2006JD007485}, + journal = {Journal of Geophysical Research: Atmospheres}, + keywords = {global change, ozone depletion, water vapor trends, temperature trends}, + number = {D9}, + title = {Simulation of secular trends in the middle atmosphere, 1950--2003}, + url = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2006JD007485}, + volume = {112}, + year = {2007}, + bdsk-url-1 = {https://agupubs.onlinelibrary.wiley.com/doi/abs/10.1029/2006JD007485}, + bdsk-url-2 = {http://dx.doi.org/10.1029/2006JD007485}} @article{eckermann_et_al_2009, - Author = {Eckermann, S. D. and K. W. Hoppel and L. Coy and J. P. McCormack and D. E. Siskind and K. Nielsen and A. Kochenash and M. H. Stevens and C. R. Englert and W. Singer and M. Hervig}, - Doi = {https://doi.org/10.1016/j.jastp.2008.09.036}, - Issn = {1364-6826}, - Journal = {Journal of Atmospheric and Solar-Terrestrial Physics}, - Keywords = {Data assimilation, Polar mesospheric cloud, Tide, Planetary wave, Mesosphere}, - Note = {Global Perspectives on the Aeronomy of the Summer Mesopause Region}, - Number = {3}, - Pages = {531 - 551}, - Title = {High-altitude data assimilation system experiments for the northern summer mesosphere season of 2007}, - Url = {http://www.sciencedirect.com/science/article/pii/S1364682608002575}, - Volume = {71}, - Year = {2009}, - Bdsk-Url-1 = {http://www.sciencedirect.com/science/article/pii/S1364682608002575}, - Bdsk-Url-2 = {https://doi.org/10.1016/j.jastp.2008.09.036}} + author = {Eckermann, S. D. and K. W. Hoppel and L. Coy and J. P. McCormack and D. E. Siskind and K. Nielsen and A. Kochenash and M. H. Stevens and C. R. Englert and W. Singer and M. Hervig}, + doi = {https://doi.org/10.1016/j.jastp.2008.09.036}, + issn = {1364-6826}, + journal = {Journal of Atmospheric and Solar-Terrestrial Physics}, + keywords = {Data assimilation, Polar mesospheric cloud, Tide, Planetary wave, Mesosphere}, + note = {Global Perspectives on the Aeronomy of the Summer Mesopause Region}, + number = {3}, + pages = {531 - 551}, + title = {High-altitude data assimilation system experiments for the northern summer mesosphere season of 2007}, + url = {http://www.sciencedirect.com/science/article/pii/S1364682608002575}, + volume = {71}, + year = {2009}, + bdsk-url-1 = {http://www.sciencedirect.com/science/article/pii/S1364682608002575}, + bdsk-url-2 = {https://doi.org/10.1016/j.jastp.2008.09.036}} @inproceedings{alpert_et_al_2019, - Author = {Alpert, J. C. and Yudin, V. A. and Strobach, E.}, - Booktitle = {AGU Fall Meeting 2019}, - Organization = {AGU}, - Title = {Atmospheric Gravity Wave Sources Correlated with Resolved-scale GW Activity and Sub-grid Scale Parameterization in the FV3gfs Model}, - Year = {2019}} + author = {Alpert, J. C. and Yudin, V. A. and Strobach, E.}, + booktitle = {AGU Fall Meeting 2019}, + organization = {AGU}, + title = {Atmospheric Gravity Wave Sources Correlated with Resolved-scale GW Activity and Sub-grid Scale Parameterization in the FV3gfs Model}, + year = {2019}} @article{ern_et_al_2018, - Author = {Ern, M. and Trinh, Q. T. and Preusse, P. and Gille, J. C. and Mlynczak, M. G. and Russell III, J. M. and Riese, M.}, - Doi = {10.5194/essd-10-857-2018}, - Journal = {Earth System Science Data}, - Number = {2}, - Pages = {857--892}, - Title = {{GRACILE}: a comprehensive climatology of atmospheric gravity wave parameters based on satellite limb soundings}, - Url = {https://www.earth-syst-sci-data.net/10/857/2018/}, - Volume = {10}, - Year = {2018}, - Bdsk-Url-1 = {https://www.earth-syst-sci-data.net/10/857/2018/}, - Bdsk-Url-2 = {http://dx.doi.org/10.5194/essd-10-857-2018}} + author = {Ern, M. and Trinh, Q. T. and Preusse, P. and Gille, J. C. and Mlynczak, M. G. and Russell III, J. M. and Riese, M.}, + doi = {10.5194/essd-10-857-2018}, + journal = {Earth System Science Data}, + number = {2}, + pages = {857--892}, + title = {{GRACILE}: a comprehensive climatology of atmospheric gravity wave parameters based on satellite limb soundings}, + url = {https://www.earth-syst-sci-data.net/10/857/2018/}, + volume = {10}, + year = {2018}, + bdsk-url-1 = {https://www.earth-syst-sci-data.net/10/857/2018/}, + bdsk-url-2 = {http://dx.doi.org/10.5194/essd-10-857-2018}} @inproceedings{yudin_et_al_2019, - Author = {Yudin, V. A. and S. I. Karol and R. A. Akmaev and et al.}, - Booktitle = {Space Weather Workshop}, - Title = {Longitudinal Variability of Wave Dynamics in Weather Models Extended into the Mesosphere and Thermosphere}, - Year = {2019}} + author = {Yudin, V. A. and S. I. Karol and R. A. Akmaev and et al.}, + booktitle = {Space Weather Workshop}, + title = {Longitudinal Variability of Wave Dynamics in Weather Models Extended into the Mesosphere and Thermosphere}, + year = {2019}} @article{mansell_2013, - Author = {Edward R. Mansell and Conrad L. Ziegler}, - Date-Added = {2015-02-26 22:32:59 +0000}, - Date-Modified = {2020-02-10 23:06:41 +0000}, - Doi = {10.1175/JAS-D-12-0264.1}, - Journal = {Journal of the Atmospheric Sciences}, - Keywords = {storm electrification, microphysics 2-moment}, - Number = {7}, - Pages = {2032-2050}, - Title = {Aerosol Effects on Simulated Storm Electrification and Precipitation in a Two-moment Bulk Microphysics Model}, - Volume = {70}, - Year = {2013}} + author = {Edward R. Mansell and Conrad L. Ziegler}, + date-added = {2015-02-26 22:32:59 +0000}, + date-modified = {2020-02-10 23:06:41 +0000}, + doi = {10.1175/JAS-D-12-0264.1}, + journal = {Journal of the Atmospheric Sciences}, + keywords = {storm electrification, microphysics 2-moment}, + number = {7}, + pages = {2032-2050}, + title = {Aerosol Effects on Simulated Storm Electrification and Precipitation in a Two-moment Bulk Microphysics Model}, + volume = {70}, + year = {2013}, + bdsk-url-1 = {https://doi.org/10.1175/JAS-D-12-0264.1}} @article{mansell_2010, - Author = {Edward R. Mansell}, - Date-Added = {2011-02-22 10:34:11 -0600}, - Date-Modified = {2011-02-22 10:35:34 -0600}, - Doi = {10.1175/2010JAS3341.1}, - Journal = {Journal of the Atmospheric Sciences}, - Keywords = {advection, microphysics 2-moment}, - Pages = {3084-3094}, - Title = {On Sedimentation and Advection in Multimoment Bulk Microphysics}, - Volume = {67}, - Year = {2010}} + author = {Edward R. Mansell}, + date-added = {2011-02-22 10:34:11 -0600}, + date-modified = {2011-02-22 10:35:34 -0600}, + doi = {10.1175/2010JAS3341.1}, + journal = {Journal of the Atmospheric Sciences}, + keywords = {advection, microphysics 2-moment}, + pages = {3084-3094}, + title = {On Sedimentation and Advection in Multimoment Bulk Microphysics}, + volume = {67}, + year = {2010}, + bdsk-url-1 = {https://doi.org/10.1175/2010JAS3341.1}} @article{mansell_etal_2010, - Author = {E. R. Mansell and C. L. Ziegler and E. C. Bruning}, - Date-Added = {2007-08-20 15:44:13 -0500}, - Date-Modified = {2010-04-13 16:55:16 -0500}, - Doi = {10.1175/2009JAS2965.1}, - Journal = {Journal of the Atmospheric Sciences}, - Keywords = {storm electrification, microphysics 2-moment}, - Pages = {171-194}, - Title = {Simulated Electrification of a Small Thunderstorm with Two-Moment Bulk Microphysics}, - Volume = {67}, - Year = {2010}} + author = {E. R. Mansell and C. L. Ziegler and E. C. Bruning}, + date-added = {2007-08-20 15:44:13 -0500}, + date-modified = {2010-04-13 16:55:16 -0500}, + doi = {10.1175/2009JAS2965.1}, + journal = {Journal of the Atmospheric Sciences}, + keywords = {storm electrification, microphysics 2-moment}, + pages = {171-194}, + title = {Simulated Electrification of a Small Thunderstorm with Two-Moment Bulk Microphysics}, + volume = {67}, + year = {2010}, + bdsk-url-1 = {https://doi.org/10.1175/2009JAS2965.1}} + +@inproceedings{yudin_et_al_2020, + author = {Yudin, V. A. and Yang, F. and Karol, S. I. and Fuller-Rowell T. J. and Kubaryk, A. and Juang, H. and Kar, S. and Alpert, J. C. and Li, Z.}, + booktitle = {1st UFS Users' Workshop}, + title = {The Unified Gravity Wave Physics in the vertically extended atmosphere models of NGGPS and UFS}, + url = {https://dtcenter.org/sites/default/files/events/2020/4-valery-yudin.pdf}, + year = {2020}, + bdsk-url-1 = {https://dtcenter.org/sites/default/files/events/2020/4-valery-yudin.pdf}} + +@article{choi_and_hong_2015, + author = {Choi, H.-J. and Hong, S.-Y.}, + doi = {10.1002/2015JD024230}, + journal = {Journal of Geophysical Research: Atmospheres}, + pages = {12445--12457}, + title = {An updated subgrid orographic parameterization for global atmospheric forecast models}, + url = {https://doi.org/10.1002/2015JD024230}, + volume = {120}, + year = {2015}, + bdsk-url-1 = {https://doi.org/10.1002/2015JD024230}} + +@article{tsiringakis_et_al_2017, + author = {Tsiringakis, A. and Steeneveld, G. J. and Holtslag, A. A. M.}, + journal = {Quarterly Journal of the Royal Meteorological Society}, + pages = {1504--1516}, + title = {Small-scale orographic gravity wave drag in stable boundary layers and its impact on synoptic systems and near-surface meteorology}, + volume = {143}, + year = {2017}, + bdsk-url-1 = {https://doi.org/10.1002/qj.3021}} + @comment{BibDesk Static Groups{ diff --git a/physics/docs/pdftxt/CPT_CSAW.txt b/physics/docs/pdftxt/CPT_CSAW.txt deleted file mode 100644 index 723e65b20..000000000 --- a/physics/docs/pdftxt/CPT_CSAW.txt +++ /dev/null @@ -1,25 +0,0 @@ -/** -\page CSAW_scheme Chikira-Sugiyama Scale-Aware Convection Scheme with Arakawa-Wu Extension -\section cs_descrip Description - -The Chikira-Sugiyama cumulus scheme (Chikira and Sugiyama (2010) \cite Chikira_2010) with prognostic closure and -Arakawa-Wu Scale-Aware extension \cite Arakawa_2013 is an offshoot of the prognostic Arakawa-Schubert scheme. -It is characterized by a spectral representation of cloud types according to updraft velocity at cloud base, a level -at which the mass flux is determined by a convective kinetic energy closure. The -lateral entrainment rate vertically varies depending on the buoyancy and vertical -velocity of the updraft air parcel following Gregory (2001) \cite Gregory_2001 . - The entrainment rate tends to be large near cloud base because of the small updraft -velocity near that level. Deep convection tends to be suppressed when convective available potential energy -is small because of upward reduction of in-cloud moist static energy. Dry environment air significantly reduces -in-cloud humidity mainly because of the large entrainment rate in the lower troposphere, which leads to suppression -of deep convection, consistent with observations and previous of cloud-resolving models. - - - -\section intra_csaw Intraphysics Communication -\ref arg_table_cs_conv_run - -\section gen_cs_conv General Algorithm -\ref gen_cs_cumlus - -*/ diff --git a/physics/docs/pdftxt/CPT_MG3.txt b/physics/docs/pdftxt/CPT_MG3.txt deleted file mode 100644 index 3dc3fece4..000000000 --- a/physics/docs/pdftxt/CPT_MG3.txt +++ /dev/null @@ -1,45 +0,0 @@ -/** -\page CPT_MG3 Morrison-Gettelman Cloud Microphysics Scheme -\section des_MG3_cloud Description -The Morrison-Gettelman Version 3 (MG3) microphysics scheme is a six-category double momentum bulk scheme. It forecasts mass -and number concentration of five hydrometeors (cloud water, cloud ice, rain, snow and graupel) in addition to mass of water vapor. - -# Morrison Gettelman Advancements -- MG1: Morrison and Gettelman (2008) \cite Morrison_2008 (CESM1, CAM5) - - Morrison et al 2005 scheme - - Added sub-grid scale variance - - Coupling to activation (aerosols) -- MG2: Gettelman and Morrison (2015) \cite Gettelman_2015_1 \cite Gettelman_2015_2 (CESM2, CAM6) - - Prognostic precipitation (rain and snow) - - Sub-stepping and sub-column capable -- MG3: Gettelman et al. (2019) \cite Gettelman_et_al_2019 - - Rimed hydrometeors (graupel or hail) are added to stratiform cloud scheme for global models - - Global climate impacts are limited to small increased in ice mass - - High (14 km) resolution simulations show local production of rimed ice (graupel) can affect regional -precipitation amounts and intensity - -A schematic of the MG3 scheme is shown in Figure 1. MG3 starts with MG2 \cite Gettelman_2015_1 \cite Gettelman_2015_2 and adds a -series of processes (in red). One rimed hydrometeor category is added. Both mass and number are prognosed. Rimed ice has the -"character" of hail or graupel by pre-selecting density and fall speed parameters. - -\image html MG3_MP_diagram.png "Figure 1: A schematic of the MG3 scheme (Courtesy of A. Gettleman )" width=10cm - -Some unique attributes of MG3 cloud microphysics include: - --# Consistent treatment of cloud fraction in cloud macrophysics and radiation --# Subgrid-scale microphysics --# Maximum-overlap and in-cloud precipitation fraction area --# Options for subcolumn microphysics --# Options for running with fewer species and processes, simulating MG1 and MG2 codes --# Completely aerosol awareness with 1) constant aerosol mixing ratio, 2) climatology IN/CCN from CAM5 (default; \c cam5_4_143_NAAI_monclimo2.nc), 3) climatology aerosol from MERRA2 , 4) GOCART, and 5) MAM7 --# Sub-step semi-implicit sedimentation --# Can be used along with the FV in-core saturation adjustment - -\section intra_mg3 Intraphysics Communication -\ref arg_table_m_micro_run - -\section gen_mg3 General Algorithm -\ref detail_m_micro_run - - -*/ diff --git a/physics/docs/pdftxt/CPT_adv_suite.txt b/physics/docs/pdftxt/CPT_adv_suite.txt deleted file mode 100644 index bc34cc1e6..000000000 --- a/physics/docs/pdftxt/CPT_adv_suite.txt +++ /dev/null @@ -1,233 +0,0 @@ -/** -\page csawmg_page csawmg Suite - -\section csawmg_suite_overview Overview - -The csawmg physics suite uses the parameterizations in the following order: - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_NSST - - \ref GFS_NOAH - - \ref GFS_SFCSICE - - \ref GFS_HEDMF - - \ref GFS_UGWP_v0 - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_H2OPHYS - - \ref CSAW_scheme - - \ref GFS_SAMFshal - - \ref CPT_MG3 - - \ref mod_cs_conv_aw_adj - -\section sdf_cpt_suite Suite Definition File -\code - - - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - - - - - GFS_suite_interstitial_rad_reset - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - GFS_surface_generic_pre - GFS_surface_composites_pre - dcyc2t3 - GFS_surface_composites_inter - GFS_suite_interstitial_2 - - - - sfc_diff - GFS_surface_loop_control_part1 - sfc_nst_pre - sfc_nst - sfc_nst_post - lsm_noah - sfc_sice - GFS_surface_loop_control_part2 - - - - GFS_surface_composites_post - sfc_diag - sfc_diag_post - GFS_surface_generic_post - GFS_PBL_generic_pre - hedmf - GFS_PBL_generic_post - GFS_GWD_generic_pre - cires_ugwp - cires_ugwp_post - GFS_GWD_generic_post - rayleigh_damp - GFS_suite_stateout_update - ozphys_2015 - h2ophys - get_phi_fv3 - GFS_suite_interstitial_3 - GFS_DCNV_generic_pre - cs_conv_pre - cs_conv - cs_conv_post - GFS_DCNV_generic_post - GFS_SCNV_generic_pre - samfshalcnv - GFS_SCNV_generic_post - GFS_suite_interstitial_4 - cnvc90 - GFS_MP_generic_pre - m_micro_pre - m_micro - m_micro_post - cs_conv_aw_adj - GFS_MP_generic_post - maximum_hourly_diagnostics - phys_tend - - - - -\endcode - -\section cpt_nml_option Namelist -\code -&gfs_physics_nml - fhzero = 6. - ldiag3d = .true. - fhcyc = 24. - nst_anl = .true. - use_ufo = .true. - pre_rad = .false. - crtrh = 0.93,0.90,0.95 - ncld = 2 - imp_physics = 10 - pdfcld = .false. - fhswr = 3600. - fhlwr = 3600. - ialb = 1 - iems = 1 - IAER = 111 - ico2 = 2 - isubc_sw = 2 - isubc_lw = 2 - isol = 2 - lwhtr = .true. - swhtr = .true. - cnvgwd = .true. - shal_cnv = .true. - cal_pre = .false. - redrag = .true. - dspheat = .false. - hybedmf = .true. - satmedmf = .false. - lheatstrg = .false. - random_clds = .true. - trans_trac = .true. - cnvcld = .false. - imfshalcnv = 2 - imfdeepcnv = -1 - cdmbgwd = 3.5,0.25 - prslrd0 = 0. - ivegsrc = 1 - isot = 1 - lsm = 1 - iopt_dveg = 2 - iopt_crs = 1 - iopt_btr = 1 - iopt_run = 1 - iopt_sfc = 1 - iopt_frz = 1 - iopt_inf = 1 - iopt_rad = 1 - iopt_alb = 2 - iopt_snf = 4 - iopt_tbot = 2 - iopt_stc = 1 - oz_phys = .false. - oz_phys_2015 = .true. - debug = .false. - - ras = .false. - cscnv = .true. - do_shoc = .false. - shoc_parm = 7000.0,1.0,2.0,0.7,-999.0 - do_aw = .true. - shoc_cld = .false. - h2o_phys = .true. - shcnvcw = .false. - xkzm_h = 0.5 - xkzm_m = 0.5 - xkzm_s = 1.0 - ccwf = 1.0,1.0 - dlqf = 0.25,0.05 - mg_dcs = 200.0 - mg_ts_auto_ice = 180.0,900.0 - mg_qcvar = 1.0 - fprcp = 2 - pdfflag = 4 - iccn = .false. - aero_in = .false. - mg_do_graupel = .true. - mg_do_hail = .false. - do_sb_physics = .true. - mg_do_ice_gmao = .false. - mg_do_liq_liu = .true. - cs_parm = 8.0,4.0,1.0e3,3.5e3,20.0,1.0,0.0,1.0,0.6,0.0 - ctei_rm = 0.60,0.23 - max_lon = 8000 - max_lat = 4000 - rhcmax = 0.9999999 - effr_in = .true. - - nstf_name = 2,1,1,0,5 - ltaerosol = .false. - lradar = .false. - cplflx = .false. - iau_delthrs = 6 - iaufhrs = 30 - iau_inc_files = "''" -/ - -&cires_ugwp_nml - knob_ugwp_solver = 2 - knob_ugwp_source = 1,1,0,0 - knob_ugwp_wvspec = 1,25,25,25 - knob_ugwp_azdir = 2,4,4,4 - knob_ugwp_stoch = 0,0,0,0 - knob_ugwp_effac = 1,1,1,1 - knob_ugwp_doaxyz = 1 - knob_ugwp_doheat = 1 - knob_ugwp_dokdis = 1 - knob_ugwp_ndx4lh = 1 - knob_ugwp_version = 0 - launch_level = 25 -/ -/ -\endcode - - - -*/ diff --git a/physics/docs/pdftxt/CU_GF_deep.txt b/physics/docs/pdftxt/CU_GF_deep.txt index a17b58d07..92b8c3b7c 100644 --- a/physics/docs/pdftxt/CU_GF_deep.txt +++ b/physics/docs/pdftxt/CU_GF_deep.txt @@ -2,23 +2,35 @@ \page CU_GF Grell-Freitas Scale and Aerosol Aware Convection Scheme \section gfcu_descrip Description -The Grell-Freitas (GF) scheme as described in Grell and Freitas (2014, GF1) \cite grell_and_freitas_2014 and -Freitas et al. (2018, FG) \cite freitas_et_al_2018 follow the mass flux approach published by Grell (1993) \cite grell_1993. +The Grell-Freitas (GF) scheme, as described in Grell and Freitas (2014) \cite grell_and_freitas_2014, +Freitas et al. (2018) \cite freitas_et_al_2018, Freitas et al. (2021) \cite freitas_et_al_2021, and Lin et al. (2022) +(under review) follows the mass flux approach published by Grell (1993) \cite grell_1993. Further developments by Grell and \f$D\acute{e}v\acute{e}nyi\f$ (2002) \cite Grell_2002 included implementing stochastics through allowing parameter perturbations. In GF1 scale awareness, and the aerosol dependence through rain generation (following Berry (1968) \cite berry_1968 and evaporation formulations (following Jiang et al. (2010) \cite Jiang_2010 ), depending on the cloud concentration nuclei at cloud base were added. FG included mixed phase physics impact, momentum transport (as in ECMWF), a diurnal cycle closure (Bechtold et al. (2014) \cite bechtold_et_al_2014 ), and a trimodal spectral size to simulate the interaction -and transition from shallow, congestus and deep convection regimes. The vertical massflux distribution of shallow, congestus and +and transition from shallow, congestus and deep convection regimes. In order for this trimodal size spectrum to be +accurately represented, GF's deep and shallow convective schemes must be run together. +The vertical massflux distribution of shallow, congestus and deep convection regimes is characterized by Probability Density Functions (PDF's). The three PDF's are meant to represent the average statistical mass flux characteristic of deep, congestus, and shallow (respectively) plumes in the grid area. Each PDF therefore represents a spectrum of plumes within the grid box. Forcing is different for each characteristic type. Entrainment and detrainment are derived from the PDF's. The deep convection considers scale awareness (Arakawa et al. (2011) \cite Arakawa_2011 ), the congestus type convection as well as the shallow convection are not scale-aware. Aerosol dependence is implemented through dependence of rain generation and -evaporation formulations depending on the cloud concentration nuclei at cloud base. Aerosol dependence is considered experimental and +evaporation formulations depending on the cloud concentration nuclei at cloud base (Berry 1968 \cite berry_1968, +Jiang et al.(2010) \cite Jiang_2010, and Lee and Feingold (2010) \cite lee_and_feingold_2010 ). Aerosol dependence is considered experimental and is turned off at this point. GF is able to transport tracers. -A paper describing the latest changes and modifications is in progress and will be submitted to GMD. +A paper describing the latest changes and modifications is in process and will be submitted to GMD. + +\section version_cugf_enh CCPP Physics Updates +\version CCPP v6.0.0 + +- GPU capabilities have been added +- Cap suppressing (\p do_cap_suppress) based on radar data assimilation has been added. This is used only for the RAP suite +- Some fixed parameters have been made scale-aware +- Updated coupling between radiation and convection has been implemented \b Operational \b Impacts \b in \b RAP/HRRR @@ -40,9 +52,9 @@ in the RAP. Additionally, the shallow convection and PBL schemes pass cloud information to the radiation scheme, which improved cloud/radiation interaction and retention of the inversion typically found above mixed layers. -\ref arg_table_cu_gf_driver_run +- \ref arg_table_cu_gf_driver_run \section gen_gfgsd General Algorithm -\ref gen_gf_driver +- \ref gen_gf_driver */ diff --git a/physics/docs/pdftxt/GFDL_cloud.txt b/physics/docs/pdftxt/GFDL_cloud.txt index 6240a259e..1af854c55 100644 --- a/physics/docs/pdftxt/GFDL_cloud.txt +++ b/physics/docs/pdftxt/GFDL_cloud.txt @@ -8,13 +8,13 @@ and has been significantly improved over years at GFDL (Lord et al. (1984) \cite Krueger et al. (1995) \cite krueger_et_al_1995, Chen and Lin (2011) \cite chen_and_lin_2011, Chen and Lin (2013) \cite chen_and_lin_2013). Physics processes of GFDL cloud MP are described in Figure 1 (also see warm_rain() and icloud()) and are feature with time-split between warm-rain (faster) and ice-phase (slower) processes (see 'conversion time scale' in gfdl_cloud_microphys.F90 for default values). -\image html gfdl_cloud_mp_diagram.png "Figure 1: GFDL MP at a glance (Courtesy of S.J. Lin at GFDL)" width=10cm +\image html gfdl_cloud_mp_diagram.png "Figure 1: GFDL MP at a glance (Courtesy of S.J. Lin at GFDL)" width=900 Some unique attributes of GFDL cloud microphysics include: # Precipitation and Cloud Effects on Dynamics -\image html FV3_structure.png "Figure 1: FV3 structure; Yellow represents external API routines, called once per physics time step; Green are called once per remapping time step; Blue are called once per acoustic time step. " width=10cm +\image html FV3_structure.png "Figure 1: FV3 structure; Yellow represents external API routines, called once per physics time step; Green are called once per remapping time step; Blue are called once per acoustic time step. " width=1200 The leftmost column of Figure 1 shows the external API calls used during a typical process-split model integration procedure. First, the solver is called, which advances the solver a full "physics" time step. This updated state is then passed to the physical parameterization package, which then computes the physics tendencies over the same time interval. Finally, the tendencies are then used to update the diff --git a/physics/docs/pdftxt/GFS_H2OPHYS.txt b/physics/docs/pdftxt/GFS_H2OPHYS.txt index efd38065f..190cede52 100644 --- a/physics/docs/pdftxt/GFS_H2OPHYS.txt +++ b/physics/docs/pdftxt/GFS_H2OPHYS.txt @@ -16,10 +16,10 @@ The \f$(P-L)_{0}\f$ and \f$\tau_*\f$ values were computed from perturbation expe The equilibrium profile \f$q_{0}\f$ is specified using a climatology based on a combination of reanalysis and satellite observations. \section intra_h2o Intraphysics Communication -\ref arg_table_h2ophys_run +- \ref arg_table_h2ophys_run \section gen_h2o General Algorithm -\ref genal_h2ophys +- \ref genal_h2ophys */ diff --git a/physics/docs/pdftxt/GFS_HEDMF.txt b/physics/docs/pdftxt/GFS_HEDMF.txt deleted file mode 100644 index 62821e16b..000000000 --- a/physics/docs/pdftxt/GFS_HEDMF.txt +++ /dev/null @@ -1,55 +0,0 @@ -/** -\page GFS_HEDMF GFS Hybrid Eddy-Diffusivity Mass-Flux PBL and Free Atmospheric Turbulence Scheme -\section des_pbl Description -The Hybrid EDMF scheme is a first-order turbulent transport -scheme used for subgrid-scale vertical turbulent mixing in the PBL -and above. It blends the traditional first-order approach that has -been used and improved over the last several years with a more recent -scheme that uses a mass-flux approach to calculate the countergradient -diffusion terms. - -The PBL scheme's main task is to calculate tendencies of temperature, -moisture, and momentum due to vertical diffusion throughout the column -(not just the PBL). The scheme is an amalgamation of decades of work, -starting from the initial first-order PBL scheme of Troen and Mahrt (1986) -\cite troen_and_mahrt_1986, implemented according to Hong and Pan (1996) -\cite hong_and_pan_1996 and modified by Han and Pan (2011) -\cite han_and_pan_2011 and Han et al.(2016) \cite Han_2016 to -include top-down mixing due to stratocumulus layers from Lock et al. (2000) -\cite lock_et_al_2000 and replacement of counter-gradient terms with a mass -flux scheme according to Siebesma et al.(2007) \cite siebesma_et_al_2007 -and Soares et al. (2004) \cite soares_et_al_2004. Recently, heating due to -TKE dissipation was also added according to Han et al.(2016) \cite Han_2016. - -This subroutine contains all of logic for the Hybrid EDMF PBL scheme except -for the calculation of the updraft properties and mass flux. The scheme -works on a basic level by calculating background diffusion coefficients -and updating them according to which processes are occurring in the column. -The most important difference in diffusion coefficients occurs between -those levels in the PBL and those above the PBL, so the PBL height -calculation is of utmost importance. An initial estimate is calculated in a -"predictor" step in order to calculate Monin-Obukhov similarity values and -a corrector step recalculates the PBL height based on updated surface -thermal characteristics. Using the PBL height and the similarity parameters, -the diffusion coefficients are updated below the PBL top based on Hong and -Pan (1996) \cite hong_and_pan_1996 (including counter-gradient terms). -Diffusion coefficients in the free troposphere (above the PBL top) are -calculated according to Louis (1979) \cite louis_1979 with updated -Richardson number-dependent functions. If it is diagnosed that PBL top-down -mixing is occurring according to Lock et al. (2000) \cite lock_et_al_2000 , -then then diffusion coefficients are updated accordingly. Finally, for -convective boundary layers (defined as when the Obukhov length exceeds a -threshold), the counter-gradient terms are replaced using the mass flux -scheme of Siebesma et al. (2007) \cite siebesma_et_al_2007 . In order to -return time tendencies, a fully implicit solution is found using tridiagonal -matrices, and time tendencies are "backed out." Before returning, the time -tendency of temperature is updated to reflect heating due to TKE -dissipation following Han et al. (2016) \cite Han_2016 . - -\section intra_pbl Intraphysics Communication -\ref arg_table_hedmf_run - -\section gen_pbl General Algorithm -\ref general_edmf - -*/ diff --git a/physics/docs/pdftxt/GFS_NOAH.txt b/physics/docs/pdftxt/GFS_NOAH.txt index 19360d092..74dc42127 100644 --- a/physics/docs/pdftxt/GFS_NOAH.txt +++ b/physics/docs/pdftxt/GFS_NOAH.txt @@ -26,7 +26,7 @@ with arrows also represent positive feedbacks. The single horizontal gay-dotted line (no arrows) indicates the top of the PBL, and the seven small vertical dashed lines (no arrows) represent precipitation - \image html Noah_LA_interaction.png "Figure 1: Local Land-atmosphere Interaction (courtesy of Michael Ek)" width=10cm + \image html Noah_LA_interaction.png "Figure 1: Local Land-atmosphere Interaction (courtesy of Michael Ek)" width=900 Recently, the land surface updates in 2017 GFS operational physics includes: - IGBP 20-type 1-km land classification - STASGO 19-type 1-km soil classification @@ -36,12 +36,11 @@ Recently, the land surface updates in 2017 GFS operational physics includes: - Unify snow cover, albedo between radiation and land surface model - Increase ground heat flux under deep snow - Upgrade surface layer parameterization scheme \ref GFS_SFCLYR to modify the roughness-length formulation and introduce a stability parameter constraint in the Monin-Obukhov similarity theory to prevent the land-atmosphere system from fully decoupling leading to excessive cooling of 2m temperature during sunset - \image html land_dataset.png "Figure 2: Land Data Sets Used in NCEP Modeling Systems" width=10cm + \image html land_dataset.png "Figure 2: Land Data Sets Used in NCEP Modeling Systems" width=900 \section intra_noah Intraphysics Communication - + GFS Noah LSM Driver (\ref arg_table_lsm_noah_run) - + GFS Noah LSM Model (gfssflx()) +- \ref arg_table_lsm_noah_run + \section gen_al_noah General Algorithm -+ \ref general_noah_drv -+ \ref general_sflx +- lsm_noah::lsm_noah_run */ diff --git a/physics/docs/pdftxt/GFS_NOAHMP.txt b/physics/docs/pdftxt/GFS_NOAHMP.txt index 7a3636b5f..bc2c58457 100644 --- a/physics/docs/pdftxt/GFS_NOAHMP.txt +++ b/physics/docs/pdftxt/GFS_NOAHMP.txt @@ -21,7 +21,8 @@ The CCPP interface to the NoahMP LSM is a driving software layer on top of the a Note that noahmp_glacer() and noahmp_sflx() are the actual NoahMP codes. \section intra_noahmp Intraphysics Communication - + GFS NoahMP LSM Driver (\ref arg_table_noahmpdrv_run) -\section gen_al_noahmp General Algorithm of Driver + + \ref arg_table_noahmpdrv_run + +\section gen_al_noahmp General Algorithm + \ref general_noahmpdrv */ diff --git a/physics/docs/pdftxt/GFS_NSST.txt b/physics/docs/pdftxt/GFS_NSST.txt index 9b9fc0149..b74e99328 100644 --- a/physics/docs/pdftxt/GFS_NSST.txt +++ b/physics/docs/pdftxt/GFS_NSST.txt @@ -26,10 +26,10 @@ where: The GFS NSST scheme is used to forecast the NSST for two main purposes: supply SSTs to the atmospheric model for the calculation of air-sea heat and moisture fluxes and providing a sub-layer temperature profile forecast for use as a first guess in the Gridpoint Statistical Interpolator (GSI) data assimilation code. Atmospheric inputs include short- and long-wave radiation, surface pressure, surface layer winds, temperature and specific humidity, and rainfall. The NSST scheme and has shown positive impact on the analysis and prediction of the ocean and atmosphere in weather prediction time scale. \section intra_nst Intraphysics Communication -\ref arg_table_sfc_nst_run +- \ref arg_table_sfc_nst_run \section gen_nst General Algorithm -\ref NSST_general_algorithm +- sfc_nst::sfc_nst_run */ diff --git a/physics/docs/pdftxt/GFS_OCEAN.txt b/physics/docs/pdftxt/GFS_OCEAN.txt index b384aec84..8fa396967 100644 --- a/physics/docs/pdftxt/GFS_OCEAN.txt +++ b/physics/docs/pdftxt/GFS_OCEAN.txt @@ -8,9 +8,11 @@ does not change the SST. Therefore, the SST stays constant throughout the foreca In some models, such as the UFS atmosphere, the SST can change if forcing towards the climatology is turned on. \section intra_sfcocean Intraphysics Communication -\ref arg_table_sfc_ocean_run +- \ref arg_table_sfc_ocean_run +\section gen_gfs_sos General Algorithm +- \ref sfc_ocean::sfc_ocean_run diff --git a/physics/docs/pdftxt/GFS_OZPHYS.txt b/physics/docs/pdftxt/GFS_OZPHYS.txt index 3a2ddc173..6de6e2c72 100644 --- a/physics/docs/pdftxt/GFS_OZPHYS.txt +++ b/physics/docs/pdftxt/GFS_OZPHYS.txt @@ -51,10 +51,10 @@ depend on the temperature and column ozone climatology (\c global_o3prdlos.f77 is replaced by \c ozprdlos_2015_new_sbuvO3_tclm15_nuchem.f77 in ozphys_2015_run). \section intra_ozone Intraphysics Communication -\ref arg_table_ozphys_2015_run +- \ref arg_table_ozphys_2015_run \section gen_ozone General Algorithm -\ref genal_ozphys_2015 +- \ref genal_ozphys_2015 */ diff --git a/physics/docs/pdftxt/GFS_RRTMG.txt b/physics/docs/pdftxt/GFS_RRTMG.txt index 6dfb5ed27..7a02d35a1 100644 --- a/physics/docs/pdftxt/GFS_RRTMG.txt +++ b/physics/docs/pdftxt/GFS_RRTMG.txt @@ -10,7 +10,7 @@ transformations. The schematic radiation module structure is shown in Figure 1. - \image html schematic_Rad_mod.png "Figure 1: Schematic Radiation Module Structure" width=10cm + \image html schematic_Rad_mod.png "Figure 1: Schematic Radiation Module Structure" GFS radiation package is intended to provide a fast and accurate method of determining the total radiative flux at any given @@ -70,9 +70,53 @@ - CSULFtoa: Upward LW - CSUSFtoa: Upward SW +\section rrtmg_enh CCPP Physics Updates +\version CCPP v6.0.0 + +Requests have been made by many physics developers and users to rewrite +the cloud routines (routines progcld) for radiation computation in the program +radiation_clouds.f. Those cloud subroutines are very similar, and +have many lines of common code. We modified the radiation_clouds.f module, +and includes all the calculations of the cloud properties to a new subroutine +radiation_clouds_prop. We also moved the common code from subroutines +progcld to this new subroutine. Subroutine radiation_clouds_prop can be +called by RRTMG and RRTMGP. A single call to the subroutine +radiation_clouds_prop can connect to the calculations of the cloud +radiation properties for all the microphysics schemes. + +Summary of the major changes: +- radiation_clouds.f + + A new subroutine “radiation_clouds_prop” was added to radiation_clouds.f. This new subroutine calculates all cloud radiation properties for all the microphysics schemes. Subroutines "progcld*" were renamed based on the input variables \p imp_physics, and the inactive subroutines were removed from file radiation_clouds.f + - 'progcld1' --- > progcld_zhao_carr + - 'progcld3' --- > progcld_zhao_carr_pdf + - 'progcld4' --- > progcld_gfdl_lin + - 'progcld5' --- > progcld_fer_hires + - 'progcld6' --- > progcld_thompson_wsm6 + - 'progclduni' --- > progclduni + - 'progcld_thompson'--- > progcld_thompson + +- GFS_rrtmg_pre.F90 + + Removed the “progcld” subroutine calls, and replaced them with a single subroutine call to “radiation_clouds_prop”. + +- radiation_cloud_overlap.F90 + + Replaced subroutine “get_alpha_exp” with “get_alpha_exper”. The new subroutine revises alpha for exponential random cloud overlap option. This new subroutine is used in programs GFS_rrtmgp_cloud_overlap_pre.F90 and GFS_rrtmgp_gfdlmp_pre.F90. + +- Subroutine getml() has been modified. The subroutine computes low, mid, high, total and boundary clouds, and is used in GFS_cloud_diagnostics.F90. + \section intraphysics_rrtmg Intraphysics Communication - + For RRTMG-Longwave radiation parameterization (\ref arg_table_rrtmg_lw_run) - + For RRTMG-Shortwave radiation parameterization (\ref arg_table_rrtmg_sw_run) ++ \b GFS_suite_interstitial_rad_reset: \ref arg_table_GFS_suite_interstitial_rad_reset_run ++ \b gfs_rrtmg_pre: \ref arg_table_GFS_rrtmg_pre_run ++ \b GFS_radiation_surface: \ref arg_table_GFS_radiation_surface_run ++ \b rad_sw_pre: \ref arg_table_rad_sw_pre_run ++ \b rrtmg_sw: \ref arg_table_rrtmg_sw_run ++ \b rrtmg_sw_post: \ref arg_table_rrtmg_sw_post_run ++ \b rrtmg_lw_pre: \ref arg_table_rrtmg_lw_pre_run ++ \b rrtmg_lw: \ref arg_table_rrtmg_lw_run ++ \b rrtmg_lw_post: \ref arg_table_rrtmg_lw_post_run ++ \b GFS_rrtmg_post: \ref arg_table_GFS_rrtmg_post_run \section gen_al_rrtmg General Algorithm + \ref gen_lwrad diff --git a/physics/docs/pdftxt/GFS_RRTMGP.txt b/physics/docs/pdftxt/GFS_RRTMGP.txt new file mode 100644 index 000000000..4f2ebaddd --- /dev/null +++ b/physics/docs/pdftxt/GFS_RRTMGP.txt @@ -0,0 +1,14 @@ +/** +\page GFS_RRTMGP GFS RRTMGP Shortwave/Longwave Radiation Scheme + +\section des_rrtmgp Description + +\section intraphysics_rrtmgp Intraphysics Communication + + For RRTMG-Longwave radiation parameterization (\ref arg_table_rrtmg_lw_run) + + For RRTMG-Shortwave radiation parameterization (\ref arg_table_rrtmg_sw_run) + +\section gen_al_rrtmgp General Algorithm + + \ref gen_lwrad + + \ref gen_swrad + +*/ diff --git a/physics/docs/pdftxt/GFS_SAMF.txt b/physics/docs/pdftxt/GFS_SAMF.txt deleted file mode 100644 index 192f1f9a1..000000000 --- a/physics/docs/pdftxt/GFS_SAMF.txt +++ /dev/null @@ -1,9 +0,0 @@ -/** -\page GFS_SAMF GFS Scale-Aware Simplified Arakawa-Schubert (sa-SAS) Convection Scheme - -\section des_samf Description - -\section intra_samf Intraphysics Communication - - -*/ diff --git a/physics/docs/pdftxt/GFS_SAMFdeep.txt b/physics/docs/pdftxt/GFS_SAMFdeep.txt index 66d541563..346637b3b 100644 --- a/physics/docs/pdftxt/GFS_SAMFdeep.txt +++ b/physics/docs/pdftxt/GFS_SAMFdeep.txt @@ -65,6 +65,165 @@ rain conversion rate, entrainment and detrainment rates, overshooting layers, and maximum allowable cloudbase mass flux (as of June 2018). +\section v6_enh CCPP Physics Updates +\version CCPP v6.0.0 + +\subsection ca_page Cellular Automata Stochastic Convective Organization Scheme + +\b Scientific \b Background + +Cumulus clouds in the atmosphere can organize into a variety of sizes, ranging +from small fair‐weather cumulus clouds, rain showers and thunderstorms, to +larger scale weather systems. In weather and climate models, such organization +is traditionally not well-represented as the motions associated with cumulus +clouds are generally too small to be resolved by the numerical model. +In this scheme we use a stochastic cellular automaton (CA), a mathematical +model often used to describe self‐organizing behavior in physical systems to +represent the effects of convective organization. The scheme addresses the +effect of convective organization in a bulk-plume cumulus convection +parameterizations (saSAS), where this type of organization has to be +represented in terms of how the resolved flow would “feel” convection if +more coherent structures were present on the subgrid. + +In addition, for longer range forecasts (seasonal, decadal, climate), +the relevance of stochastic cumulus convection in numerical models can also +be discussed in terms of noise induced forcing. As an example, on the +time scale of organized convectively coupled waves, the small scale individual +convective plumes grow and decay so rapidly that they are not predictable +on time-scales longer than a few hours, whereas the organized larger scale +convectively coupled wave envelope can have a deterministic limit of +predictability of about two weeks. Thus, for longer range forecasts, +individual convective plumes can be viewed as stochastic noise - they can +have an impact on the convectively coupled waves (due to noise forcing), +but they are not predictable on their own. By providing the CA with a +stochastic initialization, the effect of stochastic cumulus convection +is also represented by the scheme. + +The scientific motivation for the scheme, the CA rulesets explored, and +the impact on convectively coupled equatorial waves can be found in the +following references; Bengtsson et al. 2011 \cite Bengtsson_2011, +Bengtsson et al. 2013 \cite bengtsson_et_al_2013, +Bengtsson and Kornich (2016) \cite bengtsson_and_kornich_2016, +Bengtsson et al 2019 \cite Bengtsson_2019, +and Bengtsson et al. 2021 \cite bengtsson_et_al_2021. + +\b Technical \b remarks + +The CA source code is located in the stochastic physics submodule in +the ufs-weather-model: https://github.com/noaa-psd/stochastic_physics . +In the UFS Weather Model, the main call to the CA routines are made +from FV3/stochastic_physics_driver.F90. + +There are currently two options to evolve the CA (can be done simultaneously); +(\p ca_global) a large scale global pattern which evolves the ruleset according +to game of life with cell history, or (\p ca_sgs) a sub-grid scale pattern +which is conditioned on a forcing from the atmospheric model. The two options +are controlled by namelist and are evolved in cellular_automata_globa.F90 +and cellular_automata_sgs.F90 respectively. Both approaches use the main +CA module update_ca.F90 to evolve the CA in time. Since the CA needs to know +about its neighborhood it uses the halo information to gather the state +in adjacent MPI domains and/or adjacent cube sphere interfaces. + +\b The \p ca_sgs \b option - \b Coupled \b to \b saSAS \b cumulus \b convection \b scheme + +The evolution of the CA is an extension to the automaton family known as “Generations,” +which in turn is based on the “Game of Life”(Chopard & Droz, 1998 \cite Chopard_1998) + but adds cell history to the rule set. It is a deterministic CA ruleset, initialized +with Gaussian white noise. Thus, when used in an ensemble system, each ensemble +member can provide a different seed to the random number generator governing +the initial state to then generate a different evolution for each member. +By cell history we refer to newborn cells being given a “lifetime,”τ, +that is incrementally reduced by 1 each time step where the rules are not met, + in contrast to going directly from 1 to 0. The CA is conditioned on a +forcing from the host model through the lifetime variable τ such that: + +\f[ +\tau =N\left( \frac{\int_{l=1}^{l=top}E\frac{dp }{g} }{\max\left( \int_{l=1}^{l=top} E\frac{d p}{g}\right)} \right) +\f] + +here, N is an integer that when multiplied by the model time-step represents +a physical time scale, such that τ is longer in regions where the forcing is larger, +E is the vertically integrated convective rain evaporation from the +saSAS cumulus convection scheme stored in Coupling%condition. The denominator is +the maximum value of the forcing in the global domain. While the grid-scale +forcing in practice could be any two-dimensional field, we choose here +to set it as the vertically integrated subgrid rain evaporation amount, +serving as an indicator of geographical regions where enhanced subgrid +organization may arise through convective cold-pools. + +The CA is evolved on a finer grid than the numerical prediction +host model (size controlled by namelist), and can be either coarse +grained back to the host model grid as a fraction, or (in case of \p nca_plumes = .true.) +give back the maximum number of connected “plumes” (represented by +connected CA cells), and their associated size within each numerical +prediction host model grid-box. nca_plumes is default true and the +maximum cluster size is passed to the saSAS cumulus convection scheme +in the Coupling%ca_deep container. + +Depending on the activated namelist options, the CA can feed back to +the saSAS convection scheme via the entrainment (\p ca_entr), closure +(\p ca_closure) or convective initiation (\p ca_trigger) in the following way: + +- Entrainment (\p ca_entr): In entraining plume model bulk mass-flux schemes, +the upward mass-flux is typically parameterized as a function of environmental +air being entrained into the rising plume (as well as parcel properties at +cloud base). The fractional entrainment is described as a function of the +plume radius. Larger thermals (plumes) have smaller fractional entrainment, +which is a consequence of the fact that larger areas have relatively smaller +perimeters. In this scheme, the assumption is that subgrid organization will +lead to a few larger plumes rather than several smaller plumes, such that +the grid-box average fractional entrainment is reduced. Thus, after +the CA is updated, we count the number of plumes, and their associated +size within each NWP grid-box (\p nca_plumes = true). If the largest +cluster of cells found on the subgrid is larger than a set radius, then the +fractional entrainment rate is reduced at that grid-point by 30% +(selected based on experimentation) + +- Triggering (\p ca_trigger): In NWP models physical processes are parameterized +in columns, and the horizontal interaction between physical processes takes +place only through advection and diffusion. As the CA can organize clusters +across adjacent NWP model grid-boxes, the method offers a novel approach to +enhance the probability of triggering of convection in nearby areas, +representing subgrid fluctuations in temperature and humidity, and triggering +in premoistened regions if convection is triggered in a cluster. The +stochastic nature of the CA may enhance organization in different +directions within the grid-box, and across grid-boxes, depending on the +initial seed. If the model is run as an ensemble, the convection scheme's +stochastic triggering function can help to improve uncertainty estimates +associated with subgrid fluctuations of temperature and humidity and +randomness in organization. In this work, model grid boxes in which the +CA's largest connecting plume exceeds a given threshold will be considered +as candidates for convective activation, in addition to saSAS’s current +triggering criteria. + +- Closure (\p ca_closure): We assume that convection that organizes into +plumes with larger radii tends to cover a larger area fraction of the +grid-box and thereby acts to enhance the cloud base mass flux. In this +coupling strategy, we again count the number of plumes (represented by +connected cellular automaton cells), and their associated size within +each NWP grid-box. If the largest cluster of cells found on the subgrid +is larger than a set radius, then the cloud base mass-flux is enhanced in +that grid-box by 25% (selected based on experimentation). This option is +being revisited by reformulating the entire closure using a prognostic +evolution of the updraft area fraction, and is in its current formulation +not recommended. + +\subsection gen_enh Physics Updates in GFS Cumulus Convection + +- To enhance the surface-based convective available potential energy (CAPE), +more strict convection trigger conditions are applied. +- Enhanced downdraft detrainments start from 60 mb above the ground surface +rather than from the cloud base. +- Reduced rain evaporation with the removal of wind shear dependency, which +helps to reduce cold bias in tropospheric temperature profile especially over Tropics. +- Separation cloud depth of deep and shallow convection is +increased to 200 hPa from 150 hPa. +- Updraft entrainment rates for moisture, hydrometeors, and tracers are +increased by about 30%. +- A positive definite TVD (Total Variation Diminishing) mass-flux transport +scheme for moisture, hydrometeors and tracers and a method for removing negative tracer mixing ratio values have been implemented. + +\sa NCEP Office Note 505 \cite https://doi.org/10.25923/cybh-w893 and 506 \cite https://doi.org/10.25923/5051-3r70 \section intra_deep Intraphysics Communication \ref arg_table_samfdeepcnv_run diff --git a/physics/docs/pdftxt/GFS_SATMEDMFVDIFQ.txt b/physics/docs/pdftxt/GFS_SATMEDMFVDIFQ.txt index de543fe6c..4e00d7c3c 100644 --- a/physics/docs/pdftxt/GFS_SATMEDMFVDIFQ.txt +++ b/physics/docs/pdftxt/GFS_SATMEDMFVDIFQ.txt @@ -2,9 +2,9 @@ \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: +The current operational GFS scale-aware TKE-EDMF PBL scheme + is an extended version of GFS Hybrid Eddy-Diffusivity Mass-Flux PBL and Free Atmospheric Turbulence +scheme (Han et al. 2016 \cite Han_2016; Han et al. 2017 \cite han_et_al_2017) with below enhancement: -# Eddy diffusivity (K) is now a function of TKE which is prognostically predicted @@ -26,10 +26,30 @@ to take into account nonlocal transport by large eddies(mfpbltq.f) it was an eddy diffusion form) - For local turbulence mixing, a TKE closure model is used. + +\section v6_pbl_enh CCPP Physics Updates +\version CCPP v6.0.0 + +- Wind shear effect in characteristic mixing length calculation is included, which +reduces the mixing length in a strong shear environment such as a hurricane. +- To better predict surface inversion as well as capping inversion near the PBL top, +background diffusivity in the inversion layers is reduced as a function of surface +roughness and green vegetation fraction. +- To reduce the PBL overgrowth, the PBL updraft overshoot is not only limited by +bulk Richardson number-based-PBL depth, but the virtual potential temperature at +top of the surface layer rather than that at the model first layer is also used as +the near-surface virtual potential temperature in the bulk-Richardson number +computation. This helps to largely suppress the unrealistic widespread popcorn-like precipitation. +- Updraft entrainment rates for moisture, hydrometeors, and tracers are increased by about 30%. +- A positive definite total variation diminishing (TVD) mass-flux transport scheme for moisture, hydrometeors, +and tracers and a method for removing negative tracer mixing ratio values have been implemented. + +\sa NCEP Office Note 505 \cite https://doi.org/10.25923/cybh-w893 and 506 \cite https://doi.org/10.25923/5051-3r70 + \section intra_satmedmfvdifq Intraphysics Communication -\ref arg_table_satmedmfvdifq_run +- \ref arg_table_satmedmfvdifq_run \section gen_pbl_satmedmfvdifq General Algorithm -\ref gen_satmedmfvdifq +- \ref gen_satmedmfvdifq */ diff --git a/physics/docs/pdftxt/GFS_SFCLYR.txt b/physics/docs/pdftxt/GFS_SFCLYR.txt index 60d804a01..5498f510d 100644 --- a/physics/docs/pdftxt/GFS_SFCLYR.txt +++ b/physics/docs/pdftxt/GFS_SFCLYR.txt @@ -54,6 +54,16 @@ Here \f$z\f$ is the height, \f$L\f$ is the Obukhov length, \f$z_{0M}\f$ is the m The pertinent features of the GFS stable surface layer parameterization scheme are described in the appendix of Zheng et al. (2017) \cite zheng_et_al_2017. +\section version_gfsslay_enh Physics Updates +\version CCPP v6.0.0 + +- A new canopy heat storage algorithm was implemented. The reduction of the sensible heat flux into the PBL, as a function of surface roughness and vegetation fraction, helps to reduce nighttime cold and daytime warm 2-meter temperature biases over forested regions. +- A sea spray effect algorithm was included to enhance sensible and latent heat fluxes, especially for strong wind conditions. +- To better represent sub-grid scale turbulence variability in the surface layer, a new algorithm for maximum surface layer stability parameter was developed as an inverse function of the background turbulent eddy diffusivity. +- The thermal roughness length calculation over land has been modified. + +\sa Han et al.(2021) \cite https://doi.org/10.25923/cybh-w893 and Han et al.(2022) \cite https://doi.org/10.25923/5051-3r70 + \section intra_rough Intraphysics Communication \ref arg_table_sfc_diff_run diff --git a/physics/docs/pdftxt/GFS_SFCSICE.txt b/physics/docs/pdftxt/GFS_SFCSICE.txt index b7b3c38f3..4cd61f316 100644 --- a/physics/docs/pdftxt/GFS_SFCSICE.txt +++ b/physics/docs/pdftxt/GFS_SFCSICE.txt @@ -31,11 +31,10 @@ fluxes and albedo are treated separately for the ice and the open water. \section intra_sice Intraphysics Communication -+ GFS Sea Ice Driver (\ref arg_table_sfc_sice_run) -+ Three-layer Thermodynamics Sea Ice Model (ice3lay()) \cite winton_2000 +- \ref arg_table_sfc_sice_run \section gen_sice General Algorithm -+ \ref general_sice_run -+ \ref gen_ice3lay +- \ref general_sice_run +- \ref gen_ice3lay */ diff --git a/physics/docs/pdftxt/GFS_SPP.txt b/physics/docs/pdftxt/GFS_SPP.txt new file mode 100644 index 000000000..0a461e84e --- /dev/null +++ b/physics/docs/pdftxt/GFS_SPP.txt @@ -0,0 +1,70 @@ +/** +\page GFS_SPP Stochastically-Perturbed Parameterizations (SPP) + +\section des_spp Description + +For both regional and global ensembles, sufficient initial condition and +physics uncertainty representation is critically important to ensemble +performance. Otherwise, members may tend toward similar solutions, +resulting in forecasts not capturing the full envelope of possible +outcomes. To improve the effectiveness of the ensemble, stochastic +physics can be employed. Stochastically-Perturbed Parameterizations +(SPP) provides one method through which unknown or uncertain physical +processes can be represented in ensemble forecasting. As it is currently +employed in CCPP (Beck et al.(2022) \cite beck_et_al_2022), SPP can be applied to the following physics parameterizations: +\ref MYNNEDMF, \ref SFC_MYNNSFL, \ref GFS_RRTMG, \ref GFS_UNIFIED_UGWP,\ref GFS_drag_suite and +\ref THOMPSON (note that both \ref RUCLSM and \ref GFS_NOAH can also be +run with stochastic parameter perturbations). A list of the parameters perturbed +within each scheme can be found below: + +- \ref MYNNEDMF + - Eddy diffusivity + - Viscosity + - Background water vapor + - Lateral entrainment rate +- \ref SFC_MYNNSFL + - Thermal roughness length + - Moisture roughness length + - Aerodynamic roughness length +- \ref GFS_UNIFIED_UGWP and \ref GFS_drag_suite + - Subgrid-scale terrain variations + - Froude number + - Wind speed tendencies +- \ref GFS_RRTMG + - Effective cloud water, snow, and ice radii +- \ref THOMPSON + - Graupel intercept parameter + - Cloud droplet shape parameter + - Vertical velocity used in CCN activation + - Ice number concentration + +Magnitudes, time decorrelation lengths, and other namelist settings can be modified to control the perturbations for each scheme; however, for now, +all parameters are perturbed identically within each scheme. For detailed information on how to activate and modify SPP settings for +these schemes, the reader is referred to the SRW App Users Guide. + +Each parameter listed above was chosen through consultation with +physics experts, often the author of the parameterization, in order +to target fields that could benefit from the application of SPP. However, there are many other parameters which could be effectively +perturbed to improve uncertainty representation and ensemble spread generation. + In most of the perturbed parameterizations, the perturbation magnitudes +are multiplied by coefficients to generate reasonable parameter values; +however, users should be careful when making changes to the magnitudes +provided as a guideline in the SRW App documentation, since it is still +possible to generate unphysical parameter values. Default magnitudes +and decorrelation lengths in the SRW App documentation were the result +of extensive testing with 3-km CONUS simulations. If the user would +like to apply SPP at other resolutions, it is recommended that retrospective +simulations be conducted over the area of interest to ensure reasonable +application of the perturbations. + +## GFS Surface Parameter Perturbation + +Land surface perturbation (Gehne et al. (2019) \cite Gehne_2019) has been recently introduced +into UFS. This treatment is based on the hypothesis that one of the major +causes of the insufficient spread in current global NWP model,especially near the surface, is a lack of treatment of +uncertainty in the soil state and in the associated model parameters. It allows for land surface parameters such as surface albedo, +vegetation fraction, soil hydraulic conductivity, leaf area index (LAI), surface roughness lengths for heat and momentom to vary in space. +These parameters and variables have been shown to impact forecasts of 2m temperature, 10m wind and precipitation. Based on the parameter +or variable,different strategies to perturb are necessary. + +*/ diff --git a/physics/docs/pdftxt/GFS_STOCHY_PHYS.txt.save b/physics/docs/pdftxt/GFS_STOCHY_PHYS.txt.save deleted file mode 100644 index 184172a8c..000000000 --- a/physics/docs/pdftxt/GFS_STOCHY_PHYS.txt.save +++ /dev/null @@ -1,75 +0,0 @@ -/** -\page STOCHY_PHYS GFS Stochastic Physics -\section des_stochy Description -Traditionally, physical parameterization schemes were assumed to be deterministic, producing representations of small-scale -processes unique to the resolved-scale atmospheric state. This assumption becomes increasingly problematic as computational -advances permit more accurate simulations at finer resolutions where small-scale processes exhibit more stochastic qualities. -Small-scale convective fluctuations often interact strongly with the nonlinear flow dynamics, with substantial repercussions -for large-scale model evolution. Producing accurate and reliable probabilistic predictions therefore depends critically on -representations of parameterization uncertainties. - -In the 2015 GFS implemmentaion, new stochastic physics schemes were employed to represent model error to replace -the artificial additive inflation. The upgraded stochastic physics suite has three components, including -- Stochastically Perturbed Physics Tendencies (\b SPPT; Buizza et al.(1999) \cite buizza_et_al_1999 ; Palmer (1997) -\cite palmer_1997 ; Palmer (2001) \cite palmer_2001) -- Specific HUMidity perturbations (\b SHUM; Tompkins and Berner (2008) \cite tompkins_and_berner_2008) -- Stochastic Kinetic Energy Backscatter (\b SKEB; Berner et al.(2009) \cite berner_et_al_2009; Shutts (2005) \cite shutts_2005) - -All three of these schemes use a first-order auto-regrassive (AR(1)) random pattern generator to produce spatially and temporally -correlated perturbations with three different horizontal length/time scales 500 km/0.25 days, 1000 km/3 days and 2000 km/30 days, -and standard deviations of 0.8, 0.4 and 0.2 respectively. Zhu et al.(2018) \cite zhu_et_al_2018 show an example of a realization -of the three components. The above nine numbers are meant to span the uncertainty at mesoscale, synoptic scale and planetary space -and time scales with pattern 1 (500 km decorrelation scale) being the starting point and most important component for the medium-range -ensemble prediction system. - -Condering the delicate balance between model dynamics and vertical momentum transport which is established in the lowest model -levels on timescales of the order of minutes, the tendency perturbations were reduced towards zero close to the surface. A tapering -fucntion \f$\mu\f$ is applied in SPPT, so there are no tendency perturbation in the mountain blocked flow (i.e., on or below the level -of dividing streamline that is diagnosed by the gwdps_run, mountain blocking scheme). It is done to avoid numerical instability in the -boundary layer. - - - -\section sppt_des The SPPT Scheme in FV3GFS -ECMWF first introduced a stochastic representation of parameterization uncertainties in the medium-range ensemble in October -1998 using scheme that multiplies the total parameterized physics tendencies with a random number (Buizza et al., 1999 -\cite buizza_et_al_1999). The scheme was originally referred to as 'stochastic physics'. It is now commonly referred to as the -Stochastically Perturbed Parameterization Tendency scheme (SPPT). - -The SPPT scheme in FV3GFS uses perturbations collinear to the unperturbed tendencies. For all variables \f$X\in\left\{u,v,T,q\right\}\f$, -the perturbed tendency is obtained with the same random number \f$r\f$ -\f[ -X_{p}=(1+r\mu)X_{c} -\f] -The distribution from which \f$r\f$ is drawn is close to a Gaussian distribution. The random field \f$r\f$ is obtained through first-order -auto-regressive processes in spectral space. At ECMWF, a multi-scale approach is implemented in IFS with -\f[ -r=\sum_{j=1}^Jr_{j} -\f] -where the component random fields \f$r_{j}\f$ are independent and represent different scales. The total physical parameterization tendency -is multiplied by a randomly-evolving global pattern field whose average value at any point is unity and whose standard deviation is prescribed. -The pattern field is composed of three independent patterns, each generated from triangularly-truncated spherical harmonic expansions which -have the property that their spatial auto-correlation function is independent of position on the sphere. Each spherical harmonic mode in each -expansion is evolved in time using first-order autogressive process with fixed decorrelation time and wavenumber-dependent noise term: -\f[ -\widehat{r}_{mn}(t)=\phi\widehat{r}_{mn}(t-\Delta t)+\sigma_{n}\sqrt{1-\phi^{2}}\eta_{mn}(t) -\f] -where \f$\widehat{r}_{mn}\f$ is the spherical harmonic for zonal wave number \f$m\f$ and total wavenumber \f$n\f$, -\n \f$\sigma_{n}\f$ is the standard deviation of the time-series and is a function of \f$n\f$, decorrelation length scale, and desired -amplitude of the pattern. -\n \f$\phi\f$: temporal decorrelation -\n \f$\eta_{mn}\f$: random Gaussian number E(0,1) - -\section skeb_des The Stochastic Kinetic Energy Backscatter (SKEB) scheme in FV3GFS -As with SPPT, the SKEB scheme is based on the product of a spectrally-generated pattern field and a derived model field. However, -instead of using model tendencies, the backscatter scheme uses a horizontally-smoothed dissipation rate field to modulate the pattern -field and defined this to be a streamfunction forcing function. The pattern uses a noise term with a different wavenumber dependence -to that used in SPPT and one that gives a power law spectrum - -\section shum_des The SHUM Scheme in FV3GFS - -\section sfcpert_des The Land Surface Perturbations in FV3GFS - - - -*/ diff --git a/physics/docs/pdftxt/GFS_SURFACE_PERT.txt b/physics/docs/pdftxt/GFS_SURFACE_PERT.txt index 1ecdfaa34..234571bca 100644 --- a/physics/docs/pdftxt/GFS_SURFACE_PERT.txt +++ b/physics/docs/pdftxt/GFS_SURFACE_PERT.txt @@ -2,6 +2,8 @@ \page surf_pert GFS Surface Parameter Perturbation \section des_sfcpert Description +\todo land surface prt + Land surface perturbation (Gehne et al. (2019) \cite Gehne_2019) has been recently introduced into FV3GFS. This treatment is based on the hypothesis that one of the major causes of the insufficient spread in current global NWP model,especially near the surface, is a lack of treatment of diff --git a/physics/docs/pdftxt/GFS_UGWPv0.txt b/physics/docs/pdftxt/GFS_UGWPv0.txt index 82cd06f68..f2b3b143a 100644 --- a/physics/docs/pdftxt/GFS_UGWPv0.txt +++ b/physics/docs/pdftxt/GFS_UGWPv0.txt @@ -109,9 +109,9 @@ and dynamical instability of waves described by the linear (Weinstock 1984 \cite weinstock_1984; Hines 1997 \cite hines_1997) saturation theories. \section intra_UGWPv0 Intraphysics Communication -\ref arg_table_cires_ugwp_run +- \ref arg_table_cires_ugwp_run \section gen_al_ugwpv0 General Algorithm -\ref gen_cires_ugwp +- \ref gen_cires_ugwp */ diff --git a/physics/docs/pdftxt/GFS_ZHAOC.txt b/physics/docs/pdftxt/GFS_ZHAOC.txt deleted file mode 100644 index fcc69cf6e..000000000 --- a/physics/docs/pdftxt/GFS_ZHAOC.txt +++ /dev/null @@ -1,43 +0,0 @@ -/** -\page GFS_ZHAOC GFS Zhao-Carr Microphysics Scheme -\section des_zhao Description - This is the GFS scheme for grid-scale condensation and precipitation which is based on - Zhao and Carr (1997) \cite zhao_and_carr_1997 and Sundqvist et al. (1989) \cite sundqvist_et_al_1989 . - The main feature of this parameterization is the inclusion of cloud water and cloud ice in both the - convective and grid-scale precipitation paramterizations, and use only one predictive variable, the - cloud water/ice mixing ratio \f$m\f$, to represent both cloud water and cloud ice. This will reduce - the model computation time and storage requirements. - - Figure 1 shows a schematic illustration of this scheme. - There are two sources of prognostic cloud condensate, namely convective - detrainment (samfdeepcnv_run() and samfshalcnv_run()) and grid-sale condensation (zhaocarr_gscond_run()). - Both of them produce either cloud water or cloud ice, depending on - the cloud substance at and above the grid point at current and previous time steps, and on the temperature. Evaporation of - cloud is allowed at points where the relative humidity is lower than the critical value required for condensation. Precipitation - is diagnostically calculated directly from the cloud water/ice mixing ratio. Both frozen and liquid precipitation can be - prognostically produced, enabling this scheme to predict precipitation type. - - \image html GFS_zhaocarr_schematic.png "Figure 1: Schematic illustration of the precipitation scheme" width=10cm - - The parameterization of precipitation is required in order to remove - water from the atmosphere and transport it to the ground. - For the precipitation production, only the principle microphysical processes associated with formation of rain and - snow are inlcuded. Figure 2 presents the microphysical processes considered in the microphysics scheme. Basically, - there are four types of microphysical processes considered here: - + Production of rain from cloud water (\f$P_{racw}\f$, \f$P_{raut}\f$, \f$P_{sacw}\f$) - + Production of snow from cloud ice (\f$P_{saut}\f$, \f$P_{saci}\f$) - + Melting of snow to form rain below the freezing level (\f$P_{sm1}\f$, \f$P_{sm2}\f$) - + Evaporation of precipitation (\f$E_{rr}\f$, \f$E_{rs}\f$) -\image html precpd-micop.png "Figure 2: Microphysical processes simulated in the precipitation scheme " width=10cm - Some processes, such as the freezing of raindrops and the interaction between rain drops and cloud ice, have been ignored - since the upward motion on the synoptic scale is too weak to advect the raindrops upward. Additionally, precipitation is - diagnostically calculated directly from the cloud mixing ratio. -\section intra_zhao Intraphysics Communication - + For grid-scale condensation and evaporation of cloud process (\ref arg_table_zhaocarr_gscond_run) - + For precipitation (snow or rain) production (\ref arg_table_zhaocarr_precpd_run) -\section Gen_zhao General Algorithm - + \ref general_gscond - + \ref general_precpd - - -*/ diff --git a/physics/docs/pdftxt/GFS_drag_suite.txt b/physics/docs/pdftxt/GFS_drag_suite.txt new file mode 100644 index 000000000..ed059e1f9 --- /dev/null +++ b/physics/docs/pdftxt/GFS_drag_suite.txt @@ -0,0 +1,19 @@ +/** +\page GFS_drag_suite GSL Drag Suite Scheme +\section des_drag Description + +The GSL drag suite, developed by NOAA's Global Systems Laboratory, 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. + +All four orographic GWD schemes require static input data files that contain statistical information about the subgrid terrain within each model grid cell, such as the standard deviation of the subgrid topography, which comes from the high resolution USGS 30-second GMETED2010 dataset. These data files augment the usual "oro_data.tile*.nc" files, which contain orographic height data and GWD static data for the GFSv16 GWD parameterizations. The static data files for the large-scale GWD and blocking schemes are named "oro_data_ls.tile*.nc". The source topography for the datasets are calculated from a 2.5-minute lat-lon grid to filter out small-scale topographic variations. The static data files for the small-scale GWD and TOFD schemes are named "oro_data_ss.tile*.nc". The data is from the 30-second topographic dataset, but band-passed filtered from ~20km down to ~2km as per Beljaars et al.(2004) \cite beljaars_et_al_2004. + +The large-scale GWD and blocking schemes are explicitly tapered off from horizontal grid resolutions starting at ~13km down to 3km resolution, at and below which the scheme is not active. + + +\section instra_drag Intraphysics Communication +- \ref arg_table_drag_suite_run + +\section gen_drag General Algorithm +- \ref gen_drag_suite +*/ diff --git a/physics/docs/pdftxt/GFS_ugwpv1_gsldrag.txt b/physics/docs/pdftxt/GFS_ugwpv1_gsldrag.txt new file mode 100644 index 000000000..ea817ce7c --- /dev/null +++ b/physics/docs/pdftxt/GFS_ugwpv1_gsldrag.txt @@ -0,0 +1,48 @@ +UGWPv1_gsldrag scheme. + +The "ugwpv1_gsldrag" combines the orographic gravity wave drag (GWD) parameterizations of the GSL drag suite with the version 1 UGWP non-stationary gravity wave drag (NGW) scheme of \cite yudin_et_al_2020. + +For information on the GSL drag suite, click here. + +The NGW physics scheme parameterizes the effects of non-stationary waves +unresolved by dynamical cores. These non-stationary oscillations with periods +bounded by Coriolis and Brunt-Väisälä frequencies and typical horizontal +scales from tens to several hundreds of kilometers, are forced by the +imbalance of convective and frontal/jet dynamics in the troposphere and +lower stratosphere (Fritts 1984 \cite fritts_1984; Alexander et al. +2010 \cite alexander_et_al_2010; Plougonven and Zhang 2014 \cite plougonven_and_zhang_2014). +The NGWs propagate upwards and the amplitudes exponentially grow with +altitude until instability and breaking of waves occur. Convective and +dynamical instability induced by GWs with large amplitudes can trigger +production of small-scale turbulence and self-destruction of waves. +The latter process in the theory of atmospheric GWs is frequently referred +as the wave saturation (Lindzen 1981 \cite lindzen_1981; Weinstock +1984 \cite weinstock_1984; Fritts 1984 \cite fritts_1984). Herein, +“saturation” or "breaking" refers to any processes that act to reduce +wave amplitudes due to instabilities and/or interactions arising from +large-amplitude perturbations limiting the exponential growth of GWs +with height. Background dissipation processes such as molecular diffusion +and radiative cooling, in contrast, act independently of GW amplitudes. +In the middle atmosphere, impacts of NGW saturation (or breaking) and +dissipation on the large-scale circulation, mixing, and transport have +been acknowledged in the physics of global weather and climate models +after pioneering studies by Lindzen 1981 \cite lindzen_1981 and Holton +1983 \cite holton_1983. Comprehensive reviews on the physics of NGWs +and OGWs in climate and weather models have been discussted in Alexander +et al. 2010 \cite alexander_et_al_2010, Geller et al. +2013 \cite geller_et_al_2013, and Garcia et al. 2017 \cite garcia_et_al_2017. +They are formulated using different aspects of the nonlinear and linear +propagation, instability, breaking and dissipation of waves along with +different specifications of GW sources (Garcia et al. 2007 \cite garcia_et_al_2007; +Richter et al 2010 \cite richter_et_al_2010; Eckermann et al. +2009 \cite eckermann_et_al_2009; Eckermann 2011 \cite eckermann_2011; +Lott et al. 2012 \cite lott_et_al_2012). + +Several studies have demonstrated the importance of NGW physics to improve +model predictions in the stratosphere and upper atmosphere (Alexander et al. + 2010 \cite alexander_et_al_2010; Geller et al. 2013). In order to describe +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. + + diff --git a/physics/docs/pdftxt/GFS_unified_ugwp.txt b/physics/docs/pdftxt/GFS_unified_ugwp.txt new file mode 100644 index 000000000..f4b7a2aa7 --- /dev/null +++ b/physics/docs/pdftxt/GFS_unified_ugwp.txt @@ -0,0 +1,160 @@ +/** +\page GFS_UNIFIED_UGWP GFS Unified UGWP Scheme + +\section des_uugwp Description + +The "unified_ugwp" scheme was the first "unification" of the \ref GFS_drag_suite with the \ref GFS_UGWP_v0 orographic and +non-stationary gravity wave drag schemes. It was coded as a testing platform + to determine the optimal combination of schemes to use for future physics +prototypes. For the large-scale orographic gravity wave drag (OGW) and blocking scheme, the user +may specify either those of the \ref GFS_UGWP_v0 or those of the \ref GFS_drag_suite. +The GSL Drag Suite includes two new "small-scale" orographic drag schemes, which +may be used in combination with either "large-scale" orographic schemes. +Finally, the non-stationary gravity wave drag (NGW) scheme is that of the \ref GFS_UGWP_v0 scheme. + +\b Description \b of \b the \b GSL \b Drag \b Suite: + +The \ref GFS_drag_suite, developed by NOAA's Global Systems Laboratory, +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 is 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. + +All four orographic GWD schemes require static input data files that +contain statistical information about the subgrid terrain within each +model grid cell, such as the standard deviation of the subgrid topography, +which comes from the high resolution USGS 30-second GMETED2010 dataset. +These data files augment the usual "oro_data.tile*.nc" files, which contain +orographic height data and GWD static data for the GFSv16 GWD parameterizations. +The static data files for the large-scale GWD and blocking schemes are named +"oro_data_ls.tile*.nc". The source topography for the datasets are calculated +from a 2.5-minute lat-lon grid to filter out small-scale topographic variations. +The static data files for the small-scale GWD and TOFD schemes are named +"oro_data_ss.tile*.nc". The data is from the 30-second topographic dataset, +but band-passed filtered from approximately 20 km down to approximately 2 km +as per Beljaars et al. (2004)\cite beljaars_et_al_2004. + +The large-scale GWD and blocking schemes are explicitly tapered off from +horizontal grid resolutions starting at approximately 13 km down to approximately +3 km resolution, at and below which the scheme is not active. + +\b Description \b of \b the \b non-stationary \b GWD \b scheme \b of \b the \ref GFS_UGWP_v0 \b scheme: + +The NGW physics scheme parameterizes the effects of non-stationary waves +unresolved by dynamical cores. These non-stationary oscillations with periods +bounded by Coriolis and Brunt-Väisälä frequencies and typical horizontal +scales from tens to several hundreds of kilometers, are forced by the +imbalance of convective and frontal/jet dynamics in the troposphere and +lower stratosphere (Fritts (1984) \cite fritts_1984; +Alexander et al.(2010) \cite alexander_et_al_2010; +Plougonven and Zhang 2014 \cite plougonven_and_zhang_2014). The NGWs propagate +upwards and the amplitudes exponentially grow with altitude until instability +and breaking of waves occur. Convective and dynamical instability induced +by GWs with large amplitudes can trigger production of small-scale turbulence +and self-destruction of waves. The latter process in the theory of atmospheric +GWs is frequently referred as the wave saturation (Lindzen(1981) \cite lindzen_1981; +Weinstock(1984) \cite weinstock_1984; Fritts(1984) \cite fritts_1984). +Herein, “saturation” or "breaking" refers to any processes that act to reduce +wave amplitudes due to instabilities and/or interactions arising from +large-amplitude perturbations limiting the exponential growth of GWs with height. +Background dissipation processes such as molecular diffusion and radiative cooling, +in contrast, act independently of GW amplitudes. In the middle atmosphere, +impacts of NGW saturation (or breaking) and dissipation on the large-scale +circulation, mixing, and transport have been acknowledged in the physics +of global weather and climate models after pioneering studies by +Lindzen(1981) \cite lindzen_1981 and Holton(1983) \cite holton_1983. +Comprehensive reviews on the physics of NGWs and OGWs in climate and +weather models have been discussted in Alexander et al. 2010 \cite alexander_et_al_2010, +Geller et al. 2013 \cite geller_et_al_2013, and Garcia et al. 2017 \cite garcia_et_al_2017. +They are formulated using different aspects of the nonlinear and +linear propagation, instability, breaking and dissipation of waves +along with different specifications of GW sources +(Garcia et al. 2007 \cite garcia_et_al_2007; +Richter et al 2010 \cite richter_et_al_2010; +Eckermann et al. 2009 \cite eckermann_et_al_2009; +Eckermann 2011 \cite eckermann_2011; +Lott et al. 2012 \cite lott_et_al_2012). + +The concept of UGWP was first proposed and implemented in +the Unified Forecast System (UFS) with model top at different levels +by scientists from the University of Colorado Cooperative Institute for +Research in the Environmental Sciences (CIRES) at NOAA's Space Weather +Prediction Center (SWPC) and from NOAA's Environmental Modeling Center (EMC) +(Alpert et al. 2019 \cite alpert_et_al_2019; Yudin et al. 2016 \cite yudin_et_al_2016; +Yudin et al. 2018 \cite yudin_et_al_2018). The UGWP considers identical +GW propagation solvers for OGWs and NGWs with different approaches for +specification of subgrid wave sources. The current set of the input and +control parameters for UGWP version 0 (UGWP v0) enables options for GW effects, +including momentum deposition (also called GW drag), heat deposition, and mixing +by eddy viscosity, conductivity and diffusion; however, note that the eddy +mixing effects induced by instability of GWs are not activated in this version. + +Namelist parameters control the number of directional azimuths in which +waves can propagate, number of waves in a single direction, and the level +above the surface at which NGWs can be launched. Among the input parameters, +the GW efficiency factors reflect intermittency of wave excitation. They +should vary with horizontal resolution, reflecting the capability of the +dynamical core to resolve mesoscale wave activity with the enhancement +of model resolution. + +Prescribed distributions for vertical momentum flux (VMF) of NGWs have +been employed in global numerical weather prediction and reanalysis models +to ease tuning of GW schemes to the climatology of the middle atmosphere +dynamics in the absence of the global wind data above about 35 km +(Eckermann et al. 2009 \cite eckermann_et_al_2009; Molod et al. 2015 \cite molod_et_al_2015). +These distributions of VMF qualitatively describe the general features +of the latitudinal and seasonal variations of the global GW activity in +the lower stratosphere, observed from the ground and space +(Ern et al. 2018 \cite ern_et_al_2018). Subgrid GW sources can also be +parameterized to respond to year-to-year variations of solar input and +anthropogenic emissions (Richter et al 2010 \cite richter_et_al_2010; +2014 \cite richter_et_al_2014). + +Note that in UGWP v0, the momentum and heat deposition due to GW breaking and dissipation have been tested in the multi-year simulations and medium-range forecasts using a configuration of the UFS weather model using 127 levels with model top at approximately 80 km. + +Along with the GW heat and momentum depositions, GW eddy mixing is an +important element of the Whole Atmosphere Model (WAM) physics, as shown +in WAM simulations with the spectral dynamics (Yudin et al. 2018 \cite yudin_et_al_2018). +The impact of eddy mixing effects in the middle and upper atmosphere, +which is not included in this version, need to be tested, evaluated, +and orchestrated with the representation of the subgrid turbulent diffusion +and the numerical dissipation. + +The representation of subgrid GWs is particularly important for WAMs that +extend into the thermosphere (top lid at about 600 km). In the mesosphere and +thermosphere, the background attenuation of subgrid waves due to molecular +and turbulent diffusion, radiative damping and ion drag will be the +additional mechanism of NGW and OGW dissipation along with convective and +dynamical instability of waves described by the linear (Lindzen 1981 \cite lindzen_1981) +and nonlinear (Weinstock 1984 \cite weinstock_1984; +Hines 1997 \cite hines_1997) saturation theories. + +\section intra_unified Intraphysics Communication +- \ref arg_table_unified_ugwp_run + +\section ga_unified_ugwp General Algorithm +- \ref gen_unified_ugwp + + +*/ diff --git a/physics/docs/pdftxt/GFS_v16_suite.txt b/physics/docs/pdftxt/GFS_v16_suite.txt new file mode 100644 index 000000000..38098838d --- /dev/null +++ b/physics/docs/pdftxt/GFS_v16_suite.txt @@ -0,0 +1,46 @@ +/** +\page GFS_v16_page GFS_v16 Suite + +\section gfsv16_suite_overview Overview + +Version 16 of the Global Forecast System (GFS) was implemented operationally by the NOAA +National Centers for Environmental Prediction (NCEP) in 2021. This suite is available for +use with the UFS SRW App and with the CCPP SCM. + +The GFS_v16 suite uses the parameterizations in the following order: + - \ref GFS_RRTMG + - \ref GFS_SFCLYR + - \ref GFS_NSST + - \ref GFS_OCEAN + - \ref GFS_NOAH + - \ref GFS_SFCSICE + - \ref GFS_SATMEDMFVDIFQ + - \ref GFS_UGWP_v0 + - \ref GFS_OZPHYS + - \ref GFS_H2OPHYS + - \ref GFS_SAMFdeep + - \ref GFS_SAMFshal + - \ref GFDL_cloud + +\section sdf_gfsv16b Suite Definition File +\include suite_FV3_GFS_v16.xml + + +\section gfs16_nml_opt_des Namelist +\ref GFDL_cloud namelist options +\snippet RE6/FV3_GFS_v16_input.nml GFDL_CLOUD_MP_NML +Other namelist options +\snippet RE6/FV3_GFS_v16_input.nml GFS_PHYSICS_NML + +- nstf_name = \f$[2,0,0,0,0]^1 [2,1,0,0,0]^2\f$ + - \f$^1\f$ NSST is on and coupled with spin up off + - \f$^2\f$ NSST is on and coupled with spin up on + +- Grid-spacing dependency of \p cdmbgwd + - \b C48: cdmbgwd="0.071,2.1,1.0,1.0" + - \b C96: cdmbgwd="0.14,1.8,1.0,1.0" + - \b C192: cdmbgwd="0.23,1.5,1.0,1.0" + - \b C384: cdmbgwd="1.1,0.72,1.0,1.0" + - \b C768: cdmbgwd="4.0,0.15,1.0,1.0" + +*/ diff --git a/physics/docs/pdftxt/GFS_v17_p8_suite.txt b/physics/docs/pdftxt/GFS_v17_p8_suite.txt new file mode 100644 index 000000000..ad2246b76 --- /dev/null +++ b/physics/docs/pdftxt/GFS_v17_p8_suite.txt @@ -0,0 +1,50 @@ +/** +\page GFS_v17_p8_page GFS_v17_p8 Suite + +\section gfsv_17_p8_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 suite is a prototype of +the GFS_v17 suite, and is expected to evolve before the implementation. It is available for use +with the UFS MRW App and with the CCPP SCM. The primary differences between the GFS_v16 and GFS_v17_p8 suites are: +- \b Microphysics: The replacement of \ref GFDL_cloud with \ref THOMPSON +- \b Deep \b Cumulus: Add \ref ca_page +- \b Gravity \b Wave \b Drag: The replacement of \ref GFS_UGWP_v0 with \ref GFS_UNIFIED_UGWP +- \b Land \b Surface \b Model: The replacement of \ref GFS_NOAH with \ref NoahMP + +The GFS_v17_p8 suite uses the parameterizations in the following order: + - \ref GFS_RRTMG + - \ref GFS_SFCLYR + - \ref GFS_NSST + - \ref NoahMP + - \ref GFS_SFCSICE + - \ref GFS_SATMEDMFVDIFQ + - \ref GFS_UNIFIED_UGWP + - \ref GFS_OZPHYS + - \ref GFS_H2OPHYS + - \ref GFS_SAMFdeep + - \ref GFS_SAMFshal + - \ref THOMPSON + + +\section sdf_gfsv17p8 Suite Definition File +\include suite_FV3_GFS_v17_p8.xml + +\section gfs17_nml_opt_des Namelist +- General physics options +\snippet FV3_GFS_v17_p8_input.nml GFS_PHYSICS_NML +- \ref GFS_UNIFIED_UGWP related options +\snippet FV3_GFS_v17_p8_input.nml CIRES_UGWP_NML + +- nstf_name = \f$[2,0,0,0,0]^1 [2,1,0,0,0]^2\f$ + - \f$^1\f$ NSST is on and coupled with spin up off + - \f$^2\f$ NSST is on and coupled with spin up on + +- Grid-spacing dependency of \p cdmbgwd + - \b C48: cdmbgwd="0.071,2.1,1.0,1.0" + - \b C96: cdmbgwd="0.14,1.8,1.0,1.0" + - \b C192: cdmbgwd="0.23,1.5,1.0,1.0" + - \b C384: cdmbgwd="1.1,0.72,1.0,1.0" + - \b C768: cdmbgwd="4.0,0.15,1.0,1.0" + +*/ diff --git a/physics/docs/pdftxt/GFSphys_namelist.txt b/physics/docs/pdftxt/GFSphys_namelist.txt deleted file mode 100644 index e792e953f..000000000 --- a/physics/docs/pdftxt/GFSphys_namelist.txt +++ /dev/null @@ -1,159 +0,0 @@ -/** -\page ccppphys_nml Namelist Option Description - -\section gfs_physics_nml GFS Physics Namelist Option - -\param fhzero -\param h2o_phys logical, -\param ldiag3d logical, -\param fhcyc -\param use_ufo logical, -\param pre_rad logical, -\param ncld integer, -\param imp_physics integer, -\param pdfcld logical, -\param fhswr -\param fhlwr -\param ialb gfs_control_type::ialb -\n SW surface albedo control flag -\n 0: using climatology surface albedo scheme for SW -\n 1: using MODIS based land surface albedo for SW -\param iems LW global surface emissivity control flag -\n 0: black-body emissivity -\n 1: surface type based climatology in \f$1^o\f$ horizontal resolution -\param iaer aerosol effect control flag (physparam::iaerflg) -\n 3-digit flag "abc" (volcanic, LW, SW): -\n a: stratospheric volcanic aerosols -\n b: tropospheric aerosols for LW -\n c: tropospheric aerosols for SW -\n =0: aerosol effect is not included; =1: aerosol effect is included -\param ico2 \f$CO_2\f$ data source control flag (physparam::ico2flg) -\n 0: prescribed value (380 ppmv) -\n 1: yearly global averaged annual mean from observations -\n 2: monthly 15 degree horizontal resolution from observations -\param isubc_sw subgrid cloud approximation control flag in SW radiation -\n 0: no McICA approximation in SW radiation -\n 1: use McICA with prescribed permutation seeds (test mode) -\n 2: use McICA with randomly generated permutation seeds -\param isubc_lw subgrid cloud approximation control flag in LW radiation -\n 0: no McICA approximation in LW radiation -\n 1: use McICA with prescribed permutation seeds (test mode) -\n 2: use McICA with randomly generated permutation seeds -\param isol solar constant scheme control flag -\n 0: fixed value = 1366.0 \f$W m^{-2}\f$ (old standard) -\n 10: fixed value = 1360.8 \f$W m^{-2}\f$ (new standard) -\n 1: NOAA ABS-scale TSI table (yearly) with 11-yr cycle approximation -\n 2: NOAA TIM-scale TSI table (yearly) with 11-yr cycle approximation -\n 3: CMIP5 TIM-scale TSI table (yearly) with 11-yr cycle approximation -\n 4: CMIP5 TIM-scale TSI table (monthly) with 11-yr cycle approximation -\param lwhtr logical flag for output of longwave heating rate -\param swhtr logical flag for output of shortwave heating rate -\param cnvgwd logical flag for convective gravity wave drag -\param shal_cnv logical flag for shallow convection -\param cal_pre logical flag for precipitation type algorithm -\param redrag logical flag for reduced drag coefficient for high wind over sea -\param dspheat logical flag for TKE dissipation heating -\param hybedmf logical flag for hybrid EDMF PBL scheme -\param random_clds -\param trans_trac -\param cnvcld -\param imfshalcnv -\param imfdeepcnv -\param cdmbgwd -\param prslrd0 -\param ivegsrc -\param isot -\param debug -\param nstf_name -\param nst_anl -\param psautco -\param prautco - - -\section gfdl_cloud_microphysics_nml GFDL Cloud Microphysics Namelist Option - -\param sedi_transport logical, \e true to turn on horizontal momentum transport during sedimentation -\param do_sedi_heat logical, \e true to turn on horizontal heat transport during sedimentation -\param rad_snow logical, \e true to consider snow in cloud fraction calculation -\param rad_graupel logical, \e true to consider graupel in cloud fraction calculation -\param rad_rain logical, \e true to consider rain in cloud fraction calculation -\param const_vi logical, \e true to use constant cloud ice fall speed -\param const_vs logical, \e true to use constant snow fall speed -\param const_vg logical, \e true to use constant graupel fall speed -\param const_vr logical, \e true to use constant rain fall speed -\param vi_max real, maximum fall speed for cloud ice -\param vs_max real, maximum fall speed for snow -\param vg_max real, maximum fall speed for graupel -\param vr_max real, maximum fall speed for rain -\param qi_lim real, cloud ice limiter to prevent large ice built up in cloud ice freezing and deposition -\param prog_ccn logical, \e true to activate prognostic CCN (not supported in GFS Physics) -\param do_qa logical, \e true to activate inline cloud fraction diagnosis in fast saturation adjustment -\param fast_sat_adj logical, \e true to adjust cloud water evaporation/freezing, cloud ice deposition when fast saturation adjustment is activated (do_sat_adj=.true. in \b fv_core_nml block) -\param tau_l2v real, time scale for evaporation of cloud water to water vapor. Increasing/decreasing \p tau_l2v can decrease/boost deposition of cloud water to water vapor -\param tau_v2l real, time scale for condensation of water vapor to cloud water. Increasing/decreasing \p tau_v2l can decrease/boost condensation of water vapor to cloud water -\param tau_g2v real, time scale for sublimation of graupel to water vapor. Increasing/decreasing \p tau_g2v can decrease/boost sublimation of graupel to water vapor -\param rthresh real, critical cloud water radius for autoconversion (cloud water -> rain). Increasing/decreasing of \p rthresh makes the autoconversion harder/easier -\param dw_land real, base value for subgrid deviation/variability over land -\param dw_ocean real, base value for subgrid deviation/variability over ocean -\param ql_gen real, maximum value for cloud water generated from condensation of water vapor (water vapor -> cloud water). Increasing/decreasing \b ql_gen can increase/decrease cloud water -\param ql_mlt real, maximum value of cloud water allowed from melted cloud ice (cloud ice -> cloud water or rain). Exceedance of which will become rain. Increasing/decreasing \p ql_mlt can increase/decrease cloud water and decrease/increase rain -\param qi0_crt real, threshold of cloud ice to snow autoconversion (cloud ice -> snow). Increasing/decreasing \p qi0_crt can increase/decrease cloud ice and decrease/increase snow -\param qs0_crt real, threshold of snow to graupel autoconversion (snow -> graupel). Increasing/decreasing \p qs0_crt can increase/decrease snow and decrease/increase graupel -\param tau_i2s real, time scale for autoconversion of cloud ice to snow. Increasing/decreasing \p tau_i2s can decrease/boost autoconversion of cloud ice to snow (cloud ice -> snow) -\param c_psaci real, accretion efficiency of cloud ice to snow (cloud ice -> snow). Increasing/decreasing of \p c_psaci can boost/decrease the accretion of cloud ice to snow -\param c_pgacs real, accretion efficiency of snow to graupel (snow-> graupel). Increasing/decreasing of \p c_pgacs can boost/decrease the accretion of snow to graupel -\param rh_inc real, relative humidity increment for complete evaporation of cloud water and cloud ice -\param rh_inr real, relative humidity increment for sublimation of snow -\param rh_ins real, relative humidity increment for minimum evaporation of rain -\param ccn_l real, base CCN over land. Increasing/decreasing \b ccn_l can on the one hand boost/decrease the autoconversion of cloud water to rain (cloud water -> rain), on the other hand make the autoconversion harder/easier -\param ccn_o real, base CCN over ocean. Increasing/decreasing \b ccn_o can on the one hand boost/decrease the autoconversion of cloud water to rain (cloud water -> rain), on the other hand make the autoconversion harder/easier -\param c_paut real, uutoconversion efficiency of cloud water to rain (cloud water -> rain). Increasing/decreasing of \p c_paut can boost/decrease the autoconversion of cloud water to rain -\param c_cracw real, accretion efficiency of cloud water to rain (cloud water -> rain) -\param use_ppm logical, \e true to use PPM fall scheme; .false. to use time-implicit monotonic fall scheme -\param use_ccn logical, \e true to compute prescribed CCN. It should be .true. when \p prog_ccn = .false. -\param mono_prof logical, \e true to turn on terminal fall with monotonic PPM scheme. This is used together with \p use_ppm =.true. -\param z_slope_liq logical, \e true to turn on vertically subgrid linear monotonic slope for autoconversion of cloud water to rain -\param z_slope_ice logical, \e true to turn on vertically subgrid linear monotonic slope for autoconversion of cloud ice to snow -\param de_ice logical, \e true to convert excessive cloud ice to snow to prevent ice over-built from other sources like convection scheme (not supported in GFS physics) -\param fix_negative logical, \e true to fix negative water species using nearby points -\param icloud_f integer, flag (0,1,or 2) for cloud fraction diagnostic scheme -\param mp_time real, time step of GFDL cloud microphysics - - -\section gsd_mynn_edmf_nml GSD MYNN-EDMF Namelist Option - -\param bl_mynn_mixlength 0: Original form from Nakanishi and Niino (2009) \cite NAKANISHI_2009. No scale-wareness is applied to the master mixing length, regardless of "scaleware" setting. -\n 1: HRRR operational form 201609-201807. Designed to work without the mass-flux scheme.Uses BouLac mixing length in free atmosphere. This helps remove excessively large mixing in unstable layers aloft. Scale-awareness in dx is available via "scaleaware" setting. -\n 2: HRRR operational form 201807-present. Designed to be compatible with mass-flux scheme activated (default). as in (1), but \e elb is lengthened using separate cloud mixing length functions for statistically stable and unstable regimes. This -\e elb adjustment is only possible for nonzero cloud fractions, such that cloud-free cells are treated as in (1), but BouLac calculation is used more sparingly when \e elb > 500 m. This is to reduce the computational expense that comes with the BouLac calculation. Also, -This option is scale-aware in dx if "scaleaware" =1. (Following Ito et al. 2015 \cite Ito_2015) - -\param bl_mynn_cloudpdf 0: Use Sommeria-Deardorff \cite Sommeria_1977 subgrid cloud PDF -\n 1: Use Kuwano-Yoshida \cite Kuwano_Yoshida_2010 subgrid cloud PDF -\n 2: Use modified Chaboureau-Bechtold \cite Chaboureau_2002 \cite Chaboureau_2005 subgrid cloud PDF (default) - -\param bl_mynn_edmf 0: Deactivate mass-flux scheme -\n 1: Activate dynamic multiplume mass-flux scheme (default) - -\param bl_mynn_edmf_mom 0: Deactivate momentum transport in mass-flux scheme (default) -\n 1: Activate momentum tranport in dynamic multiplume mass-flux scheme. \c bl_mynn_edmf must be set to 1. - -\param bl_mynn_edmf_tke 0: Deactivate TKE transport in mass-flux scheme (default) -\n 1: Activate TKE transport in dynamic multiplume mass-flux scheme. \c bl_mynn_edmf must be set to 1. - -\param bl_mynn_cloudmix 0: Deactivate the mixing of any water species mixing ratios -\n 1: Activate the mixing of all water species mixing ratios (default) - -\param bl_mynn_mixqt 0: Mix individual water species separately (default) -\n 1: DO NOT USE - -\param bl_mynn_tkeadvect False: Deactivate TKE advection (default) -\n True: Activate TKE advection - -\param grav_settling 0: Deactivate gravitational settling of fog (default) -\n 1: Activate gravitational settling of fog. Do not use this option if cloud-droplet settling is handled within the microphysics scheme - -\param icloud_bl 0: Deactivate coupling of subgrid clouds to radiation -\n 1: Activate subgrid cloud coupling to radiation (highly suggested) - -*/ diff --git a/physics/docs/pdftxt/GFSv14_suite.txt b/physics/docs/pdftxt/GFSv14_suite.txt deleted file mode 100644 index d1dcb038c..000000000 --- a/physics/docs/pdftxt/GFSv14_suite.txt +++ /dev/null @@ -1,168 +0,0 @@ -/** -\page suite0_page FV3_GFS_v14 - -\section gfsv14_suite_overview Overview - -This is the operational physics suite in a spectral dynamical core until June of 2019. -The GFSv14 physics suite uses the parameterizations in the following order: - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_NSST - - \ref GFS_NOAH - - \ref GFS_SFCSICE - - \ref GFS_HEDMF - - \ref GFS_GWDPS - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_SAMFdeep - - \ref GFS_GWDC - - \ref GFS_SAMFshal - - \ref GFS_ZHAOC - - \ref GFS_CALPRECIPTYPE - - \ref STOCHY_PHYS - -\section sdf_gfsv14 Suite Definition File - -The GFS v14 suite uses the parameterizations in the following order, as defined in \c FV3_GFS_v14 : -\code - - - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - stochastic_physics - stochastic_physics_sfc - - - - - GFS_suite_interstitial_rad_reset - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - dcyc2t3 - GFS_surface_generic_pre - GFS_suite_interstitial_2 - - - - sfc_ex_coef - GFS_surface_loop_control_part1 - sfc_nst_pre - sfc_nst - sfc_nst_post - lsm_noah - sfc_sice - GFS_surface_loop_control_part2 - - - - sfc_diag - sfc_diag_post - GFS_surface_generic_post - GFS_PBL_generic_pre - hedmf - GFS_PBL_generic_post - GFS_GWD_generic_pre - gwdps - gwdps_post - rayleigh_damp - GFS_suite_stateout_update - ozphys - GFS_DCNV_generic_pre - get_phi_fv3 - GFS_suite_interstitial_3 - samfdeepcnv - GFS_DCNV_generic_post - gwdc_pre - gwdc - gwdc_post - GFS_SCNV_generic_pre - samfshalcnv - samfshalcnv_post - GFS_SCNV_generic_post - GFS_suite_interstitial_4 - cnvc90 - GFS_MP_generic_pre - zhaocarr_gscond - zhaocarr_precpd - GFS_MP_generic_post - maximum_hourly_diagnostics - - - - - GFS_stochastics - - - - -\endcode - -\section gfs14_nml_opt_des Namelist Option -\code - fhzero = 6 - h2o_phys = .false. - oz_phys = .true. - oz_phys_2015 = .false. - ldiag3d = .false. - fhcyc = 24 - use_ufo = .true. - pre_rad = .false. - ncld = 5 - imp_physics = 11 - pdfcld = .false. - fhswr = 3600. - fhlwr = 3600. - ialb = 1 - iems = 1 - iaer = 111 - ico2 = 2 - isubc_sw = 2 - isubc_lw = 2 - isol = 2 - lwhtr = .true. - swhtr = .true. - cnvgwd = .true. - shal_cnv = .true. - cal_pre = .false. - redrag = .true. - dspheat = .true. - hybedmf = .true. - random_clds = .false. - trans_trac = .true. - cnvcld = .true. - imfshalcnv = 2 - imfdeepcnv = 2 - cdmbgwd = 3.5,0.25 - prslrd0 = 0. - ivegsrc = 1 - isot = 1 - debug = .false. - nstf_name = 2,0,0,0,0 - nst_anl = .true. - psautco = 0.0008,0.0005 - prautco = 0.00015,0.00015 -\endcode - -check \ref gfs_physics_nml for description - -*/ diff --git a/physics/docs/pdftxt/GFSv15_suite.txt b/physics/docs/pdftxt/GFSv15_suite.txt deleted file mode 100644 index abf446224..000000000 --- a/physics/docs/pdftxt/GFSv15_suite.txt +++ /dev/null @@ -1,233 +0,0 @@ -/** -\page GFS_v15_page GFS_v15 Suite - -\section gfs1_suite_overview Overview - -Version 15 of the Global Forecast System (GFS) was implemented operationally by the NOAA -National Centers for Environmental Prediction (NCEP) on June 12, 2019. -GFS v15 uses the Finite-Volume Cubed-Sphere (FV3) dynamical core -and a revised physics suite when compared to GFS v14. - -- Replacement of the Zhao-Carr microphysics with the more advanced \ref GFDL_cloud -- Updated parameterization of ozone photochemistry with additional production and loss terms -- Newly introduced parameterization of middle atmospheric water vapor photochemistry -- Revised bare soil evaporation scheme -- Modified convective parameterization scheme to reduce excessive cloud top cooling - -The GFS v15 physics suite uses the parameterizations in the following order: - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_NSST - - \ref GFS_NOAH - - \ref GFS_SFCSICE - - \ref GFS_HEDMF - - \ref GFS_GWDPS - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_H2OPHYS - - \ref GFS_SAMFdeep - - \ref GFS_GWDC - - \ref GFS_SAMFshal - - \ref GFDL_cloud - - \ref GFS_CALPRECIPTYPE - -\section sdf_gfsv15 Suite Definition File - -The GFS v15 suite uses the parameterizations in the following order, as defined in \c SCM_GFS_v15: -\code - - - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - - - - - GFS_suite_interstitial_rad_reset - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - dcyc2t3 - GFS_surface_generic_pre - GFS_surface_composites_pre - GFS_suite_interstitial_2 - - - - sfc_diff - GFS_surface_loop_control_part1 - sfc_nst_pre - sfc_nst - sfc_nst_post - lsm_noah - sfc_sice - GFS_surface_loop_control_part2 - - - - GFS_surface_composites_post - sfc_diag - sfc_diag_post - GFS_surface_generic_post - GFS_PBL_generic_pre - hedmf - GFS_PBL_generic_post - GFS_GWD_generic_pre - gwdps - gwdps_post - rayleigh_damp - GFS_suite_stateout_update - ozphys_2015 - h2ophys - GFS_DCNV_generic_pre - get_phi_fv3 - GFS_suite_interstitial_3 - samfdeepcnv - GFS_DCNV_generic_post - gwdc_pre - gwdc - gwdc_post - GFS_SCNV_generic_pre - samfshalcnv - samfshalcnv_post - GFS_SCNV_generic_post - GFS_suite_interstitial_4 - cnvc90 - GFS_MP_generic_pre - gfdl_cloud_microphys - GFS_MP_generic_post - maximum_hourly_diagnostics - - - - -\endcode - -\section gfs15_nml_opt_des Namelist Option -\code -&gfs_physics_nml - fhzero = 6. - ldiag3d = .true. - fhcyc = 24. - nst_anl = .true. - use_ufo = .true. - pre_rad = .false. - ncld = 5 - imp_physics = 11 - pdfcld = .false. - fhswr = 3600. - fhlwr = 3600. - ialb = 1 - iems = 1 - IAER = 111 - ico2 = 2 - isubc_sw = 2 - isubc_lw = 2 - isol = 2 - lwhtr = .true. - swhtr = .true. - cnvgwd = .true. - shal_cnv = .true. - cal_pre = .false. - redrag = .true. - dspheat = .true. - hybedmf = .true. - satmedmf = .false. - shinhong = .false. - do_ysu = .false. - lheatstrg = .false. - lgfdlmprad = .false. - effr_in = .false. - random_clds = .false. - trans_trac = .false. - cnvcld = .true. - imfshalcnv = 2 - imfdeepcnv = 2 - cdmbgwd = 3.5,0.25 - prslrd0 = 0. - ivegsrc = 1 - isot = 1 - debug = .false. - oz_phys = .false. - oz_phys_2015 = .true. - h2o_phys = .true. - nstf_name = 2,1,1,0,5 - xkzminv = 0.3 - xkzm_m = 1.0 - xkzm_h = 1.0 - do_sppt = .false. - do_shum = .false. - do_skeb = .false. - do_sfcperts = .false. -/ - -&gfdl_cloud_microphysics_nml - sedi_transport = .true. - do_sedi_heat = .false. - rad_snow = .true. - rad_graupel = .true. - rad_rain = .true. - const_vi = .F. - const_vs = .F. - const_vg = .F. - const_vr = .F. - vi_max = 1. - vs_max = 2. - vg_max = 12. - vr_max = 12. - qi_lim = 1. - prog_ccn = .false. - do_qa = .false. - fast_sat_adj = .false. - tau_l2v = 225. - tau_v2l = 150. - tau_g2v = 900. - rthresh = 10.e-6 - dw_land = 0.16 - dw_ocean = 0.10 - ql_gen = 1.0e-3 - ql_mlt = 1.0e-3 - qi0_crt = 8.0E-5 - qs0_crt = 1.0e-3 - tau_i2s = 1000. - c_psaci = 0.05 - c_pgacs = 0.01 - rh_inc = 0.30 - rh_inr = 0.30 - rh_ins = 0.30 - ccn_l = 300. - ccn_o = 100. - c_paut = 0.5 - c_cracw = 0.8 - use_ppm = .false. - use_ccn = .true. - mono_prof = .true. - z_slope_liq = .true. - z_slope_ice = .true. - de_ice = .false. - fix_negative = .true. - icloud_f = 1 - mp_time = 150. -/ -\endcode - -*/ diff --git a/physics/docs/pdftxt/GFSv15_suite_TKEEDMF.txt b/physics/docs/pdftxt/GFSv15_suite_TKEEDMF.txt deleted file mode 100644 index 6215fe361..000000000 --- a/physics/docs/pdftxt/GFSv15_suite_TKEEDMF.txt +++ /dev/null @@ -1,224 +0,0 @@ -/** -\page GFS_v15plus_page GFS_v15plus Suite - -\section gfs2p_suite_overview Overview - -This physics suite is the same as GFS v15 physics suite with \ref GFS_SATMEDMF replace of \ref GFS_HEDMF . - - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_NSST - - \ref GFS_NOAH - - \ref GFS_SFCSICE - - \ref GFS_SATMEDMF - - \ref GFS_GWDPS - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_H2OPHYS - - \ref GFS_SAMFdeep - - \ref GFS_GWDC - - \ref GFS_SAMFshal - - \ref GFDL_cloud - - \ref GFS_CALPRECIPTYPE - - -\section sdf_gfsv15p Suite Definition File - -The GFS v15plus suite uses the parameterizations in the following order, as defined in \c SCM_GFS_v15plus : -\code - - - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - - - - - GFS_suite_interstitial_rad_reset - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - dcyc2t3 - GFS_surface_generic_pre - GFS_surface_composites_pre - GFS_suite_interstitial_2 - - - - sfc_diff - GFS_surface_loop_control_part1 - sfc_nst_pre - sfc_nst - sfc_nst_post - lsm_noah - sfc_sice - GFS_surface_loop_control_part2 - - - - GFS_surface_composites_post - sfc_diag - sfc_diag_post - GFS_surface_generic_post - GFS_PBL_generic_pre - satmedmfvdif - GFS_PBL_generic_post - GFS_GWD_generic_pre - gwdps - gwdps_post - rayleigh_damp - GFS_suite_stateout_update - ozphys_2015 - h2ophys - GFS_DCNV_generic_pre - get_phi_fv3 - GFS_suite_interstitial_3 - samfdeepcnv - GFS_DCNV_generic_post - gwdc_pre - gwdc - gwdc_post - GFS_SCNV_generic_pre - samfshalcnv - samfshalcnv_post - GFS_SCNV_generic_post - GFS_suite_interstitial_4 - cnvc90 - GFS_MP_generic_pre - gfdl_cloud_microphys - GFS_MP_generic_post - maximum_hourly_diagnostics - - - - -\endcode - -\section gfs15p_nml_opt_des Namelist Option -\code -&gfs_physics_nml - fhzero = 6. - ldiag3d = .true. - fhcyc = 24. - nst_anl = .true. - use_ufo = .true. - pre_rad = .false. - ncld = 5 - imp_physics = 11 - pdfcld = .false. - fhswr = 3600. - fhlwr = 3600. - ialb = 1 - iems = 1 - IAER = 111 - ico2 = 2 - isubc_sw = 2 - isubc_lw = 2 - isol = 2 - lwhtr = .true. - swhtr = .true. - cnvgwd = .true. - shal_cnv = .true. - cal_pre = .false. - redrag = .true. - dspheat = .true. - hybedmf = .false. - satmedmf = .true. - shinhong = .false. - do_ysu = .false. - lheatstrg = .false. - lgfdlmprad = .false. - effr_in = .false. - random_clds = .false. - trans_trac = .false. - cnvcld = .true. - imfshalcnv = 2 - imfdeepcnv = 2 - cdmbgwd = 3.5,0.25 - prslrd0 = 0. - ivegsrc = 1 - isot = 1 - debug = .false. - oz_phys = .false. - oz_phys_2015 = .true. - h2o_phys = .true. - nstf_name = 2,1,1,0,5 - xkzminv = 0.3 - xkzm_m = 1.0 - xkzm_h = 1.0 - do_sppt = .false. - do_shum = .false. - do_skeb = .false. - do_sfcperts = .false. -/ - -&gfdl_cloud_microphysics_nml - sedi_transport = .true. - do_sedi_heat = .false. - rad_snow = .true. - rad_graupel = .true. - rad_rain = .true. - const_vi = .F. - const_vs = .F. - const_vg = .F. - const_vr = .F. - vi_max = 1. - vs_max = 2. - vg_max = 12. - vr_max = 12. - qi_lim = 1. - prog_ccn = .false. - do_qa = .false. - fast_sat_adj = .false. - tau_l2v = 225. - tau_v2l = 150. - tau_g2v = 900. - rthresh = 10.e-6 - dw_land = 0.16 - dw_ocean = 0.10 - ql_gen = 1.0e-3 - ql_mlt = 1.0e-3 - qi0_crt = 8.0E-5 - qs0_crt = 1.0e-3 - tau_i2s = 1000. - c_psaci = 0.05 - c_pgacs = 0.01 - rh_inc = 0.30 - rh_inr = 0.30 - rh_ins = 0.30 - ccn_l = 300. - ccn_o = 100. - c_paut = 0.5 - c_cracw = 0.8 - use_ppm = .false. - use_ccn = .true. - mono_prof = .true. - z_slope_liq = .true. - z_slope_ice = .true. - de_ice = .false. - fix_negative = .true. - icloud_f = 1 - mp_time = 150. -/ -\endcode - -*/ diff --git a/physics/docs/pdftxt/GFSv15p2_no_nsst_suite.txt b/physics/docs/pdftxt/GFSv15p2_no_nsst_suite.txt deleted file mode 100644 index 982afc860..000000000 --- a/physics/docs/pdftxt/GFSv15p2_no_nsst_suite.txt +++ /dev/null @@ -1,127 +0,0 @@ -/** -\page GFS_v15p2_no_nsst_page GFS_v15p2_no_nsst Suite - -\section gfsv15_no_nsst_suite_overview Overview - -Suite GFS_v15p2_no_nsst is a companion suite of GFS_v15p2 with GRIB2 data initialization. - -The GFS_v15p2_no_nsst physics suite uses the parameterizations in the following order: - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_OCEAN - - \ref GFS_NOAH - - \ref GFS_SFCSICE - - \ref GFS_HEDMF - - \ref GFS_UGWP_v0 - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_H2OPHYS - - \ref GFS_SAMFdeep - - \ref GFS_SAMFshal - - \ref GFDL_cloud - - \ref GFS_CALPRECIPTYPE - -\section sdf_gfsv15p2_no_nsst Suite Definition File -- For GRIB2 initialization data: \subpage suite_FV3_GFS_v15p2_no_nsst_xml - -\section gfs15p2nonsst_nml_opt_des Namelist - -- \b &gfs_physics_nml -\n \c fhzero = 6 -\n \c h2o_phys = .true. -\n \c ldiag3d = .false. -\n \c fhcyc = 24 -\n \c use_ufo = .true. -\n \c pre_rad = .false. -\n \c ncld = 5 -\n \c imp_physics = 11 -\n \c pdfcld = .false. -\n \c fhswr = 3600. -\n \c fhlwr = 3600. -\n \c ialb = 1 -\n \c iems = 1 -\n \c iaer = 111 -\n \c ico2 = 2 -\n \c isubc_sw = 2 -\n \c isubc_lw = 2 -\n \c isol = 2 -\n \c lwhtr = .true. -\n \c swhtr = .true. -\n \c cnvgwd = .true. -\n \c shal_cnv = .true. -\n \c cal_pre = .false. -\n \c redrag = .true. -\n \c dspheat = .true. -\n \c hybedmf = .true. -\n \c random_clds = .false. -\n \c trans_trac = .true. -\n \c cnvcld = .true. -\n \c imfshalcnv = 2 -\n \c imfdeepcnv = 2 -\n \c cdmbgwd = 3.5,0.25 [1.0,1.2] [0.2,2.5] [0.125,3.0] ! [C768] [C384] [C192] [C96]L64 -\n \c prslrd0 = 0. -\n \c ivegsrc = 1 -\n \c isot = 1 -\n \c debug = .false. -\n \c oz_phys = .F. -\n \c oz_phys_2015 = .T. -\n \c nstf_name = 0,0,0,0,0 -\n \c nst_anl = .true. -\n \c psautco = 0.0008,0.0005 -\n \c prautco = 0.00015,0.00015 -\n \c lgfdlmprad = .true. -\n \c effr_in = .true. -\n \c do_sppt = .false. -\n \c do_shum = .false. -\n \c do_skeb = .false. -\n \c do_sfcperts = .false. - -- \b &gfdl_cloud_microphysics_nml -\n \c sedi_transport = .true. -\n \c do_sedi_heat = .false. -\n \c rad_snow = .true. -\n \c rad_graupel = .true. -\n \c rad_rain = .true. -\n \c const_vi = .F. -\n \c const_vs = .F. -\n \c const_vg = .F. -\n \c const_vr = .F. -\n \c vi_max = 1. -\n \c vs_max = 2. -\n \c vg_max = 12. -\n \c vr_max = 12. -\n \c qi_lim = 1. -\n \c prog_ccn = .false. -\n \c do_qa = .true. -\n \c fast_sat_adj = .true. -\n \c tau_l2v = 225. -\n \c tau_v2l = 150. -\n \c tau_g2v = 900. -\n \c rthresh = 10.e-6 -\n \c dw_land = 0.16 -\n \c dw_ocean = 0.10 -\n \c ql_gen = 1.0e-3 -\n \c ql_mlt = 1.0e-3 -\n \c qi0_crt = 8.0E-5 -\n \c qs0_crt = 1.0e-3 -\n \c tau_i2s = 1000. -\n \c c_psaci = 0.05 -\n \c c_pgacs = 0.01 -\n \c rh_inc = 0.30 -\n \c rh_inr = 0.30 -\n \c rh_ins = 0.30 -\n \c ccn_l = 300. -\n \c ccn_o = 100. -\n \c c_paut = 0.5 -\n \c c_cracw = 0.8 -\n \c use_ppm = .false. -\n \c use_ccn = .true. -\n \c mono_prof = .true. -\n \c z_slope_liq = .true. -\n \c z_slope_ice = .true. -\n \c de_ice = .false. -\n \c fix_negative = .true. -\n \c icloud_f = 1 -\n \c mp_time = 150. - -*/ diff --git a/physics/docs/pdftxt/GFSv15p2_suite.txt b/physics/docs/pdftxt/GFSv15p2_suite.txt deleted file mode 100644 index d79cab076..000000000 --- a/physics/docs/pdftxt/GFSv15p2_suite.txt +++ /dev/null @@ -1,289 +0,0 @@ -/** -\page GFS_v15p2_page GFS_v15p2 Suite - -\section gfs1_suite_overview Overview - -Suite GFS_v15p2 has the parameterizations used in the GFS v15 implemented operationally -in June 2019. - -The GFS_v15p2 physics suite uses the parameterizations in the following order: - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_NSST - - \ref GFS_OCEAN - - \ref GFS_NOAH - - \ref GFS_SFCSICE - - \ref GFS_HEDMF - - \ref GFS_UGWP_v0 - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_H2OPHYS - - \ref GFS_SAMFdeep - - \ref GFS_SAMFshal - - \ref GFDL_cloud - -\section sdf_gfsv15p2 Suite Definition File -\code - - - - - - - fv_sat_adj - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - - - - - GFS_suite_interstitial_rad_reset - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - GFS_surface_generic_pre - GFS_surface_composites_pre - dcyc2t3 - GFS_surface_composites_inter - GFS_suite_interstitial_2 - - - - sfc_diff - GFS_surface_loop_control_part1 - sfc_nst_pre - sfc_nst - sfc_nst_post - lsm_noah - sfc_sice - GFS_surface_loop_control_part2 - - - - GFS_surface_composites_post - sfc_diag - sfc_diag_post - GFS_surface_generic_post - GFS_PBL_generic_pre - hedmf - GFS_PBL_generic_post - GFS_GWD_generic_pre - cires_ugwp - cires_ugwp_post - GFS_GWD_generic_post - rayleigh_damp - GFS_suite_stateout_update - ozphys_2015 - h2ophys - get_phi_fv3 - GFS_suite_interstitial_3 - GFS_DCNV_generic_pre - samfdeepcnv - GFS_DCNV_generic_post - GFS_SCNV_generic_pre - samfshalcnv - GFS_SCNV_generic_post - GFS_suite_interstitial_4 - cnvc90 - GFS_MP_generic_pre - gfdl_cloud_microphys - GFS_MP_generic_post - maximum_hourly_diagnostics - - - - - GFS_stochastics - phys_tend - - - - -\endcode - - -\section gfs15p2_nml_opt_des Namelist - -\code -&gfs_physics_nml - cdmbgwd = 3.5,0.25 - cal_pre = .false. - cnvcld = .true. - cnvgwd = .true. - debug = .false. - do_myjpbl = .false. - do_myjsfc = .false. - do_sfcperts = .false. - do_shum = .false. - do_skeb = .false. - do_sppt = .false. - do_tofd = .false. - do_ugwp = .false. - do_ysu = .false. - dspheat = .true. - effr_in = .true. - fhcyc = 0.0 - fhlwr = 3600.0 - fhswr = 3600.0 - fhzero = 6.0 - h2o_phys = .true. - hybedmf = .true. - iaer = 111 - ialb = 1 - iau_inc_files = '' - ico2 = 2 - iems = 1 - imfdeepcnv = 2 - imfshalcnv = 2 - imp_physics = 11 - iopt_alb = 2 - iopt_btr = 1 - iopt_crs = 1 - iopt_dveg = 2 - iopt_frz = 1 - iopt_inf = 1 - iopt_rad = 1 - iopt_run = 1 - iopt_sfc = 1 - iopt_snf = 4 - iopt_stc = 1 - iopt_tbot = 2 - isol = 2 - isot = 1 - isubc_lw = 2 - isubc_sw = 2 - ivegsrc = 1 - ldiag3d = .false. - ldiag_ugwp = .false. - lgfdlmprad = .true. - lheatstrg = .false. - lsm = 1 - lwhtr = .true. - ncld = 5 - nsradar_reset = 3600 - nst_anl = .true. - nstf_name* = 2, 1, 0, 0, 0 - oz_phys = .false. - oz_phys_2015 = .true. - pdfcld = .false. - pre_rad = .false. - prslrd0 = 0.0 - random_clds = .false. - redrag = .true. - satmedmf = .false. - shal_cnv = .true. - shinhong = .false. - swhtr = .true. - trans_trac = .true. - use_ufo = .true. - xkzm_h = 1.0 - xkzm_m = 1.0 - xkzminv = 0.3 -/ - -&gfdl_cloud_microphysics_nml - sedi_transport = .true. - do_sedi_heat = .false. - rad_snow = .true. - rad_graupel = .true. - rad_rain = .true. - const_vi = .F. - const_vs = .F. - const_vg = .F. - const_vr = .F. - vi_max = 1. - vs_max = 2. - vg_max = 12. - vr_max = 12. - qi_lim = 1. - prog_ccn = .false. - do_qa = .true. - fast_sat_adj = .true. - tau_l2v = 225. - tau_v2l = 150. - tau_g2v = 900. - rthresh = 1e-05 - dw_land = 0.16 - dw_ocean = 0.10 - ql_gen = 1.0e-3 - ql_mlt = 1.0e-3 - qi0_crt = 8.0E-5 - qs0_crt = 1.0e-3 - tau_i2s = 1000. - c_psaci = 0.05 - c_pgacs = 0.01 - rh_inc = 0.30 - rh_inr = 0.30 - rh_ins = 0.30 - ccn_l = 300. - ccn_o = 100. - c_paut = 0.5 - c_cracw = 0.8 - use_ppm = .false. - use_ccn = .true. - mono_prof = .true. - z_slope_liq = .true. - z_slope_ice = .true. - de_ice = .false. - fix_negative = .true. - icloud_f = 1 - mp_time = 90. - -/ - -&cires_ugwp_nml - knob_ugwp_azdir = 2, 4, 4, 4 - knob_ugwp_doaxyz = 1 - knob_ugwp_doheat = 1 - knob_ugwp_dokdis = 1 - knob_ugwp_effac = 1, 1, 1, 1 - knob_ugwp_ndx4lh = 1 - knob_ugwp_solver = 2 - knob_ugwp_source = 1, 1, 0, 0 - knob_ugwp_stoch = 0, 0, 0, 0 - knob_ugwp_version = 0 - knob_ugwp_wvspec = 1, 25, 25, 25 - launch_level = 25 -/ - -&nam_sfcperts - iseed_sfc = 0 - nsfcpert = 6 - pertalb = -999.0 - pertlai = -999.0 - pertshc = -999.0 - pertvegf = -999.0 - pertz0 = -999.0 - pertzt = -999.0 - sfc_lscale = 500000 - sfc_tau = 21600 - sppt_land = .false. -/ - - -\endcode - -- nstf_name = \f$[2,0,0,0,0]^1 [2,1,0,0,0]^2 \f$ - - \f$^1\f$ NSST is on and coupled with spin up off - - \f$^2\f$ NSST is on and coupled with spin up on - -*/ diff --git a/physics/docs/pdftxt/GFSv16beta_no_nsst_suite.txt b/physics/docs/pdftxt/GFSv16beta_no_nsst_suite.txt deleted file mode 100644 index 3e5205199..000000000 --- a/physics/docs/pdftxt/GFSv16beta_no_nsst_suite.txt +++ /dev/null @@ -1,167 +0,0 @@ -/** -\page GFS_v16beta_no_nsst_page GFS_v16beta_no_nsst Suite - -\section gfsv16beta_no_nsst_suite_overview Overview - -Suite GFS_v16beta_no_nsst is a companion suite of GFS_v16beta with GRIB2 data initialization. - -The GFS_v16beta_no_nsst physics suite uses the parameterizations in the following order: - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_OCEAN - - \ref GFS_NOAH - - \ref GFS_SFCSICE - - \ref GFS_SATMEDMFVDIFQ - - \ref GFS_UGWP_v0 - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_H2OPHYS - - \ref GFS_SAMFdeep - - \ref GFS_SAMFshal - - \ref GFDL_cloud - - \ref GFS_CALPRECIPTYPE - -\section sdf_gfsv16bnonsst Suite Definition File -- For GRIB2 initialization data: \subpage suite_FV3_GFS_v16beta_no_nsst_xml - -\section gfs16betanonsst_nml_opt_des Namelist - -- \b &gfs_physics_nml -\n \c fhzero = 6 -\n \c h2o_phys = .true. -\n \c ldiag3d = .false. -\n \c fhcyc = 24 -\n \c use_ufo = .true. -\n \c pre_rad = .false. -\n \c ncld = 5 -\n \c imp_physics = 11 -\n \c pdfcld = .false. -\n \c fhswr = 3600. -\n \c fhlwr = 3600. -\n \c ialb = 1 -\n \c iems = 1 -\n \c iaer = 5111 -\n \c icliq_sw = 2 -\n \c iovr_lw = 3 -\n \c iovr_sw = 3 -\n \c ico2 = 2 -\n \c isubc_sw = 2 -\n \c isubc_lw = 2 -\n \c isol = 2 -\n \c lwhtr = .true. -\n \c swhtr = .true. -\n \c cnvgwd = .true. -\n \c shal_cnv = .true. -\n \c cal_pre = .false. -\n \c redrag = .true. -\n \c dspheat = .true. -\n \c hybedmf = .false. -\n \c satmedmf = .true. -\n \c isatmedmf = 1 -\n \c lheatstrg = .true. -\n \c random_clds = .false. -\n \c trans_trac = .true. -\n \c cnvcld = .true. -\n \c imfshalcnv = 2 -\n \c imfdeepcnv = 2 -\n \c cdmbgwd = 4.0,0.15,1.0,1.0 [1.1,0.72,1.0,1.0] [0.23,1.5,1.0,1.0] [0.14,1.8,1.0,1.0] ! [C768] [C384] [C192] [C96]L64 -\n \c prslrd0 = 0. -\n \c ivegsrc = 1 -\n \c isot = 1 -\n \c lsoil = 4 -\n \c lsm = 1 -\n \c iopt_dveg = 1 -\n \c iopt_crs = 1 -\n \c iopt_btr = 1 -\n \c iopt_run = 1 -\n \c iopt_sfc = 1 -\n \c iopt_frz = 1 -\n \c iopt_inf = 1 -\n \c iopt_rad = 1 -\n \c iopt_alb = 2 -\n \c iopt_snf = 4 -\n \c iopt_tbot = 2 -\n \c iopt_stc = 1 -\n \c debug = .false. -\n \c oz_phys = .F. -\n \c oz_phys_2015 = .T. -\n \c nstf_name = 0,0,0,0,0 -\n \c nst_anl = .true. -\n \c psautco = 0.0008,0.0005 -\n \c prautco = 0.00015,0.00015 -\n \c lgfdlmprad = .true. -\n \c effr_in = .true. -\n \c ldiag_ugwp = .false. -\n \c do_ugwp = .false. -\n \c do_tofd = .true. -\n \c do_sppt = .false. -\n \c do_shum = .false. -\n \c do_skeb = .false. -\n \c do_sfcperts = .false. - - -- \b &gfdl_cloud_microphysics_nml -\n \c sedi_transport = .true. -\n \c do_sedi_heat = .false. -\n \c rad_snow = .true. -\n \c rad_graupel = .true. -\n \c rad_rain = .true. -\n \c const_vi = .F. -\n \c const_vs = .F. -\n \c const_vg = .F. -\n \c const_vr = .F. -\n \c vi_max = 1. -\n \c vs_max = 2. -\n \c vg_max = 12. -\n \c vr_max = 12. -\n \c qi_lim = 1. -\n \c prog_ccn = .false. -\n \c do_qa = .true. -\n \c fast_sat_adj = .true. -\n \c tau_l2v = 225. -\n \c tau_v2l = 150. -\n \c tau_g2v = 900. -\n \c rthresh = 10.e-6 -\n \c dw_land = 0.16 -\n \c dw_ocean = 0.10 -\n \c ql_gen = 1.0e-3 -\n \c ql_mlt = 1.0e-3 -\n \c qi0_crt = 8.0E-5 -\n \c qs0_crt = 1.0e-3 -\n \c tau_i2s = 1000. -\n \c c_psaci = 0.05 -\n \c c_pgacs = 0.01 -\n \c rh_inc = 0.30 -\n \c rh_inr = 0.30 -\n \c rh_ins = 0.30 -\n \c ccn_l = 300. -\n \c ccn_o = 100. -\n \c c_paut = 0.5 -\n \c c_cracw = 0.8 -\n \c use_ppm = .false. -\n \c use_ccn = .true. -\n \c mono_prof = .true. -\n \c z_slope_liq = .true. -\n \c z_slope_ice = .true. -\n \c de_ice = .false. -\n \c fix_negative = .true. -\n \c icloud_f = 1 -\n \c mp_time = 150. -\n \c reiflag = 2 - - -- \b &cires_ugwp_nml -\n \c knob_ugwp_solver = 2 -\n \c knob_ugwp_source = 1,1,0,0 -\n \c knob_ugwp_wvspec = 1,25,25,25 -\n \c knob_ugwp_azdir = 2,4,4,4 -\n \c knob_ugwp_stoch = 0,0,0,0 -\n \c knob_ugwp_effac = 1,1,1,1 -\n \c knob_ugwp_doaxyz = 1 -\n \c knob_ugwp_doheat = 1 -\n \c knob_ugwp_dokdis = 1 -\n \c knob_ugwp_ndx4lh = 1 -\n \c knob_ugwp_version = 0 -\n \c launch_level = 27 - -*/ diff --git a/physics/docs/pdftxt/GFSv16beta_suite.txt b/physics/docs/pdftxt/GFSv16beta_suite.txt deleted file mode 100644 index eac420cd0..000000000 --- a/physics/docs/pdftxt/GFSv16beta_suite.txt +++ /dev/null @@ -1,275 +0,0 @@ -/** -\page GFS_v16beta_page GFS_v16beta Suite - -\section gfsv16beta_suite_overview Overview - -Version 16 of the Global Forecast System (GFS) will be implemented operationally by the NOAA -National Centers for Environmental Prediction (NCEP) in 2021. GFS_v16beta is a prototype of -the GFS_v16 suite. The main difference between the GFS_v15p2 and GFS_v16beta suites is the -replacement of the K-based EDMF PBL scheme with a moist TKE based one. - - -The GFS_v16beta physics suite uses the parameterizations in the following order: - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_NSST - - \ref GFS_OCEAN - - \ref GFS_NOAH - - \ref GFS_SFCSICE - - \ref GFS_SATMEDMFVDIFQ - - \ref GFS_UGWP_v0 - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_H2OPHYS - - \ref GFS_SAMFdeep - - \ref GFS_SAMFshal - - \ref GFDL_cloud - -\section sdf_gfsv16b Suite Definition File -\code - - - - - - - fv_sat_adj - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - - - - - GFS_suite_interstitial_rad_reset - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - GFS_surface_generic_pre - GFS_surface_composites_pre - dcyc2t3 - GFS_surface_composites_inter - GFS_suite_interstitial_2 - - - - sfc_diff - GFS_surface_loop_control_part1 - sfc_nst_pre - sfc_nst - sfc_nst_post - lsm_noah - sfc_sice - GFS_surface_loop_control_part2 - - - - GFS_surface_composites_post - sfc_diag - sfc_diag_post - GFS_surface_generic_post - GFS_PBL_generic_pre - satmedmfvdifq - GFS_PBL_generic_post - GFS_GWD_generic_pre - cires_ugwp - cires_ugwp_post - GFS_GWD_generic_post - rayleigh_damp - GFS_suite_stateout_update - ozphys_2015 - h2ophys - GFS_DCNV_generic_pre - get_phi_fv3 - GFS_suite_interstitial_3 - samfdeepcnv - GFS_DCNV_generic_post - GFS_SCNV_generic_pre - samfshalcnv - GFS_SCNV_generic_post - GFS_suite_interstitial_4 - cnvc90 - GFS_MP_generic_pre - gfdl_cloud_microphys - GFS_MP_generic_post - maximum_hourly_diagnostics - - - - - GFS_stochastics - - - - -\endcode - - - -\section gfs16beta_nml_opt_des Namelist - -\code -&gfs_physics_nml - fhzero = 6 - h2o_phys = .true. - ldiag3d = .false. - fhcyc = 24 - use_ufo = .true. - pre_rad = .false. - ncld = 5 - imp_physics = 11 - pdfcld = .false. - fhswr = 3600. - fhlwr = 3600. - ialb = 1 - iems = 1 - iaer = 5111 - icliq_sw = 2 - iovr_lw = 3 - iovr_sw = 3 - ico2 = 2 - isubc_sw = 2 - isubc_lw = 2 - isol = 2 - lwhtr = .true. - swhtr = .true. - cnvgwd = .true. - shal_cnv = .true. - cal_pre = .false. - redrag = .true. - dspheat = .true. - hybedmf = .false. - satmedmf = .true. - isatmedmf = 1 - lheatstrg = .true. - random_clds = .false. - trans_trac = .true. - cnvcld = .true. - imfshalcnv = 2 - imfdeepcnv = 2 - cdmbgwd = 4.0,0.15,1.0,1.0 - prslrd0 = 0. - ivegsrc = 1 - isot = 1 - lsoil = 4 - lsm = 1 - iopt_dveg = 1 - iopt_crs = 1 - iopt_btr = 1 - iopt_run = 1 - iopt_sfc = 1 - iopt_frz = 1 - iopt_inf = 1 - iopt_rad = 1 - iopt_alb = 2 - iopt_snf = 4 - iopt_tbot = 2 - iopt_stc = 1 - debug = .false. - oz_phys = .F. - oz_phys_2015 = .T. - nstf_name = @[NSTF_NAME] - nst_anl = .true. - psautco = 0.0008,0.0005 - prautco = 0.00015,0.00015 - lgfdlmprad = .true. - effr_in = .true. - ldiag_ugwp = .false. - do_ugwp = .false. - do_tofd = .true. - do_sppt = .false. - do_shum = .false. - do_skeb = .false. - do_sfcperts = .false. -/ - -&gfdl_cloud_microphysics_nml - sedi_transport = .true. - do_sedi_heat = .false. - rad_snow = .true. - rad_graupel = .true. - rad_rain = .true. - const_vi = .F. - const_vs = .F. - const_vg = .F. - const_vr = .F. - vi_max = 1. - vs_max = 2. - vg_max = 12. - vr_max = 12. - qi_lim = 1. - prog_ccn = .false. - do_qa = .true. - fast_sat_adj = .true. - tau_l2v = 225. - tau_v2l = 150. - tau_g2v = 900. - rthresh = 10.e-6 - dw_land = 0.16 - dw_ocean = 0.10 - ql_gen = 1.0e-3 - ql_mlt = 1.0e-3 - qi0_crt = 8.0E-5 - qs0_crt = 1.0e-3 - tau_i2s = 1000. - c_psaci = 0.05 - c_pgacs = 0.01 - rh_inc = 0.30 - rh_inr = 0.30 - rh_ins = 0.30 - ccn_l = 300. - ccn_o = 100. - c_paut = 0.5 - c_cracw = 0.8 - use_ppm = .false. - use_ccn = .true. - mono_prof = .true. - z_slope_liq = .true. - z_slope_ice = .true. - de_ice = .false. - fix_negative = .true. - icloud_f = 1 - mp_time = 150. - reiflag = 2 -/ - -&cires_ugwp_nml - knob_ugwp_solver = 2 - knob_ugwp_source = 1,1,0,0 - knob_ugwp_wvspec = 1,25,25,25 - knob_ugwp_azdir = 2,4,4,4 - knob_ugwp_stoch = 0,0,0,0 - knob_ugwp_effac = 1,1,1,1 - knob_ugwp_doaxyz = 1 - knob_ugwp_doheat = 1 - knob_ugwp_dokdis = 1 - knob_ugwp_ndx4lh = 1 - knob_ugwp_version = 0 - launch_level = 27 -/ - -\endcode - -- nstf_name = \f$[2,0,0,0,0]^1 [2,1,0,0,0]^2\f$ - - \f$^1\f$ NSST is on and coupled with spin up off - - \f$^2\f$ NSST is on and coupled with spin up on - -*/ diff --git a/physics/docs/pdftxt/GSD_CU_GF_deep.txt b/physics/docs/pdftxt/GSD_CU_GF_deep.txt deleted file mode 100644 index 05e3cf39e..000000000 --- a/physics/docs/pdftxt/GSD_CU_GF_deep.txt +++ /dev/null @@ -1,48 +0,0 @@ -/** -\page GSD_CU_GF Grell-Freitas Scale and Aerosol Aware Convection Scheme -\section gfcu_descrip Description - -The Grell-Freitas (GF) scheme as described in Grell and Freitas (2014, GF1) \cite grell_and_freitas_2014 and -Freitas et al. (2018, FG) \cite freitas_et_al_2018 follow the mass flux approach published by Grell (1993) \cite grell_1993. -Further developments by Grell and \f$D\acute{e}v\acute{e}nyi\f$ (2002) \cite Grell_2002 included implementing -stochastics through allowing parameter perturbations. In GF1 scale awareness, and the aerosol dependence through rain generation (following -Berry (1968) \cite berry_1968 and evaporation formulations (following Jiang et al. (2010) \cite Jiang_2010 ), depending on the -cloud concentration nuclei at cloud base were added. FG included mixed phase physics impact, momentum transport (as in ECMWF), - a diurnal cycle closure (Bechtold et al. (2014) \cite bechtold_et_al_2014 ), and a trimodal spectral size to simulate the interaction -and transition from shallow, congestus and deep convection regimes. The vertical massflux distribution of shallow, congestus and -deep convection regimes is characterized by Probability Density Functions (PDF's). The three PDF's are meant to represent the average -statistical mass flux characteristic of deep, congestus, and shallow (respectively) plumes in the grid area. Each PDF therefore represents -a spectrum of plumes within the grid box. Forcing is different for each characteristic type. Entrainment and detrainment are derived -from the PDF's. The deep convection considers scale awareness (Arakawa et al. (2011) \cite Arakawa_2011 ), the congestus type convection -as well as the shallow convection are not scale-aware. Aerosol dependence is implemented through dependence of rain generation and -evaporation formulations depending on the cloud concentration nuclei at cloud base. Aerosol dependence is considered experimental and -is turned off at this point. GF is able to transport tracers. - -A paper describing the latest changes and modifications is in progress and will be submitted to GMD. - -\b Operational \b Impacts \b in \b RAP/HRRR - - - Uses mass-flux schemes, which are more physically realistic than (sounding) adjustment schemes - - Takes parameterization uncertainty into account by allowing parameters from multiple convective schemes which can be perturbed -internally or with temporal and spatial correlation patterns - - For higher resolutions (less than 10 km), in addition to scale awareness as in Arakawa et al. (2011) \cite Arakawa_2011 GF can -transition as grid spacing decreases into a shallow convection scheme - - Coupled to the grid scale precipitation and radiation schemes through passing of diagnosed cloud liquid and ice from simulated -precipitating convective cloud and shallow convective clouds - -\section intra_rough_gf Intraphysics Communication -The GF scheme passes cloud hydrometeors to the grid-scale microphysics scheme (\ref GSD_THOMPSON ) through detrainment from each -convective cloud layer containing convective cloud. The detrained condensate interacts with short- and longwave radiation by -contributing to the "opaqueness" to radiation of each grid layer. Additionally, detrained condensate is added to any existing condensate, -to be treated by the complex grid-scale microphysics scheme. This allows for a crude emulation of stratiform precipitation regions -in the RAP. - -Additionally, the shallow convection and PBL schemes pass cloud information to the radiation scheme, which improved cloud/radiation -interaction and retention of the inversion typically found above mixed layers. - -\ref arg_table_cu_gf_driver_run - -\section gen_gfgsd General Algorithm -\ref gen_gf_driver - -*/ diff --git a/physics/docs/pdftxt/GSD_MYNN_EDMF.txt b/physics/docs/pdftxt/GSD_MYNN_EDMF.txt deleted file mode 100644 index ff2db411d..000000000 --- a/physics/docs/pdftxt/GSD_MYNN_EDMF.txt +++ /dev/null @@ -1,76 +0,0 @@ -/** -\page GSD_MYNNEDMF GSD MYNN-EDMF Boundary Layer and Shallow Cloud Scheme -\section mynnedmf_descrip Description - -The Mellor-Yamada-Nakanishi-Niino (Nakanishi and Niino 2009 \cite NAKANISHI_2009) eddy -diffusivity-mass flux (EDMF) scheme was implemented into CCPP to introduce an alternative -turbulent kinetic energy (TKE)-based planetary boundary layer (PBL) scheme which could -serve as a candidate PBL parameterization for the next-generation unified forecast system. -The MYNN-EDMF is currently emplyed in NOAA's operational Rapid Refresh (RAP; Benjamin et al.2016 \cite Benjamin_2016) -and High-Resolution Rapid Refresh (HRRR) forecast systems. - -The original MYNN scheme was demonstrated to be an improvement over predecessor Mellor-Yamada-type -PBL schemes (e.g., Mellor and Yamada 1974,1982 \cite Mellor_1974 \cite Mellor_1982) when compared against large-eddy -simulation (LES) of a convective PBL (Nakanishi and Niino 2004, 2009 \cite Nakanishi_2004 \cite NAKANISHI_2009), the -prediction of advection fog (Nakanishi and Niino 2006 \cite Nakanishi_2006), and for the representation of coastal -barrier jets (Olson and Brown 2009 \cite olson_and_brown_2009). The MYNN scheme can be configured to function at either -level 2.5 or 3.0 closure and includes a partial-condensation scheme (also known as a cloud PDF or a statistical-cloud -scheme) to represent the effects of subgrid-scale(SGS) clouds on the buoyancy flux (Nakanishi and Niino 2004, 2006, and 2009 -\cite Nakanishi_2004 \cite Nakanishi_2006 \cite NAKANISHI_2009). The closure constants for the original MYNN scheme -were tuned to a database of LES as opposed to observational data. - -The MYNN-EDMF scheme has been extensively developed to improve upon the forecast skill of the original MYNN, -largely driven by requirements to improve forecast skill in support of the NOAA's National Weather Service (NWS), -the Federal Aviation Administration (FAA) and users within the renewable-energy industry.Specifically, fundamental -changes were made to the formulation of the mixing lengths and representation of SGS clouds, but new components have also -been added to improve to representation of non-local mixing, the turbulence interaction with clouds, and the coupling to other -model components (i.e., radiation). A description of the changes to the MYNN scheme are described in Olson et al.(2019) -\cite olson_et_al_2019. - - -\section intra_mynnpbl Intraphysics Communication -- Cloud-Radiation Interaction - -\sa gsd_mynnrad_pre -\sa gsd_mynnrad_post - -The subgrid-scale(SGS) clouds produced by the MYNN-EDMF are coupled to the longwave and shortwave radiation schemes -if the namelist parameter \p icloud_bl is set to 1. In this case, the SGS cloud fraction, \p CLDFRA_BL, and the SGS -cloud-mixing ratio, \b QC_BL, are added to the microphysics arrays within the radiation driver (mynnrad_pre_run()). -The following two steps are performed: - -(1) the cloud fraction of the resolved-scale clouds are computed, using Xu and Randal (1996) \cite xu_and_randall_1996 -by default; - -(2) if the resolved-scale cloud liquid and ice, \f$q_c\f$ and \f$q_i\f$, is less than \f$10^{-6}kg kg^{-1}\f$ and -\f$10^{-8}kg kg^{-1}\f$, respectively, and there exists a nonzero SGS cloud fraction, then the SGS components are -added to their respective resolved-scale components by a temperature weighting, according to linear approximation -of Hobbs et al.(1974) \cite HOBBS_1974 : -\f[ - W_{ice}=1-min(1,max(0,(T-254)/15)) - W_{h2o}=1-W_{ice} -\f] - -Then we sort the SGS cloud water and liquid as : - -\f$q_c\f$=QC_BL*\f$W_{h2o}\f$*CLDFRA_BL - -\f$q_i\f$=QC_BL*\f$W_{ice}\f$*CLDFRA_BL - -This allows us to only use one 3-D array for both SGS cloud water and ice. The updated \f$q_{c}\f$,\f$q_{i}\f$, and -\p CLDFRA are then used as input into the radiation schemes. After exiting the radiation schemes, the original -values of \f$q_c, q_i\f$ and \p CLDFRA are restored, so the SGS clouds do not impact the resolved-scale moisture budget. - - -The GSD MYNN-EDMF CCPP-compliant interface: -\ref arg_table_mynnedmf_wrapper_run - -\section gen_mynnedmf_conv GSD MYNN-EDMF Scheme General Algorithm - -\image html MYNN-EDMF_call_order.png "Figure 1.The order of subroutines within the MYNN-EDMF (Courtesy of J.B. Olson). The green rectangles within the main subroutine (mynn_bl_driver()) represent subroutine calls. The blue rectangles represent tasks coded within the main driver. A brief description is shown on the right " width=10cm - - -\ref gen_mynn_bl_driver - - -*/ diff --git a/physics/docs/pdftxt/GSD_RUCLSM.txt b/physics/docs/pdftxt/GSD_RUCLSM.txt deleted file mode 100644 index 4d98faef8..000000000 --- a/physics/docs/pdftxt/GSD_RUCLSM.txt +++ /dev/null @@ -1,100 +0,0 @@ -/** -\page GSD_RUCLSM GSD RUC Land Surface Model -\section ruclsm_descrip Description - -The land surface model (LSM) was originally developed as part of the NOAA Rapid Update Cycle (RUC) model development effort; with ongoing modifications, it is now used as an option for the WRF community model. The RUC model and its WRF-based NOAA successor, the Rapid Refresh (RAP) and High-Resolution Rapid Refresh (HRRR), are hourly updated and have an emphasis on short-range, near-surface forecasts including aviation-impact variables and pre-convective environment. Therefore, coupling to this LSM (hereafter the RUC LSM) has been critical to provide more accurate lower boundary conditions. - -The RUC LSM became operational at the NOAA/National Centers for Environmental Prediction (NCEP) first, as part of the RUC from 1998–2012, and then -as part of the RAP from 2012 through the present and as part of HRRR from 2014 through the present. The simple treatments of basic land surface -processes in the RUC LSM (Smirnova et al. 2016 \cite Smirnova_2016 ) have proven to be physically robust and capable of realistically representing -the evolution of soil moisture, soil temperature, and snow in cycled models. Extension of the RAP domain to encompass all of North America and -adjacent high-latitude ocean areas necessitated further development of the RUC LSM for application in the tundra permafrost regions and over Arctic -sea ice (Smirnova et al. 2000 \cite Smirnova_2000). Other modifications include refinements in the snow model and a more accurate specification of -albedo, roughness length, and other surface properties. These recent modifications in the RUC LSM are described and evaluated in -Smirnova et al. 2016 \cite Smirnova_2016 . - -The parameterizations in the RUC LSM describe complicated atmosphere–land surface interactions in an intentionally simplified fashion to avoid -excessive sensitivity to multiple uncertain surface parameters. Nevertheless, the RUC LSM, when coupled with the hourly-assimilating atmospheric model, -demonstrated over years of ongoing cycling (Benjamin et al. 2004a,b \cite Benjamin_2004a \cite Benjamin_2004b ; Berbery et al. 1999 \cite Berbery_1999) -that it can produce a realistic evolution of hydrologic and time-varying soil fields (i.e., soil moisture and temperature) that cannot be directly -observed over large areas, as well as the evolution of snow cover on the ground surface. This result is possible only if the soil–vegetation–snow -component of the coupled model, constrained only by atmospheric boundary conditions and the specification of surface characteristics, has sufficient -skill to avoid long-term drift. - -International projects for intercomparison of land surface and snow parameterization schemes were essential in providing the testing environment and -afforded an excellent opportunity to evaluate the RUC LSM with different land use and soil types and within a variety of climates. The RUC LSM was -included in phase 2(d) of the Project for the Intercomparison of Land Surface Prediction Schemes [PILPS-2(d)], in which tested models performed -18-yr simulations of the land surface state for the Valdai site in Russia (Schlosser et al. 1997 \cite Schlosser_1997 ; Slater et al. 2001 \cite Slater_2001 ;  -Luo et al. 2003 \cite Luo_2003 ). The RUC LSM was also tested during the Snow Models Intercomparison Project (SnowMIP, SnowMIP2, ESM-SnowMIP), -with emphasis on snow parameterizations for both grassland and forest locations in different parts of the world -(Etchevers et al. 2002, 2004 \cite Etchevers_2002 \cite Etchevers_2004; Essery et al. 2009 \cite Essery_2009 ; Rutter et al. 2009 \cite Rutter_2009 , -Krinner et al. 2018 \cite Krinner_2018 ). The analysis of RUC LSM performance over 10 reference sites in ESM-SnowMIP rated it on the 5th place -among the 26 participating models. - -In global application, RUC LSM is implemented in the Global Systems Division (GSD) physics suite for testing in the NOAA Next-Generation Global -Prediction System (NGGPS)- FV3-GSD suite. To specify surface characteristics, RUC LSM uses the Land Data Sets provided by NCEP for Global -Modeling Systems (see Figure 2 in \ref GFS_NOAH ) - -## RUC LSM characteristics that differ from NOAH LSM: -\image html ruc_lsm_veg_soil.png "Figure 1. RUC LSM Vegetation and Soil Model (Courtesy of T.G. Smirnova) " width=10cm -- \b Implicit \b solution of energy and moisture budgets in the layer spanning the ground surface -- \b 9 \b soil \b levels with high vertical resolution near surface -RUC LSM has more levels in oil than \ref GFS_NOAH model with higher resolution near the interface with the atmosphere -- \b Prognostic \b soil moisture variable (\f$\theta-\theta_r\f$) -The prognostic variables for soil moisture is volumetric soil moisture content minus residual value of soil moisture which is tied -to soil particles and does not participate in moisture transport. -- \b Frozen \b soil \b physics algorithm -RUC LSM has a different approach to take into account freezing and thawing processes in soil. -- Treatment of \b mixed \b phase \b precipitation -It accounts for mixed phase precipitation provided by \ref GSD_THOMPSON used in RAP and HRRR. -- Simple treatment of \b sea \c ice which solves heat diffusion in sea ice and allows evolving snow cover on top of sea ice -- sub-grid-scale \b heterogeneity of surface parameters in RUC LSM -With the certain level of confidence in the skill of the model, the next requirement is to provide land static fields and surface -parameters with the best possible accuracy. RAP and HRRR use the same datasets as \ref GFS_NOAH. But instead of specifying surface -parameters for the dominant soil and land-use category in the grid box, RUC LSM takes into account the sub-grid scale heterogeneity -in the computation of such parameters as roughness length, emissivity, soil porosity, soil heat capacity and others. The difference in -roughness between the mosaic and dominant category presented on figure 2 is positive from contribution of the forests, which helped to -reduce high biases of surface wind speeds in these regions. Roughness lenghth has also seasonal variability in the cropland regions, -which again helped to improve the wind forecasts during the warm season. -\image html ruc_lsm_heterogeneity.png "Figure 2: sub-grid scale heterogeneity of surface parameters in RUC LSM (Courtesy of T.G. Smirnova)" width=10cm - -- New: simple irrigation in the cropland area -- New: water/snow intercepted by canopy as function of vegetation fraction and leaf area index (LAI) - -## RUC snow model characteristics: -Snow forms additional two layers on top of soil in RUC LSM -- \b 2-layer \b snow model: when SWE < 1.6 cm - snow layer is combined with top soil layer -- Fractional snow cover (SWE < 3 cm): -- weighted average of snow-covered and snow-free areas to compute snow paramters (roughness, albedo) -- New: "mosaic" approach for patchy snow - - Seperate treatment of energy and moisture budgets for snow-covered and snow-free portions of the grid cell - - Aggregate solutions at the end of time step - - Reduced cold bias for areas with thin snow -\image html ruc_lsm_mosaic.png "Figure 3: recent development: mosaic approach for patchy snow (Courtesy of T.G. Smirnova) " width=10cm -- Iterative snow melting algorithm -- Density of snow on the ground - a function of compaction parameter and snow depth and temperature -- Snow albedo - a function of temperature and snow fraction -- Snow interception by canopy - a function of vegetation fraction and LAI -- Density of falling snow/graupel/ice precipitation - - The density of falling snow/graupel/ice is computed inside RUC LSM using empirical temperature-dependent equations; - - Averaged density of frozen precipitation is defined from weighted contribution of each hydrometeor species: -\f[ - \rho_{fr}=\rho_{sn}*\alpha_{sn}+\rho_{gr}*\alpha_{gr}+\rho_{ice}*\alpha_{ice} -\f] -- The depth of new snow is defined from its liquid equivalent and \f$\rho_{fr}\f$ -\image html ruc_lsm_frozen_precip.png "Figure 4: HRRR 23-h forecasts of snow accumulation, valid 08 UTC, 29 Dec 2015 (Courtesy of T.G. Smirnova)" width=10cm - -snow accumulation with variable density is provided as an additional product in the model guidance. Figure 4 shows one example of this product -from the 23-h HRRR forecast for snowstorm on 29 Dec 2015. This product is in the middle panel. The panel on the left uses traditional 10:1 ratio, -and the right panel is oberved snow accumulation. We can see that the new product in the middle here has a better, further north location of maximum -snow accumulation, and high ammounts of snow in the product with 10:1 ratio are trimmed in central and southern Iowa where both observed and model -precipitation had a high content of sleet. There is even larger improvement in the Chicago area, where observed and model precipitation were almost -totally sleet. - -\section intra_ruclsm Intraphysics Communication -\ref arg_table_lsm_ruc_run - -\section gen_ruclsm General Algorithm -\ref gen_lsmruc - -*/ diff --git a/physics/docs/pdftxt/GSD_THOMPSON.txt b/physics/docs/pdftxt/GSD_THOMPSON.txt deleted file mode 100644 index 525d3bedc..000000000 --- a/physics/docs/pdftxt/GSD_THOMPSON.txt +++ /dev/null @@ -1,85 +0,0 @@ -/** -\page GSD_THOMPSON Thompson Aerosol-Aware Microphysics Scheme -\section thompson_descrp Description - - -The GSD RAP/HRRR microphysics implementation represents the most aggressive attempt to include explicit prediction of -cloud and precipitation microphysical processes in the NCEP operational forecast model suite. The RAP and HRRR are -important guidance to NWS aviation forecasts, and any microphysics improvements are aimed at least in part, to improve -that guidance. The scheme is particularly beneficial for aircraft icing forecasts. - -The scheme computes sources, sinks, and conversions for the mixing ratios of cloud water, rainwater, cloud ice, snow, -and graupel. Number concentration for cloud ice (particles per cubic meter) is also forecast, based on statistical relationships -of number concentration, density, and ice mass from recent observational studies. Since April 2014 (WRFv3.6), this is also the "aerosol-aware" scheme as described in -Thompson and Eidhammer (2014) \cite Thompson_2014 . - -The microphysical processes accounted for are shown in the graphic below: -\image html gsd_thompson.png "Figure 1: Complex Microphysics Model in the RAP" width=10cm - -Descriptions of these preocesses follow: -- \b Deposition: Diffusional growth of ice particles under conditions of vapor supersaturation with respect to ice. -Growth is "aerosol-aware", meaning the number of ice-friendly nulei and ice crystals is estimated by the microphysics scheme. -Deposition of ice is estimated using the properties of these ice-friendly aerosols. Latent heat associated with the phase -change from vapor to ice is released to the atmosphere. - -- \b Sublimation: Diffusional shrinkage of ice particles under conditions of vapor subsaturation with respect to ice. -The effect of aerosols on the sublimation process is estimated. Latent heat associated with the phase change from ice -to vapor is removed from the atmosphere. - -- \b Riming: Rapid freezing of supercooled cloud-size drops as a result of collisions with frozen precipitation particles, -or foreign objects with sub \f$0^{o}C\f$ surface temperatures, such as airplane wings. Latent heat of freezing is released -to the atmosphere during the process. - -- \b Evaporation: Process by which liquid is transformed into the gaseous state. The evaporation process is "aerosol-aware" -through estimation of aerosol impacts. Latent heat is removed from the atmosphere and stored in water vapor during this process. - -- \b Condensation: Process by which vapor is transformed into a liquid state. The impact of aerosols on condensation is estimated. -latent heat is released into the atmosphere during this process. - -- \b Ice \b multiplication: Formation of small ice particles as a result of freezing of supercooled cloud or raindrops. Ice multiplication occurs only under very restrictive conditions, but can be a large source of ice particles when these conditions are met. - -- \b Aggregation/autoconversion \b of \b snow: Process through which frozen precipitation particles grow by collision and the assimilation of cloud particles or other precipitation particles. The autoconversion rate increases as ambient temperatures rise toward freezing. - -- \b Accretion/autoconversion \b of \b cloud \b liquid: Process through which some cloud drops grow to become raindrops by collision and the assimilation of cloud drops. - -- \b Supercooled \b water \b formation: Liquid cloud particles that remain in their liquid state despite being cooled below the freezing point of water. - -The scheme also assumes precipitation particle-size distributions for the three predicted precipitation types: rain, snow, and graupel. -These size distributions are requied to emulate growth of precipitation by accretion of cloud-size particles, coalescence with other -precipitation particles, and fall speeds of precipitation hydrometeors. The rainwater fall speed depends on the rainwater mixing ratio, -with small values associated with fall speeds (and allowing the model to parameterize the behavior) of drizzle. The forecast precipitation -type is based on what prognostic precipitation type actually reaches the surface (Benjamin et al.(2016) \cite Benjamin_2016b ) - -# Advantages of the GSD Thompson Scheme and Updating Cloud Fields -Some of the more general advantages of the upgraded MP scheme implementation in the RAP on the model's cloud and precipitation -forecasts are listed below. - -- Includes five hydrometeor types and their interactions, plus a sixth forecast variable for cloud ice number concentration. Drizzle -is parameterized through using low fall velocities when there are low rain mixing ratios. - -- Includes impact of types of aerosol on condensation of water/deposition of ice - -- Accounts for horizontal and vertical advection of hydrometeors - -- Allows for more accurate prediction of precipitation in the form of snow, because slow fall velocities give time for snow to -advect between grid columns - -- Includes cloud ice sedimentation, which positively influences RH and cloud forecasts - -- Because the scheme is a relatively complete mixed-phase scheme, it can account for the formation of supercooled water, a prerequisite -for the model to provide useful guidance for aircraft icing forecasts - -- Can account for cloud phase changes and provides a sound physical basis for diagnosing precipitation type reaching the ground - - - -\section intra_thompson Intraphysics Communication -\ref arg_table_mp_thompson_run - -\section g_thompson General Algorithm -- \ref gen_thompson_init -- \ref gen_thompson_hrrr -- \ref gen_mpgtdriver -- \ref gen_mp_thompson - -*/ diff --git a/physics/docs/pdftxt/GSD_adv_suite.txt b/physics/docs/pdftxt/GSD_adv_suite.txt deleted file mode 100644 index 4d986075b..000000000 --- a/physics/docs/pdftxt/GSD_adv_suite.txt +++ /dev/null @@ -1,268 +0,0 @@ -/** -\page GSD_v1_page GSD_v1 Suite - -\section gsd_suite_overview Overview - -Suite GSD_v1 contains the parameterizations used in the NOAA operational Rapid Refresh (RAP) -and High-Resolution Rapid Refresh (HRRR) models. These models runs at 13- and 3- km resolution, -respectively. - - -Additional Model Information Links: -- https://rapidrefresh.noaa.gov -- https://rapidrefresh.noaa.gov/hrrr/ - -The GSD_v1 physics suite uses the parameterizations in the following order: - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_NSST - - \ref RUCLSM - - \ref MYNNEDMF - - \ref GFS_UGWP_v0 - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_H2OPHYS - - \ref CU_GF - - \ref cu_gf_deep_group - - \ref cu_gf_sh_group - - \ref THOMPSON - -\section sdf_gsdsuite Suite Definition File -\code - - - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - - - - - GFS_suite_interstitial_rad_reset - sgscloud_radpre - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - sgscloud_radpost - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - GFS_surface_generic_pre - GFS_surface_composites_pre - dcyc2t3 - GFS_surface_composites_inter - GFS_suite_interstitial_2 - - - - sfc_diff - GFS_surface_loop_control_part1 - sfc_nst_pre - sfc_nst - sfc_nst_post - lsm_ruc - lsm_ruc_sfc_sice_pre - sfc_sice - lsm_ruc_sfc_sice_post - GFS_surface_loop_control_part2 - - - - GFS_surface_composites_post - sfc_diag - sfc_diag_post - GFS_surface_generic_post - mynnedmf_wrapper - GFS_GWD_generic_pre - cires_ugwp - cires_ugwp_post - GFS_GWD_generic_post - rayleigh_damp - GFS_suite_stateout_update - ozphys_2015 - h2ophys - get_phi_fv3 - GFS_suite_interstitial_3 - GFS_DCNV_generic_pre - cu_gf_driver_pre - cu_gf_driver - GFS_DCNV_generic_post - GFS_SCNV_generic_pre - GFS_SCNV_generic_post - GFS_suite_interstitial_4 - cnvc90 - GFS_MP_generic_pre - mp_thompson_pre - mp_thompson - mp_thompson_post - GFS_MP_generic_post - cu_gf_driver_post - maximum_hourly_diagnostics - phys_tend - - - - -\endcode - -\section gsd_nml_option Namelist -\code -&gfs_physics_nml - fhzero = 6. - h2o_phys = .true. - ldiag3d = .true. - fhcyc = 0. - nst_anl = .true. - use_ufo = .true. - pre_rad = .false. - ncld = 5 - imp_physics = 8 - ltaerosol = .true. - lradar = .true. - ttendlim = 0.004 - pdfcld = .false. - fhswr = 3600. - fhlwr = 3600. - ialb = 1 - iems = 1 - iaer = 111 - ico2 = 2 - isubc_sw = 2 - isubc_lw = 2 - isol = 2 - lwhtr = .true. - swhtr = .true. - cnvgwd = .true. - shal_cnv = .true. - cal_pre = .false. - redrag = .true. - dspheat = .true. - hybedmf = .false. - satmedmf = .false. - lheatstrg = .false. - do_mynnedmf = .true. - do_mynnsfclay = .false. - random_clds = .false. - trans_trac = .true. - cnvcld = .true. - imfshalcnv = 3 - imfdeepcnv = 3 - cdmbgwd = 3.5,0.25 - prslrd0 = 0. - ivegsrc = 1 - isot = 1 - debug = .false. - oz_phys = .false. - oz_phys_2015 = .true. - nstf_name = 2,1,1,0,5 - cplflx = .false. - iau_delthrs = 6 - iaufhrs = 30 - iau_inc_files = "''" - do_sppt = .false. - do_shum = .false. - do_skeb = .false. - do_sfcperts = .false. - lsm = 3 - lsoil_lsm = 9 - iopt_dveg = 2 - iopt_crs = 1 - iopt_btr = 1 - iopt_run = 1 - iopt_sfc = 1 - iopt_frz = 1 - iopt_inf = 1 - iopt_rad = 1 - iopt_alb = 2 - iopt_snf = 4 - iopt_tbot = 2 - iopt_stc = 1 - icloud_bl = 1 - bl_mynn_tkeadvect = .true. - bl_mynn_edmf = 1 - bl_mynn_edmf_mom = 1 - gwd_opt = 1 -/ - -&gfdl_cloud_microphysics_nml - sedi_transport = .true. - do_sedi_heat = .false. - rad_snow = .true. - rad_graupel = .true. - rad_rain = .true. - const_vi = .F. - const_vs = .F. - const_vg = .F. - const_vr = .F. - vi_max = 1. - vs_max = 2. - vg_max = 12. - vr_max = 12. - qi_lim = 1. - prog_ccn = .false. - do_qa = .false. - fast_sat_adj = .false. - tau_l2v = 225. - tau_v2l = 150. - tau_g2v = 900. - rthresh = 10.e-6 - dw_land = 0.16 - dw_ocean = 0.10 - ql_gen = 1.0e-3 - ql_mlt = 1.0e-3 - qi0_crt = 8.0E-5 - qs0_crt = 1.0e-3 - tau_i2s = 1000. - c_psaci = 0.05 - c_pgacs = 0.01 - rh_inc = 0.30 - rh_inr = 0.30 - rh_ins = 0.30 - ccn_l = 300. - ccn_o = 100. - c_paut = 0.5 - c_cracw = 0.8 - use_ppm = .false. - use_ccn = .true. - mono_prof = .true. - z_slope_liq = .true. - z_slope_ice = .true. - de_ice = .false. - fix_negative = .true. - icloud_f = 1 - mp_time = 150. -/ - -&cires_ugwp_nml - knob_ugwp_solver = 2 - knob_ugwp_source = 1,1,0,0 - knob_ugwp_wvspec = 1,25,25,25 - knob_ugwp_azdir = 2,4,4,4 - knob_ugwp_stoch = 0,0,0,0 - knob_ugwp_effac = 1,1,1,1 - knob_ugwp_doaxyz = 1 - knob_ugwp_doheat = 1 - knob_ugwp_dokdis = 1 - knob_ugwp_ndx4lh = 1 - knob_ugwp_version = 0 - launch_level = 25 -/ -\endcode - - -*/ diff --git a/physics/docs/pdftxt/HRRR_suite.txt b/physics/docs/pdftxt/HRRR_suite.txt new file mode 100644 index 000000000..46ec264a0 --- /dev/null +++ b/physics/docs/pdftxt/HRRR_suite.txt @@ -0,0 +1,34 @@ +/** +\page HRRR_suite_page HRRR Suite + +\section HRRR_suite_overview Overview + +The HRRR suite contains the parameterizations used in the NOAA operational +High-Resolution Rapid Refresh (HRRR) model, which runs at 3-km resolution. +This suite is available for use with the UFS SRW App and with the CCPP SCM. +This suite is most applicable for runs at 3-km resolution since it does not +parameterize deep convection. + +For additional information about the HRRR model, visit: +https://rapidrefresh.noaa.gov/hrrr/. + +The HRRR suite uses the parameterizations in the following order: + - \ref SGSCLOUD_page + - \ref GFS_RRTMG + - \ref SFC_MYNNSFL + - \ref GFS_NSST + - \ref RUCLSM + - \ref MYNNEDMF + - \ref GFS_drag_suite + - \ref GFS_OZPHYS + - \ref GFS_H2OPHYS + - \ref THOMPSON + + +\section sdf_hrrrsuite Suite Definition File +\include suite_FV3_HRRR.xml + +\section hrrr_nml_option Namelist +\snippet RE6/FV3_HRRR_input.nml GFS_PHYSICS_NML + +*/ diff --git a/physics/docs/pdftxt/MYNN_EDMF.txt b/physics/docs/pdftxt/MYNN_EDMF.txt index aebe6b9fb..bdd29a99c 100644 --- a/physics/docs/pdftxt/MYNN_EDMF.txt +++ b/physics/docs/pdftxt/MYNN_EDMF.txt @@ -13,8 +13,8 @@ The original MYNN scheme was demonstrated to be an improvement over predecessor PBL schemes (e.g., Mellor and Yamada 1974,1982 \cite Mellor_1974 \cite Mellor_1982) when compared against large-eddy simulation (LES) of a convective PBL (Nakanishi and Niino 2004, 2009 \cite Nakanishi_2004 \cite NAKANISHI_2009), the prediction of advection fog (Nakanishi and Niino 2006 \cite Nakanishi_2006), and for the representation of coastal -barrier jets (Olson and Brown 2009 \cite olson_and_brown_2009). The MYNN scheme can be configured to function at either -level 2.5 or 3.0 closure and includes a partial-condensation scheme (also known as a cloud PDF or a statistical-cloud +barrier jets (Olson and Brown 2009 \cite olson_and_brown_2009). The MYNN scheme can be configured to function at +level 2.5, 2.6 (current default) or 3.0 closure and includes a partial-condensation scheme (also known as a cloud PDF or a statistical-cloud scheme) to represent the effects of subgrid-scale(SGS) clouds on the buoyancy flux (Nakanishi and Niino 2004, 2006, and 2009 \cite Nakanishi_2004 \cite Nakanishi_2006 \cite NAKANISHI_2009). The closure constants for the original MYNN scheme were tuned to a database of LES as opposed to observational data. @@ -25,14 +25,11 @@ the Federal Aviation Administration (FAA) and users within the renewable-energy changes were made to the formulation of the mixing lengths and representation of subgrid-scale(SGS) clouds, but new components have also been added to improve the representation of non-local mixing, the turbulence interaction with clouds, and the coupling to other model components (i.e., radiation). A description of the changes to the MYNN scheme are available in Olson et al.(2019) -\cite olson_et_al_2019. - +\cite https://doi.org/10.25923/n9wm-be49. \section intra_mynnpbl Intraphysics Communication - Cloud-Radiation Interaction - -\sa gsd_mynnrad_pre -\sa gsd_mynnrad_post +\sa \ref SGSCLOUD_page The SGS clouds produced by the MYNN-EDMF scheme are coupled to the longwave and shortwave radiation schemes if the namelist parameter \p icloud_bl is set to 1. In this case, the SGS cloud fraction, \p CLDFRA_BL, and the SGS @@ -65,9 +62,9 @@ values of \f$q_c, q_i\f$ and \p CLDFRA are restored, so the SGS clouds do not i The MYNN-EDMF CCPP-compliant interface: \ref arg_table_mynnedmf_wrapper_run -\section gen_mynnedmf_conv MYNN-EDMF Scheme General Algorithm +\section gen_mynnedmf_conv General Algorithm -\image html MYNN-EDMF_call_order.png "Figure 1.The order of subroutines within the MYNN-EDMF (Courtesy of J.B. Olson). The green rectangles within the main subroutine (mynn_bl_driver()) represent subroutine calls. The blue rectangles represent tasks coded within the main driver. A brief description is shown on the right " width=10cm +\image html MYNN-EDMF_call_order.png "Figure 1.The order of subroutines within the MYNN-EDMF (Courtesy of J.B. Olson). The green rectangles within the main subroutine (mynn_bl_driver()) represent subroutine calls. The blue rectangles represent tasks coded within the main driver. A brief description is shown on the right " width=600 \ref gen_mynn_bl_driver diff --git a/physics/docs/pdftxt/MYNN_SFCLAYER.txt b/physics/docs/pdftxt/MYNN_SFCLAYER.txt index 301bdb5cd..22353601e 100644 --- a/physics/docs/pdftxt/MYNN_SFCLAYER.txt +++ b/physics/docs/pdftxt/MYNN_SFCLAYER.txt @@ -12,7 +12,7 @@ drag (Beljaars et al. 2004) \cite beljaars_et_al_2004 ], requires that surface l assumptions made across all model components are physically consistent. The MYNN surface layer scheme was originally developed for the Mellor-Yamada-Nakanishi-Niino (MYNN)-Eddy Diffusivity-Mass -Flux (EDMF) scheme (Nakanishi and Niino 2009 \cite NAKANISHI_2009, Olson et al. 2019 \cite olson_et_al_2019) and has been used in NOAA's operational +Flux (EDMF) scheme (Nakanishi and Niino 2009 \cite NAKANISHI_2009, Olson et al. 2019 \cite https://doi.org/10.25923/n9wm-be49) and has been used in NOAA's operational Rapid Refresh (RAP; Benjamin et al. 2016 \cite Benjamin_2016 ) and High-Resolution Rapid Refresh (HRRR) forecast systems since 2014. During this time, the scheme has undergone significant development in tandem with other components of the forecast systems. More recently, several new features have been added in order to accommodate different capabilities in the Common Community Physics Package (CCPP) (Heinzeller et al. 2019). This updated version of the @@ -41,7 +41,7 @@ basic state variables): u*, z/L, surface heat and moisture fluxes. \section gen_mynnsfclay MYNN Surface Layer Scheme General Algorithm -\image html MYNN-SFCLAY_call_order.png "Figure 1.The order of operations within the MYNN surface layer scheme (Courtesy of J.B. Olson)." width=10cm +\image html MYNN-SFCLAY_call_order.png "Figure 1.The order of operations within the MYNN surface layer scheme (Courtesy of J.B. Olson)." width=900 Within the MYNN surface layer scheme, there is a dependency check for the first timestep. If true, several arrays are initialized at every i point. This is done because (1) some variables are calculated in schemes called after the surface layer call and (2) some variables are used within diff --git a/physics/docs/pdftxt/NSSLMICRO.txt b/physics/docs/pdftxt/NSSLMICRO.txt index 5d94f6600..3d35c9fd2 100644 --- a/physics/docs/pdftxt/NSSLMICRO.txt +++ b/physics/docs/pdftxt/NSSLMICRO.txt @@ -1,5 +1,5 @@ /** -\page NSSLMICRO NSSL 2-moment Microphysics Scheme +\page NSSLMICRO_page NSSL 2-moment Cloud Microphysics Scheme \section nssl2m_descrp Description The NSSL two-moment bulk microphysical parameterization scheme that describes form and phase changes among a range of liquid and ice hydrometeors, as described in Mansell et al. (2010) \cite Mansell_etal_2010 and Mansell and Ziegler (2013) \cite Mansell_2013. The microphysical parameterization predicts the mass mixing ratio and number concentration of cloud droplets, raindrops, cloud ice crystals (columns), snow particles (including large crystals and aggregates), graupel, and (optionally) hail. @@ -8,28 +8,17 @@ The graupel and hail particle densities are also calculated by predicting the to Hydrometeor size distributions are assumed to follow a gamma functional form. Microphysical processes include cloud droplet and cloud ice nucleation, condensation, deposition, evaporation, sublimation, collection–coalescence, variable-density riming, shedding, ice multiplication, cloud ice aggregation, freezing and melting, and conversions between hydrometeor categories. -CCN concentration is predicted as in Mansell et al. (2010) with a bulk activation spectrum approximating small aerosols. The model tracks the number of unactivated CCN, and the local CCN concentration is depleted as droplets are activated, either at cloud base or in cloud. The CCN are subjected to advection and subgrid turbulent mixing but have no other interactions with hydrometeors; for example, scavenging by raindrops is omitted. CCN are restored by droplet evaporation and by a gradual regeneration when no hydrometeors are present. Aerosol sensitivity is enhanced by explicitly treating droplet condensation instead of using a saturation adjustment. Supersaturation (within reason) is allowed to persist in updraft with low droplet concentration. +Cloud concentration nuclei (CCN) concentration is predicted as in Mansell et al. (2010) \cite Mansell_etal_2010 with a bulk activation spectrum approximating small aerosols. The model tracks the number of unactivated CCN, and the local CCN concentration is depleted as droplets are activated, either at cloud base or in cloud. The CCN are subjected to advection and subgrid turbulent mixing but have no other interactions with hydrometeors; for example, scavenging by raindrops is omitted. CCN are restored by droplet evaporation and by a gradual regeneration when no hydrometeors are present. Aerosol sensitivity is enhanced by explicitly treating droplet condensation instead of using a saturation adjustment. Supersaturation (within reason) is allowed to persist in updraft with low droplet concentration. Excessive size sorting (common in 2-moment schemes) is effectively controlled by an adaptive breakup method that prevents reflectivity growth by sedimentation (Mansell 2010 \cite Mansell_2010). -The NSSL scheme is designed with deep (severe) convection in mind at grid spacings of 4km or smaller, but can also be run at larger grid spacing as needed for nesting etc. It is also able to capture non-severe and winter weather. - -Namelist parameters: -- \b nssl_hail_on: (logical: .true./.false.) Turns the hail category (3 variables: mass, number, and volume) Default value is .false. Field table variables: hailwat, hail_nc, hail_vol - -- \b nssl_ccn_on: (logical: .true./.false.) Turns prediction on/off for simple CCN number concentration. Default value is .true. Field table variable: ccn_nc - -- \b nssl_cccn: (real) Background CCN concentration at STP. CCN are initialized as a constant number mixing ratio (nssl_cccn/1.225). The default value is 0.6e9 m-3 - -- \b nssl_alphah, nssl_alphahl: (real) Shape parameters for graupel (h) and hail (hl). Default values are 0.0 and 1.0. - - +The NSSL scheme is designed with deep (severe) convection in mind at grid spacings of up to 4 km, but can also be run at larger grid spacing as needed for nesting etc. It is also able to capture non-severe and winter weather. \section intra_nssl2m Intraphysics Communication -\ref arg_table_mp_nssl_run +- \ref arg_table_mp_nssl_run \section gen_nssl2m General Algorithm -- \ref gen_nssl2m_init -- \ref gen_nssl2m_driver +- \ref gen_nssl + */ diff --git a/physics/docs/pdftxt/RAP_suite.txt b/physics/docs/pdftxt/RAP_suite.txt new file mode 100644 index 000000000..cbf25f1ad --- /dev/null +++ b/physics/docs/pdftxt/RAP_suite.txt @@ -0,0 +1,31 @@ +/** +\page rap_suite_page RAP Suite + +\section rap_suite_overview Overview + +The RAP suite contains the parameterizations used in the NOAA operational Rapid Refresh (RAP) model +which runs at 13-km resolution. Currently, the RAP suite is supported in SCM only. For additional +information about the RAP model, visit: https://rapidrefresh.noaa.gov. + +The RAP suite uses the parameterizations in the following order: + - \ref SGSCLOUD_page + - \ref GFS_RRTMG + - \ref SFC_MYNNSFL + - \ref GFS_NSST + - \ref RUCLSM + - \ref MYNNEDMF + - \ref GFS_drag_suite + - \ref GFS_OZPHYS + - \ref GFS_H2OPHYS + - \ref CU_GF + - \ref cu_gf_deep_group + - \ref cu_gf_sh_group + - \ref THOMPSON + +\section sdf_gsdsuite Suite Definition File +\include suite_FV3_RAP.xml + +\section RAP_nml_option Namelist +\snippet RE6/FV3_RAP_input.nml GFS_PHYSICS_NML + +*/ diff --git a/physics/docs/pdftxt/RE6/FV3_GFS_v16_input.nml b/physics/docs/pdftxt/RE6/FV3_GFS_v16_input.nml new file mode 100644 index 000000000..941a512aa --- /dev/null +++ b/physics/docs/pdftxt/RE6/FV3_GFS_v16_input.nml @@ -0,0 +1,340 @@ +&amip_interp_nml + data_set = 'reynolds_oi' + date_out_of_range = 'climo' + interp_oi_sst = .true. + no_anom_sst = .false. + use_ncep_ice = .false. + use_ncep_sst = .true. +/ + +&atmos_model_nml + blocksize = 40 + ccpp_suite = 'FV3_GFS_v16' + chksum_debug = .false. + dycore_only = .false. +/ + +&cires_ugwp_nml + knob_ugwp_azdir = 2, 4, 4, 4 + knob_ugwp_doaxyz = 1 + knob_ugwp_doheat = 1 + knob_ugwp_dokdis = 1 + knob_ugwp_effac = 1, 1, 1, 1 + knob_ugwp_ndx4lh = 1 + knob_ugwp_solver = 2 + knob_ugwp_source = 1, 1, 0, 0 + knob_ugwp_stoch = 0, 0, 0, 0 + knob_ugwp_version = 0 + knob_ugwp_wvspec = 1, 25, 25, 25 + launch_level = 27 +/ + +&diag_manager_nml + prepend_date = .false. +/ + +&external_ic_nml + checker_tr = .false. + filtered_terrain = .true. + gfs_dwinds = .true. + levp = 65 + nt_checker = 0 +/ + +&fms_io_nml + checksum_required = .false. + max_files_r = 100 + max_files_w = 100 +/ + +&fms_nml + clock_grain = 'ROUTINE' + domains_stack_size = 3000000 + print_memory_usage = .false. +/ + +&fv_core_nml + a_imp = 1.0 + adjust_dry_mass = .false. + agrid_vel_rst = .false. + bc_update_interval = 6 + beta = 0.0 + consv_am = .false. + consv_te = 0.0 + d2_bg = 0.0 + d2_bg_k1 = 0.2 + d2_bg_k2 = 0.0 + d4_bg = 0.12 + d_con = 1.0 + d_ext = 0.0 + dddmp = 0.1 + delt_max = 0.008 + dnats = 1 + do_sat_adj = .true. + do_schmidt = .true. + do_vort_damp = .true. + dwind_2d = .false. + dz_min = 2 + external_eta = .true. + external_ic = .true. + fill = .true. + full_zs_filter = .false. + fv_debug = .false. + fv_sg_adj = 450 + gfs_phil = .false. + hord_dp = -5 + hord_mt = 5 + hord_tm = 5 + hord_tr = 10 + hord_vt = 5 + hydrostatic = .false. + io_layout = 1, 1 + k_split = 6 + ke_bg = 0.0 + kord_mt = 9 + kord_tm = -9 + kord_tr = 9 + kord_wz = 9 + layout = 5, 2 + make_nh = .false. + mountain = .false. + n_split = 6 + n_sponge = 10 + n_zs_filter = 0 + na_init = 0 + ncep_ic = .false. + nggps_ic = .true. + no_dycore = .false. + nord = 3 + npx = 203 + npy = 117 + npz = 64 + nrows_blend = 10 + ntiles = 1 + nudge_dz = .false. + nudge_qv = .true. + nwat = 6 + p_fac = 0.1 + phys_hydrostatic = .false. + print_freq = 6 + psm_bc = 1 + range_warn = .false. + read_increment = .false. + regional = .true. + regional_bcs_from_gsi = .false. + res_latlon_dynamics = '' + reset_eta = .false. + rf_cutoff = 750.0 + stretch_fac = 0.999 + target_lat = 38.5 + target_lon = -97.5 + tau = 10.0 + use_hydro_pressure = .false. + vtdm4 = 0.02 + warm_start = .false. + write_restart_with_bcs = .false. + z_tracer = .true. +/ + +&fv_grid_nml + grid_file = 'INPUT/grid_spec.nc' +/ + +!> [GFDL_CLOUD_MP_NML] +&gfdl_cloud_microphysics_nml + c_cracw = 0.8 + c_paut = 0.5 + c_pgacs = 0.01 + c_psaci = 0.05 + ccn_l = 300.0 + ccn_o = 100.0 + const_vg = .false. + const_vi = .false. + const_vr = .false. + const_vs = .false. + de_ice = .false. + do_qa = .true. + do_sedi_heat = .false. + dw_land = 0.16 + dw_ocean = 0.1 + fast_sat_adj = .true. + fix_negative = .true. + icloud_f = 1 + mono_prof = .true. + mp_time = 150.0 + prog_ccn = .false. + qi0_crt = 8e-05 + qi_lim = 1.0 + ql_gen = 0.001 + ql_mlt = 0.001 + qs0_crt = 0.001 + rad_graupel = .true. + rad_rain = .true. + rad_snow = .true. + reiflag = 2 + rh_inc = 0.3 + rh_inr = 0.3 + rh_ins = 0.3 + rthresh = 1e-05 + sedi_transport = .true. + tau_g2v = 900.0 + tau_i2s = 1000.0 + tau_l2v = 225.0 + tau_v2l = 150.0 + use_ccn = .true. + use_ppm = .false. + vg_max = 12.0 + vi_max = 1.0 + vr_max = 12.0 + vs_max = 2.0 + z_slope_ice = .true. + z_slope_liq = .true. +/ +!! [GFDL_CLOUD_MP_NML] + +!> [GFS_PHYSICS_NML] +&gfs_physics_nml + cal_pre = .false. + cdmbgwd = 4.0, 0.15, 1.0, 1.0 + cnvcld = .true. + cnvgwd = .true. + debug = .false. + do_shum = .false. + do_skeb = .false. + do_spp = .false. + do_sppt = .false. + do_tofd = .true. + do_ugwp = .false. + dspheat = .true. + effr_in = .true. + fhcyc = 0 + fhlwr = 3600.0 + fhswr = 3600.0 + fhzero = 1.0 + h2o_phys = .true. + hybedmf = .false. + iaer = 5111 + ialb = 1 + iau_inc_files = '' + icliq_sw = 2 + ico2 = 2 + iems = 1 + imfdeepcnv = 2 + imfshalcnv = 2 + imp_physics = 11 + iopt_alb = 2 + iopt_btr = 1 + iopt_crs = 1 + iopt_dveg = 1 + iopt_frz = 1 + iopt_inf = 1 + iopt_rad = 1 + iopt_run = 1 + iopt_sfc = 1 + iopt_snf = 4 + iopt_stc = 1 + iopt_tbot = 2 + iovr = 3 + isatmedmf = 1 + isol = 2 + isot = 1 + isubc_lw = 2 + isubc_sw = 2 + ivegsrc = 1 + ldiag3d = .false. + ldiag_ugwp = .false. + lgfdlmprad = .true. + lheatstrg = .true. + lndp_each_step = .true. + lndp_type = 0 + lsm = 1 + lsoil = 4 + lwhtr = .true. + n_var_lndp = 0 + n_var_spp = 0 + nsradar_reset = 3600 + nst_anl = .true. + nstf_name = 2, 1, 0, 0, 0 + oz_phys = .false. + oz_phys_2015 = .true. + pdfcld = .false. + prautco = 0.00015, 0.00015 + pre_rad = .false. + print_diff_pgr = .false. + prslrd0 = 0.0 + psautco = 0.0008, 0.0005 + random_clds = .false. + redrag = .true. + satmedmf = .true. + shal_cnv = .true. + swhtr = .true. + trans_trac = .true. + use_ufo = .true. +/ +!! [GFS_PHYSICS_NML] + +&interpolator_nml + interp_method = 'conserve_great_circle' +/ + +&mpp_io_nml + deflate_level = 1 + shuffle = 1 +/ + +&nam_sfcperts +/ + +&nam_sppperts +/ + +&nam_stochy + shum = -999.0 + shum_lscale = 150000 + shum_tau = 21600 + shumint = 3600 + skeb = -999.0 + skeb_lscale = 150000 + skeb_tau = 21600 + skeb_vdof = 10 + skebint = 3600 + sppt = -999.0 + sppt_lscale = 150000 + sppt_tau = 21600 + spptint = 3600 + use_zmtnblck = .false. +/ + +&namsfc + fabsl = 99999 + faisl = 99999 + faiss = 99999 + fnacna = '' + fnaisc = '../fix_am/CFSR.SEAICE.1982.2012.monthly.clim.grb' + fnglac = '../fix_am/global_glacier.2x2.grb' + fnmskh = '../fix_am/seaice_newland.grb' + fnmxic = '../fix_am/global_maxice.2x2.grb' + fnsmcc = '../fix_am/global_soilmgldas.t126.384.190.grb' + fnsnoa = '' + fnsnoc = '../fix_am/global_snoclim.1.875.grb' + fntsfa = '' + fntsfc = '../fix_am/RTGSST.1982.2012.monthly.clim.grb' + fnzorc = 'igbp' + fsicl = 99999 + fsics = 99999 + fslpl = 99999 + fsmcl = 99999, 99999, 99999 + fsnol = 99999 + fsnos = 99999 + fsotl = 99999 + ftsfl = 99999 + ftsfs = 90 + fvetl = 99999 + fvmnl = 99999 + fvmxl = 99999 + landice = .true. + ldebug = .false. +/ + +&surf_map_nml +/ diff --git a/physics/docs/pdftxt/RE6/FV3_GFS_v17_p8_input.nml b/physics/docs/pdftxt/RE6/FV3_GFS_v17_p8_input.nml new file mode 100644 index 000000000..d43e54c92 --- /dev/null +++ b/physics/docs/pdftxt/RE6/FV3_GFS_v17_p8_input.nml @@ -0,0 +1,377 @@ +&atmos_model_nml + blocksize = 32 + chksum_debug = .false. + dycore_only = .false. + ccpp_suite = 'FV3_GFS_v17_p8' +/ + +&diag_manager_nml + prepend_date = .false. + max_output_fields = 300 +/ + +&fms_io_nml + checksum_required = .false. + max_files_r = 100 + max_files_w = 100 +/ + +&mpp_io_nml +shuffle=1 +deflate_level=1 +/ + +&fms_nml + clock_grain = 'ROUTINE' + domains_stack_size = 3000000 + print_memory_usage = .false. +/ + +&fv_core_nml + layout = 3,8 + io_layout = 1,1 + npx = 97 + npy = 97 + ntiles = 6 + npz = 127 + dz_min = 6 + psm_bc = 1 + grid_type = -1 + make_nh = .true. + fv_debug = .false. + range_warn = .true. + reset_eta = .false. + n_sponge = 42 + nudge_qv = .true. + nudge_dz = .false. + tau = 10.0 + rf_cutoff = 7.5e2 + d2_bg_k1 = 0.20 + d2_bg_k2 = 0.04 + kord_tm = -9 + kord_mt = 9 + kord_wz = 9 + kord_tr = 9 + hydrostatic = .false. + phys_hydrostatic = .false. + use_hydro_pressure = .false. + beta = 0. + a_imp = 1. + p_fac = 0.1 + k_split = 2 + n_split = 6 + nwat = 6 + na_init = 1 + d_ext = 0. + dnats = 0 + fv_sg_adj = 450 + d2_bg = 0. + nord = 2 + dddmp = 0.1 + d4_bg = 0.12 + vtdm4 = 0.02 + delt_max = 0.002 + ke_bg = 0. + do_vort_damp = .true. + external_ic = .true. + external_eta = .true. + gfs_phil = .false. + nggps_ic = .true. + mountain = .false. + ncep_ic = .false. + d_con = 1. + hord_mt = 5 + hord_vt = 5 + hord_tm = 5 + hord_dp = -5 + hord_tr = 8 + adjust_dry_mass = .false. + dry_mass=98320.0 + consv_te = 1. + do_sat_adj = .false. + consv_am = .false. + fill = .true. + dwind_2d = .false. + print_freq = 6 + warm_start = .false. + no_dycore = .false. + z_tracer = .true. + agrid_vel_rst = .true. + read_increment = .false. + res_latlon_dynamics = '' +/ + +&external_ic_nml + filtered_terrain = .true. + levp = 128 + gfs_dwinds = .true. + checker_tr = .false. + nt_checker = 0 +/ + +!> [GFS_PHYSICS_NML] +&gfs_physics_nml + fhzero = 6 + h2o_phys = .true. + ldiag3d = .false. + qdiag3d = .false. + print_diff_pgr = .false. + fhcyc = 24 + use_ufo = .true. + pre_rad = .false. + imp_physics = 8 + iovr = 3 + ltaerosol = .false. + lradar = .false. + ttendlim = -999 + dt_inner = 360 + sedi_semi = .true. + decfl = 10 + oz_phys = .false. + oz_phys_2015 = .true. + lsoil_lsm = 4 + do_mynnedmf = .false. + do_mynnsfclay = .false. + icloud_bl = 1 + bl_mynn_edmf = 1 + bl_mynn_tkeadvect = .true. + bl_mynn_edmf_mom = 1 + do_ugwp = .false. + do_tofd = .false. + gwd_opt = 2 + do_ugwp_v0 = .true. + do_ugwp_v1 = .false. + do_ugwp_v0_orog_only = .false. + do_ugwp_v0_nst_only = .false. + do_gsl_drag_ls_bl = .false. + do_gsl_drag_ss = .true. + do_gsl_drag_tofd = .true. + do_ugwp_v1_orog_only = .false. + min_lakeice = 0.15 + min_seaice = 0.15 + use_cice_alb = .false. + pdfcld = .false. + fhswr = 3600. + fhlwr = 3600. + ialb = 2 + iems = 2 + iaer = 1011 + icliq_sw = 2 + ico2 = 2 + isubc_sw = 2 + isubc_lw = 2 + isol = 2 + lwhtr = .true. + swhtr = .true. + cnvgwd = .true. + shal_cnv = .true. + cal_pre = .false. + redrag = .true. + dspheat = .true. + hybedmf = .false. + satmedmf = .true. + isatmedmf = 1 + lheatstrg = .true. + lseaspray = .true. + random_clds = .false. + trans_trac = .true. + cnvcld = .true. + imfshalcnv = 2 + imfdeepcnv = 2 + ras = .false. + cdmbgwd = 0.14,1.8,1.0,1.0 + prslrd0 = 0. + ivegsrc = 1 + isot = 1 + lsoil = 4 + lsm = 2 + iopt_dveg = 4 + iopt_crs = 2 + iopt_btr = 1 + iopt_run = 1 + iopt_sfc = 3 + iopt_trs = 2 + iopt_frz = 1 + iopt_inf = 1 + iopt_rad = 3 + iopt_alb = 1 + iopt_snf = 4 + iopt_tbot = 2 + iopt_stc = 3 + debug = .false. + nstf_name = 2,1,0,0,0 + nst_anl = .true. + psautco = 0.0008,0.0005 + prautco = 0.00015,0.00015 + lgfdlmprad = .false. + effr_in = .true. + ldiag_ugwp = .false. + fscav_aero = '*:0.0' + do_sppt = .false. + do_shum = .false. + do_skeb = .false. + do_RRTMGP = .false. + active_gases = 'h2o_co2_o3_n2o_ch4_o2' + ngases = 6 + lw_file_gas = 'rrtmgp-data-lw-g128-210809.nc' + lw_file_clouds = 'rrtmgp-cloud-optics-coeffs-lw.nc' + sw_file_gas = 'rrtmgp-data-sw-g112-210809.nc' + sw_file_clouds = 'rrtmgp-cloud-optics-coeffs-sw.nc' + rrtmgp_nGptsSW = 112 + rrtmgp_nGptsLW = 128 + rrtmgp_nBandsLW = 16 + rrtmgp_nBandsSW = 14 + doGP_cldoptics_LUT = .true. + doGP_lwscat = .true. + frac_grid = .true. + cplchm = .false. + cplflx = .false. + cplice = .false. + cplwav = .false. + cplwav2atm = .false. + do_ca = .true. + ca_global = .false. + ca_sgs = .true. + nca = 1 + ncells = 5 + nlives = 12 + nseed = 1 + nfracseed = 0.5 + nthresh = 18 + ca_trigger = .true. + nspinup = 1 + iseed_ca = 12345 +/ +!! [GFS_PHYSICS_NML] + +!> [CIRES_UGWP_NML] +&cires_ugwp_nml + knob_ugwp_solver = 2 + knob_ugwp_source = 1,1,0,0 + knob_ugwp_wvspec = 1,25,25,25 + knob_ugwp_azdir = 2,4,4,4 + knob_ugwp_stoch = 0,0,0,0 + knob_ugwp_effac = 1,1,1,1 + knob_ugwp_doaxyz = 1 + knob_ugwp_doheat = 1 + knob_ugwp_dokdis = 1 + knob_ugwp_ndx4lh = 1 + knob_ugwp_version = 0 + launch_level = 54 +/ +!! [CIRES_UGWP_NML] + +&gfdl_cloud_microphysics_nml + sedi_transport = .true. + do_sedi_heat = .false. + rad_snow = .true. + rad_graupel = .true. + rad_rain = .true. + const_vi = .false. + const_vs = .false. + const_vg = .false. + const_vr = .false. + vi_max = 1. + vs_max = 2. + vg_max = 12. + vr_max = 12. + qi_lim = 1. + prog_ccn = .false. + do_qa = .true. + fast_sat_adj = .true. + tau_l2v = 225. + tau_v2l = 150. + tau_g2v = 900. + rthresh = 10.e-6 ! This is a key parameter for cloud water + dw_land = 0.16 + dw_ocean = 0.10 + ql_gen = 1.0e-3 + ql_mlt = 1.0e-3 + qi0_crt = 8.0E-5 + qs0_crt = 1.0e-3 + tau_i2s = 1000. + c_psaci = 0.05 + c_pgacs = 0.01 + rh_inc = 0.30 + rh_inr = 0.30 + rh_ins = 0.30 + ccn_l = 300. + ccn_o = 100. + c_paut = 0.5 + c_cracw = 0.8 + use_ppm = .false. + use_ccn = .true. + mono_prof = .true. + z_slope_liq = .true. + z_slope_ice = .true. + de_ice = .false. + fix_negative = .true. + icloud_f = 1 + mp_time = 150. + reiflag = 2 +/ + +&interpolator_nml + interp_method = 'conserve_great_circle' +/ + +&namsfc + FNGLAC = 'global_glacier.2x2.grb' + FNMXIC = 'global_maxice.2x2.grb' + FNTSFC = 'RTGSST.1982.2012.monthly.clim.grb' + FNSNOC = 'global_snoclim.1.875.grb' + FNZORC = 'igbp' + FNALBC = 'C96.snowfree_albedo.tileX.nc' + FNALBC2 = 'C96.facsf.tileX.nc' + FNAISC = 'CFSR.SEAICE.1982.2012.monthly.clim.grb' + FNTG3C = 'C96.substrate_temperature.tileX.nc' + FNVEGC = 'C96.vegetation_greenness.tileX.nc' + FNVETC = 'C96.vegetation_type.tileX.nc' + FNSOTC = 'C96.soil_type.tileX.nc' + FNSMCC = 'global_soilmgldas.statsgo.t1534.3072.1536.grb' + FNMSKH = 'global_slmask.t1534.3072.1536.grb' + FNTSFA = '' + FNACNA = '' + FNSNOA = '' + FNVMNC = 'C96.vegetation_greenness.tileX.nc' + FNVMXC = 'C96.vegetation_greenness.tileX.nc' + FNSLPC = 'C96.slope_type.tileX.nc' + FNABSC = 'C96.maximum_snow_albedo.tileX.nc' + LDEBUG =.false. + FSMCL(2) = 99999 + FSMCL(3) = 99999 + FSMCL(4) = 99999 + LANDICE = .false. + FTSFS = 90 + FAISL = 99999 + FAISS = 99999 + FSNOL = 99999 + FSNOS = 99999 + FSICL = 0 + FSICS = 0 + FTSFL = 99999 + FVETL = 99999 + FSOTL = 99999 + FvmnL = 99999 + FvmxL = 99999 + FSLPL = 99999 + FABSL = 99999 +/ + +&fv_grid_nml + grid_file = 'INPUT/grid_spec.nc' +/ + +&nam_stochy +/ + +&nam_sfcperts +/ + +&MOM_input_nml + output_directory = 'MOM6_OUTPUT/', + input_filename = 'n' + restart_input_dir = 'INPUT/', + restart_output_dir = 'RESTART/', + parameter_filename = 'INPUT/MOM_input', + 'INPUT/MOM_override'/ diff --git a/physics/docs/pdftxt/RE6/FV3_HRRR_input.nml b/physics/docs/pdftxt/RE6/FV3_HRRR_input.nml new file mode 100644 index 000000000..a9558a8de --- /dev/null +++ b/physics/docs/pdftxt/RE6/FV3_HRRR_input.nml @@ -0,0 +1,301 @@ +&amip_interp_nml + data_set = 'reynolds_oi' + date_out_of_range = 'climo' + interp_oi_sst = .true. + no_anom_sst = .false. + use_ncep_ice = .false. + use_ncep_sst = .true. +/ + +&atmos_model_nml + blocksize = 40 + ccpp_suite = 'FV3_HRRR' + chksum_debug = .false. + dycore_only = .false. +/ + +&cires_ugwp_nml + knob_ugwp_azdir = 2, 4, 4, 4 + knob_ugwp_doaxyz = 1 + knob_ugwp_doheat = 1 + knob_ugwp_dokdis = 1 + knob_ugwp_effac = 1, 1, 1, 1 + knob_ugwp_ndx4lh = 1 + knob_ugwp_solver = 2 + knob_ugwp_source = 1, 1, 0, 0 + knob_ugwp_stoch = 0, 0, 0, 0 + knob_ugwp_version = 0 + knob_ugwp_wvspec = 1, 25, 25, 25 + launch_level = 25 +/ + +&diag_manager_nml + prepend_date = .false. +/ + +&external_ic_nml + checker_tr = .false. + filtered_terrain = .true. + gfs_dwinds = .true. + levp = 65 + nt_checker = 0 +/ + +&fms_io_nml + checksum_required = .false. + max_files_r = 100 + max_files_w = 100 +/ + +&fms_nml + clock_grain = 'ROUTINE' + domains_stack_size = 3000000 + print_memory_usage = .false. +/ + +&fv_core_nml + a_imp = 1.0 + adjust_dry_mass = .false. + bc_update_interval = 6 + beta = 0.0 + consv_am = .false. + consv_te = 0.0 + d2_bg = 0.0 + d2_bg_k1 = 0.2 + d2_bg_k2 = 0.04 + d4_bg = 0.12 + d_con = 1.0 + d_ext = 0.0 + dddmp = 0.1 + delt_max = 0.008 + dnats = 0 + do_sat_adj = .false. + do_schmidt = .true. + do_vort_damp = .true. + dwind_2d = .false. + dz_min = 2 + external_eta = .true. + external_ic = .true. + fill = .true. + full_zs_filter = .false. + fv_debug = .false. + fv_sg_adj = 300 + gfs_phil = .false. + hord_dp = -5 + hord_mt = 5 + hord_tm = 5 + hord_tr = 10 + hord_vt = 5 + hydrostatic = .false. + io_layout = 1, 1 + k_split = 2 + ke_bg = 0.0 + kord_mt = 9 + kord_tm = -9 + kord_tr = 9 + kord_wz = 9 + layout = 5, 2 + make_nh = .true. + mountain = .false. + n_split = 5 + n_sponge = 24 + n_zs_filter = 0 + na_init = 1 + ncep_ic = .false. + nggps_ic = .true. + no_dycore = .false. + nord = 3 + nord_tr = 2 + npx = 203 + npy = 117 + npz = 64 + nrows_blend = 10 + ntiles = 1 + nudge_qv = .false. + nwat = 6 + p_fac = 0.1 + phys_hydrostatic = .false. + print_freq = 6 + psm_bc = 1 + range_warn = .true. + read_increment = .false. + regional = .true. + regional_bcs_from_gsi = .false. + res_latlon_dynamics = 'fv3_increment.nc' + reset_eta = .false. + rf_cutoff = 2000.0 + stretch_fac = 0.999 + target_lat = 38.5 + target_lon = -97.5 + tau = 5.0 + use_hydro_pressure = .false. + vtdm4 = 0.02 + warm_start = .false. + write_restart_with_bcs = .false. + z_tracer = .true. +/ + +&fv_grid_nml + grid_file = 'INPUT/grid_spec.nc' +/ + +!> [GFS_PHYSICS_NML] +&gfs_physics_nml + bl_mynn_edmf = 1 + bl_mynn_edmf_mom = 1 + bl_mynn_tkeadvect = .true. + cal_pre = .false. + cdmbgwd = 3.5, 1.0 + cnvcld = .false. + cnvgwd = .false. + cplflx = .false. + debug = .false. + do_deep = .false. + do_gsl_drag_ls_bl = .true. + do_gsl_drag_ss = .true. + do_gsl_drag_tofd = .true. + do_mynnedmf = .true. + do_mynnsfclay = .true. + do_shum = .false. + do_skeb = .false. + do_spp = .false. + do_sppt = .false. + dspheat = .true. + effr_in = .true. + fhcyc = 0 + fhlwr = 1200.0 + fhswr = 1200.0 + fhzero = 1.0 + gwd_opt = 3 + h2o_phys = .true. + hybedmf = .false. + iaer = 5111 + ialb = 1 + iau_delthrs = 6 + iau_inc_files = '' + iaufhrs = 30 + icliq_sw = 2 + icloud_bl = 1 + ico2 = 2 + iems = 1 + imfdeepcnv = -1 + imfshalcnv = -1 + imp_physics = 8 + iopt_alb = 2 + iopt_btr = 1 + iopt_crs = 1 + iopt_dveg = 2 + iopt_frz = 1 + iopt_inf = 1 + iopt_rad = 1 + iopt_run = 1 + iopt_sfc = 1 + iopt_snf = 4 + iopt_stc = 1 + iopt_tbot = 2 + iovr = 3 + isol = 2 + isot = 1 + isubc_lw = 2 + isubc_sw = 2 + ivegsrc = 1 + kice = 9 + ldiag3d = .false. + lheatstrg = .false. + lndp_each_step = .true. + lndp_type = 0 + lradar = .true. + lsm = 3 + lsoil = 4 + lsoil_lsm = 9 + ltaerosol = .true. + lwhtr = .true. + n_var_lndp = 0 + n_var_spp = 0 + nsradar_reset = 3600 + nst_anl = .true. + nstf_name = 2, 1, 0, 0, 0 + oz_phys = .false. + oz_phys_2015 = .true. + pdfcld = .false. + pre_rad = .false. + print_diff_pgr = .false. + prslrd0 = 0.0 + random_clds = .false. + redrag = .true. + satmedmf = .false. + shal_cnv = .false. + swhtr = .true. + trans_trac = .true. + ttendlim = -999 + use_ufo = .true. +/ +!! [GFS_PHYSICS_NML] + +&interpolator_nml + interp_method = 'conserve_great_circle' +/ + +&nam_sfcperts +/ + +&nam_sppperts +/ + +&nam_stochy + shum = -999.0 + shum_lscale = 150000 + shum_tau = 21600 + shumint = 3600 + skeb = -999.0 + skeb_lscale = 150000 + skeb_tau = 21600 + skeb_vdof = 10 + skebint = 3600 + sppt = -999.0 + sppt_lscale = 150000 + sppt_tau = 21600 + spptint = 3600 + use_zmtnblck = .false. +/ + +&namsfc + fabsl = 99999 + faisl = 99999 + faiss = 99999 + fnacna = '' + fnaisc = '../fix_am/CFSR.SEAICE.1982.2012.monthly.clim.grb' + fnglac = '../fix_am/global_glacier.2x2.grb' + fnmskh = '../fix_am/seaice_newland.grb' + fnmxic = '../fix_am/global_maxice.2x2.grb' + fnsmcc = '../fix_am/global_soilmgldas.t126.384.190.grb' + fnsnoa = '' + fnsnoc = '../fix_am/global_snoclim.1.875.grb' + fntsfa = '' + fntsfc = '../fix_am/RTGSST.1982.2012.monthly.clim.grb' + fnzorc = 'igbp' + fsicl = 99999 + fsics = 99999 + fslpl = 99999 + fsmcl = 99999, 99999, 99999 + fsnol = 99999 + fsnos = 99999 + fsotl = 99999 + ftsfl = 99999 + ftsfs = 90 + fvetl = 99999 + fvmnl = 99999 + fvmxl = 99999 + ldebug = .true. +/ + +&surf_map_nml + cd2 = -1 + cd4 = 0.12 + max_slope = 0.4 + n_del2_strong = 0 + n_del2_weak = 2 + n_del4 = 1 + peak_fac = 1.0 + zero_ocean = .false. +/ diff --git a/physics/docs/pdftxt/RE6/FV3_RAP_input.nml b/physics/docs/pdftxt/RE6/FV3_RAP_input.nml new file mode 100644 index 000000000..c4d920bff --- /dev/null +++ b/physics/docs/pdftxt/RE6/FV3_RAP_input.nml @@ -0,0 +1,387 @@ +&atmos_model_nml + blocksize = 32 + chksum_debug = .false. + dycore_only = .false. + ccpp_suite = 'FV3_RAP' +/ + +&diag_manager_nml + prepend_date = .false. + max_output_fields = 300 +/ + +&fms_io_nml + checksum_required = .false. + max_files_r = 100 + max_files_w = 100 +/ + +&mpp_io_nml +shuffle=1 +deflate_level=1 +/ + +&fms_nml + clock_grain = 'ROUTINE' + domains_stack_size = 3000000 + print_memory_usage = .false. +/ + +&fv_core_nml + layout = 3,8 + io_layout = 1,1 + npx = 97 + npy = 97 + ntiles = 6 + npz = 127 + grid_type = -1 + make_nh = .true. + fv_debug = .false. + range_warn = .false. + reset_eta = .false. + n_sponge = 42 + nudge_qv = .true. + nudge_dz = .false. + tau = 10. + rf_cutoff = 7.5e2 + d2_bg_k1 = 0.20 + d2_bg_k2 = 0.0 + kord_tm = -9 + kord_mt = 9 + kord_wz = 9 + kord_tr = 9 + hydrostatic = .false. + phys_hydrostatic = .false. + use_hydro_pressure = .false. + beta = 0. + a_imp = 1. + p_fac = 0.1 + k_split = 2 + n_split = 6 + nwat = 6 + na_init = 1 + d_ext = 0. + dnats = 0 + fv_sg_adj = 450 + d2_bg = 0. + nord = 2 + dddmp = 0.1 + d4_bg = 0.12 + vtdm4 = 0.02 + delt_max = 0.002 + ke_bg = 0. + do_vort_damp = .true. + external_ic = .true. + external_eta = .true. + gfs_phil = .false. + nggps_ic = .true. + mountain = .false. + ncep_ic = .false. + d_con = 1. + hord_mt = 5 + hord_vt = 5 + hord_tm = 5 + hord_dp = -5 + hord_tr = 8 + adjust_dry_mass = .false. + consv_te = 1. + do_sat_adj = .false. + consv_am = .false. + fill = .true. + dwind_2d = .false. + print_freq = 6 + warm_start = .false. + no_dycore = .false. + z_tracer = .true. + agrid_vel_rst = .true. + read_increment = .false. + res_latlon_dynamics = '' +/ + +&external_ic_nml + filtered_terrain = .true. + levp = 128 + gfs_dwinds = .true. + checker_tr = .false. + nt_checker = 0 +/ + +!> [GFS_PHYSICS_NML] +&gfs_physics_nml + fhzero = 6 + h2o_phys = .true. + ldiag3d = .false. + qdiag3d = .false. + print_diff_pgr = .false. + fhcyc = 24 + use_ufo = .true. + pre_rad = .false. + imp_physics = 8 + ltaerosol = .true. + lradar = .true. + nssl_cccn = 0.6e9 + nssl_alphah = 0.0 + nssl_alphahl = 1.0 + nssl_hail_on = .false. + nssl_ccn_on = .true. + nssl_invertccn = .true. + dt_inner = 60 + ttendlim = -999 + pdfcld = .false. + fhswr = 3600. + fhlwr = 3600. + ialb = 2 + iems = 2 + iaer = 5111 + icliq_sw = 1 + iovr = 1 + icloud = 0 + ico2 = 2 + isubc_sw = 2 + isubc_lw = 2 + isol = 2 + lwhtr = .true. + swhtr = .true. + cnvgwd = .true. + do_deep = .true. + shal_cnv = .true. + cal_pre = .false. + redrag = .true. + dspheat = .true. + hybedmf = .false. + satmedmf = .false. + isatmedmf = 1 + do_mynnedmf = .true. + lheatstrg = .false. + lseaspray = .false. + random_clds = .false. + trans_trac = .true. + cnvcld = .true. + imfshalcnv = 3 + imfdeepcnv = 3 + ras = .false. + cdmbgwd = 0.14,1.8,1.0,1.0 + do_mynnsfclay = .true. + prslrd0 = 0. + ivegsrc = 1 + isot = 1 + lsm = 3 + lsoil = 4 + lsoil_lsm = 9 + kice = 9 + iopt_dveg = 1 + iopt_crs = 1 + iopt_btr = 1 + iopt_run = 1 + iopt_sfc = 1 + iopt_frz = 1 + iopt_inf = 1 + iopt_rad = 1 + iopt_alb = 2 + iopt_snf = 4 + iopt_tbot = 2 + iopt_stc = 1 + debug = .false. + oz_phys = .false. + oz_phys_2015 = .true. + nstf_name = 2,0,0,0,0 + nst_anl = .true. + lkm = 0 + psautco = 0.0008,0.0005 + prautco = 0.00015,0.00015 + lgfdlmprad = .true. + cplchm = .false. + cplwav = .false. + cplwav2atm = .false. + effr_in = .true. + ldiag_ugwp = .false. + do_ugwp = .false. + do_tofd = .false. + gwd_opt = 3 + ldiag_ugwp = .false. + do_ugwp_v0 = .false. + do_ugwp_v0_orog_only = .false. + do_gsl_drag_ls_bl = .true. + do_gsl_drag_ss = .true. + do_gsl_drag_tofd = .true. + do_ugwp_v1 = .false. + do_ugwp_v1_orog_only = .false. + do_sppt = .false. + do_shum = .false. + do_skeb = .false. + lndp_type = 0 + n_var_lndp = 0 + lndp_each_step = .false. + fscav_aero = '*:0.0' + icloud_bl = 1 + bl_mynn_tkeadvect = .true. + bl_mynn_edmf = 1 + bl_mynn_edmf_mom = 1 + do_RRTMGP = .false. + active_gases = 'h2o_co2_o3_n2o_ch4_o2' + ngases = 6 + lw_file_gas = 'rrtmgp-data-lw-g128-210809.nc' + lw_file_clouds = 'rrtmgp-cloud-optics-coeffs-lw.nc' + sw_file_gas = 'rrtmgp-data-sw-g112-210809.nc' + sw_file_clouds = 'rrtmgp-cloud-optics-coeffs-sw.nc' + rrtmgp_nGptsSW = 112 + rrtmgp_nGptsLW = 128 + rrtmgp_nBandsLW = 16 + rrtmgp_nBandsSW = 14 + doGP_cldoptics_LUT = .false. + doGP_lwscat = .false. + use_LW_jacobian = .false. + damp_LW_fluxadj = .false. + lfnc_k = -999 + lfnc_p0 = -999 +/ +!! [GFS_PHYSICS_NML] + +&gfdl_cloud_microphysics_nml + sedi_transport = .true. + do_sedi_heat = .false. + rad_snow = .true. + rad_graupel = .true. + rad_rain = .true. + const_vi = .false. + const_vs = .false. + const_vg = .false. + const_vr = .false. + vi_max = 1. + vs_max = 2. + vg_max = 12. + vr_max = 12. + qi_lim = 1. + prog_ccn = .false. + do_qa = .true. + fast_sat_adj = .true. + tau_l2v = 225. + tau_v2l = 150. + tau_g2v = 900. + rthresh = 10.e-6 ! This is a key parameter for cloud water + dw_land = 0.16 + dw_ocean = 0.10 + ql_gen = 1.0e-3 + ql_mlt = 1.0e-3 + qi0_crt = 8.0E-5 + qs0_crt = 1.0e-3 + tau_i2s = 1000. + c_psaci = 0.05 + c_pgacs = 0.01 + rh_inc = 0.30 + rh_inr = 0.30 + rh_ins = 0.30 + ccn_l = 300. + ccn_o = 100. + c_paut = 0.5 + c_cracw = 0.8 + use_ppm = .false. + use_ccn = .true. + mono_prof = .true. + z_slope_liq = .true. + z_slope_ice = .true. + de_ice = .false. + fix_negative = .true. + icloud_f = 1 + mp_time = 150. + reiflag = 2 +/ + +&interpolator_nml + interp_method = 'conserve_great_circle' +/ + +&namsfc + FNGLAC = 'global_glacier.2x2.grb' + FNMXIC = 'global_maxice.2x2.grb' + FNTSFC = 'RTGSST.1982.2012.monthly.clim.grb' + FNSNOC = 'global_snoclim.1.875.grb' + FNZORC = 'igbp' + FNALBC = 'global_snowfree_albedo.bosu.t126.384.190.rg.grb' + FNALBC2 = 'global_albedo4.1x1.grb' + FNAISC = 'CFSR.SEAICE.1982.2012.monthly.clim.grb' + FNTG3C = 'global_tg3clim.2.6x1.5.grb' + FNVEGC = 'global_vegfrac.0.144.decpercent.grb' + FNVETC = 'global_vegtype.igbp.t126.384.190.rg.grb' + FNSOTC = 'global_soiltype.statsgo.t126.384.190.rg.grb' + FNSMCC = 'global_soilmgldas.statsgo.t1534.3072.1536.grb' + FNMSKH = 'global_slmask.t1534.3072.1536.grb' + FNTSFA = '' + FNACNA = '' + FNSNOA = '' + FNVMNC = 'global_shdmin.0.144x0.144.grb' + FNVMXC = 'global_shdmax.0.144x0.144.grb' + FNSLPC = 'global_slope.1x1.grb' + FNABSC = 'global_mxsnoalb.uariz.t126.384.190.rg.grb' + LDEBUG = .false. + FSMCL(2) = 99999 + FSMCL(3) = 99999 + FSMCL(4) = 99999 + LANDICE = .true. + FTSFS = 90 + FAISL = 99999 + FAISS = 99999 + FSNOL = 99999 + FSNOS = 99999 + FSICL = 99999 + FSICS = 99999 + FTSFL = 99999 + FVETL = 99999 + FSOTL = 99999 + FvmnL = 99999 + FvmxL = 99999 + FSLPL = 99999 + FABSL = 99999 +/ + +&fv_grid_nml + grid_file = 'INPUT/grid_spec.nc' +/ + +&nam_stochy + STOCHINI=.false., + SKEBNORM=1, + SKEB_NPASS=30, + SKEB_VDOF=5, + SKEB=-999., + SKEB_TAU=2.16E4, + SKEB_LSCALE=1000.E3, + SKEBINT=1800, + SHUM=-999., + SHUM_TAU=21600, + SHUM_LSCALE=500000, + SHUMINT=3600, + SPPT=-999., + SPPT_TAU=21600, + SPPT_LSCALE=500000, + SPPT_LOGIT=.TRUE., + SPPT_SFCLIMIT=.TRUE., + SPPTINT=1800, + ISEED_SHUM=1, + ISEED_SKEB=2, + ISEED_SPPT=3, +/ + +&nam_sfcperts + lndp_type = 0 + LNDP_TAU=21600, + LNDP_LSCALE=500000, + ISEED_LNDP=2010, + lndp_var_list = 'smc', 'vgf', 'alb', 'sal', 'emi', 'zol' + lndp_prt_list = 0.200, 0.001, 0.001, 0.001, 0.001, 0.001 +/ + +&cires_ugwp_nml + knob_ugwp_solver = 2 + knob_ugwp_source = 1,1,0,0 + knob_ugwp_wvspec = 1,25,25,25 + knob_ugwp_azdir = 2,4,4,4 + knob_ugwp_stoch = 0,0,0,0 + knob_ugwp_effac = 1,1,1,1 + knob_ugwp_doaxyz = 1 + knob_ugwp_doheat = 1 + knob_ugwp_dokdis = 1 + knob_ugwp_ndx4lh = 1 + knob_ugwp_version = 0 + launch_level = 54 +/ diff --git a/physics/docs/pdftxt/RE6/FV3_RRFS_v1beta_input.nml b/physics/docs/pdftxt/RE6/FV3_RRFS_v1beta_input.nml new file mode 100644 index 000000000..1ff750f4c --- /dev/null +++ b/physics/docs/pdftxt/RE6/FV3_RRFS_v1beta_input.nml @@ -0,0 +1,295 @@ +&amip_interp_nml + data_set = 'reynolds_oi' + date_out_of_range = 'climo' + interp_oi_sst = .true. + no_anom_sst = .false. + use_ncep_ice = .false. + use_ncep_sst = .true. +/ + +&atmos_model_nml + blocksize = 40 + ccpp_suite = 'FV3_RRFS_v1beta' + chksum_debug = .false. + dycore_only = .false. +/ + +!> [CIRES_UGWP_NML] +&cires_ugwp_nml + knob_ugwp_azdir = 2, 4, 4, 4 + knob_ugwp_doaxyz = 1 + knob_ugwp_doheat = 1 + knob_ugwp_dokdis = 1 + knob_ugwp_effac = 1, 1, 1, 1 + knob_ugwp_ndx4lh = 1 + knob_ugwp_solver = 2 + knob_ugwp_source = 1, 1, 0, 0 + knob_ugwp_stoch = 0, 0, 0, 0 + knob_ugwp_version = 0 + knob_ugwp_wvspec = 1, 25, 25, 25 + launch_level = 25 +/ +!! [CIRES_UGWP_NML] + +&diag_manager_nml + prepend_date = .false. +/ + +&external_ic_nml + checker_tr = .false. + filtered_terrain = .true. + gfs_dwinds = .true. + levp = 65 + nt_checker = 0 +/ + +&fms_io_nml + checksum_required = .false. + max_files_r = 100 + max_files_w = 100 +/ + +&fms_nml + clock_grain = 'ROUTINE' + domains_stack_size = 3000000 + print_memory_usage = .false. +/ + +&fv_core_nml + a_imp = 1.0 + adjust_dry_mass = .false. + bc_update_interval = 6 + beta = 0.0 + consv_am = .false. + consv_te = 0.0 + d2_bg = 0.0 + d2_bg_k1 = 0.2 + d2_bg_k2 = 0.04 + d4_bg = 0.12 + d_con = 1.0 + d_ext = 0.0 + dddmp = 0.1 + delt_max = 0.008 + dnats = 0 + do_sat_adj = .false. + do_schmidt = .true. + do_vort_damp = .true. + dwind_2d = .false. + dz_min = 2 + external_eta = .true. + external_ic = .true. + fill = .true. + full_zs_filter = .false. + fv_debug = .false. + fv_sg_adj = 300 + gfs_phil = .false. + hord_dp = 6 + hord_mt = 6 + hord_tm = 6 + hord_tr = 10 + hord_vt = 6 + hydrostatic = .false. + io_layout = 1, 1 + k_split = 2 + ke_bg = 0.0 + kord_mt = 9 + kord_tm = -9 + kord_tr = 9 + kord_wz = 9 + layout = 5, 2 + make_nh = .true. + mountain = .false. + n_split = 5 + n_sponge = 24 + n_zs_filter = 0 + na_init = 1 + ncep_ic = .false. + nggps_ic = .true. + no_dycore = .false. + nord = 3 + npx = 203 + npy = 117 + npz = 64 + nrows_blend = 10 + ntiles = 1 + nudge_qv = .false. + nwat = 6 + p_fac = 0.1 + phys_hydrostatic = .false. + print_freq = 6 + psm_bc = 1 + range_warn = .true. + read_increment = .false. + regional = .true. + regional_bcs_from_gsi = .false. + res_latlon_dynamics = 'fv3_increment.nc' + reset_eta = .false. + rf_cutoff = 2000.0 + stretch_fac = 0.999 + target_lat = 38.5 + target_lon = -97.5 + tau = 5.0 + use_hydro_pressure = .false. + vtdm4 = 0.02 + warm_start = .false. + write_restart_with_bcs = .false. + z_tracer = .true. +/ + +&fv_grid_nml + grid_file = 'INPUT/grid_spec.nc' +/ + +!> [GFS_PHYSICS_NML] +&gfs_physics_nml + bl_mynn_edmf = 1 + bl_mynn_edmf_mom = 1 + bl_mynn_tkeadvect= .true. + cal_pre = .false. + cdmbgwd = 3.5, 0.25 + cnvcld = .false. + cnvgwd = .false. + cplflx = .false. + debug = .false. + do_deep = .false. + do_mynnedmf = .true. + do_mynnsfclay = .true. + do_shum = .false. + do_skeb = .false. + do_spp = .false. + do_sppt = .false. + dspheat = .true. + effr_in = .true. + fhcyc = 0 + fhlwr = 1200.0 + fhswr = 1200.0 + fhzero = 1.0 + h2o_phys = .true. + hybedmf = .false. + iaer = 111 + ialb = 1 + iau_delthrs = 6 + iau_inc_files = '' + iaufhrs = 30 + icloud_bl = 1 + ico2 = 2 + iems = 1 + imfdeepcnv = -1 + imfshalcnv = -1 + imp_physics = 8 + iopt_alb = 2 + iopt_btr = 1 + iopt_crs = 1 + iopt_dveg = 2 + iopt_frz = 1 + iopt_inf = 1 + iopt_rad = 1 + iopt_run = 1 + iopt_sfc = 1 + iopt_snf = 4 + iopt_stc = 1 + iopt_tbot = 2 + isol = 2 + isot = 1 + isubc_lw = 2 + isubc_sw = 2 + ivegsrc = 1 + ldiag3d = .false. + lheatstrg = .false. + lndp_each_step = .true. + lndp_type = 0 + lradar = .true. + lsm = 2 + lsoil = 4 + lsoil_lsm = 4 + ltaerosol = .true. + lwhtr = .true. + n_var_lndp = 0 + n_var_spp = 0 + nsradar_reset = 3600 + nst_anl = .true. + nstf_name = 2, 1, 0, 0, 0 + oz_phys = .false. + oz_phys_2015 = .true. + pdfcld = .false. + pre_rad = .false. + print_diff_pgr = .false. + prslrd0 = 0.0 + random_clds = .false. + redrag = .true. + satmedmf = .false. + shal_cnv = .false. + swhtr = .true. + trans_trac = .true. + ttendlim = -999 + use_ufo = .true. +/ + !! [GFS_PHYSICS_NML] + +&interpolator_nml + interp_method = 'conserve_great_circle' +/ + +&nam_sfcperts +/ + +&nam_sppperts +/ + +&nam_stochy + shum = -999.0 + shum_lscale = 150000 + shum_tau = 21600 + shumint = 3600 + skeb = -999.0 + skeb_lscale = 150000 + skeb_tau = 21600 + skeb_vdof = 10 + skebint = 3600 + sppt = -999.0 + sppt_lscale = 150000 + sppt_tau = 21600 + spptint = 3600 + use_zmtnblck = .false. +/ + +&namsfc + fabsl = 99999 + faisl = 99999 + faiss = 99999 + fnacna = '' + fnaisc = '../fix_am/CFSR.SEAICE.1982.2012.monthly.clim.grb' + fnglac = '../fix_am/global_glacier.2x2.grb' + fnmskh = '../fix_am/seaice_newland.grb' + fnmxic = '../fix_am/global_maxice.2x2.grb' + fnsmcc = '../fix_am/global_soilmgldas.t126.384.190.grb' + fnsnoa = '' + fnsnoc = '../fix_am/global_snoclim.1.875.grb' + fntsfa = '' + fntsfc = '../fix_am/RTGSST.1982.2012.monthly.clim.grb' + fnzorc = 'igbp' + fsicl = 99999 + fsics = 99999 + fslpl = 99999 + fsmcl = 99999, 99999, 99999 + fsnol = 99999 + fsnos = 99999 + fsotl = 99999 + ftsfl = 99999 + ftsfs = 90 + fvetl = 99999 + fvmnl = 99999 + fvmxl = 99999 + ldebug = .true. +/ + +&surf_map_nml + cd2 = -1 + cd4 = 0.12 + max_slope = 0.4 + n_del2_strong = 0 + n_del2_weak = 2 + n_del4 = 1 + peak_fac = 1.0 + zero_ocean = .false. +/ diff --git a/physics/docs/pdftxt/RE6/FV3_WoFS_v0_input.nml b/physics/docs/pdftxt/RE6/FV3_WoFS_v0_input.nml new file mode 100644 index 000000000..cfe497ebb --- /dev/null +++ b/physics/docs/pdftxt/RE6/FV3_WoFS_v0_input.nml @@ -0,0 +1,302 @@ +&amip_interp_nml + data_set = 'reynolds_oi' + date_out_of_range = 'climo' + interp_oi_sst = .true. + no_anom_sst = .false. + use_ncep_ice = .false. + use_ncep_sst = .true. +/ + +&atmos_model_nml + blocksize = 40 + ccpp_suite = 'FV3_RRFS_v1nssl' + chksum_debug = .false. + dycore_only = .false. +/ + +!> [CIRES_UGWP_NML] +&cires_ugwp_nml + knob_ugwp_azdir = 2, 4, 4, 4 + knob_ugwp_doaxyz = 1 + knob_ugwp_doheat = 1 + knob_ugwp_dokdis = 1 + knob_ugwp_effac = 1, 1, 1, 1 + knob_ugwp_ndx4lh = 1 + knob_ugwp_solver = 2 + knob_ugwp_source = 1, 1, 0, 0 + knob_ugwp_stoch = 0, 0, 0, 0 + knob_ugwp_version = 0 + knob_ugwp_wvspec = 1, 25, 25, 25 + launch_level = 25 +/ +!! [CIRES_UGWP_NML] + +&diag_manager_nml + prepend_date = .false. +/ + +&external_ic_nml + checker_tr = .false. + filtered_terrain = .true. + gfs_dwinds = .true. + levp = 65 + nt_checker = 0 +/ + +&fms_io_nml + checksum_required = .false. + max_files_r = 100 + max_files_w = 100 +/ + +&fms_nml + clock_grain = 'ROUTINE' + domains_stack_size = 3000000 + print_memory_usage = .false. +/ + +&fv_core_nml + a_imp = 1.0 + adjust_dry_mass = .false. + bc_update_interval = 6 + beta = 0.0 + consv_am = .false. + consv_te = 0.0 + d2_bg = 0.0 + d2_bg_k1 = 0.2 + d2_bg_k2 = 0.04 + d4_bg = 0.12 + d_con = 1.0 + d_ext = 0.0 + dddmp = 0.1 + delt_max = 0.008 + dnats = 0 + do_sat_adj = .false. + do_schmidt = .true. + do_vort_damp = .true. + dwind_2d = .false. + dz_min = 2 + external_eta = .true. + external_ic = .true. + fill = .true. + full_zs_filter = .false. + fv_debug = .false. + fv_sg_adj = 300 + gfs_phil = .false. + hord_dp = 6 + hord_mt = 6 + hord_tm = 6 + hord_tr = 10 + hord_vt = 6 + hydrostatic = .false. + io_layout = 1, 1 + k_split = 2 + ke_bg = 0.0 + kord_mt = 9 + kord_tm = -9 + kord_tr = 9 + kord_wz = 9 + layout = 5, 2 + make_nh = .true. + mountain = .false. + n_split = 5 + n_sponge = 24 + n_zs_filter = 0 + na_init = 1 + ncep_ic = .false. + nggps_ic = .true. + no_dycore = .false. + nord = 3 + npx = 203 + npy = 117 + npz = 64 + nrows_blend = 10 + ntiles = 1 + nudge_qv = .false. + nwat = 7 + p_fac = 0.1 + phys_hydrostatic = .false. + print_freq = 6 + psm_bc = 1 + range_warn = .true. + read_increment = .false. + regional = .true. + regional_bcs_from_gsi = .false. + res_latlon_dynamics = 'fv3_increment.nc' + reset_eta = .false. + rf_cutoff = 2000.0 + stretch_fac = 0.999 + target_lat = 38.5 + target_lon = -97.5 + tau = 5.0 + use_hydro_pressure = .false. + vtdm4 = 0.075 + warm_start = .false. + write_restart_with_bcs = .false. + z_tracer = .true. +/ + +&fv_diagnostics_nml + do_hailcast = .true. +/ + +&fv_grid_nml + grid_file = 'INPUT/grid_spec.nc' +/ + +!> [GFS_PHYSICS_NML] +&gfs_physics_nml + bl_mynn_edmf = 1 + bl_mynn_edmf_mom = 1 + bl_mynn_tkeadvect = .true. + cal_pre = .false. + cdmbgwd = 3.5, 0.25 + cnvcld = .false. + cnvgwd = .false. + cplflx = .false. + debug = .false. + do_deep = .false. + do_mynnedmf = .true. + do_mynnsfclay = .true. + do_shum = .false. + do_skeb = .false. + do_spp = .false. + do_sppt = .false. + dspheat = .true. + effr_in = .true. + fhcyc = 0 + fhlwr = 1200.0 + fhswr = 1200.0 + fhzero = 1.0 + h2o_phys = .true. + hybedmf = .false. + iaer = 111 + ialb = 1 + iau_delthrs = 6 + iau_inc_files = '' + iaufhrs = 30 + icloud_bl = 1 + ico2 = 2 + iems = 1 + imfdeepcnv = -1 + imfshalcnv = -1 + imp_physics = 17 + iopt_alb = 2 + iopt_btr = 1 + iopt_crs = 1 + iopt_dveg = 2 + iopt_frz = 1 + iopt_inf = 1 + iopt_rad = 1 + iopt_run = 1 + iopt_sfc = 1 + iopt_snf = 4 + iopt_stc = 1 + iopt_tbot = 2 + isol = 2 + isot = 1 + isubc_lw = 2 + isubc_sw = 2 + ivegsrc = 1 + ldiag3d = .false. + lheatstrg = .false. + lndp_each_step = .true. + lndp_type = 0 + lradar = .true. + lsm = 1 + lsoil = 4 + lsoil_lsm = 4 + ltaerosol = .true. + lwhtr = .true. + n_var_lndp = 0 + n_var_spp = 0 + nsradar_reset = 3600 + nssl_cccn = 600000000.0 + nssl_ccn_on = .true. + nssl_hail_on = .true. + nst_anl = .true. + nstf_name = 2, 1, 0, 0, 0 + oz_phys = .false. + oz_phys_2015 = .true. + pdfcld = .false. + pre_rad = .false. + print_diff_pgr = .false. + prslrd0 = 0.0 + random_clds = .false. + redrag = .true. + satmedmf = .false. + shal_cnv = .false. + swhtr = .true. + trans_trac = .true. + ttendlim = -999 + use_ufo = .true. +/ +!! [GFS_PHYSICS_NML] + +&interpolator_nml + interp_method = 'conserve_great_circle' +/ + +&nam_sfcperts +/ + +&nam_sppperts +/ + +&nam_stochy + shum = -999.0 + shum_lscale = 150000 + shum_tau = 21600 + shumint = 3600 + skeb = -999.0 + skeb_lscale = 150000 + skeb_tau = 21600 + skeb_vdof = 10 + skebint = 3600 + sppt = -999.0 + sppt_lscale = 150000 + sppt_tau = 21600 + spptint = 3600 + use_zmtnblck = .false. +/ + +&namsfc + fabsl = 99999 + faisl = 99999 + faiss = 99999 + fnacna = '' + fnaisc = '../fix_am/CFSR.SEAICE.1982.2012.monthly.clim.grb' + fnglac = '../fix_am/global_glacier.2x2.grb' + fnmskh = '../fix_am/seaice_newland.grb' + fnmxic = '../fix_am/global_maxice.2x2.grb' + fnsmcc = '../fix_am/global_soilmgldas.t126.384.190.grb' + fnsnoa = '' + fnsnoc = '../fix_am/global_snoclim.1.875.grb' + fntsfa = '' + fntsfc = '../fix_am/RTGSST.1982.2012.monthly.clim.grb' + fnzorc = 'igbp' + fsicl = 99999 + fsics = 99999 + fslpl = 99999 + fsmcl = 99999, 99999, 99999 + fsnol = 99999 + fsnos = 99999 + fsotl = 99999 + ftsfl = 99999 + ftsfs = 90 + fvetl = 99999 + fvmnl = 99999 + fvmxl = 99999 + ldebug = .true. +/ + +&surf_map_nml + cd2 = -1 + cd4 = 0.12 + max_slope = 0.4 + n_del2_strong = 0 + n_del2_weak = 2 + n_del4 = 1 + peak_fac = 1.0 + zero_ocean = .false. +/ diff --git a/physics/docs/pdftxt/suite_FV3_GFS_v16beta.xml.txt b/physics/docs/pdftxt/RE6/suite_FV3_GFS_v16.xml similarity index 93% rename from physics/docs/pdftxt/suite_FV3_GFS_v16beta.xml.txt rename to physics/docs/pdftxt/RE6/suite_FV3_GFS_v16.xml index fb14b32b5..122b937e1 100644 --- a/physics/docs/pdftxt/suite_FV3_GFS_v16beta.xml.txt +++ b/physics/docs/pdftxt/RE6/suite_FV3_GFS_v16.xml @@ -1,10 +1,6 @@ -/** -\page suite_FV3_GFS_v16beta_xml suite_FV3_GFS_v16beta.xml - -\code - + @@ -23,7 +19,8 @@ GFS_suite_interstitial_rad_reset GFS_rrtmg_pre - rrtmg_sw_pre + GFS_radiation_surface + rad_sw_pre rrtmg_sw rrtmg_sw_post rrtmg_lw_pre @@ -68,13 +65,12 @@ cires_ugwp cires_ugwp_post GFS_GWD_generic_post - rayleigh_damp GFS_suite_stateout_update ozphys_2015 h2ophys - GFS_DCNV_generic_pre get_phi_fv3 GFS_suite_interstitial_3 + GFS_DCNV_generic_pre samfdeepcnv GFS_DCNV_generic_post GFS_SCNV_generic_pre @@ -86,6 +82,7 @@ gfdl_cloud_microphys GFS_MP_generic_post maximum_hourly_diagnostics + phys_tend @@ -95,6 +92,3 @@ -\endcode - -*/ diff --git a/physics/docs/pdftxt/suite_FV3_GFS_v15p2.xml.txt b/physics/docs/pdftxt/RE6/suite_FV3_GFS_v17_p8.xml similarity index 81% rename from physics/docs/pdftxt/suite_FV3_GFS_v15p2.xml.txt rename to physics/docs/pdftxt/RE6/suite_FV3_GFS_v17_p8.xml index 2ec63092e..c4b295a6d 100644 --- a/physics/docs/pdftxt/suite_FV3_GFS_v15p2.xml.txt +++ b/physics/docs/pdftxt/RE6/suite_FV3_GFS_v17_p8.xml @@ -1,16 +1,7 @@ -/** -\page FV3_GFS_v15p2_sdf GFS_v15p2 Suite Definition File - -\code - + - - - fv_sat_adj - - GFS_time_vary_pre @@ -23,7 +14,8 @@ GFS_suite_interstitial_rad_reset GFS_rrtmg_pre - rrtmg_sw_pre + GFS_radiation_surface + rad_sw_pre rrtmg_sw rrtmg_sw_post rrtmg_lw_pre @@ -51,7 +43,7 @@ sfc_nst_pre sfc_nst sfc_nst_post - lsm_noah + noahmpdrv sfc_sice GFS_surface_loop_control_part2 @@ -62,13 +54,12 @@ sfc_diag_post GFS_surface_generic_post GFS_PBL_generic_pre - hedmf + satmedmfvdifq GFS_PBL_generic_post GFS_GWD_generic_pre - cires_ugwp - cires_ugwp_post + unified_ugwp + unified_ugwp_post GFS_GWD_generic_post - rayleigh_damp GFS_suite_stateout_update ozphys_2015 h2ophys @@ -83,10 +74,16 @@ GFS_suite_interstitial_4 cnvc90 GFS_MP_generic_pre - gfdl_cloud_microphys - GFS_MP_generic_post - maximum_hourly_diagnostics - + mp_thompson_pre + + + mp_thompson + + + mp_thompson_post + GFS_MP_generic_post + maximum_hourly_diagnostics + @@ -96,7 +93,3 @@ - -\endcode - -*/ diff --git a/physics/docs/pdftxt/RE6/suite_FV3_HRRR.xml b/physics/docs/pdftxt/RE6/suite_FV3_HRRR.xml new file mode 100644 index 000000000..445f3a37b --- /dev/null +++ b/physics/docs/pdftxt/RE6/suite_FV3_HRRR.xml @@ -0,0 +1,81 @@ + + + + + + GFS_time_vary_pre + GFS_rrtmg_setup + GFS_rad_time_vary + GFS_phys_time_vary + + + + + GFS_suite_interstitial_rad_reset + sgscloud_radpre + GFS_rrtmg_pre + GFS_radiation_surface + rad_sw_pre + rrtmg_sw + rrtmg_sw_post + rrtmg_lw_pre + rrtmg_lw + sgscloud_radpost + rrtmg_lw_post + GFS_rrtmg_post + + + + + GFS_suite_interstitial_phys_reset + GFS_suite_stateout_reset + get_prs_fv3 + GFS_suite_interstitial_1 + GFS_surface_generic_pre + GFS_surface_composites_pre + dcyc2t3 + GFS_surface_composites_inter + GFS_suite_interstitial_2 + + + + mynnsfc_wrapper + GFS_surface_loop_control_part1 + sfc_nst_pre + sfc_nst + sfc_nst_post + lsm_ruc + GFS_surface_loop_control_part2 + + + + GFS_surface_composites_post + sfc_diag + sfc_diag_post + GFS_surface_generic_post + mynnedmf_wrapper + GFS_GWD_generic_pre + drag_suite + GFS_GWD_generic_post + GFS_suite_stateout_update + ozphys_2015 + h2ophys + get_phi_fv3 + GFS_suite_interstitial_3 + GFS_suite_interstitial_4 + GFS_MP_generic_pre + mp_thompson_pre + mp_thompson + mp_thompson_post + GFS_MP_generic_post + maximum_hourly_diagnostics + phys_tend + + + + + GFS_stochastics + + + + diff --git a/physics/docs/pdftxt/suite_FV3_GFS_v15p2_no_nsst.xml.txt b/physics/docs/pdftxt/RE6/suite_FV3_RAP.xml similarity index 73% rename from physics/docs/pdftxt/suite_FV3_GFS_v15p2_no_nsst.xml.txt rename to physics/docs/pdftxt/RE6/suite_FV3_RAP.xml index 44f8e8296..f03c1a1e8 100644 --- a/physics/docs/pdftxt/suite_FV3_GFS_v15p2_no_nsst.xml.txt +++ b/physics/docs/pdftxt/RE6/suite_FV3_RAP.xml @@ -1,99 +1,90 @@ -/** -\page suite_FV3_GFS_v15p2_no_nsst_xml suite_FV3_GFS_v15p2_no_nsst.xml - -\code - - - - - - - fv_sat_adj - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - - - - - GFS_suite_interstitial_rad_reset - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - GFS_surface_generic_pre - GFS_surface_composites_pre - dcyc2t3 - GFS_surface_composites_inter - GFS_suite_interstitial_2 - - - - sfc_diff - GFS_surface_loop_control_part1 - sfc_ocean - lsm_noah - sfc_sice - GFS_surface_loop_control_part2 - - - - GFS_surface_composites_post - sfc_diag - sfc_diag_post - GFS_surface_generic_post - GFS_PBL_generic_pre - hedmf - GFS_PBL_generic_post - GFS_GWD_generic_pre - cires_ugwp - cires_ugwp_post - GFS_GWD_generic_post - rayleigh_damp - GFS_suite_stateout_update - ozphys_2015 - h2ophys - get_phi_fv3 - GFS_suite_interstitial_3 - GFS_DCNV_generic_pre - samfdeepcnv - GFS_DCNV_generic_post - GFS_SCNV_generic_pre - samfshalcnv - GFS_SCNV_generic_post - GFS_suite_interstitial_4 - cnvc90 - GFS_MP_generic_pre - gfdl_cloud_microphys - GFS_MP_generic_post - maximum_hourly_diagnostics - - - - - GFS_stochastics - - - - -\endcode - -*/ - + + + + + + + GFS_time_vary_pre + GFS_rrtmg_setup + GFS_rad_time_vary + GFS_phys_time_vary + + + + + GFS_suite_interstitial_rad_reset + sgscloud_radpre + GFS_rrtmg_pre + GFS_radiation_surface + rad_sw_pre + rrtmg_sw + rrtmg_sw_post + rrtmg_lw_pre + rrtmg_lw + sgscloud_radpost + rrtmg_lw_post + GFS_rrtmg_post + + + + + GFS_suite_interstitial_phys_reset + GFS_suite_stateout_reset + get_prs_fv3 + GFS_suite_interstitial_1 + GFS_surface_generic_pre + GFS_surface_composites_pre + dcyc2t3 + GFS_surface_composites_inter + GFS_suite_interstitial_2 + + + + mynnsfc_wrapper + GFS_surface_loop_control_part1 + sfc_nst_pre + sfc_nst + sfc_nst_post + lsm_ruc + GFS_surface_loop_control_part2 + + + + GFS_surface_composites_post + sfc_diag + sfc_diag_post + GFS_surface_generic_post + mynnedmf_wrapper + GFS_GWD_generic_pre + drag_suite + GFS_GWD_generic_post + GFS_suite_stateout_update + ozphys_2015 + h2ophys + get_phi_fv3 + GFS_suite_interstitial_3 + GFS_DCNV_generic_pre + cu_gf_driver_pre + cu_gf_driver + GFS_DCNV_generic_post + GFS_SCNV_generic_pre + GFS_SCNV_generic_post + GFS_suite_interstitial_4 + cnvc90 + GFS_MP_generic_pre + mp_thompson_pre + mp_thompson + mp_thompson_post + GFS_MP_generic_post + cu_gf_driver_post + maximum_hourly_diagnostics + phys_tend + + + + + GFS_stochastics + + + + diff --git a/physics/docs/pdftxt/suite_FV3_RRFS_v1beta.xml.txt b/physics/docs/pdftxt/RE6/suite_FV3_RRFS_v1beta.xml similarity index 92% rename from physics/docs/pdftxt/suite_FV3_RRFS_v1beta.xml.txt rename to physics/docs/pdftxt/RE6/suite_FV3_RRFS_v1beta.xml index 681e9d21c..97228c0a6 100644 --- a/physics/docs/pdftxt/suite_FV3_RRFS_v1beta.xml.txt +++ b/physics/docs/pdftxt/RE6/suite_FV3_RRFS_v1beta.xml @@ -1,10 +1,6 @@ -/** -\page FV3_RRFS_v1beta_sdf RRFS_v1beta Suite Definition File - -\code - + @@ -19,7 +15,8 @@ GFS_suite_interstitial_rad_reset sgscloud_radpre GFS_rrtmg_pre - rrtmg_sw_pre + GFS_radiation_surface + rad_sw_pre rrtmg_sw rrtmg_sw_post rrtmg_lw_pre @@ -63,7 +60,6 @@ cires_ugwp cires_ugwp_post GFS_GWD_generic_post - rayleigh_damp GFS_suite_stateout_update ozphys_2015 h2ophys @@ -76,6 +72,7 @@ mp_thompson_post GFS_MP_generic_post maximum_hourly_diagnostics + phys_tend @@ -85,7 +82,3 @@ - -\endcode - -*/ diff --git a/physics/docs/pdftxt/RE6/suite_FV3_WoFS_v0.xml b/physics/docs/pdftxt/RE6/suite_FV3_WoFS_v0.xml new file mode 100644 index 000000000..1a34ba1a1 --- /dev/null +++ b/physics/docs/pdftxt/RE6/suite_FV3_WoFS_v0.xml @@ -0,0 +1,80 @@ + + + + + + + GFS_time_vary_pre + GFS_rrtmg_setup + GFS_rad_time_vary + GFS_phys_time_vary + + + + + GFS_suite_interstitial_rad_reset + sgscloud_radpre + GFS_rrtmg_pre + GFS_radiation_surface + rad_sw_pre + rrtmg_sw + rrtmg_sw_post + rrtmg_lw_pre + rrtmg_lw + sgscloud_radpost + rrtmg_lw_post + GFS_rrtmg_post + + + + + GFS_suite_interstitial_phys_reset + GFS_suite_stateout_reset + get_prs_fv3 + GFS_suite_interstitial_1 + GFS_surface_generic_pre + GFS_surface_composites_pre + dcyc2t3 + GFS_surface_composites_inter + GFS_suite_interstitial_2 + + + + mynnsfc_wrapper + GFS_surface_loop_control_part1 + sfc_nst_pre + sfc_nst + sfc_nst_post + lsm_noah + sfc_sice + GFS_surface_loop_control_part2 + + + + GFS_surface_composites_post + sfc_diag + sfc_diag_post + GFS_surface_generic_post + mynnedmf_wrapper + GFS_GWD_generic_pre + cires_ugwp + cires_ugwp_post + GFS_GWD_generic_post + GFS_suite_stateout_update + ozphys_2015 + h2ophys + get_phi_fv3 + GFS_MP_generic_pre + mp_nssl + GFS_MP_generic_post + maximum_hourly_diagnostics + phys_tend + + + + + GFS_stochastics + + + + diff --git a/physics/docs/pdftxt/RRFS_SGSCLOUD.txt b/physics/docs/pdftxt/RRFS_SGSCLOUD.txt index 2f199c6ce..a8c1f11e7 100644 --- a/physics/docs/pdftxt/RRFS_SGSCLOUD.txt +++ b/physics/docs/pdftxt/RRFS_SGSCLOUD.txt @@ -1,22 +1,25 @@ /** -\page SGSCLOUD_page Subgrid-scale Cloud Pre-radiation Interstitial +\page SGSCLOUD_page Subgrid-scale Cloud Interstitial \section rrfs_sgscloud_descrip Description This interstitial module adds the subgrid-scale cloud information to the resolved-scale (microphysics) clouds. This procedure is required when using microphysics schemes that only produce clouds in fully saturated grid cells, like the Thompson microphysics scheme, and when using boundary layer and convection schemes that produce subgrid-scale cloud information (mixing ratio and cloud fraction). This allows the subgrid-scale cloud information to be assembled into the rest of the cloud information prior to calling the radiation schemes. \section intra_rrfssgs Intraphysics Communication - sgscloud_radpre_run(): \ref arg_table_sgscloud_radpre_run +- sgscloud_radpost_run():\ref arg_table_sgscloud_radpost_run \section gen_rrfssgs SGSCLOUD Pre-radiation Interstitial General Algorithm The order of procedures is outlined below: \n 1) Back up the original qc and qi in "save arrays" qc_save and qi_save. \n 2) Partition the condensate from the convection scheme into liquid and ice. -\n 3) Use Xu and Randall (1996) \cite xu_and_randall_1996 cloud fraction for the convection scheme subgrid clouds. Note that the MYNN-EDMF PBL scheme subgrid clouds input into this scheme are already partitioned into qc and qi and already have assigned cloud fractions. +\n 3) Use Xu and Randall (1996) \cite xu_and_randall_1996 +cloud fraction for the convection scheme subgrid clouds. Note that the MYNN-EDMF PBL scheme subgrid clouds input into +this scheme are already partitioned into qc and qi and already have assigned cloud fractions. \n 4) Add the subgrid cloud mixing ratio and cloud fraction to the original (resolved-scale) qc, qi and cloud fraction coming from the microphysics scheme. Note this information is only added to grid cells when resolved-scale clouds are below a very small threshold value. \n 5) Recompute the diagnostic high, mid, low, total and boundary layer clouds to be consistent with the clouds seen by the radiation scheme. -To provide a cloud fraction at t=0 (before the boundary layer or convection schemes are called), Xu and Randall (1996) \cite xu_and_randall_1996 cloud fraction is used. After the radiation schemes are called, module_SGSCloud_RadPost.F90 is called to restore the original qc and qi from qc_save and qi_save. +To provide a cloud fraction at t=0 (before the boundary layer or convection schemes are called), Xu and Randall (1996) \cite xu_and_randall_1996 cloud fraction is used. After the radiation schemes are called, sgscloud_radpost_run() is called to restore the original qc and qi from qc_save and qi_save. diff --git a/physics/docs/pdftxt/RRFS_v1alpha_suite.txt b/physics/docs/pdftxt/RRFS_v1alpha_suite.txt deleted file mode 100644 index a3051a88b..000000000 --- a/physics/docs/pdftxt/RRFS_v1alpha_suite.txt +++ /dev/null @@ -1,210 +0,0 @@ -/** -\page RRFS_v1alpha_page RRFS_v1alpha Suite - -\section RRFS_v1alpha_suite_overview Overview - -Suite RRFS_v1alpha is one of the supported suites for use in the UFS Short-Range Weather Application -(UFS SRW App). This suite is most applicable for runs at 3-km resolution since it does not parameterize -deep convection. - -The RRFS_v1alpha physics suite uses the parameterizations in the following order: - - \ref SGSCLOUD_page - - \ref GFS_RRTMG - - \ref GFS_SFCLYR - - \ref GFS_NSST - - \ref NoahMP - - \ref MYNNEDMF - - \ref GFS_UGWP_v0 - - \ref GFS_RAYLEIGH - - \ref GFS_OZPHYS - - \ref GFS_H2OPHYS - - \ref THOMPSON - -\section sdf_rrfssuite Suite Definition File -\code - - - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - - - - - GFS_suite_interstitial_rad_reset - sgscloud_radpre - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - sgscloud_radpost - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - GFS_surface_generic_pre - GFS_surface_composites_pre - dcyc2t3 - GFS_surface_composites_inter - GFS_suite_interstitial_2 - - - - sfc_diff - GFS_surface_loop_control_part1 - sfc_nst_pre - sfc_nst - sfc_nst_post - noahmpdrv - sfc_sice - GFS_surface_loop_control_part2 - - - - GFS_surface_composites_post - sfc_diag - sfc_diag_post - GFS_surface_generic_post - mynnedmf_wrapper - GFS_GWD_generic_pre - cires_ugwp - cires_ugwp_post - GFS_GWD_generic_post - rayleigh_damp - GFS_suite_stateout_update - ozphys_2015 - h2ophys - get_phi_fv3 - GFS_suite_interstitial_3 - GFS_suite_interstitial_4 - GFS_MP_generic_pre - mp_thompson_pre - mp_thompson - mp_thompson_post - GFS_MP_generic_post - maximum_hourly_diagnostics - - - - - GFS_stochastics - - - - -\encode - -\section rrfs_nml_option Namelist -\code -&gfs_physics_nml - bl_mynn_edmf = 1 - bl_mynn_edmf_mom = 1 - bl_mynn_tkeadvect = .true. - cal_pre = .false. - cdmbgwd = 3.5,0.25 - cnvcld = .false. - cnvgwd = .false. - cplflx = .false. - debug = .false. - do_deep = .false. - do_mynnedmf = .true. - do_mynnsfclay = .false. - do_sfcperts = .false. - do_shum = .false. - do_skeb = .false. - do_sppt = .false. - dspheat = .true. - effr_in = .true. - fhcyc = 0.0 - fhlwr = 1200.0 - fhswr = 1200.0 - fhzero = 1.0 - h2o_phys = .true. - hybedmf = .false. - iaer = 111 - ialb = 1 - iau_delthrs = 6 - iau_inc_files = '' - iaufhrs = 30 - icloud_bl = 1 - ico2 = 2 - iems = 1 - imfdeepcnv = -1 - imfshalcnv = -1 - imp_physics = 8 - iopt_alb = 2 - iopt_btr = 1 - iopt_crs = 1 - iopt_dveg = 2 - iopt_frz = 1 - iopt_inf = 1 - iopt_rad = 1 - iopt_run = 1 - iopt_sfc = 1 - iopt_snf = 4 - iopt_stc = 1 - iopt_tbot = 2 - isol = 2 - isot = 1 - isubc_lw = 2 - isubc_sw = 2 - ivegsrc = 1 - ldiag3d = .false. - lheatstrg = .false. - lradar = .true. - lsm = 2 - lsoil_lsm = 4 - ltaerosol = .true. - lwhtr = .true. - ncld = 5 - nsradar_reset = 3600 - nst_anl = .true. - nstf_name = 2,1,0,0,0 - oz_phys = .false. - oz_phys_2015 = .true. - pdfcld = .false. - pre_rad = .false. - prslrd0 = 0.0 - random_clds = .false. - redrag = .true. - satmedmf = .false. - shal_cnv = .false. - swhtr = .true. - trans_trac = .true. - ttendlim = -999 - use_ufo = .true. - -/ - -&cires_ugwp_nml - knob_ugwp_azdir = 2,4,4,4 - knob_ugwp_doaxyz = 1 - knob_ugwp_doheat = 1 - knob_ugwp_dokdis = 1 - knob_ugwp_effac = 1,1,1,1 - knob_ugwp_ndx4lh = 1 - knob_ugwp_solver = 2 - knob_ugwp_source = 1,1,0,0 - knob_ugwp_stoch = 0,0,0,0 - knob_ugwp_version = 0 - knob_ugwp_wvspec = 1,25,25,25 - launch_level = 25 - -/ -\endcode - - -*/ diff --git a/physics/docs/pdftxt/RRFS_v1beta_suite.txt b/physics/docs/pdftxt/RRFS_v1beta_suite.txt new file mode 100644 index 000000000..df84d10d0 --- /dev/null +++ b/physics/docs/pdftxt/RRFS_v1beta_suite.txt @@ -0,0 +1,36 @@ +/** +\page RRFS_v1beta_page RRFS_v1beta Suite + +\section RRFS_v1beta_suite_overview Overview + +The RRFS_v1beta suite is the primary suite target for the upcoming operational implementation of + the Rapid Refresh Forecast System (RRFS), which is used in the UFS SRW App. +This suite is most applicable for runs at 3-km resolution since it does not parameterize +deep convection. This suite is available for use with the UFS SRW App and with the +CCPP SCM. + +The RRFS_v1beta suite uses the parameterizations in the following order: + - \ref SGSCLOUD_page + - \ref GFS_RRTMG + - \ref SFC_MYNNSFL + - \ref GFS_NSST + - \ref NoahMP + - \ref GFS_SFCSICE + - \ref MYNNEDMF + - \ref GFS_UGWP_v0 + - \ref GFS_OZPHYS + - \ref GFS_H2OPHYS + - \ref THOMPSON + +\section sdf_rrfsv1bsuite Suite Definition File +\include suite_FV3_RRFS_v1beta.xml + +\section rrfs_nml_option Namelist +- General physics options +\snippet FV3_RRFS_v1beta_input.nml GFS_PHYSICS_NML +- \ref GFS_UGWP_v0 related options +\snippet FV3_RRFS_v1beta_input.nml CIRES_UGWP_NML + + + +*/ diff --git a/physics/docs/pdftxt/RUCLSM.txt b/physics/docs/pdftxt/RUCLSM.txt index bf45ff4b3..00b064e5f 100644 --- a/physics/docs/pdftxt/RUCLSM.txt +++ b/physics/docs/pdftxt/RUCLSM.txt @@ -29,14 +29,20 @@ Luo et al. 2003 \cite Luo_2003 ). The RUC LSM was also tested during the Snow Mo with emphasis on snow parameterizations for both grassland and forest locations in different parts of the world (Etchevers et al. 2002, 2004 \cite Etchevers_2002 \cite Etchevers_2004; Essery et al. 2009 \cite Essery_2009 ; Rutter et al. 2009 \cite Rutter_2009 , Krinner et al. 2018 \cite Krinner_2018 ). The analysis of RUC LSM performance over 10 reference sites in ESM-SnowMIP rated it on the 5th place -among the 26 participating models. +among the 26 participating models. The results were published in Menard et al.(2021) \cite Menard_2021 and Essery et al. (2020) \cite essery_et_al_2020. +RUC LSM received high rankings in ESM-SnowMIP experiement in terms of multi-year snow cover and surface temperature simulations +for several sites located in different parts of the world (Menard et al.2021 \cite Menard_2021). -In global application, RUC LSM is implemented in the Global Systems Division (GSD) physics suite for testing in the NOAA Next-Generation Global -Prediction System (NGGPS)- FV3-GSD suite. To specify surface characteristics, RUC LSM uses the Land Data Sets provided by NCEP for Global -Modeling Systems (see Figure 2 in \ref GFS_NOAH ) +RUC LSM is used in several weather prediction models around the world (Austria, New Zealand, Switzerland, RAP/HRRR in US). Recent RUC LSM implementation in the high-resolution model in the Swiss Alps led to some small modifications and adjustments to the snow model. +These adjustments will be available in the next CCPP public release. + +Coupling of the RUC LSM to physically-based stochastic snow model (He et al.(2021) \cite he_et_al_2021) will be implemented in the next public release. + +The sensitivity of surface fluxes and turbine-height winds to the RUC LSM parameters has been explored by Geng Xia, NREL. This study +will determine the uncertainty range for the selected parameters in the RUC LSM and will be described in the journal paper. ## RUC LSM characteristics that differ from NOAH LSM: -\image html ruc_lsm_veg_soil.png "Figure 1. RUC LSM Vegetation and Soil Model (Courtesy of T.G. Smirnova) " width=10cm +\image html ruc_lsm_veg_soil.png "Figure 1. RUC LSM Vegetation and Soil Model (Courtesy of T.G. Smirnova) " width=900 - \b Implicit \b solution of energy and moisture budgets in the layer spanning the ground surface - \b 9 \b soil \b levels with high vertical resolution near surface RUC LSM has more levels in oil than \ref GFS_NOAH model with higher resolution near the interface with the atmosphere @@ -56,7 +62,7 @@ in the computation of such parameters as roughness length, emissivity, soil poro roughness between the mosaic and dominant category presented on figure 2 is positive from contribution of the forests, which helped to reduce high biases of surface wind speeds in these regions. Roughness lenghth has also seasonal variability in the cropland regions, which again helped to improve the wind forecasts during the warm season. -\image html ruc_lsm_heterogeneity.png "Figure 2: sub-grid scale heterogeneity of surface parameters in RUC LSM (Courtesy of T.G. Smirnova)" width=10cm +\image html ruc_lsm_heterogeneity.png "Figure 2: sub-grid scale heterogeneity of surface parameters in RUC LSM (Courtesy of T.G. Smirnova)" width=900 - New: simple irrigation in the cropland area - New: water/snow intercepted by canopy as function of vegetation fraction and leaf area index (LAI) @@ -70,7 +76,7 @@ Snow forms additional two layers on top of soil in RUC LSM - Seperate treatment of energy and moisture budgets for snow-covered and snow-free portions of the grid cell - Aggregate solutions at the end of time step - Reduced cold bias for areas with thin snow -\image html ruc_lsm_mosaic.png "Figure 3: recent development: mosaic approach for patchy snow (Courtesy of T.G. Smirnova) " width=10cm +\image html ruc_lsm_mosaic.png "Figure 3: recent development: mosaic approach for patchy snow (Courtesy of T.G. Smirnova) " width=900 - Iterative snow melting algorithm - Density of snow on the ground - a function of compaction parameter and snow depth and temperature - Snow albedo - a function of temperature and snow fraction @@ -82,7 +88,7 @@ Snow forms additional two layers on top of soil in RUC LSM \rho_{fr}=\rho_{sn}*\alpha_{sn}+\rho_{gr}*\alpha_{gr}+\rho_{ice}*\alpha_{ice} \f] - The depth of new snow is defined from its liquid equivalent and \f$\rho_{fr}\f$ -\image html ruc_lsm_frozen_precip.png "Figure 4: HRRR 23-h forecasts of snow accumulation, valid 08 UTC, 29 Dec 2015 (Courtesy of T.G. Smirnova)" width=10cm +\image html ruc_lsm_frozen_precip.png "Figure 4: HRRR 23-h forecasts of snow accumulation, valid 08 UTC, 29 Dec 2015 (Courtesy of T.G. Smirnova)" width=900 snow accumulation with variable density is provided as an additional product in the model guidance. Figure 4 shows one example of this product from the 23-h HRRR forecast for snowstorm on 29 Dec 2015. This product is in the middle panel. The panel on the left uses traditional 10:1 ratio, @@ -91,10 +97,25 @@ snow accumulation, and high ammounts of snow in the product with 10:1 ratio are precipitation had a high content of sleet. There is even larger improvement in the Chicago area, where observed and model precipitation were almost totally sleet. +\section v6_updates_ruc Physics Updates +\version CCPP V6.0.0 +- Initialization of land and ice emissivity with consideration of partial snow cover +- Initialization of land and ice albedo with consideration of partial snow cover +- Initialization of water vapor mixing ratio over land and ice +- Changes in the computation of a flag for sea ice: it is set to true only if \p flag_cice = .false. (uncoupled sea ice model) +- Introduced separate variables for sea ice, for example: \p showfallac is replaced with \p snowfallac_ice +- Added accomodation of fractional surface grid (land and ice fractions are possible within the grid cell) +- Introduced solar angle dependence of albedo for snow-free land +- Introduced a SPP option for stochastic perturbations for emissivity, albedo and vegetation fraction +- Bug fix in hydraulic conductivity +- Based on RRFS testing, the coefficient in the soil resistance formulation (Sakaguchi and Zeng (2009) \cite sakaguchi_and_zeng_2009) +was increased from 0.5 to 0.7 to increase soil resistance to evaporation + + \section intra_ruclsm Intraphysics Communication -\ref arg_table_lsm_ruc_run +- \ref arg_table_lsm_ruc_run \section gen_ruclsm General Algorithm -\ref gen_lsmruc +- module_sf_ruclsm::lsmruc */ diff --git a/physics/docs/pdftxt/THOMPSON.txt b/physics/docs/pdftxt/THOMPSON.txt index 8f16ce55b..57819f368 100644 --- a/physics/docs/pdftxt/THOMPSON.txt +++ b/physics/docs/pdftxt/THOMPSON.txt @@ -1,20 +1,19 @@ /** -\page THOMPSON Thompson Aerosol-Aware Microphysics Scheme +\page THOMPSON Thompson Aerosol-Aware Cloud Microphysics Scheme \section thompson_descrp Description - -The RAP/HRRR microphysics implementation represents the most aggressive attempt to include explicit prediction of -cloud and precipitation microphysical processes in the NCEP operational forecast model suite. The RAP and HRRR are -important guidance to NWS aviation forecasts, and any microphysics improvements are aimed at least in part, to improve -that guidance. The scheme is particularly beneficial for aircraft icing forecasts. - The scheme computes sources, sinks, and conversions for the mixing ratios of cloud water, rainwater, cloud ice, snow, and graupel. Number concentration for cloud ice (particles per cubic meter) is also forecast, based on statistical relationships -of number concentration, density, and ice mass from recent observational studies. Since April 2014 (WRFv3.6), this is also the "aerosol-aware" scheme as described in -Thompson and Eidhammer (2014) \cite Thompson_2014 . +of number concentration, density, and ice mass from recent observational studies. Since April 2014 (WRFv3.6), this is also the "aerosol-aware" scheme as described in Thompson and Eidhammer (2014) \cite Thompson_2014 . + +The original RAP/HRRR microphysics implementation represents the most aggressive attempt to include explicit prediction of +cloud and precipitation microphysical processes in the NCEP operational forecast model suite. The RAP and HRRR are +important guidance to NWS aviation forecasts, and any microphysics improvements are aimed at least in part, to improve +that guidance. The scheme is particularly beneficial for aircraft icing forecasts. Recently, this scheme is now being tested +with a GFS_v17 prototype: the GFS_v17_p8 suite at Environmental Modeling Center (EMC) as a candidate for the next operational implementation. The microphysical processes accounted for are shown in the graphic below: -\image html gsd_thompson.png "Figure 1: Complex Microphysics Model in the RAP" width=10cm +\image html gsd_thompson.png "Figure 1: Complex Microphysics Model in the RAP" width=500 Descriptions of these preocesses follow: - \b Deposition: Diffusional growth of ice particles under conditions of vapor supersaturation with respect to ice. @@ -71,12 +70,24 @@ for the model to provide useful guidance for aircraft icing forecasts - Can account for cloud phase changes and provides a sound physical basis for diagnosing precipitation type reaching the ground +\section v6_enh_thompson CCPP Physics Updates +\version CCPP v6.0.0 +Three mechanisms are available improve the stability of the scheme for weather forecast applications: +\a inner \a loop, \a subcycle, and \a semi-Lagrangian \a sedimentation \a of \a rain \a and \a graupel. +The inner loop and the subcycle are similar in that the physics time step is subdivided and the scheme +is activated more often than others in the physics suite. However, they differ in implementation. +With the inner loop method, namelist variable \b dt_inner is used to set the short step. +Conversely, the subcycle method is controlled by CCPP Framework through the "subcycle loop" in the suite definition file. +The two methods should be used exclusively. The Semi-Lagrangian sedimentation of rain and graupel (based on Juang and Hong 2010 \cite Henry_Juang_2010 ) +increases numerical stability by applying the subtime step only to sedimentation computation. +Two namelist variables control the usage of the semi-Lagrangian sedimentation, \b sedi_semi and \b decfl. +Sedi-semi is set to ‘true’ to activate the method. Decfl is a parameter that needs to avoid deformation of the arriving grids, currently, "10". \section intra_thompson Intraphysics Communication -\ref arg_table_mp_thompson_run +- \ref arg_table_mp_thompson_run -\section g_thompson General Algorithm +\section gal_thompson General Algorithm - \ref gen_thompson_init - \ref gen_thompson_hrrr - \ref gen_mpgtdriver diff --git a/physics/docs/pdftxt/WoFS_v0_suite.txt b/physics/docs/pdftxt/WoFS_v0_suite.txt new file mode 100644 index 000000000..1fee972f2 --- /dev/null +++ b/physics/docs/pdftxt/WoFS_v0_suite.txt @@ -0,0 +1,33 @@ +/** +\page WoFS_v0_page WoFS_v0 Suite + +\section wofs_v0_suite_overview Overview + +The WoFS_v0 suite is targeted for use in the upcoming operational implementation +of the NOAA's Warn-on-Forecast System (WoFS). This suite is available for use with the UFS SRW App and with +the CCPP SCM. This suite is most applicable for runs at 3-km resolution since it does not parameterize +deep convection. + +The WoFS suite uses the parameterizations in the following order: + - \ref SGSCLOUD_page + - \ref GFS_RRTMG + - \ref SFC_MYNNSFL + - \ref GFS_NSST + - \ref GFS_NOAH + - \ref GFS_SFCSICE + - \ref MYNNEDMF + - \ref GFS_UGWP_v0 + - \ref GFS_OZPHYS + - \ref GFS_H2OPHYS + - \ref NSSLMICRO_page + +\section sdf_rrfsv1nssl_suite Suite Definition File +\include suite_FV3_WoFS_v0.xml + +\section rrfsv1nssl_nml_option Namelist +- General physics options +\snippet FV3_WoFS_v0_input.nml GFS_PHYSICS_NML +- \ref GFS_UGWP_v0 related options +\snippet FV3_WoFS_v0_input.nml CIRES_UGWP_NML + +*/ diff --git a/physics/docs/pdftxt/all_shemes_list.txt b/physics/docs/pdftxt/all_shemes_list.txt index 03b2ccd9b..72f1d4652 100644 --- a/physics/docs/pdftxt/all_shemes_list.txt +++ b/physics/docs/pdftxt/all_shemes_list.txt @@ -1,80 +1,59 @@ /** -\page allscheme_page Parameterizations and Suites Overview +\page allscheme_page Overview of Schemes and Suites \section allscheme_overview Physical Parameterizations -In the CCPP, each parameterization is in its own modern Fortran module (i.e., CCPP-compliant; see rules for scheme to considered CCPP-compliant at - CCPP-Compliant Physics Parameterizations ), -which facilitates model development and code maintenance. Additionally, we are listing any pre- and post- interstitials that must accompany the scheme. While some individual parameterization can be invoked for the SCM, most host models will assemble the parameterizations in suites. +In the CCPP, each parameterization is in its own modern Fortran module (see rules for a scheme to be considered CCPP-compliant at + CCPP-Compliant Physics Parameterizations ), +which facilitates model development and code maintenance. While some individual parameterization can be invoked for the SCM, most host models will assemble the parameterizations in suites. \b Radiation - \subpage GFS_RRTMG - + CCPP-compliant modules: rrtmg_sw_pre / rrtmg_sw / rrtmg_sw_post / rrtmg_lw_pre / rrtmg_lw / rrtmg_lw_post / dcyc2t3 - - \subpage SGSCLOUD_page - + CCPP-compliant module: sgscloud_radpre \b PBL \b and \b Turbulence - - \subpage GFS_HEDMF - + CCPP-compliant module: \ref hedmf - \subpage GFS_SATMEDMFVDIFQ - + CCPP-compliant module: \ref satmedmfvdifq - - \subpage MYNNEDMF - + CCPP-compliant module: mynnedmf_wrapper + - \subpage MYNNEDMF with \subpage SGSCLOUD_page \b Land \b Surface \b Model - \subpage GFS_NOAH - + CCPP-compliant module: lsm_noah - \subpage RUCLSM - + CCPP-compliant module: lsm_ruc - \subpage NoahMP - + CCPP-compliant module: \ref noahmpdrv \b Cumulus \b Parameterizations - \subpage GFS_SAMFdeep - + CCPP-compliant module: \ref samfdeepcnv + - \ref ca_page - \subpage GFS_SAMFshal - + CCPP-compliant module: \ref samfshalcnv - - \subpage CSAW_scheme - + CCPP-compliant modules: cs_conv_pre / cs_conv / cs_conv_post / cs_conv_aw_adj - \subpage CU_GF - + CCPP-compliant modules: \ref cu_gf_driver_pre / cu_gf_driver \b Microphysics - \subpage GFDL_cloud - + CCPP-compliant modules: fv_sat_adj / gfdl_cloud_microphys - - \subpage CPT_MG3 - + CCPP-compliant modules: \ref m_micro_pre / m_micro / \ref m_micro_post - \subpage THOMPSON - + CCPP-compliant modules: mp_thompson_pre / mp_thompson / mp_thompson_post + - \subpage NSSLMICRO_page \b Ozone \b Photochemical \b Production \b and \b Loss - \subpage GFS_OZPHYS - + CCPP-compliant module: ozphys_2015 \b Water \b Vapor \b Photochemical \b Production \b and \b Loss - \subpage GFS_H2OPHYS - + CCPP-compliant module: h2ophys \b Gravity \b Wave \b Drag - \subpage GFS_UGWP_v0 - + CCPP-compliant modules: cires_ugwp / cires_ugwp_post + - \subpage GFS_UNIFIED_UGWP + - \subpage GFS_drag_suite \b Surface \b Layer - \subpage GFS_SFCLYR - + CCPP-compliant module: sfc_diff + - \subpage SFC_MYNNSFL \b Simplified \b Ocean \b and \b Sea \b Ice \b Representation - \subpage GFS_NSST - + CCPP-compliant modules: sfc_nst_pre / sfc_nst / sfc_nst_post - \subpage GFS_OCEAN - + CCPP-compliant module: sfc_ocean - \subpage GFS_SFCSICE - + CCPP-compliant module: sfc_sice \b Others - - \subpage GFS_RAYLEIGH - + CCPP-compliant module: rayleigh_damp + - \ref ca_page + - \subpage GFS_SPP 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 @@ -82,8 +61,8 @@ specific humidity, cloud fraction, water contents for cloud liquid, cloud ice, r The time integration of the physics suites is based on the following: - The tendencies from the different physical processes are computed by the parameterizations or derived in separate interstitial routines. -- The first part of the suite, comprised of the parameterizations for radiation, surface layer, surface (land, ocean, and sea ice), boundary layer, -and Rayleigh damping, is computed using a hybrid of parallel and sequential splitting described in Donahue and Caldwell (2018) +- The first part of the suite, comprised of the parameterizations for radiation, surface layer, surface (land, ocean, and sea ice), and boundary layer + is computed using a hybrid of parallel and sequential splitting described in Donahue and Caldwell (2018) \cite donahue_and_caldwell_2018, a method in which the various parameterizations use the same model state as input but are impacted by the preceding parameterizations. The tendencies from the various parameterizations are then added together and used to update the model state. - The surface parameterizations (land, ocean and sea ice) are invoked twice in a subcycling loop, with the first time to create a guess, and the second time to @@ -95,32 +74,26 @@ to the parameterization. \section allsuite_overview Physics Suites -There are two publicly supported host models that use CCPP v5: the UFS Weather Model used in the Short Range Weather Application (SRW App) and the -CCPP Single Column Model (SCM). The SRW App supports the use of suites GFS_v15p2 and RRFS_v1alpha, while the SCM supports the use of suites -GFS_v15p2, GFS_v16beta, RRFS_v1alpha, csawmg and GSD_v1. Suite GFS_v15p2 is an operational suite that invokes the parameterizations used in the GFS v15 -implemented operationally in June 2019. Other suites are experimental, and targeted for future UFS operational implementations. It should be noted -that suite RRFS_v1alpha does not include a convective parameterization scheme and is targeted for convective-allowing resolutions of 3-km grid -spacing. The other suites are primarily targeted for medium-range weather and subseasonal-to-seasonal scales of grid spacing 13-km and coarser. -The forcing datasets included in the CCPP SCM v5.0 public release were created by averaging observations and large-eddy simulations over seas that are -too coarse to resolve convection. Therefore, best results will be obtained with be obtained with the CCPP SCM v5.0 when using suites that include parameterized +There are two publicly supported host models that use CCPP v6: the UFS Weather Model and the CCPP Single Column Model (SCM). +The UFS Weather Model is included in the UFS Short Range Weather Application (SRW App) v2 and the UFS Medium Range Weather Application (MRW App) v2. +The forcing datasets included in the CCPP SCM v6.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 v6.0 when using suites that include parameterized convection. -Table 1. Physics suite options included in this documentation. +Table 1. Physics suites and primary schemes supported in CCPP v6.0.0 \tableofcontents -| Physics suites | GFS_v15p2 | GFS_v16beta | csawmg | GSD_v1 | RRFS_v1alpha | -|------------------|----------------------|--------------------------|---------------------|---------------------------------------------|--------------------| -| HOST Model | SCM, SRW | SCM | SCM | SCM | SCM, SRW | -| Deep Cu | \ref GFS_SAMFdeep | \ref GFS_SAMFdeep | \ref CSAW_scheme | \ref CU_GF | \a off | -| Shallow Cu | \ref GFS_SAMFshal | \ref GFS_SAMFshal | \ref GFS_SAMFshal | \ref MYNNEDMF and \ref cu_gf_sh_group | \ref MYNNEDMF | -| Microphysics | \ref GFDL_cloud | \ref GFDL_cloud | \ref CPT_MG3 | \ref THOMPSON | \ref THOMPSON | -| PBL/TURB | \ref GFS_HEDMF | \ref GFS_SATMEDMFVDIFQ | \ref GFS_HEDMF | \ref MYNNEDMF | \ref MYNNEDMF | -| Radiation | \ref GFS_RRTMG | \ref GFS_RRTMG | \ref GFS_RRTMG | \ref GFS_RRTMG | \ref GFS_RRTMG and \ref SGSCLOUD_page | -| Surface Layer | \ref GFS_SFCLYR | \ref GFS_SFCLYR | \ref GFS_SFCLYR | \ref GFS_SFCLYR | \ref GFS_SFCLYR | -| Land | \ref GFS_NOAH | \ref GFS_NOAH | \ref GFS_NOAH | \ref RUCLSM | \ref NoahMP | -| Gravity Wave Drag| \ref GFS_UGWP_v0 | \ref GFS_UGWP_v0 | \ref GFS_UGWP_v0 | \ref GFS_UGWP_v0 | \ref GFS_UGWP_v0 | -| Ocean | \ref GFS_NSST or \ref GFS_OCEAN | \ref GFS_NSST or \ref GFS_OCEAN | \ref GFS_NSST | \ref GFS_NSST | \ref GFS_NSST | -| Ozone | \ref GFS_OZPHYS | \ref GFS_OZPHYS | \ref GFS_OZPHYS | \ref GFS_OZPHYS | \ref GFS_OZPHYS | -| Water Vapor | \ref GFS_H2OPHYS | \ref GFS_H2OPHYS | \ref GFS_H2OPHYS | \ref GFS_H2OPHYS | \ref GFS_H2OPHYS | +| Physics suites | GFS_v16 | GFS_v17_p8 | RAP | HRRR | RRFS_v1beta | WoFS_v0 | +|------------------|--------------------|-------------------------|------------------|-----------------------------|--------------------|---------------| +|\b Host | SCM, SRWv2 | SCM, MRWv2 | SCM | SCM, SRWv2 | SCM, SRWv2 | SCM, SRWv2 | +|\b Deep \b Cu | \ref GFS_SAMFdeep | \ref GFS_SAMFdeep + \ref ca_page | \ref CU_GF | \a off | \a off | \a off | +|\b Shallow \b Cu | \ref GFS_SAMFshal | \ref GFS_SAMFshal | \ref CU_GF | \ref MYNNEDMF | \ref MYNNEDMF | \ref MYNNEDMF | +|\b Microphysics | \ref GFDL_cloud | \ref THOMPSON w/o aerosol-aware | \ref THOMPSON | \ref THOMPSON | \ref THOMPSON | \ref NSSLMICRO_page | +|\b PBL/TURB | \ref GFS_SATMEDMFVDIFQ | \ref GFS_SATMEDMFVDIFQ | \ref MYNNEDMF | \ref MYNNEDMF | \ref MYNNEDMF | \ref MYNNEDMF | +|\b Radiation | \ref GFS_RRTMG | \ref GFS_RRTMG | \ref GFS_RRTMG | \ref GFS_RRTMG | \ref GFS_RRTMG | \ref GFS_RRTMG | +|\b Surface \b Layer | \ref GFS_SFCLYR | \ref GFS_SFCLYR | \ref SFC_MYNNSFL | \ref SFC_MYNNSFL | \ref SFC_MYNNSFL | \ref SFC_MYNNSFL | +|\b LSM | \ref GFS_NOAH | \ref NoahMP | \ref RUCLSM | \ref RUCLSM | \ref NoahMP | \ref GFS_NOAH | +|\b Gravity \b Wave \b Drag| \ref GFS_UGWP_v0 | \ref GFS_UNIFIED_UGWP | \ref GFS_drag_suite | \ref GFS_drag_suite | \ref GFS_UGWP_v0 | \ref GFS_UGWP_v0 | +|\b Sea \b Ice | \ref GFS_SFCSICE | \ref GFS_SFCSICE | \ref RUCLSM | \ref RUCLSM | \ref GFS_SFCSICE | \ref GFS_SFCSICE | \tableofcontents diff --git a/physics/docs/pdftxt/all_shemes_list.txt.FV3 b/physics/docs/pdftxt/all_shemes_list.txt.FV3 deleted file mode 100644 index 4ddef249b..000000000 --- a/physics/docs/pdftxt/all_shemes_list.txt.FV3 +++ /dev/null @@ -1,110 +0,0 @@ -/** -\page allscheme_page Parameterizations and Suites Overview - -\section allscheme_overview Physics Parameterizations - -In the CCPP-Physics v3.0 release, each parameterization is in its own modern Fortran module, - which facilitates model development and -code maintenance. While some individual parameterization can be invoked for the CCPP SCM, most users will assemble the -parameterizations in suites. - -- Radiation - - \subpage GFS_RRTMG - -- PBL and Turbulence - - \subpage GFS_HEDMF - - \subpage GFS_SATMEDMF - - \subpage GSD_MYNNEDMF - -- Land Surface Model - - \subpage GFS_NOAH - - \subpage surf_pert - - \subpage GSD_RUCLSM - -- Cumulus Parameterizations - - GFS Scale-Aware Arakawa Schubert (SAS) Scheme - - \subpage GFS_SAMFdeep - - \subpage GFS_SAMFshal - - \subpage CSAW_scheme - - \subpage GSD_CU_GF - - \ref cu_gf_deep_group - - \ref cu_gf_sh_group - -- Microphysics - - \subpage GFDL_cloud - - \subpage fast_sat_adj (not available for the CCPP SCM) - - \subpage CPT_MG3 - - \subpage GSD_THOMPSON - -- Stochastic (not available for the CCPP SCM) - - \subpage STOCHY_PHYS - - \subpage surf_pert (only applicable to \ref GFS_NOAH ) - -- Ozone - - \subpage GFS_OZPHYS - - \ref GFS_ozphys_2015 - -- Water Vapor Photochemical Production and Loss - - \subpage GFS_H2OPHYS - -- Gravity Wave Drag - - \subpage GFS_GWDPS - - \subpage GFS_GWDC - -- Surface Layer and Simplified Ocean and Sea Ice Representation - - \subpage GFS_SFCLYR - - \subpage GFS_NSST - - \subpage GFS_SFCSICE - -- Others - - \subpage GFS_RAYLEIGH - - \subpage GFS_CALPRECIPTYPE - -In addition to the physical schemes themselves, this scientific documentation also covers four modules that define physics/radiation functions, parameters and constants: - - \ref func_phys - - \ref phy_sparam - - \ref physcons - - \ref radcons - -The input information for the physics include 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 - dynamical tendencies for the same variables and various surface fields, both fixed and variable. - -The time integration of the physics suites is based on the following: -- The tendencies from the different physical processes are computed by the parameterizations or derived in separate interstitial routines -- The first part of the suite, comprised of the parameterizations for radiation, surface layer, surface (land, ocean, and sea ice), boundary layer, -orographic gravity wave drag, and Rayleigh damping, is computed using a hybrid of parallel and sequential splitting described in Donahue and Caldwell(2018) -\cite donahue_and_caldwell_2018, a method in which the various parameterizations use the same model state as input but are impacted by the preceding -parameterizations. The tendencies from the various parameterizations are then added together and used to update the model state. -- The surface parameterizations (land, ocean and sea ice) are invoked twice in a loop, with the first time to create a guess, and the second time to -produce the tendencies. -- The second part of the physics suite, comprised of the parameterizations of ozone, stratospheric water vapor, deep convection, convective gravity wave drag, -shallow convection, and microphysics, is computed using sequential splitting in the order listed above, in which the model state is updated between calls -to the parameterization. -- If the in-core saturation adjustment is used (\p do_sat_adj=.true.), it is invoked at shorter timesteps along with the dynamical solver. - -\section allsuite_overview Physics Suites - -The CCPP v3 includes the suite used in the GFS v15 implemented operationally in June 2019 (suite GFS_v15). Additionally, it includes three -developmental suites which are undergoing testing for possible future implementation in the UFS. Suite GFS_v15plus is identical to suite -GFS_v15 except for a replacement in the PBL parameterization (Han et al. 2019 \cite Han_2019 ). Suite MGCSAW differs from GFS_v15 as it -contains different convection and microphysics schemes made available through a NOAA Climate Process Team (CPT) with components developed -at multiple research centers and universities, including Colorado State, Utah, NASA, NCAR, and EMC. Suite GSD_v0 differs from GFS_v15 as it -uses the convection, microphysics, and boundary layer schemes employed in the Rapid Refresh (RAP) and High-Resolution Rapid Refresh (HRRR \cite Benjamin_2016 ) -operational models and was assembled by NOAA/GSD. An assessment of an earlier version of these suites can be found in - the UFS portal -and in the GMTB website . - -Table 1. Physics suite options included in this documentation. -\tableofcontents -| Phys suites | GFS_v15 | GFS_v15plus | MGCSAW | GSD_v0 | -|------------------|----------------------|----------------------|---------------------|----------------------| -| Deep Cu | \ref GFS_SAMFdeep | \ref GFS_SAMFdeep | \ref CSAW_scheme | \ref GSD_CU_GF | -| Shallow Cu | \ref GFS_SAMFshal | \ref GFS_SAMFshal | \ref GFS_SAMFshal | \ref GSD_MYNNEDMF and \ref cu_gf_sh_group | -| Microphysics | \ref GFDL_cloud | \ref GFDL_cloud | \ref CPT_MG3 | \ref GSD_THOMPSON | -| PBL/TURB | \ref GFS_HEDMF | \ref GFS_SATMEDMF | \ref GFS_HEDMF | \ref GSD_MYNNEDMF | -| Land | \ref GFS_NOAH | \ref GFS_NOAH | \ref GFS_NOAH | \ref GSD_RUCLSM | -\tableofcontents - - -*/ diff --git a/physics/docs/pdftxt/code_overview.txt b/physics/docs/pdftxt/code_overview.txt deleted file mode 100644 index 9399fa263..000000000 --- a/physics/docs/pdftxt/code_overview.txt +++ /dev/null @@ -1,54 +0,0 @@ -/** -\page subpage_overview Overview of the Code - -In the CCPP-Physics v2 code, each parameterization is placed in its own modern Fortran module, which facilitates model development and -code maintenance. While some individual parameterization can be invoked for CCPP SCM, most users will assemble the -parameterizations in suites. The parameterizations contained in CCPP-Physics v2 can be used to run two suites: FV3GFS default -(with GFDL cloud microphysics) and GFS with Zhao-Carr microphysics. - -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 - + @ref GFS_NOAH - + @ref GFS_SFCSICE - + @ref GFS_HEDMF - + @ref GFS_GWDPS - + @ref GFS_RAYLEIGH - + @ref GFS_OZPHYS - + @ref GFS_H2OPHYS - + @ref GFS_SAMFdeep - + @ref GFS_GWDC - + @ref GFS_SAMFshal - + GFS Microphysics (MP) scheme option: - + @ref GFDL_cloud - + @ref gfdlmp - + @ref fast_sat_adj - + @ref GFS_ZHAOC - + @ref condense - + @ref precip - + @ref GFS_CALPRECIPTYPE - -The parameterizations included in the CCPP-Physics v2 are all column-based, that is, computations are performed only in the vertical. -The input information for the physics include the values of the gridbox mean prognostic variables (wind components, temperature, -specific humidity, cloud fraction, vater contents for cloud liquid, cloud ice, rain, snow, graupel, and ozone concentration), the provisional - dynamical tendencies for the same variables and various surface fields, both fixed and variable. - -The time integration of the GFS physics suite is based on the following: -- The tendencies from the different physical processes are computed by the parameterizations or derived in separate interstitial routines; -- The first part of the suite, comprised of the parameterizations for radiation, surface layer, surface (land, ocean, and sea ice), boundary layer, -orographic gravity wave drag, and Rayleigh damping, is computed using a hybrid of parallel and sequential splitting (Donahue and Caldwell(2018) -\cite donahue_and_caldwell_2018), a method in which the various parameterizations use the same model state as input but feel the effect of the preceding -parameterizations. The tendencies from the various parameterizations are then added together and used to update the model state. -- The second part of the physics suite, comprised of the parameterizations of ozone, stratospheric \f$H_2O\f$, deep convection, convective gravity wave drag, -shallow convection, and microphysics, is computed using sequential splitting in the order listed above, in which the model state is updated between calls -to the parameterization. - -In addition to the physical schemes themselves, this scientific documentation also covers four modules that define physics/radiation functions, parameters and constants: - + @ref func_phys - + @ref phy_sparam - + @ref physcons - + @ref radcons - -*/ diff --git a/physics/docs/pdftxt/code_overview.txt.Aug17 b/physics/docs/pdftxt/code_overview.txt.Aug17 deleted file mode 100644 index ebe1f6c2b..000000000 --- a/physics/docs/pdftxt/code_overview.txt.Aug17 +++ /dev/null @@ -1,66 +0,0 @@ -/** -\page subpage_overview Overview of the Code - -The GFS physics parameterization suite is called by CCPP-SCM or FV3 after the explicit dynamical computations. The -physics computations are performed only in the vertical. The input information for the physics consists of the values -of the gridbox mean prognostic variables (wind components \f$u/v\f$, temperature \f$T\f$, specific humidity \f$q\f$, cloud -fraction \f$q_a\f$, water contents for cloud liquid \f$q_l\f$, cloud ice \f$q_i\f$, rain \f$q_r\f$, snow \f$q_s\f$, graupel -\f$q_r\f$, and ozone concentration), the provisional dynamical tendencies for the same variables and various surface fields, -both fixed and variable. - -In CCPPv2, physics suite have separate modules for different processes. Such modularity is desirable from the model development -and code maintenance point of view. The GFS physics routines are called in the following order as defined in \c suite_GFS_operational_2017_scm.xml file: - + @ref GFS_RRTMG - + @ref GFS_SFCLYR - + @ref GFS_NSST - + @ref GFS_NOAH - + @ref GFS_SFCSICE - + @ref GFS_HEDMF - + @ref GFS_GWDPS - + @ref GFS_RAYLEIGH - + @ref GFS_OZPHYS - + @ref GFS_SAMFdeep - + @ref GFS_GWDC - + @ref GFS_SAMFshal - + Microphysics (MP) scheme option: - + @ref GFDL_cloud - + @ref GFS_ZHAOC - -The time integration of the GFS physics suite is based on the following: -- It has be to written in CCPP-compliant modern Fortran with augument table and modules. -- The tendencies from the different physical processes are computed in separate interstitial routines; - Evaluating the forcing terms resulting from the parameterizations at the departure point and at the arrival point ensures the accuracy of the coupling. -- The value of a prognostic variable is updated with the tendency from one process and the next process starts from this updated -value (in what is usually refered to as the sequential splitting (Beljaars(1991) \cite beljaars_1991)). - -While the using of sufficiently small time steps may be acceptable in the context of idealized process studies. Comparably long time steps -are essential in operational production models for efficiency. It is obvious that the numerics of the parameterized processes has to be compatible -with the dynamics of the model. In FV3GFS, dynamical time steps are used ranging from 225s for the deterministic C768 forecasts (~13 km - in grid spacing), to 450s for C384 forecasts (~25 km) and 1800s for C96 forecasts (~100 km). The default time step of GFDL cloud -microphysics (\c mp_time) is 150s. If \c mp_time isn't divisible by physics time step or is larger than physics time step, the actual \c mp_time step -becomes dt/NINT[dt/MIN(dt, mp_time)]. Shortwave and Longwave calling interval in GFS RRTMG is 3600s. The accuracy of the numerical approximation - of the parameterized equations are often optimized for a given resolution and time step. - -Traditionally, the parameterization in most cases (e.g. GFS physics suite in Global Spectral Model(GSM)) is split from the dynamical part of the model. Recently, -progress have been made towards a more consistent incorporation of the physical parameterizations to the dynamical part of the model -(Wedi (1999) \cite wedi_1999 ; Cullen and Salmond 2002 \cite cullen_and_salmond_2002). This is possible as processes may require -interaction and it may be necessary to enforce a balance, e.g. between -dynamics and boundary layer diffusion (Beljaars(1991) \cite beljaars_1991), or between dynamics and clouds in FV3GFS: - + @ref fast_sat_adj - -The NCEP Global Ensemble Forecast System (GEFS) is under-spread near the surface, a common characteristic of ensemble prediction systems. Several -methods for increasing the spread have been tested. Perturbation of roughness lengths for heat and momentum, soil hydraulic conductivity, vegetation -fraction, surface albedo, and leaf area index are applied, with the amplitude and perturbation scales based on previous reseach: - -Results show that these surface perturbation have a modest impact on the spread of near-surface temperature and other variables in the GEFS, and - have been shown to impact forecasts of 2m temperature, 10m wind and precipitation. - -Besides scientific documentation of GFS suite physical schemes, there are three modules to define physics (or radiation) attributes and constants: - + @ref phy_sparam - + @ref physcons - + @ref radcons - - - - -*/ diff --git a/physics/docs/pdftxt/mainpage.txt b/physics/docs/pdftxt/mainpage.txt index 315d907f9..57a713207 100644 --- a/physics/docs/pdftxt/mainpage.txt +++ b/physics/docs/pdftxt/mainpage.txt @@ -2,32 +2,64 @@ \mainpage Introduction Welcome to the scientific documentation for the parameterizations available in the Common -Community Physics Package (CCPP) v5.0.0 and the suites that can be configured using them. - -\image html mesocam.png " " width=10cm - -The CCPP-Physics is envisioned to contain parameterizations used in NOAA's Unified Forecast System (UFS) -applications for weather through seasonal prediction timescales, encompassing the current operational GFS schemes as well as -developmental schemes under consideration for upcoming operational implementations. New in this release is -suite RRFS_v1alpha, which is being tested in the UFS Short-Range Weather Application for future use -in the convective-allowing Rapid Refresh Forecast System (RRFS), slated for operational implementation -in 2023. Convection-allowing models allow us to begin to resolve the fine details within storm systems that are -necessary for the accurate predition of high-impact events such as tornadoes, flash floods, and winter weather. -Experience gained from the development of earlier operational and experimental convective-allowing models (CAMs), -such as the High Resolution Rapid Refresh (HRRR) and HRRR Ensemble (HRRRE), the North American Mesoscale Forecast -System (NAM) nests, the NSSL Experimental Warn-on-Forecast System for ensembles (NEWS-e), the NCAR experimental -CAM ensemble, and GFDL's FV3-based CAM efforts, guide this process. - -The CCPP parameterizations are aggregated in suites by the host models. The CCPP Single Column Model (SCM), developed -by the Development Testbed Center, supports suites GFS_v15p2, GFS_v16beta, GSD_v1, csawmg, and RRFS_v1alpha, while the -UFS Short-Range Weather Application supports suites GFS_v15p2 and RRFS_v1alpha. The UFS Medium-Range Weather Application -is not intended for use with CCPP v5.0.0. +Community Physics Package (CCPP) v6.0.0 and the suites that can be configured using them. + +The CCPP-Physics (available through https://github.com/NCAR/ccpp-physics/) is envisioned to contain parameterizations used in the +Unified Forecast System (UFS) +applications for weather through seasonal prediction timescales, encompassing the current operational GFS schemes, as well as +developmental schemes under consideration for upcoming operational implementations. The UFS can be configured for multiple +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. + + +The CCPP parameterizations are aggregated in suites by the host models. In this release, the CCPP Single Column Model (SCM), developed +by the Development Testbed Center (DTC), supports suites: +- \ref GFS_v16_page +- \ref GFS_v17_p8_page +- \ref HRRR_suite_page +- \ref RRFS_v1beta_page +- \ref WoFS_v0_page +- \ref rap_suite_page + +while the UFS Short-Range Weather Application 2.0 supports suites \ref GFS_v16_page, \ref HRRR_suite_page, \ref RRFS_v1beta_page and +\ref WoFS_v0_page. The UFS Medium-Range Weather Application 2.0 supports suite \ref GFS_v17_p8_page. + +New schemes and capability highlights in this release: +- \ref NSSLMICRO_page +- \ref GFS_UNIFIED_UGWP and \ref GFS_drag_suite +- \ref SFC_MYNNSFL +- \ref ca_page +- \ref GFS_SPP In this website you will find documentation on various aspects of each parameterization, including a high-level overview of its function, the input/output argument list, and a description of the algorithm. More details about this and other CCPP releases may be found on the CCPP website hosted by -the Developmental Testbed Center (DTC). +DTC. + + +## Acknowledgements + +CCPP team would like to express our deepest gratitude for UFS physics developers' contribution to the +development of CCPP-Physics. +\n We would also like to give special thanks to: + +- \b NOAA \b Global \b Systems \b Laboratory: Hannah Barnes, Jeff Beck, Georg Grell, Joseph Olson, Tanya Smirnova, Michael Toy +- \b NOAA \b Physical \b Sciences \b Laboratory: Jian-Wen Bao, Lisa Bengtsson, Song-You Hong +- \b NOAA \b National \b Severe \b Storms \b Laboratory: Ted Mansell +- \b NOAA \b Environmental \b Modeling \b Center: Jongil Han, Qingfu Liu, Ruiyu Sun +- \b Atmospheric \b and \b Environmental \b Research, \b Inc.: Michael Iacono +- \b Joint \b Center \b for \b Satellite \b Data \b Assimilation: Greg Thompson +- \b NASA \b Goddard \b Space \b Flight \b Center: Valery Yudin + +as a whole for their support and contribution for this CCPP scientific documentation (SciDoc). + + +\b CCPP \b SciDoc \b Team: Man Zhang, Ligia Bernardet, Grant Firl, Dom Heinzeller, and Weiwei Li +\n Developmental Testbed Center */ diff --git a/physics/docs/pdftxt/mainpage.txt.Aug17 b/physics/docs/pdftxt/mainpage.txt.Aug17 deleted file mode 100644 index fe79157ee..000000000 --- a/physics/docs/pdftxt/mainpage.txt.Aug17 +++ /dev/null @@ -1,39 +0,0 @@ -/** -\mainpage Introduction - -\anchor mainpage-top - -Welcome to the GMTB Common Community Physics Package (CCPP) V2.0 scientific documentation. This version contains all parameterizations of \b the \b GFS \b physics \b suite on the top of NEMSfv3gfs repository on NOAA VLab in July 2018. In this website you will find documentation on various aspects of the parameterizations, including basic description, input/output argument list and general/detailed algorithm. - -A major upgrade to the parameterization of \ref GFDL_cloud was implemented in the FV3GFS, -which is being configured to replace spectral model (NEMS GSM) in operational implementation (Q2FY19). It is the most significant change to -the GFS physics suite since the Zhao-Carr microphysics scheme was implemented in the NCEP -Global Forecasting System(GFS) as a simple scheme and predicted only total cloud condensate. -Six prognostic cloud spieces variables have been introduced to enable a more physically based -representation of water vapor, mixed-phase (liquid/ice) cloud and precipitating rain/snow/graupel. A fast physics -(phase change only, for now) has been implemented between "Lagrangian-to-Eulerian" remapping in the FV3 dynamic solver. - -Other physics Upgrade of Q3FY17 GFS include: -+ Use of higher resolution land surface climatologies and new surface albedo data. - + IGBP 20-type land classifications and STASGO 19-type soil classifications - + New MODIS-based snow free albedo - + New MODIS-based maximum snow albedo - + Updated diurnal albedo treatment - + Unified snow cover and snow albedo between radiation and Noah LSM - + Fixed excessive cooling of T2m during sunset - + Increased ground heat flux under deep snow - - Major issue addressed: - + Reduced patchiness of land cover and its properties - + Reduced cold temperature bias over snow: Alaska, Northwest, Northeast - + Mitigated stable boundary layer decoupling - + Improved surface exchange coefficient - + Removed excessive large snow albedo -+ Updated land parameterization to reduced excessive cooling of 2m temperatures during sunset (00Z). -+ Changes to cumulus convection parameterization to improve summertime precipitation forecasts. -+ Included a Near-Surface Sea Temperature model to represent diurnal warming and sub-layer cooling effects. -+ Reduced Rayleigh damping in the upper stratosphere to improve temperature and circulation forecast. - - You can find more information about the GMTB Common Community Physics Package (CCPP) on the DTC website. - -*/ diff --git a/physics/docs/pdftxt/suite_FV3_GFS_v16beta_no_nsst.xml.txt b/physics/docs/pdftxt/suite_FV3_GFS_v16beta_no_nsst.xml.txt deleted file mode 100644 index 0cc7a08da..000000000 --- a/physics/docs/pdftxt/suite_FV3_GFS_v16beta_no_nsst.xml.txt +++ /dev/null @@ -1,97 +0,0 @@ -/** -\page suite_FV3_GFS_v16beta_no_nsst_xml suite_FV3_GFS_v16beta_no_nsst.xml - -\code - - - - - - - fv_sat_adj - - - - - GFS_time_vary_pre - GFS_rrtmg_setup - GFS_rad_time_vary - GFS_phys_time_vary - - - - - GFS_suite_interstitial_rad_reset - GFS_rrtmg_pre - rrtmg_sw_pre - rrtmg_sw - rrtmg_sw_post - rrtmg_lw_pre - rrtmg_lw - rrtmg_lw_post - GFS_rrtmg_post - - - - - GFS_suite_interstitial_phys_reset - GFS_suite_stateout_reset - get_prs_fv3 - GFS_suite_interstitial_1 - GFS_surface_generic_pre - GFS_surface_composites_pre - dcyc2t3 - GFS_surface_composites_inter - GFS_suite_interstitial_2 - - - - sfc_diff - GFS_surface_loop_control_part1 - sfc_ocean - lsm_noah - sfc_sice - GFS_surface_loop_control_part2 - - - - GFS_surface_composites_post - sfc_diag - sfc_diag_post - GFS_surface_generic_post - GFS_PBL_generic_pre - satmedmfvdifq - GFS_PBL_generic_post - GFS_GWD_generic_pre - cires_ugwp - cires_ugwp_post - GFS_GWD_generic_post - rayleigh_damp - GFS_suite_stateout_update - ozphys_2015 - h2ophys - get_phi_fv3 - GFS_suite_interstitial_3 - GFS_DCNV_generic_pre - samfdeepcnv - GFS_DCNV_generic_post - GFS_SCNV_generic_pre - samfshalcnv - GFS_SCNV_generic_post - GFS_suite_interstitial_4 - cnvc90 - GFS_MP_generic_pre - gfdl_cloud_microphys - GFS_MP_generic_post - maximum_hourly_diagnostics - - - - - GFS_stochastics - - - - -\endcode -*/ diff --git a/physics/docs/pdftxt/suite_input.nml.txt b/physics/docs/pdftxt/suite_input.nml.txt index 360187bd7..714ba7d2f 100644 --- a/physics/docs/pdftxt/suite_input.nml.txt +++ b/physics/docs/pdftxt/suite_input.nml.txt @@ -1,7 +1,8 @@ /** -\page CCPPsuite_nml_desp Namelist Options Description +\page CCPPsuite_nml_desp Supported Namelist Options -The SCM and the UFS Atmosphere access runtime configurations from file \c input.nml. This file contains +The SCM and the UFS Atmosphere, the atmospheric component of the UFS Weather Model, + access runtime configurations from file \c input.nml. This file contains various namelists records that control aspects of the I/O, dynamics, physics etc. Most physics-related options are in records \b &gfs_physics_nml. Some schemes have their own namelist records as described below. @@ -15,6 +16,8 @@ module_gfdl_cloud_microphys.F90. - Namelist \b &nam_sfcperts specifies whether and how stochastic perturbations are used in the Noah Land Surface Model. +- Namelist \b &nam_sppperts specifies options for the use of \ref GFS_SPP + Both the SDF and the input.nml contain information about how to specify the physics suite. Some of this information is redundant, and the user must make sure they are compatible.The safest practice is to use the SDF and namelist provided for each suite, since those are supported @@ -27,7 +30,7 @@ show some variables in the namelist that must match the SDF. NML Description Option CCPP scheme or interstitial Description Default Value \b General \b options -fhzero GFS_phys_time_vary hour between clearing of diagnostic buckets 0.0 +fhzero gfs_phys_time_vary hour between clearing of diagnostic buckets 0.0 h2o_phys h2ophys flag for stratosphere h2o scheme .false. ldiag3d see \a GFS_typedefs.F90 flag for 3D diagnostic fields .false. qdiag3d see \a GFS_typedefs.F90 flag for 3D tracer diagnostic fields .false. @@ -36,32 +39,31 @@ show some variables in the namelist that must match the SDF. cplwav see \a GFS_typedefs.F90 flag for using information produced by an external ocean wave model .false. cplchm see \a GFS_typedefs.F90 flag for coupled chemistry diagnostics .false. cplwav2atm see \a GFS_typedefs.F90 flag for wave to atm coupling .false. -lsidea rayleigh_damp flag for idealized physics .false. oz_phys_2015 ozphys_2015 flag for new (2015) ozone physics .false. -fhcyc GFS_phys_time_vary frequency for surface data cycling in hours 0.0 -use_ufo GFS_phys_time_vary flag for using unfiltered orography surface option .false. +fhcyc gfs_phys_time_vary frequency for surface data cycling in hours 0.0 +use_ufo gfs_phys_time_vary flag for using unfiltered orography surface option .false. ncld see \a GFS_typedefs.F90 number of hydrometeors 1 do_mynnsfclay see \a GFS_typedefs.F90 flag to activate MYNN-SFCLAY scheme .false. -prslrd0 rayleigh_damp pressure level above which to apply Rayleigh damping 0.0d0 -ral_ts rayleigh_damp time scale for Rayleigh damping in days 0.0d0 -do_sppt GFS_stochastics flag for stochastic SPPT option .false. -do_shum GFS_stochastics flag for stochastic SHUM option .false. -do_skeb GFS_stochastics flag for stochastic SKEB option .false. -do_sfcperts GFS_rrtmg_pre flag for stochastic surface perturbations option .false. +do_sppt gfs_stochastics flag for stochastic SPPT option .false. +do_shum gfs_stochastics flag for stochastic SHUM option .false. +do_skeb gfs_stochastics flag for stochastic SKEB option .false. +do_sfcperts gfs_rrtmg_pre flag for stochastic surface perturbations option .false. imp_physics choice of microphysics scheme choice of microphysics scheme: \n
  • 11: GFDL microphysics scheme
  • 8: Thompson microphysics scheme
  • 10: Morrison-Gettelman microphysics scheme +
  • 17: NSSL microphysics scheme with background CCN +
  • 18: NSSL microphysics scheme with predicted CCN (compatibility)
99 \b Parameters \b related \b to \b radiation \b scheme \b options -pdfcld GFS_rrtmg_pre flag for PDF clouds .false. +pdfcld gfs_rrtmg_pre flag for PDF clouds .false. fhswr rrtmg_sw frequency for shortwave radiation (secs) 3600. fhlwr rrtmg_lw frequency for longwave radiation (secs) 3600. -levr GFS_rrtmg_setup number of vertical levels for radiation calculations -99 -nfxr GFS_rrtmg_pre second dimension of radiation input/output array fluxr 39+6 -iflip GFS_rrtmg_setup control flag for vertical index direction \n +levr gfs_rrtmg_setup number of vertical levels for radiation calculations -99 +nfxr gfs_rrtmg_pre second dimension of radiation input/output array fluxr 39+6 +iflip gfs_rrtmg_setup control flag for vertical index direction \n
  • 0: index from TOA to surface
  • 1: index from surface to TOA @@ -74,7 +76,7 @@ show some variables in the namelist that must match the SDF.
  • 2: cloud optical property scheme based on Hu and Stamnes (1993) \cite hu_and_stamnes_1993 - updated
1 -iovr_sw rrtmg_sw control flag for cloud overlap in SW radiation \n +gfs_typedefs::gfs_control_type::iovr rrtmg_sw control flag for cloud overlap in SW & LW radiation \n
  • 0: random overlapping clouds
  • 1: max/ran overlapping clouds @@ -84,17 +86,7 @@ show some variables in the namelist that must match the SDF.
  • 5: exponential-random overlapping method
1 -iovr_lw rrtmg_lw control flag for cloud overlap in LW radiation \n -
    -
  • 0: random overlapping clouds -
  • 1: max/ran overlapping clouds -
  • 2: maximum overlap clouds (mcica only) -
  • 3: decorrelation-length overlap (mcica only) -
  • 4: exponential overlapping method -
  • 5: exponential-random overlapping method -
- 1 -ictm GFS_rrtmg_setup external data time/date control flag \n +ictm gfs_rrtmg_setup external data time/date control flag \n
  • -2: same as 0, but superimpose seasonal cycle from climatology data set
  • -1: use user provided external data for the forecast time, no extrapolation @@ -104,31 +96,31 @@ show some variables in the namelist that must match the SDF.
  • yyyy1: use yyyy data for the forecast. if needed, do extrapolation to match the fcst time
1 -crick_proof GFS_rrtmg_setup control flag for eliminating CRICK \n +crick_proof gfs_rrtmg_setup control flag for eliminating CRICK \n
  • .true.: apply layer smoothing to eliminate CRICK
  • .false.: do not apply layer smoothing
.false. -ccnorm GFS_rrtmg_setup control flag for in-cloud condensate mixing ratio \n +ccnorm gfs_rrtmg_setup control flag for in-cloud condensate mixing ratio \n
  • .true.: normalize cloud condensate
  • .false.: not normalize cloud condensate
.false. -norad_precip GFS_rrtmg_setup control flag for not using precip in radiation (Ferrier scheme) \n +norad_precip gfs_rrtmg_setup control flag for not using precip in radiation (Ferrier scheme) \n
  • .true.: snow/rain has no impact on radiation
  • .false.: snow/rain has impact on radiation
.false. -ialb GFS_rrtmg_setup SW surface albedo control flag: \n +ialb gfs_rrtmg_setup SW surface albedo control flag: \n
  • 0: using climatology surface albedo scheme for SW
  • 1: using MODIS based land surface albedo for SW
0 -iems GFS_rrtmg_setup LW surface emissivity control flag (ab 2-digit integer) : \n +iems gfs_rrtmg_setup LW surface emissivity control flag (ab 2-digit integer) : \n
  • a: =0 set surface air/ground t same for LW radiation
  • =1 set surface air/ground t diff for LW radiation @@ -137,7 +129,7 @@ show some variables in the namelist that must match the SDF.
  • =2 future development (not yet)
0 -iaer GFS_rrtmg_setup 4-digit aerosol flag (dabc for aermdl, volcanic, LW, SW): \n +iaer gfs_rrtmg_setup 4-digit aerosol flag (dabc for aermdl, volcanic, LW, SW): \n
  • d:tropospheric aerosol model scheme flag \n =0 or none, opac-climatology aerosol scheme \n @@ -152,7 +144,7 @@ show some variables in the namelist that must match the SDF. =1 include tropospheric aerosol in SW
1 -ico2 GFS_rrtmg_setup \f$CO_2\f$ data source control flag:\n +ico2 gfs_rrtmg_setup \f$CO_2\f$ data source control flag:\n
  • 0: prescribed value (380 ppmv)
  • 1: yearly global averaged annual mean from observations @@ -173,7 +165,7 @@ show some variables in the namelist that must match the SDF.
  • 2: use McICA with randomly generated permutation seeds
0 -isol GFS_rrtmg_setup solar constant scheme control flag: \n +isol gfs_rrtmg_setup solar constant scheme control flag: \n
  • 0: fixed value = 1366.0 \f$W m^{-2}\f$ (old standard)
  • 10: fixed value = 1360.8 \f$W m^{-2}\f$ (new standard) @@ -185,13 +177,13 @@ show some variables in the namelist that must match the SDF. 0 lwhtr rrtmg_lw flag for output of longwave heating rate .true. swhtr rrtmg_sw flag for output of shortwave heating rate .true. -nhfrad GFS_time_vary_pre number of timesteps for which to call radiation on physics timestep (coldstarts) 0 +nhfrad gfs_time_vary_pre number of timesteps for which to call radiation on physics timestep (coldstarts) 0 \b Parameters \b related \b to \b cumulus \b schemes imfshalcnv choice of shallow convective scheme flag for mass flux shallow convective scheme:\n
    • 1:July 2010 version of mass-flux shallow convective scheme (operational as of 2016)
    • 2: scale- & aerosol-aware mass-flux shallow convective scheme (2017) -
    • 3: scale- & aerosol-aware Grell-Freitas scheme (GSD) +
    • 3: scale- & aerosol-aware Grell-Freitas scheme
    • 4: new Tiedtke scheme (CAPS)
    • 0: modified Tiedtke's eddy-diffusion shallow convective scheme
    • -1: no shallow convection used @@ -207,22 +199,16 @@ show some variables in the namelist that must match the SDF.
    1 do_deep see \a GFS_typedefs.F90 consistency check for deep convection .true. -shal_cnv GFS_suite_interstitial flag for calling shallow convection .false. -lmfshal GFS_rrtmg_pre flag for mass-flux shallow convection scheme in the cloud fraction calculation shal_cnv .and. (imfshalcnv > 0) -lmfdeep2 GFS_rrtmg_pre flag for mass-flux deep convection scheme in the cloud fraction calculation imfdeepcnv == 2 .or. 3 .or.4 -random_clds GFS_phys_time_vary flag for whether clouds are random .false. -trans_trac GFS_suite_interstitial flag for convective transport of tracers .false. -cal_pre GFS_phys_time_vary or GFS_MP_generic flag for calling precipitation type algorithm .false. +shal_cnv gfs_suite_interstitial flag for calling shallow convection .false. +lmfshal gfs_rrtmg_pre flag for mass-flux shallow convection scheme in the cloud fraction calculation shal_cnv .and. (imfshalcnv > 0) +lmfdeep2 gfs_rrtmg_pre flag for mass-flux deep convection scheme in the cloud fraction calculation imfdeepcnv == 2 .or. 3 .or.4 +random_clds gfs_phys_time_vary flag for whether clouds are random .false. +trans_trac gfs_suite_interstitial flag for convective transport of tracers .false. +cal_pre gfs_phys_time_vary or gfs_MP_generic flag for calling precipitation type algorithm .false. shcnvcw \ref samfshalcnv flag for shallow convective cloud .false. -cscnv cs_conv flag for Chikira-Sugiyama deep convection .false. -do_aw cs_conv flag for Arakawa-Wu scale-awere adjustment .false. -do_shoc cs_conv flag for Simplified Hihger-order Closure (SHOC) .false. -do_awdd cs_conv flag to enable treating convective tendencies following Arakwaw-Wu for downdrafts (2013) .false. -cs_parm(10) cs_conv tunable parameters for Chikira-Sugiyama convection 8.0,4.0,1.0e3,3.5e3,20.0,1.0,-999.,1.,0.6,0. \b Parameters \b related \b to \b PBL \b scheme \b options -do_mynnedmf mynnedmf_wrapper* flag to activate MYNN-EDMF scheme .false. -do_myjsfc myjpbl_wrapper flag for MYJ surface layer scheme .false -dspheat \ref satmedmfvdifq, \ref hedmf flag for using TKE dissipative heating to temperature tendency in hybrid EDMF and TKE-EDMF schemes .false. +do_mynnedmf mynnedmf_wrapper flag to activate MYNN-EDMF scheme .false. +dspheat \ref satmedmfvdifq flag for using TKE dissipative heating to temperature tendency in hybrid EDMF and TKE-EDMF schemes .false. satmedmf \ref satmedmfvdifq flag for calling scale-ware TKE-based EDMF PBL scheme .false. isatmedmf \ref satmedmfvdifq flag for scale-aware TKE-based moist EDMF scheme \n
      @@ -230,15 +216,11 @@ show some variables in the namelist that must match the SDF.
    • 1: updated version of satmedmf (as of May 2019)
    0 -hybedmf \ref hedmf flag for calling hybrid EDMF PBL scheme .false. -shinhong shinhongvdif flag for scale-aware Shinhong PBL scheme .false. do_ysu see \a GFS_typedefs.F90 flag for YSU PBL scheme .false. debug see \a GFS_typedefs.F90 flag for debug printout .false. -xkzm_h \ref satmedmfvdifq, \ref hedmf background vertical diffusion for heat and q 1.0d0 -xkzm_m \ref satmedmfvdifq, \ref hedmf background vertical diffusion for momentum 1.0d0 -xkzm_s \ref satmedmfvdifq, \ref hedmf sigma threshold for background mom. diffusion 1.0d0 -xkzminv \ref hedmf maximum background value of heat diffusivity in the inversion layer 0.3 -moninq_fac \ref hedmf atmosphere diffusivity coefficient factor 1.0 +xkzm_h \ref satmedmfvdifq background vertical diffusion for heat and q 1.0d0 +xkzm_m \ref satmedmfvdifq background vertical diffusion for momentum 1.0d0 +xkzm_s \ref satmedmfvdifq sigma threshold for background mom. diffusion 1.0d0 dspfac \ref satmedmfvdifq TKE dissipative heating factor 1.0 bl_upfr \ref satmedmfvdifq updraft fraction in boundary layer mass flux scheme 0.13 bl_dnfr \ref satmedmfvdifq downdraft fraction in boundary layer mass flux scheme 0.1 @@ -301,14 +283,24 @@ show some variables in the namelist that must match the SDF.
  • 1: activate subgrid cloud coupling to radiation (highly suggested)
1 +num_dfi_radar cu_gf_driver number of timespans with radar-prescried temperature tendencies 0 +fh_dfi_radar cu_gf_driver begin+end of timespans to receive radar-prescribed temperature tendencies -2e10 +do_cap_suppress cu_gf_driver enable convection suppression in GF scheme if fh_dfi_radar is specified .true. +ix_dfi_radar cu_gf_driver index within dfi_radar_tten of each timespan (-1 means "none") -1 +dfi_radar_max_intervals cu_gf_driver number of radar-derived temperature tendency and/or convection suppression intervals 4 \b Parameters \b related \b to \b surface \b perturbation \b options -nsfcpert GFS_surface_generic_pre number of weights for stochastic surface perturbation 0 -pertz0 GFS_surface_generic_pre magnitude of perturbation of momentum roughness length -999. -pertzt GFS_surface_generic_pre magnitude of perturbation of heat to momentum roughness length ratio -999. -pertshc GFS_surface_generic_pre magnitude of perturbation of soil hydraulic conductivity -999. -pertlai GFS_surface_generic_pre magnitude of perturbation of leaf area index -999. -pertalb GFS_surface_generic_pre magnitude of surface albedo perturbation -999. -pertvegf GFS_surface_generic_pre magnitude of perturbation of vegetation fraction -999. +nsfcpert gfs_surface_generic_pre number of weights for stochastic surface perturbation 0 +pertz0 gfs_surface_generic_pre magnitude of perturbation of momentum roughness length -999. +pertzt gfs_surface_generic_pre magnitude of perturbation of heat to momentum roughness length ratio -999. +pertshc gfs_surface_generic_pre magnitude of perturbation of soil hydraulic conductivity -999. +pertlai gfs_surface_generic_pre magnitude of perturbation of leaf area index -999. +pertalb gfs_surface_generic_pre magnitude of surface albedo perturbation -999. +pertvegf gfs_surface_generic_pre magnitude of perturbation of vegetation fraction -999. +\b Parameters \b related \b to \b Cellular \b Automata \b options +do_ca \ref samfdeepcnv, gfs_stochastics cellular automata main switch .false. +ca_closure \ref samfdeepcnv logical switch for CA on closure .false +ca_entr \ref samfdeepcnv logical swith for CA on entrainment .false +ca_trigger \ref samfdeepcnv logical switch for CA on trigger .false. \b Parameters \b related \b to \b microphysics \b scheme \b options lradar gfdl_cloud_microphys flag for computing radar reflectivity in Thompson MP scheme .false. sedi_transport gfdl_cloud_microphys flag for turning on horizontal momentum transport during sedimentation .true. @@ -384,42 +376,20 @@ show some variables in the namelist that must match the SDF. mp_print gfdl_cloud_microphys \a .true. to turn on GFDL cloud microphysics debugging print out. (not supported in GFS physics) .false. ltaerosol mp_thompson flag for using aerosol climotology in Thompson MP scheme .false. ttendlim mp_thompson temperature tendency limiter per time step in K/s, set to < 0 to deactivate -999.0 -effr_in gfdl_cloud_microphys, mp_thompson, m_micro flag for using input cloud effective radii calculation .false. +ext_diag_thompson mp_thompson flag for extended diagnostic output from Thompson MP .false. +thompson_ext_ndiag3d mp_thompson number of 3d arrays for extended diagnostic output from Thompson MP 37 +dt_inner mp_thompson time step for the inner loop in second -999.0 +sedi_semi mp_thompson flag for semi Lagrangian sedi of rain .false. +decfl mp_thompson deformed CFL factor 8 +effr_in gfdl_cloud_microphys, mp_thompson flag for using input cloud effective radii calculation .false. cnvcld see \a GFS_typedefs.F90 flag for convective cloud .false. -lgfdlmprad GFS_rrtmg_pre flag for GFDL mp scheme and radiation consistency .false. -do_sb_physics m_micro flag for SB2001 autoconversion or accretion .true. -do_cldice m_micro flag for cloud ice processes for MG microphysics .true. -hetfrz_classnuc m_micro flag for heterogeneous freezing for MG microphysics .false. -mg_nccons m_micro flag for constant droplet concentration for MG microphysics .false. -mg_nicons m_micro flag for constant ice concentration for MG microphysics .false. -mg_ngcons m_micro flag for constant graupel concentration for MG microphysics .false. -sed_supersat m_micro flag for allowing supersaturation after sedimentation for MG microphysics .true. -mg_do_graupel m_micro flag for turning on prognostic graupel (with fprcp=2) .true. -mg_do_hail m_micro flag for turning on prognostic hail (with fprcp=2) .false. -microp_uniform m_micro flag for uniform subcolumns for MG microphysics .true. -mg_do_ice_gmao m_micro flag for turning on gmao ice autoconversion in MG microphysics .false. -mg_do_liq_liu m_micro flag for turning on Liu liquid treatment in MG microphysics .true. -mg_dcs m_micro autoconversion size threshold for cloud ice to snow in MG microphysics 200.0 -mg_ts_auto_ice(2) m_micro autoconversion time scale for ice in MG microphysics 180.0,180.0 -mg_qcvar m_micro cloud water relative variance in MG microphysics 1.0 -mg_rhmini m_micro relative humidity threshold parameter for nucleating ice 1.01 -mg_ncnst m_micro constant droplet num concentration \f$m^{-3}\f$ 100.e6 -mg_ninst m_micro constant ice num concentration \f$m^{-3}\f$ 0.15e6 -mg_ngnst m_micro constant graupel/hail num concertration \f$m^{-3}\f$ 0.10e6 -mg_berg_eff_factor m_micro berg efficiency factor 2.0 -mg_precip_frac_method m_micro type of precipitation fraction method 'max_overlap' -fprcp m_micro number of frozen precipitation species in MG microphysics \n -
    -
  • 0: no prognostic rain and snow -
  • 1: MG2 -
  • 2: MG3 -
- 0 -pdfflag m_micro pdf flag for MG macro physics 4 -iccn m_micro flag for using IN and CCN forcing in MG2/3 microphysics .false. -iaerclm m_micro flag for initializing aerosol data .false. -rhcmax m_micro maximum critical relative humidity 0.9999999 -aero_in m_micro flag for using aerosols in Morrison-Gettelman microphysics .false. +lgfdlmprad gfs_rrtmg_pre flag for GFDL mp scheme and radiation consistency .false. +nssl_cccn mp_nssl CCN concentration (m^-3) 0.6e9 +nssl_alphah mp_nssl graupel shape parameter 0.0 +nssl_alphahl mp_nssl hail shape parameter 1.0 +nssl_hail_on mp_nssl NSSL flag to activate the hail category .false. +nssl_ccn_on mp_nssl NSSL flag to activate the CCN category .true. +nssl_invertccn mp_nssl NSSL flag to treat CCN as activated or unactivated .true. \b Parameters \b related \b to \b gravity \b drag \b scheme \b options knob_ugwp_version cires_ugwp parameter selects a version of the UGWP implementation in FV3GFS-127L \n
    @@ -493,18 +463,24 @@ show some variables in the namelist that must match the SDF.
  • [4]: TKE for future tests and applications
2.0,0.25,1.0,1.0 -do_cnvgwd gwdc flag for convective GWD cnvgwd .and. maxval(cdmbgwd(3:4)) == 0.0 nmtvr cires_ugwp number of topographic variables such as variance etc used in the GWD parameterization-10 more added if GSL orographic drag scheme is used 14 -cgwf cires_ugwp ,gwdc multiplication factor for convective GWD 0.5d0,0.05d0 +cgwf cires_ugwp, unified_ugwp multiplication factor for convective GWD 0.5d0,0.05d0 do_gwd see \a GFS_typedefs.F90 flag for gravity wave drag maxval(cdmbgwd) > 0.0 gwd_opt drag_suite flag for GWD scheme \n
  • 1: original GFS GWD +
  • 2: Unified UGWP GWD +
  • 22: Unified UGWP GWD with extra output
  • 3: GSL drag suite
  • 33: GSL drag suite with extra output -
1 +do_ugwp_v0 unified_ugwp flag for version 0 UGWP GWD .true. +do_ugwp_v0_orog_only unified_ugwp flag for version 0 UGWP GWD (orographic drag only) .false. +do_ugwp_v0_nst_only unified_ugwp flag for version 0 UGWP GWD (non-stationary GWD only) .false. +do_gsl_drag_ls_bl unified_ugwp, drag_suite flag for GSL drag (large-scale GWD and blocking only) .false. +do_gsl_drag_ss unified_ugwp, drag_suite flag for GSL drag (small-scale GWD only) .false. +do_gsl_drag_tofd unified_ugwp, drag_suite flag for GSL drag (turbulent orog form drag only) .false. \b Parameters \b related \b to \b LSM \b options lsm see \a GFS_typedefs.F90 flag for land surface model to use \n
    @@ -616,18 +592,25 @@ show some variables in the namelist that must match the SDF.
  • 3: same as 1, but fsno for ts calculation (generally improve snow; v3.7)
1 - - nstf_name(5) sfc_nst NSST related paramters:\n +iopt_trs \ref noahmpdrv options for thermal roughness scheme:\n
    -
  • nstf_name(1): 0=NSST off, 1= NSST on but uncoupled, 2= NSST on and coupled -
  • nstf_name(2): 1=NSST spin up on, 0=NSST spin up off -
  • nstf_name(3): 1=NSST analysis on, 0=NSST analysis off -
  • nstf_name(4): zsea1 in mm -
  • nstf_name(5): zesa2 in mm +
  • 1: z0h=z0m +
  • 2: czil +
  • 3: ec +
  • 4: kb inversed
- /0,0,1,0,5/ + 2 \b Parameters \b related \b to \b other \b surface \b scheme \b options -nst_anl GFS_phys_time_vary flag for NSST analysis in gcycle/sfcsub .false. +nstf_name(5) sfc_nst NSST related paramters:\n +
    +
  • nstf_name(1): 0=NSST off, 1= NSST on but uncoupled, 2= NSST on and coupled +
  • nstf_name(2): 1=NSST spin up on, 0=NSST spin up off +
  • nstf_name(3): 1=NSST analysis on, 0=NSST analysis off +
  • nstf_name(4): zsea1 in mm +
  • nstf_name(5): zesa2 in mm +
+ /0,0,1,0,5/ +nst_anl gfs_phys_time_vary flag for NSST analysis in gcycle/sfcsub .false. frac_grid fractional grid flag for fractional grid .false. min_lakeice fractional grid minimum lake ice value 0.15d0 min_seaice fractional grid minimum sea ice value 1.0d-11 @@ -641,8 +624,10 @@ show some variables in the namelist that must match the SDF. 0 redrag sfc_diff flag for applying reduced drag coefficient for high wind over sea in GFS surface layer scheme .false. -lheatstrg GFS_surface_generic_post flag for canopy heat storage parameterization .false. -z0fac GFS_surface_generic_post surface roughness fraction factor 0.3 -e0fac GFS_surface_generic_post latent heat flux fraction factor relative to sensible heat flux,e.g., e0fac=0.5 indicates that canopy heat storage for latent heat flux is 50% of that for sensible heat flux 0.5 +lheatstrg gfs_surface_generic_post flag for canopy heat storage parameterization .false. +z0fac gfs_surface_generic_post surface roughness fraction factor 0.3 +e0fac gfs_surface_generic_post latent heat flux fraction factor relative to sensible heat flux,e.g., e0fac=0.5 indicates that canopy heat storage for latent heat flux is 50% of that for sensible heat flux 0.5 + + */ diff --git a/physics/drag_suite.F90 b/physics/drag_suite.F90 index b4bd4e4d9..3c8c42123 100644 --- a/physics/drag_suite.F90 +++ b/physics/drag_suite.F90 @@ -1,12 +1,14 @@ -!> \File drag_suite.F90 +!> \file drag_suite.F90 !! This file is the parameterization of orographic gravity wave !! drag, mountain blocking, and form drag. -!> This module contains the CCPP-compliant orographic gravity wave dray scheme. module drag_suite contains +!> \defgroup gfs_drag_suite_mod GSL drag_suite Module +!> This module contains the CCPP-compliant GSL orographic gravity wave dray scheme. +!> @{ subroutine drag_suite_init(gwd_opt, errmsg, errflg) integer, intent(in) :: gwd_opt @@ -27,9 +29,7 @@ subroutine drag_suite_init(gwd_opt, errmsg, errflg) end if end subroutine drag_suite_init -! \defgroup GFS_ogwd GFS Orographic Gravity Wave Drag -!> \defgroup gfs_drag_suite GFS drag_suite Main -!! \brief This subroutine includes orographic gravity wave drag, mountain +!> \brief This subroutine includes orographic gravity wave drag, mountain !! blocking, and form drag. !! !> The time tendencies of zonal and meridional wind are altered to @@ -200,7 +200,6 @@ end subroutine drag_suite_init !! an independent process. The next step is to test !! !> \section det_drag_suite GFS Orographic GWD Scheme Detailed Algorithm -!> @{ subroutine drag_suite_run( & & IM,KM,dvdt,dudt,dtdt,U1,V1,T1,Q1,KPBL, & & PRSI,DEL,PRSL,PRSLK,PHII,PHIL,DELTIM,KDT, & @@ -1377,7 +1376,6 @@ subroutine drag_suite_run( & end subroutine drag_suite_run !------------------------------------------------------------------- ! - subroutine drag_suite_finalize() - end subroutine drag_suite_finalize +!> @} end module drag_suite diff --git a/physics/get_prs_fv3.F90 b/physics/get_prs_fv3.F90 index 0234f26c9..db536fdf5 100644 --- a/physics/get_prs_fv3.F90 +++ b/physics/get_prs_fv3.F90 @@ -15,7 +15,7 @@ module get_prs_fv3 contains -!! \section arg_table_get_prs_fv3_run Argument Table +!> \section arg_table_get_prs_fv3_run Argument Table !! \htmlinclude get_prs_fv3_run.html !! subroutine get_prs_fv3_run(ix, levs, con_fvirt, phii, prsi, tgrs, qgrs1, del, del_gz, errmsg, errflg) @@ -53,4 +53,4 @@ subroutine get_prs_fv3_run(ix, levs, con_fvirt, phii, prsi, tgrs, qgrs1, del, de end subroutine get_prs_fv3_run -end module get_prs_fv3 \ No newline at end of file +end module get_prs_fv3 diff --git a/physics/gfdl_cloud_microphys.F90 b/physics/gfdl_cloud_microphys.F90 index 309cbac92..4e8b3d586 100644 --- a/physics/gfdl_cloud_microphys.F90 +++ b/physics/gfdl_cloud_microphys.F90 @@ -98,10 +98,9 @@ end subroutine gfdl_cloud_microphys_finalize !>\defgroup gfdlmp GFDL Cloud Microphysics Module !! This is cloud microphysics package for GFDL global cloud resolving model. !! The algorithms are originally derived from Lin et al. (1983) \cite lin_et_al_1983. -!! most of the key elements have been simplified/improved. This code at this stage -!! bears little to no similarity to the original Lin MP in zetac. -!! therefore, it is best to be called GFDL microphysics (GFDL MP) . -!>\author Shian-Jiann Lin, Linjiong Zhou +!! Most of the key elements have been simplified/improved. This code at this stage +!! bears little to no similarity to the original Lin MP. +!! Therefore, it is best to be called GFDL microphysics (GFDL MP) . !! !>\brief The module contains the GFDL cloud !! microphysics (Chen and Lin (2013) \cite chen_and_lin_2013 ). diff --git a/physics/gwdc.f b/physics/gwdc.f index 8ece20aea..9fa213c55 100644 --- a/physics/gwdc.f +++ b/physics/gwdc.f @@ -31,7 +31,7 @@ subroutine gwdc_init(do_cnvgwd, errmsg, errflg) end subroutine gwdc_init -!> \defgroup GFS_gwdc_run GFS Convective Gravity Wave Drag Scheme Module +!> \defgroup GFS_gwdc_run GFS Convective Gravity Wave Drag Module !! \brief This subroutine is the parameterization of convective gravity wave !! drag based on the theory given by Chun and Baik (1998) !! \cite chun_and_baik_1998 modified for implementation into the @@ -1360,4 +1360,4 @@ subroutine gwdc_run (im,km,lat,u1,v1,t1,q1,deltim, & end subroutine gwdc_run !> @} - end module gwdc \ No newline at end of file + end module gwdc diff --git a/physics/gwdps.f b/physics/gwdps.f index 12b2fefa0..e894104a0 100644 --- a/physics/gwdps.f +++ b/physics/gwdps.f @@ -7,11 +7,8 @@ module gwdps contains - subroutine gwdps_init() - end subroutine gwdps_init - -!> \defgroup gfs_gwdps GFS Orographic Gravity Wave Drag and Mountain Blocking Scheme Module -!! \brief This subroutine includes orographic gravity wave drag and mountain +!> \defgroup gfs_gwdps GFS gwdps Module +!! This subroutine includes orographic gravity wave drag and mountain !! blocking. !! !> The time tendencies of zonal and meridional wind are altered to @@ -1313,8 +1310,4 @@ subroutine gwdps_run( & RETURN end subroutine gwdps_run !> @} - - subroutine gwdps_finalize() - end subroutine gwdps_finalize - end module gwdps diff --git a/physics/h2ophys.f b/physics/h2ophys.f index e21417e80..d2d2cdf16 100644 --- a/physics/h2ophys.f +++ b/physics/h2ophys.f @@ -30,7 +30,7 @@ subroutine h2ophys_init(h2o_phys, errmsg, errflg) endif end subroutine h2ophys_init -!>\defgroup GFS_h2ophys GFS Water Vapor Photochemical Production and Loss Module +!>\defgroup GFS_h2ophys GFS Water Vapor Photochemical Module !> This subroutine is NRL H2O physics for stratosphere and mesosphere. !! \section arg_table_h2ophys_run Argument Table !! \htmlinclude h2ophys_run.html diff --git a/physics/lsm_noah.f b/physics/lsm_noah.f index d519dcda5..229f3020a 100644 --- a/physics/lsm_noah.f +++ b/physics/lsm_noah.f @@ -16,8 +16,7 @@ module lsm_noah contains -!>\ingroup Noah_LSM -!! This subroutine contains the CCPP-compliant lsm_noah_init to initialize soil vegetation. +!> This subroutine contains the CCPP-compliant lsm_noah_init to initialize soil vegetation. !! \section arg_table_lsm_noah_init Argument Table !! \htmlinclude lsm_noah_init.html !! @@ -202,15 +201,15 @@ end subroutine lsm_noah_finalize ! ==================== end of description ===================== ! !>\defgroup Noah_LSM GFS Noah LSM Model -!! \brief This is Noah LSM driver module, with the functionality of +!! This is Noah LSM driver module, with the functionality of !! preparing variables to run Noah LSM gfssflx(), calling Noah LSM and post-processing !! variables for return to the parent model suite including unit conversion, as well !! as diagnotics calculation. +!> @{ !! \section arg_table_lsm_noah_run Argument Table !! \htmlinclude lsm_noah_run.html !! -!> \section general_noah_drv GFS sfc_drv General Algorithm -!> @{ +!> \section general_noah_drv Noah LSM General Algorithm subroutine lsm_noah_run & & ( im, km, grav, cp, hvap, rd, eps, epsm1, rvrdm1, ps, & ! --- inputs: & t1, q1, soiltyp, vegtype, sigmaf, & @@ -362,7 +361,7 @@ subroutine lsm_noah_run & snowc(i) = zero snohf(i) = zero -!> - initialize variables wind, q, and rh at level 1. +!> - Initialize variables wind, q, and rh at level 1. q0(i) = max(q1(i), qmin) !* q1=specific humidity at level 1 (kg/kg) theta1(i) = t1(i) * prslki(i) !* adiabatic temp at level 1 (k) @@ -377,7 +376,7 @@ subroutine lsm_noah_run & enddo !> - Prepare variables to run Noah LSM: -!! - 1. configuration information (c): +! - 1. configuration information (c): ! couple couple-uncouple flag (=1: coupled, =0: uncoupled) ! ffrozp flag for snow-rain detection (1.=snow, 0.=rain) ! ice sea-ice flag (=1: sea-ice, =0: land) @@ -404,7 +403,7 @@ subroutine lsm_noah_run & sldpth(k) = zsoil(i,k-1) - zsoil(i,k) enddo -!> - 2. forcing data (f): +! - 2. forcing data (f): ! lwdn lw dw radiation flux (\f$W m^{-2}\f$) ! solnet - net sw radiation flux (dn-up) (\f$W m^{-2}\f$) ! sfcprs - pressure at height zlvl above ground (pascals) @@ -429,7 +428,7 @@ subroutine lsm_noah_run & th2 = theta1(i) q2 = q0(i) -!> - 3. other forcing (input) data (i): +! - 3. other forcing (input) data (i): ! sfcspd - wind speed (\f$m s^{-1}\f$) at height zlvl above ground ! q2sat - sat mixing ratio at height zlvl above ground (\f$kg kg^{-1}\f$) ! dqsdt2 - slope of sat specific humidity curve at t=sfctmp (\f$kg kg^{-1} k^{-1}\f$) @@ -438,7 +437,7 @@ subroutine lsm_noah_run & q2sat = qs1(i) dqsdt2 = q2sat * a23m4/(sfctmp-a4)**2 -!> - 4. canopy/soil characteristics (s): +! - 4. canopy/soil characteristics (s): ! vegtyp - vegetation type (integer index) -> vtype ! soiltyp - soil type (integer index) -> stype ! slopetyp- class of sfc slope (integer index) -> slope @@ -454,7 +453,7 @@ subroutine lsm_noah_run & slope = slopetyp(i) shdfac= sigmaf(i) -!> - Call surface_perturbation::ppfbet() to perturb vegetation fraction that goes into gsflx(). +!> - Call surface_perturbation::ppfbet() to perturb vegetation fraction that goes into gfssflx(). ! perturb vegetation fraction that goes into sflx, use the same ! perturbation strategy as for albedo (percentile matching) !! Following Gehne et al. (2018) \cite gehne_et_al_2018, a perturbation of vegetation @@ -485,7 +484,7 @@ subroutine lsm_noah_run & alb = sfalb(i) tbot = tg3(i) -!> - 5. history (state) variables (h): +! - 5. history (state) variables (h): ! cmc - canopy moisture content (\f$m\f$) ! t1 - ground/canopy/snowpack effective skin temperature (\f$K\f$) -> tsea ! stc(nsoil) - soil temp (\f$K\f$) -> stsoil @@ -521,7 +520,7 @@ subroutine lsm_noah_run & ! ---- ... outside sflx, roughness uses cm as unit z0 = zorl(i) * 0.01_kind_phys ! ---- mgehne, sfc-perts -! - Apply perturbation of soil type b parameter and leave area index. +!> - Apply perturbation of soil type b parameter and leave area index. bexpp = bexppert(i) ! sfc perts, mgehne xlaip = xlaipert(i) ! sfc perts, mgehne @@ -546,16 +545,16 @@ subroutine lsm_noah_run & & rcsoil, soilw, soilm, smcwlt, smcdry, smcref, smcmax) !> - Noah LSM: prepare variables for return to parent model and unit conversion. -!> - 6. output (o): -!!\n eta - actual latent heat flux (\f$W m^{-2}\f$: positive, if upward from sfc) -!!\n sheat - sensible heat flux (\f$W m^{-2}\f$: positive, if upward from sfc) -!!\n beta - ratio of actual/potential evap (dimensionless) -!!\n etp - potential evaporation (\f$W m^{-2}\f$) -!!\n ssoil - soil heat flux (\f$W m^{-2}\f$: negative if downward from surface) -!!\n runoff1 - surface runoff (\f$m s^{-1}\f$), not infiltrating the surface -!!\n runoff2 - subsurface runoff (\f$m s^{-1}\f$), drainage out bottom -!!\n xlai - leaf area index (dimensionless) -!!\n rca - canopy resistance (s/m) +! - 6. output (o): +! eta - actual latent heat flux (\f$W m^{-2}\f$: positive, if upward from sfc) +! sheat - sensible heat flux (\f$W m^{-2}\f$: positive, if upward from sfc) +! beta - ratio of actual/potential evap (dimensionless) +! etp - potential evaporation (\f$W m^{-2}\f$) +! ssoil - soil heat flux (\f$W m^{-2}\f$: negative if downward from surface) +! runoff1 - surface runoff (\f$m s^{-1}\f$), not infiltrating the surface +! runoff2 - subsurface runoff (\f$m s^{-1}\f$), drainage out bottom +! xlai - leaf area index (dimensionless) +! rca - canopy resistance (s/m) evap(i) = eta hflx(i) = sheat @@ -597,54 +596,54 @@ subroutine lsm_noah_run & lai(i) = xlai rca(i) = rc -!> - Do not return the following output fields to parent model: -!!\n ec - canopy water evaporation (m s-1) -!!\n edir - direct soil evaporation (m s-1) -!!\n et(nsoil)-plant transpiration from a particular root layer (m s-1) -!!\n ett - total plant transpiration (m s-1) -!!\n esnow - sublimation from (or deposition to if <0) snowpack (m s-1) -!!\n drip - through-fall of precip and/or dew in excess of canopy -!! water-holding capacity (m) -!!\n dew - dewfall (or frostfall for t<273.15) (m) -!!\n beta - ratio of actual/potential evap (dimensionless) -!!\n flx1 - precip-snow sfc (w m-2) -!!\n flx2 - freezing rain latent heat flux (w m-2) -!!\n flx3 - phase-change heat flux from snowmelt (w m-2) -!!\n snomlt - snow melt (m) (water equivalent) -!!\n sncovr - fractional snow cover (unitless fraction, 0-1) -!!\n runoff3 - numerical trunctation in excess of porosity (smcmax) -!! for a given soil layer at the end of a time step -!!\n rc - canopy resistance (s m-1) -!!\n pc - plant coefficient (unitless fraction, 0-1) where pc*etp -!! = actual transp -!!\n rsmin - minimum canopy resistance (s m-1) -!!\n rcs - incoming solar rc factor (dimensionless) -!!\n rct - air temperature rc factor (dimensionless) -!!\n rcq - atmos vapor pressure deficit rc factor (dimensionless) -!!\n rcsoil - soil moisture rc factor (dimensionless) -!!\n soilw - available soil moisture in root zone (unitless fraction -!! between smcwlt and smcmax) -!!\n soilm - total soil column moisture content (frozen+unfrozen) (m) -!!\n smcwlt - wilting point (volumetric) -!!\n smcdry - dry soil moisture threshold where direct evap frm top -!! layer ends (volumetric) -!!\n smcref - soil moisture threshold where transpiration begins to -!! stress (volumetric) -!!\n smcmax - porosity, i.e. saturated value of soil moisture -!! (volumetric) -!!\n nroot - number of root layers, a function of veg type, determined -!! in subroutine redprm. +! - Do not return the following output fields to parent model: +! ec - canopy water evaporation (m s-1) +! edir - direct soil evaporation (m s-1) +! et(nsoil)-plant transpiration from a particular root layer (m s-1) +! ett - total plant transpiration (m s-1) +! esnow - sublimation from (or deposition to if <0) snowpack (m s-1) +! drip - through-fall of precip and/or dew in excess of canopy +! water-holding capacity (m) +! dew - dewfall (or frostfall for t<273.15) (m) +! beta - ratio of actual/potential evap (dimensionless) +! flx1 - precip-snow sfc (w m-2) +! flx2 - freezing rain latent heat flux (w m-2) +! flx3 - phase-change heat flux from snowmelt (w m-2) +! snomlt - snow melt (m) (water equivalent) +! sncovr - fractional snow cover (unitless fraction, 0-1) +! runoff3 - numerical trunctation in excess of porosity (smcmax) +! for a given soil layer at the end of a time step +! rc - canopy resistance (s m-1) +! pc - plant coefficient (unitless fraction, 0-1) where pc*etp +! = actual transp +! rsmin - minimum canopy resistance (s m-1) +! rcs - incoming solar rc factor (dimensionless) +! rct - air temperature rc factor (dimensionless) +! rcq - atmos vapor pressure deficit rc factor (dimensionless) +! rcsoil - soil moisture rc factor (dimensionless) +! soilw - available soil moisture in root zone (unitless fraction +! between smcwlt and smcmax) +! soilm - total soil column moisture content (frozen+unfrozen) (m) +! smcwlt - wilting point (volumetric) +! smcdry - dry soil moisture threshold where direct evap frm top +! layer ends (volumetric) +! smcref - soil moisture threshold where transpiration begins to +! stress (volumetric) +! smcmax - porosity, i.e. saturated value of soil moisture +! (volumetric) +! nroot - number of root layers, a function of veg type, determined +! in subroutine redprm. ! endif ! end if flag_iter and flag ! enddo ! end do_i_loop -!> - Compute specific humidity at surface (\a qsurf). +!> - Compute specific humidity at surface (\p qsurf). rch(i) = rho(i) * cp * ch(i) * wind(i) qsurf(i) = q1(i) + evap(i) / (elocp * rch(i)) -!> - Compute surface upward sensible heat flux (\a hflx) and evaporation -!! flux (\a evap). +!> - Compute surface upward sensible heat flux (\p hflx) and evaporation +!! flux (\p evap). tem = one / rho(i) hflx(i) = hflx(i) * tem * cpinv evap(i) = evap(i) * tem * hvapi diff --git a/physics/lsm_ruc.F90 b/physics/lsm_ruc.F90 index 3ca78ad04..3f163bf7e 100644 --- a/physics/lsm_ruc.F90 +++ b/physics/lsm_ruc.F90 @@ -313,13 +313,13 @@ end subroutine lsm_ruc_finalize ! ! ! ==================== end of description ===================== ! -!> \defgroup lsm_ruc_group GSD RUC LSM Model -!! This module contains the RUC Land Surface Model developed by NOAA/GSD +!> \defgroup lsm_ruc_group RUC LSM Model +!! This module contains the RUC Land Surface Model developed by NOAA/GSL !! (Smirnova et al. 2016 \cite Smirnova_2016). !> \section arg_table_lsm_ruc_run Argument Table !! \htmlinclude lsm_ruc_run.html !! -!>\section gen_lsmruc GSD RUC LSM General Algorithm +!>\section gen_lsmruc RUC LSM General Algorithm subroutine lsm_ruc_run & ! inputs & ( iter, me, master, delt, kdt, im, nlev, lsm_ruc, lsm, & & imp_physics, imp_physics_gfdl, imp_physics_thompson, & diff --git a/physics/maximum_hourly_diagnostics.F90 b/physics/maximum_hourly_diagnostics.F90 index 6beae0da2..11cf7c79e 100644 --- a/physics/maximum_hourly_diagnostics.F90 +++ b/physics/maximum_hourly_diagnostics.F90 @@ -1,3 +1,4 @@ +!>\file maximum_hourly_diagnostics.F90 module maximum_hourly_diagnostics use machine, only: kind_phys diff --git a/physics/module_bl_mynn.F90 b/physics/module_bl_mynn.F90 index 3b0150e9e..f6507c1f1 100644 --- a/physics/module_bl_mynn.F90 +++ b/physics/module_bl_mynn.F90 @@ -480,8 +480,7 @@ MODULE module_bl_mynn ! !------------------------------------------------------------------- -!>\ingroup gsd_mynn_edmf -!! This subroutine initializes the mixing length, TKE, \f$\theta^{'2}\f$, +!> This subroutine initializes the mixing length, TKE, \f$\theta^{'2}\f$, !! \f$q^{'2}\f$, and \f$\theta^{'}q^{'}\f$. !!\section gen_mym_ini GSD MYNN-EDMF mym_initialize General Algorithm !> @{ @@ -668,8 +667,7 @@ END SUBROUTINE mym_initialize ! These are defined on the walls of the grid boxes. ! -!>\ingroup gsd_mynn_edmf -!! This subroutine calculates the level 2, non-dimensional wind shear +!> This subroutine calculates the level 2, non-dimensional wind shear !! \f$G_M\f$ and vertical temperature gradient \f$G_H\f$ as well as !! the level 2 stability funcitons \f$S_h\f$ and \f$S_m\f$. !!\param kts horizontal dimension @@ -678,7 +676,10 @@ END SUBROUTINE mym_initialize !!\param u west-east component of the horizontal wind (\f$m s^{-1}\f$) !!\param v south-north component of the horizontal wind (\f$m s^{-1}\f$) !!\param thl liquid water potential temperature +!!\param thetav !!\param qw total water content \f$Q_w\f$ +!!\param thlsg +!!\param gwsg !!\param ql liquid water content (\f$kg kg^{-1}\f$) !!\param vt !!\param vq @@ -824,8 +825,7 @@ END SUBROUTINE mym_level2 ! NOTE: the mixing lengths are meant to be calculated at the full- ! sigmal levels (or interfaces beween the model layers). ! -!>\ingroup gsd_mynn_edmf -!! This subroutine calculates the mixing lengths. +!> This subroutine calculates the mixing lengths. SUBROUTINE mym_length ( & & kts,kte, & & dz, dx, zw, & @@ -1235,8 +1235,7 @@ SUBROUTINE mym_length ( & END SUBROUTINE mym_length ! ================================================================== -!>\ingroup gsd_mynn_edmf -!! This subroutine was taken from the BouLac scheme in WRF-ARW and modified for +!> This subroutine was taken from the BouLac scheme in WRF-ARW and modified for !! integration into the MYNN PBL scheme. WHILE loops were added to reduce the !! computational expense. This subroutine computes the length scales up and down !! and then computes the min, average of the up/down length scales, and also @@ -1398,8 +1397,7 @@ SUBROUTINE boulac_length0(k,kts,kte,zw,dz,qtke,theta,lb1,lb2) END SUBROUTINE boulac_length0 ! ================================================================== -!>\ingroup gsd_mynn_edmf -!! This subroutine was taken from the BouLac scheme in WRF-ARW +!> This subroutine was taken from the BouLac scheme in WRF-ARW !! and modified for integration into the MYNN PBL scheme. !! WHILE loops were added to reduce the computational expense. !! This subroutine computes the length scales up and down @@ -1589,8 +1587,7 @@ END SUBROUTINE boulac_length ! # dtl, dqw, dtv, gm and gh are allowed to share storage units with ! dfm, dfh, dfq, tcd and qcd, respectively, for saving memory. ! -!>\ingroup gsd_mynn_edmf -!! This subroutine calculates the vertical diffusivity coefficients and the +!> This subroutine calculates the vertical diffusivity coefficients and the !! production terms for the turbulent quantities. !>\section gen_mym_turbulence GSD mym_turbulence General Algorithm !! Two subroutines mym_level2() and mym_length() are called within this @@ -2171,8 +2168,7 @@ END SUBROUTINE mym_turbulence ! scheme (program). ! !------------------------------------------------------------------- -!>\ingroup gsd_mynn_edmf -!! This subroutine predicts the turbulent quantities at the next step. +!> This subroutine predicts the turbulent quantities at the next step. SUBROUTINE mym_predict (kts,kte, & & closure, & & delt, & @@ -2575,8 +2571,7 @@ END SUBROUTINE mym_predict ! Set these values to those adopted by you. ! !------------------------------------------------------------------- -!>\ingroup gsd_mynn_edmf -!! This subroutine calculates the nonconvective component of the +!> This subroutine calculates the nonconvective component of the !! subgrid cloud fraction and mixing ratio as well as the functions used to !! calculate the buoyancy flux. Different cloud PDFs can be selected by !! use of the namelist parameter \p bl_mynn_cloudpdf . @@ -3089,8 +3084,7 @@ SUBROUTINE mym_condensation (kts,kte, & END SUBROUTINE mym_condensation ! ================================================================== -!>\ingroup gsd_mynn_edmf -!! This subroutine solves for tendencies of U, V, \f$\theta\f$, qv, +!> This subroutine solves for tendencies of U, V, \f$\theta\f$, qv, !! qc, and qi SUBROUTINE mynn_tendencies(kts,kte, & &closure,grav_settling, & @@ -4074,14 +4068,12 @@ SUBROUTINE mynn_tendencies(kts,kte, & END SUBROUTINE mynn_tendencies -! ================================================================== +!> This subroutine was adopted from the CAM-UW ShCu scheme and +!! adapted for use here. SUBROUTINE moisture_check(kte, delt, dp, exner, & qv, qc, qi, th, & dqv, dqc, dqi, dth ) - ! This subroutine was adopted from the CAM-UW ShCu scheme and - ! adapted for use here. - ! ! If qc < qcmin, qi < qimin, or qv < qvmin happens in any layer, ! force them to be larger than minimum value by (1) condensating ! water vapor into liquid or ice, and (2) by transporting water vapor @@ -4162,6 +4154,7 @@ END SUBROUTINE moisture_check ! ================================================================== #if (WRF_CHEM == 1) +!> THis subroutine SUBROUTINE mynn_mix_chem(kts,kte,i, & grav_settling, & delt,dz,pblh, & @@ -4309,7 +4302,7 @@ END SUBROUTINE mynn_mix_chem #endif ! ================================================================== -!>\ingroup gsd_mynn_edmf +!> This subroutine retrives exchange coeffs km/kh. SUBROUTINE retrieve_exchange_coeffs(kts,kte,& &dfm,dfh,dz,K_m,K_h) @@ -4337,7 +4330,7 @@ SUBROUTINE retrieve_exchange_coeffs(kts,kte,& END SUBROUTINE retrieve_exchange_coeffs ! ================================================================== -!>\ingroup gsd_mynn_edmf +!> solve system of linear equs on tridiagnonal matrix ntime n. SUBROUTINE tridiag(n,a,b,c,d) !! to solve system of linear eqs on tridiagonal matrix n times n @@ -4373,7 +4366,7 @@ SUBROUTINE tridiag(n,a,b,c,d) END SUBROUTINE tridiag ! ================================================================== -!>\ingroup gsd_mynn_edmf +!> This subroutine subroutine tridiag2(n,a,b,c,d,x) implicit none ! a - sub-diagonal (means it is the diagonal below the main diagonal) @@ -4408,7 +4401,7 @@ subroutine tridiag2(n,a,b,c,d,x) end subroutine tridiag2 ! ================================================================== -!>\ingroup gsd_mynn_edmf +!> This subroutine solves inversion and resolution of a tridiagonal matrix. subroutine tridiag3(kte,a,b,c,d,x) !ccccccccccccccccccccccccccccccc @@ -4449,12 +4442,11 @@ subroutine tridiag3(kte,a,b,c,d,x) return end subroutine tridiag3 ! ================================================================== -!>\ingroup gsd_mynn_edmf -!! This subroutine is the GSD MYNN-EDNF PBL driver routine,which +!> This subroutine is the MYNN-EDNF PBL driver routine,which !! encompassed the majority of the subroutines that comprise the !! procedures that ultimately solve for tendencies of !! \f$U, V, \theta, q_v, q_c, and q_i\f$. -!!\section gen_mynn_bl_driver GSD mynn_bl_driver General Algorithm +!!\section gen_mynn_bl_driver MYNN-EDMF PBL Driver General Algorithm !> @{ SUBROUTINE mynn_bl_driver( & &initflag,restart,cycling, & @@ -5624,7 +5616,7 @@ END SUBROUTINE mynn_bl_driver !> @} ! ================================================================== -!>\ingroup gsd_mynn_edmf +!> This subroutine SUBROUTINE mynn_bl_init_driver( & &RUBLTEN,RVBLTEN,RTHBLTEN,RQVBLTEN, & &RQCBLTEN,RQIBLTEN & !,RQNIBLTEN,RQNCBLTEN & @@ -5680,8 +5672,7 @@ SUBROUTINE mynn_bl_init_driver( & END SUBROUTINE mynn_bl_init_driver ! ================================================================== -!>\ingroup gsd_mynn_edmf -!! This subroutine calculates hybrid diagnotic boundary-layer height (PBLH). +!> This subroutine calculates hybrid diagnotic boundary-layer height (PBLH). !! !! NOTES ON THE PBLH FORMULATION: The 1.5-theta-increase method defines !!PBL heights as the level at. @@ -5842,9 +5833,7 @@ SUBROUTINE GET_PBLH(KTS,KTE,zi,thetav1D,qke1D,zw1D,dz1D,landsea,kzi) END SUBROUTINE GET_PBLH !> @} -! ================================================================== -!>\ingroup gsd_mynn_edmf -!! This subroutine is the Dynamic Multi-Plume (DMP) Mass-Flux Scheme. +!> This subroutine is the Dynamic Multi-Plume (DMP) Mass-Flux Scheme. !! !! dmp_mf() calculates the nonlocal turbulent transport from the dynamic !! multiplume mass-flux scheme as well as the shallow-cumulus component of @@ -7004,12 +6993,9 @@ SUBROUTINE DMP_mf( & END SUBROUTINE DMP_MF !================================================================= -!>\ingroup gsd_mynn_edmf -!! This subroutine +!> zero or one condensation for edmf: calculates THV and QC subroutine condensation_edmf(QT,THL,P,zagl,THV,QC) ! -! zero or one condensation for edmf: calculates THV and QC -! real,intent(in) :: QT,THL,P,zagl real,intent(out) :: THV real,intent(inout):: QC @@ -7068,9 +7054,8 @@ end subroutine condensation_edmf !=============================================================== subroutine condensation_edmf_r(QT,THL,P,zagl,THV,QC) -! -! zero or one condensation for edmf: calculates THL and QC -! similar to condensation_edmf but with different inputs +!> zero or one condensation for edmf: calculates THL and QC +!! similar to condensation_edmf but with different inputs ! real,intent(in) :: QT,THV,P,zagl real,intent(out) :: THL, QC @@ -7103,12 +7088,10 @@ subroutine condensation_edmf_r(QT,THL,P,zagl,THV,QC) end subroutine condensation_edmf_r !=============================================================== -! =================================================================== -! This is the downdraft mass flux scheme - analogus to edmf_JPL but -! flipped updraft to downdraft. This scheme is currently only tested -! for Stratocumulus cloud conditions. For a detailed desctiption of the -! model, see paper. - +!> This is the downdraft mass flux scheme - analogus to edmf_JPL but +!! flipped updraft to downdraft. This scheme is currently only tested +!! for Stratocumulus cloud conditions. For a detailed desctiption of the +!! model, see paper. SUBROUTINE DDMF_JPL(kts,kte,dt,zw,dz,p, & &u,v,th,thl,thv,tk,qt,qv,qc, & &rho,exner, & @@ -7469,15 +7452,13 @@ SUBROUTINE DDMF_JPL(kts,kte,dt,zw,dz,p, & END SUBROUTINE DDMF_JPL !=============================================================== - +!> Add scale-aware factor (Psig) here, taken from Honnert et al. (2011) \cite Honnert_2011 +!! and/or from Shin and Hong (2013) \cite Shin_2013. SUBROUTINE SCALE_AWARE(dx,PBL1,Psig_bl,Psig_shcu) !--------------------------------------------------------------- ! NOTES ON SCALE-AWARE FORMULATION ! - !JOE: add scale-aware factor (Psig) here, taken from Honnert et al. (2011, - ! JAS) and/or from Hyeyum Hailey Shin and Song-You Hong (2013, JAS) - ! ! Psig_bl tapers local mixing ! Psig_shcu tapers nonlocal mixing @@ -7544,8 +7525,7 @@ SUBROUTINE SCALE_AWARE(dx,PBL1,Psig_bl,Psig_shcu) END SUBROUTINE SCALE_AWARE ! ===================================================================== -!>\ingroup gsd_mynn_edmf -!! \author JAYMES- added 22 Apr 2015 +!> \author JAYMES- added 22 Apr 2015 !! This function calculates saturation vapor pressure. Separate ice and liquid functions !! are used (identical to those in module_mp_thompson.F, v3.6). Then, the !! final returned value is a temperature-dependant "blend". Because the final @@ -7578,10 +7558,8 @@ END FUNCTION esat_blend ! ==================================================================== -!>\ingroup gsd_mynn_edmf -!! This function extends function "esat" and returns a "blended" +!> This function extends function "esat" and returns a "blended" !! saturation mixing ratio. -!!\author JAYMES FUNCTION qsat_blend(t, P, waterice) IMPLICIT NONE @@ -7618,8 +7596,7 @@ END FUNCTION qsat_blend ! =================================================================== -!>\ingroup gsd_mynn_edmf -!! This function interpolates the latent heats of vaporization and sublimation into +!> This function interpolates the latent heats of vaporization and sublimation into !! a single, temperature-dependent, "blended" value, following !! Chaboureau and Bechtold (2002) \cite Chaboureau_2002, Appendix. !!\author JAYMES @@ -7644,14 +7621,13 @@ FUNCTION xl_blend(t) END FUNCTION xl_blend ! =================================================================== - +!> New stability function parameters for momentum (Puhales, 2020, WRF 4.2.1) +!! The forms in unstable conditions (z/L < 0) use Grachev et al. (2000), which are a blend of +!! the classical (Kansas) forms (i.e., Paulson 1970, Dyer and Hicks 1970), valid for weakly +!! unstable conditions (-1 < z/L < 0). The stability functions for stable conditions use an +!! updated form taken from Cheng and Brutsaert (2005), which extends the validity into very +!! stable conditions [z/L ~ O(10)]. FUNCTION phim(zet) - ! New stability function parameters for momentum (Puhales, 2020, WRF 4.2.1) - ! The forms in unstable conditions (z/L < 0) use Grachev et al. (2000), which are a blend of - ! the classical (Kansas) forms (i.e., Paulson 1970, Dyer and Hicks 1970), valid for weakly - ! unstable conditions (-1 < z/L < 0). The stability functions for stable conditions use an - ! updated form taken from Cheng and Brutsaert (2005), which extends the validity into very - ! stable conditions [z/L ~ O(10)]. IMPLICIT NONE REAL, INTENT(IN):: zet @@ -7695,15 +7671,14 @@ FUNCTION phim(zet) phim = phi_m END FUNCTION phim -! =================================================================== +!> New stability function parameters for heat (Puhales, 2020, WRF 4.2.1) +!! The forms in unstable conditions (z/L < 0) use Grachev et al. (2000), which are a blend of +!! the classical (Kansas) forms (i.e., Paulson 1970, Dyer and Hicks 1970), valid for weakly +!! unstable conditions (-1 < z/L < 0). The stability functions for stable conditions use an +!! updated form taken from Cheng and Brutsaert (2005), which extends the validity into very +!! stable conditions [z/L ~ O(10)]. FUNCTION phih(zet) - ! New stability function parameters for heat (Puhales, 2020, WRF 4.2.1) - ! The forms in unstable conditions (z/L < 0) use Grachev et al. (2000), which are a blend of - ! the classical (Kansas) forms (i.e., Paulson 1970, Dyer and Hicks 1970), valid for weakly - ! unstable conditions (-1 < z/L < 0). The stability functions for stable conditions use an - ! updated form taken from Cheng and Brutsaert (2005), which extends the validity into very - ! stable conditions [z/L ~ O(10)]. IMPLICIT NONE REAL, INTENT(IN):: zet @@ -7745,6 +7720,7 @@ FUNCTION phih(zet) END FUNCTION phih ! ================================================================== +!> SUBROUTINE topdown_cloudrad(kts,kte,dz1,zw,xland,kpbl,PBLH, & &sqc,sqi,sqw,thl,th1,ex1,p1,rho1,thetav, & &cldfra_bl1D,rthraten, & diff --git a/physics/module_gfdl_cloud_microphys.F90 b/physics/module_gfdl_cloud_microphys.F90 index 7f00d9bca..3ebcfc587 100644 --- a/physics/module_gfdl_cloud_microphys.F90 +++ b/physics/module_gfdl_cloud_microphys.F90 @@ -674,7 +674,6 @@ end subroutine gfdl_cloud_microphys_mod_driver !! Rutledge and Hobbs (1984) \cite rutledge_and_hobbs_1984. !! !>\section detmpdrv GFDL Cloud mpdrv General Algorithm -!> @{ subroutine mpdrv (hydrostatic, uin, vin, w, delp, pt, qv, ql, qr, qi, qs, & qg, qa, qn, dz, is, ie, js, je, ks, ke, ktop, kbot, j, dt_in, ntimes, & rain, snow, graupel, ice, m2_rain, m2_sol, cond, area1, land, & @@ -1094,7 +1093,6 @@ subroutine mpdrv (hydrostatic, uin, vin, w, delp, pt, qv, ql, qr, qi, qs, & enddo end subroutine mpdrv -!> @} ! ----------------------------------------------------------------------- !>\ingroup mod_gfdl_cloud_mp @@ -1154,7 +1152,6 @@ end subroutine sedi_heat !>\ingroup mod_gfdl_cloud_mp !> This subroutine includes warm rain cloud microphysics. !>\section warm_gen GFDL Cloud warm_rain General Algorithm -!> @{ subroutine warm_rain (dt, ktop, kbot, dp, dz, tz, qv, ql, qr, qi, qs, qg, & den, denfac, ccn, c_praut, rh_rain, vtr, r1, m1_rain, w1, h_var) @@ -1370,13 +1367,11 @@ subroutine warm_rain (dt, ktop, kbot, dp, dz, tz, qv, ql, qr, qi, qs, qg, & endif end subroutine warm_rain -!> @} ! ----------------------------------------------------------------------- !>\ingroup mod_gfdl_cloud_mp !> This subroutine calculates evaporation of rain and accretion of rain. !!\section gen_ravap GFDL Cloud revap_racc General Algorithm -!> @{ subroutine revap_racc (ktop, kbot, dt, tz, qv, ql, qr, qi, qs, qg, den, denfac, rh_rain, h_var) implicit none @@ -1472,7 +1467,6 @@ subroutine revap_racc (ktop, kbot, dt, tz, qv, ql, qr, qi, qs, qg, den, denfac, enddo end subroutine revap_racc -!> @} ! ----------------------------------------------------------------------- !>\ingroup mod_gfdl_cloud_mp @@ -1481,7 +1475,6 @@ end subroutine revap_racc ! qi -- > ql & ql -- > qr ! edges: qe == qbar + / - dm !>\section gen_linear GFDL cloud linear_prof General Algorithm -!> @{ subroutine linear_prof (km, q, dm, z_var, h_var) implicit none @@ -1536,7 +1529,6 @@ subroutine linear_prof (km, q, dm, z_var, h_var) endif end subroutine linear_prof -!> @} ! ======================================================================= !>\ingroup mod_gfdl_cloud_mp @@ -1548,7 +1540,6 @@ end subroutine linear_prof !! - processes splitting with some un-split sub-grouping !! - time implicit (when possible) accretion and autoconversion !>\section det_icloud GFDL icloud Detailed Algorithm -!> @{ subroutine icloud (ktop, kbot, tzk, p1, qvk, qlk, qrk, qik, qsk, qgk, dp1, & den, denfac, vts, vtg, vtr, qak, rh_adj, rh_rain, dts, h_var) @@ -2031,13 +2022,11 @@ subroutine icloud (ktop, kbot, tzk, p1, qvk, qlk, qrk, qik, qsk, qgk, dp1, & qlk, qrk, qik, qsk, qgk, qak, h_var, rh_rain) end subroutine icloud -!> @} ! ======================================================================= !>\ingroup mod_gfdl_cloud_mp !> This subroutine calculates temperature sentive high vertical resolution processes. !>\section gen_subz GFDL Cloud subgrid_z_proc General Algorithm -!! @{ subroutine subgrid_z_proc (ktop, kbot, p1, den, denfac, dts, rh_adj, tz, qv, & ql, qr, qi, qs, qg, qa, h_var, rh_rain) @@ -2454,7 +2443,6 @@ subroutine subgrid_z_proc (ktop, kbot, p1, den, denfac, dts, rh_adj, tz, qv, & enddo end subroutine subgrid_z_proc -!! @} ! ======================================================================= !>\ingroup mod_gfdl_cloud_mp @@ -4763,7 +4751,7 @@ end subroutine interpolate_z !> \ingroup mod_gfdl_cloud_mp !! The subroutine 'cloud_diagnosis' diagnoses the radius of cloud !! species. -!>author Linjiong Zhoum, Shian-Jiann Lin +!>\author Linjiong Zhoum, Shian-Jiann Lin ! ======================================================================= subroutine cloud_diagnosis (is, ie, ks, ke, den, delp, lsm, qmw, qmi, qmr, qms, qmg, t, & rew, rei, rer, res, reg) @@ -5074,7 +5062,5 @@ subroutine refl10cm_gfdl (qv1d, qr1d, qs1d, qg1d, & end subroutine refl10cm_gfdl !+---+-----------------------------------------------------------------+ -!! @} -!! @} end module gfdl_cloud_microphys_mod diff --git a/physics/module_mp_thompson.F90 b/physics/module_mp_thompson.F90 index eaef27413..ace43ab8a 100644 --- a/physics/module_mp_thompson.F90 +++ b/physics/module_mp_thompson.F90 @@ -1,5 +1,5 @@ !>\file module_mp_thompson.F90 -!! This file contains the entity of GSD Thompson MP scheme. +!! This file contains the entity of Thompson MP scheme. !>\ingroup aathompson diff --git a/physics/module_mp_thompson_make_number_concentrations.F90 b/physics/module_mp_thompson_make_number_concentrations.F90 index b31753aa2..72a1055dd 100644 --- a/physics/module_mp_thompson_make_number_concentrations.F90 +++ b/physics/module_mp_thompson_make_number_concentrations.F90 @@ -25,7 +25,11 @@ module module_mp_thompson_make_number_concentrations !+---+-----------------------------------------------------------------+ contains - +!>\ingroup aathompson +!!Table of lookup values of radiative effective radius of ice crystals +!! as a function of Temperature from -94C to 0C. Taken from WRF RRTMG +!! radiation code where it is attributed to Jon Egill Kristjansson +!! and coauthors. elemental real function make_IceNumber (Q_ice, temp) !IMPLICIT NONE @@ -124,6 +128,8 @@ end function make_IceNumber !+---+-----------------------------------------------------------------+ !+---+-----------------------------------------------------------------+ +!>\ingroup aathompson +!! elemental real function make_DropletNumber (Q_cloud, qnwfa) !IMPLICIT NONE @@ -161,6 +167,8 @@ end function make_DropletNumber !+---+-----------------------------------------------------------------+ !+---+-----------------------------------------------------------------+ +!>\ingroup aathompson +!! elemental real function make_RainNumber (Q_rain, temp) IMPLICIT NONE diff --git a/physics/module_nst_model.f90 b/physics/module_nst_model.f90 index 1e4d1a704..980035fe6 100644 --- a/physics/module_nst_model.f90 +++ b/physics/module_nst_model.f90 @@ -5,7 +5,7 @@ !>\defgroup dtm_module GFS NSST Diurnal Thermocline Model !> This module contains the diurnal thermocline layer model (DTM) of !! the GFS NSST scheme. -!>\ingroup gfs_nst_main +!>\ingroup gfs_nst_main_mod !> This module contains the diurnal thermocline layer model (DTM) of !! the GFS NSST scheme. @@ -25,7 +25,7 @@ module nst_module contains -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine contains the module of diurnal thermocline layer model. subroutine dtm_1p(kdt,timestep,rich,tox,toy,i0,q,sss,sep,q_ts,hl_ts,rho, & alpha,beta,alon,sinlat,soltim,grav,le,d_conv, & @@ -86,7 +86,7 @@ subroutine dtm_1p(kdt,timestep,rich,tox,toy,i0,q,sss,sep,q_ts,hl_ts,rho, & end subroutine dtm_1p -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine integrates one time step with modified Euler method. subroutine eulerm(kdt,timestep,rich,tox,toy,i0,q,sss,sep,q_ts,hl_ts,rho,alpha,& beta,alon,sinlat,soltim,grav,le,d_conv, & @@ -242,7 +242,7 @@ subroutine eulerm(kdt,timestep,rich,tox,toy,i0,q,sss,sep,q_ts,hl_ts,rho,alpha,& end subroutine eulerm -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine applies xz adjustment. subroutine dtm_1p_zwa(kdt,timestep,i0,q,rho,d_conv,xt,xs,xu,xv,xz,tr_mda,tr_fca,tr_tla,tr_mwa) ! apply xz adjustment: minimum depth adjustment (mda) @@ -309,7 +309,7 @@ subroutine dtm_1p_zwa(kdt,timestep,i0,q,rho,d_conv,xt,xs,xu,xv,xz,tr_mda,tr_fca, end subroutine dtm_1p_zwa -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine applies free convection adjustment(fca). subroutine dtm_1p_fca(d_conv,xt,xtts,xz,xzts) @@ -327,7 +327,7 @@ subroutine dtm_1p_fca(d_conv,xt,xtts,xz,xzts) end subroutine dtm_1p_fca -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine applies top layer adjustment (tla). subroutine dtm_1p_tla(dz,te,xt,xtts,xz,xzts) @@ -347,7 +347,7 @@ subroutine dtm_1p_tla(dz,te,xt,xtts,xz,xzts) ! xzts = xtts*(1.0+0.5*(2.0*xt-dz*te)/sqrt(xt*(xt-dz*te)))/te end subroutine dtm_1p_tla -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine applies maximum warming adjustment (mwa). subroutine dtm_1p_mwa(xt,xtts,xz,xzts) @@ -361,7 +361,7 @@ subroutine dtm_1p_mwa(xt,xtts,xz,xzts) ! xzts = 2.0*xtts/tw_max end subroutine dtm_1p_mwa -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine applies minimum depth adjustment (xz adjustment). subroutine dtm_1p_mda(xt,xtts,xz,xzts) @@ -378,7 +378,7 @@ subroutine dtm_1p_mda(xt,xtts,xz,xzts) end subroutine dtm_1p_mda -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine applies maximum temperature adjustment (mta). subroutine dtm_1p_mta(dta,xt,xtts,xz,xzts) @@ -399,7 +399,7 @@ subroutine dtm_1p_mta(dta,xt,xtts,xz,xzts) end subroutine dtm_1p_mta -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine calculates depth for convective adjustment. subroutine convdepth(kdt,timestep,i0,q,sss,sep,rho,alpha,beta,xt,xs,xz,d_conv) @@ -482,7 +482,7 @@ subroutine convdepth(kdt,timestep,i0,q,sss,sep,rho,alpha,beta,xt,xs,xz,d_conv) end subroutine convdepth -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod subroutine dtm_onset(kdt,timestep,rich,tox,toy,i0,q,sss,sep,q_ts,hl_ts,rho, & alpha,beta,alon,sinlat,soltim,grav,le,xt,xs,xu,xv,xz,xzts,xtts) ! @@ -638,7 +638,7 @@ subroutine dtm_onset(kdt,timestep,rich,tox,toy,i0,q,sss,sep,q_ts,hl_ts,rho, & end subroutine dtm_onset -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine computes coefficients (\a w_0 and \a w_d) to !! calculate d(tw)/d(ts). subroutine cal_w(kdt,xz,xt,xzts,xtts,w_0,w_d) @@ -670,7 +670,7 @@ subroutine cal_w(kdt,xz,xt,xzts,xtts,w_0,w_d) ! endif end subroutine cal_w -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine calculates the diurnal warming amount at the top layer !! with thickness of \a delz. subroutine cal_ttop(kdt,timestep,q_warm,rho,dz,xt,xz,ttop) @@ -702,7 +702,7 @@ subroutine cal_ttop(kdt,timestep,q_warm,rho,dz,xt,xz,ttop) end subroutine cal_ttop -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine adjust dtm-1p dtl thickness by applying shear flow stability !! with assumed exponential profile. subroutine app_sfs(kdt,xt,xs,xu,xv,alpha,beta,grav,d_1p,xz) @@ -763,7 +763,7 @@ subroutine app_sfs(kdt,xt,xs,xu,xv,alpha,beta,grav,d_1p,xz) ! write(*,'(a,i6,6f9.4))') ' app_sfs : ',kdt,xz0,d_sfs,d_1p,xz,2.0*xt/d_1p,t_sfs end subroutine app_sfs -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine calculates d(tz)/d(ts). subroutine cal_tztr(kdt,xt,c_0,c_d,w_0,w_d,zc,zw,z,tztr) ! @@ -811,7 +811,7 @@ subroutine cal_tztr(kdt,xt,c_0,c_d,w_0,w_d,zc,zw,z,tztr) ! write(*,'(a,i4,9f9.4))') ' cal_tztr : ',kdt,xt,c_0,c_d,w_0,w_d,zc,zw,z,tztr end subroutine cal_tztr -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !> This subroutine contains the upper ocean cool-skin parameterization !! (Fairall et al, 1996 \cite fairall_et_al_1996). subroutine cool_skin(ustar_a,f_nsol,f_sol_0,evap,sss,alpha,beta,rho_w,rho_a,ts,q_ts,hl_ts,grav,le,deltat_c,z_c,c_0,c_d) @@ -922,7 +922,7 @@ end subroutine cool_skin ! !====================== ! -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This function calculates a definitive integral of an exponential curve (power of 2). real function int_epn(z1,z2,zmx,ztr,n) ! @@ -944,7 +944,7 @@ real function int_epn(z1,z2,zmx,ztr,n) int_epn = delz*((fa+fb)/2.0 + int) end function int_epn -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine resets the value of xt,xs,xu,xv,xz. subroutine dtl_reset_cv(xt,xs,xu,xv,xz) real(kind=kind_phys), intent(inout) :: xt,xs,xu,xv,xz @@ -955,7 +955,7 @@ subroutine dtl_reset_cv(xt,xs,xu,xv,xz) xz = z_w_max end subroutine dtl_reset_cv -!>\ingroup dtm_module +!>\ingroup gfs_nst_main_mod !! This subroutine resets the value of xt,xs,xu,xv,xz,xtts,xzts. subroutine dtl_reset(xt,xs,xu,xv,xz,xzts,xtts) real(kind=kind_phys), intent(inout) :: xt,xs,xu,xv,xz,xzts,xtts diff --git a/physics/module_nst_parameters.f90 b/physics/module_nst_parameters.f90 index 6d8c8794b..3c4ffeb89 100644 --- a/physics/module_nst_parameters.f90 +++ b/physics/module_nst_parameters.f90 @@ -3,7 +3,7 @@ !! near surface sea temperature scheme. !>\defgroup nst_parameters GFS NSST Parameter Module -!! \ingroup gfs_nst_main +!! \ingroup gfs_nst_main_mod !! This module contains constants and parameters used in GFS !! near surface sea temperature scheme. !! history: diff --git a/physics/module_nst_water_prop.f90 b/physics/module_nst_water_prop.f90 index 39020526c..6a183da52 100644 --- a/physics/module_nst_water_prop.f90 +++ b/physics/module_nst_water_prop.f90 @@ -3,7 +3,7 @@ !>\defgroup waterprop GFS NSST Water Property !!This module contains GFS NSST water property subroutines. -!!\ingroup gfs_nst_main +!!\ingroup gfs_nst_main_mod module module_nst_water_prop use machine, only : kind_phys use module_nst_parameters, only : t0k @@ -40,7 +40,7 @@ module module_nst_water_prop end interface contains ! ------------------------------------------------------ -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !! This subroutine computes thermal expansion coefficient (alpha) !! and saline contraction coefficient (beta). subroutine rhocoef(t, s, rhoref, alpha, beta) @@ -85,7 +85,7 @@ subroutine rhocoef(t, s, rhoref, alpha, beta) end subroutine rhocoef ! ---------------------------------------- -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !! This subroutine computes sea water density. subroutine density(t, s, rho) ! ---------------------------------------- @@ -123,7 +123,7 @@ end subroutine density ! !====================== ! -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !! This subroutine computes the fraction of the solar radiation absorbed !! by the depth z following Paulson and Simpson (1981) \cite paulson_and_simpson_1981 . elemental subroutine sw_ps_9b(z,fxp) @@ -158,8 +158,8 @@ end subroutine sw_ps_9b ! !====================== ! -!>\ingroup waterprop -!! This subroutine +!>\ingroup gfs_nst_main_mod +!! This subroutine elemental subroutine sw_ps_9b_aw(z,aw) ! ! d(fw)/d(z) for 9-band @@ -187,7 +187,7 @@ elemental subroutine sw_ps_9b_aw(z,aw) end subroutine sw_ps_9b_aw ! !====================== -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !! This subroutine computes fraction of the solar radiation absorbed by the ocean at the depth !! z (Fairall et al. (1996) \cite fairall_et_al_1996, p. 1298) following Paulson and Simpson !! (1981) \cite paulson_and_simpson_1981 . @@ -223,7 +223,7 @@ end subroutine sw_fairall_6exp_v1 !====================== ! ! -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !! This subroutine calculates fraction of the solar radiation absorbed by the !! ocean at the depth z (fairall et al.(1996) \cite fairall_et_al_1996; p.1298) !! following Paulson and Simpson (1981) \cite paulson_and_simpson_1981. @@ -262,7 +262,7 @@ elemental subroutine sw_fairall_6exp_v1_aw(z,aw) ! end subroutine sw_fairall_6exp_v1_aw ! -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !! This subroutine computes fraction of the solar radiation absorbed by the ocean at the !! depth z (Fairall et al.(1996) \cite fairall_et_al_1996 , p.1298) following Paulson and !! Simpson (1981) \cite paulson_and_simpson_1981 . @@ -298,7 +298,7 @@ elemental subroutine sw_fairall_6exp_v1_sum(z,sum) end subroutine sw_fairall_6exp_v1_sum ! !====================== -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !! Solar radiation absorbed by the ocean at the depth z (Fairall et al. (1996) !! \cite fairall_et_al_1996, p.1298) !!\param[in] f_sol_0 solar radiation at the ocean surface (\f$W m^{-2}\f$) @@ -329,7 +329,7 @@ end subroutine sw_fairall_simple_v1 ! !====================== ! -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !! solar radiation absorbed by the ocean at the depth z (Zeng and Beljaars (2005) !! \cite zeng_and_beljaars_2005 , p.5). !>\param[in] f_sol_0 solar radiation at the ocean surface (\f$W m^{-2}\f$) @@ -360,7 +360,7 @@ end subroutine sw_wick_v1 ! !====================== ! -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !! This subroutine computes solar radiation absorbed by the ocean at the depth z !! (Fairall et al.(1996) \cite fairall_et_al_1996 , p.1301) following !! Soloviev and Vershinsky (1982) \cite soloviev_and_vershinsky_1982. @@ -397,7 +397,7 @@ end subroutine sw_soloviev_3exp_v1 ! !====================== ! -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod elemental subroutine sw_soloviev_3exp_v2(f_sol_0,z,df_sol_z) ! ! solar radiation absorbed by the ocean at the depth z (fairall et all, 1996, p. 1301) @@ -426,7 +426,7 @@ elemental subroutine sw_soloviev_3exp_v2(f_sol_0,z,df_sol_z) ! end subroutine sw_soloviev_3exp_v2 -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod elemental subroutine sw_soloviev_3exp_v2_aw(z,aw) ! ! aw = d(fxp)/d(z) @@ -458,7 +458,7 @@ end subroutine sw_soloviev_3exp_v2_aw ! !====================== ! -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod elemental subroutine sw_ohlmann_v1(z,fxp) ! ! fraction of the solar radiation absorbed by the ocean at the depth z @@ -482,7 +482,7 @@ elemental subroutine sw_ohlmann_v1(z,fxp) end subroutine sw_ohlmann_v1 ! -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod function grv(lat) real(kind=kind_phys) :: lat real(kind=kind_phys) :: gamma,c1,c2,c3,c4,pi,phi,x @@ -499,7 +499,7 @@ function grv(lat) !print *,'grav=',grv,lat end function grv -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !>This subroutine computes solar time from the julian date. subroutine solar_time_from_julian(jday,xlon,soltim) ! @@ -524,7 +524,7 @@ end subroutine solar_time_from_julian ! !*********************************************************************** ! -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !> This subroutine computes julian day and fraction from year, !! month, day and time UTC. subroutine compjd(jyr,jmnth,jday,jhr,jmn,jd,fjd) @@ -574,7 +574,7 @@ subroutine compjd(jyr,jmnth,jday,jhr,jmn,jd,fjd) endif end subroutine compjd -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod !>This subroutine computes dtm (the mean of \f$dT(z)\f$). subroutine get_dtzm_point(xt,xz,dt_cool,zc,z1,z2,dtm) ! ===================================================================== ! @@ -656,7 +656,7 @@ subroutine get_dtzm_point(xt,xz,dt_cool,zc,z1,z2,dtm) end subroutine get_dtzm_point -!>\ingroup waterprop +!>\ingroup gfs_nst_main_mod subroutine get_dtzm_2d(xt,xz,dt_cool,zc,wet,z1,z2,nx,ny,nth,dtm) !subroutine get_dtzm_2d(xt,xz,dt_cool,zc,wet,icy,z1,z2,nx,ny,dtm) ! ===================================================================== ! diff --git a/physics/module_sf_mynn.F90 b/physics/module_sf_mynn.F90 index 22b142c33..3374a7f4f 100644 --- a/physics/module_sf_mynn.F90 +++ b/physics/module_sf_mynn.F90 @@ -3,7 +3,6 @@ !WRF:MODEL_LAYER:PHYSICS ! !>\ingroup mynn_sfc -!>\defgroup module_sf_mynn_mod GSD MYNN SFC Module MODULE module_sf_mynn !------------------------------------------------------------------- @@ -2838,14 +2837,15 @@ SUBROUTINE znot_m_v6(uref, znotm) END SUBROUTINE znot_m_v6 !-------------------------------------------------------------------- !>\ingroup mynn_sfc +!! SUBROUTINE znot_t_v6(uref, znott) IMPLICIT NONE -! Calculate scalar roughness over water with input 10-m wind -! For low-to-moderate winds, try to match the Ck-U10 relationship from COARE algorithm -! For high winds, try to retain the Ck-U10 relationship of FY2015 HWRF -! -! Bin Liu, NOAA/NCEP/EMC 2017 +!> Calculate scalar roughness over water with input 10-m wind +!! For low-to-moderate winds, try to match the Ck-U10 relationship from COARE algorithm +!! For high winds, try to retain the Ck-U10 relationship of FY2015 HWRF +!! +!!\author Bin Liu, NOAA/NCEP/EMC 2017 ! ! uref(m/s) : wind speed at 10-m height ! znott(meter): scalar roughness scale over water @@ -2903,15 +2903,16 @@ END SUBROUTINE znot_t_v6 !------------------------------------------------------------------- !>\ingroup mynn_sfc +!! SUBROUTINE znot_m_v7(uref, znotm) IMPLICIT NONE -! Calculate areodynamical roughness over water with input 10-m wind -! For low-to-moderate winds, try to match the Cd-U10 relationship from COARE V3.5 (Edson et al. 2013) -! For high winds, try to fit available observational data -! Comparing to znot_t_v6, slightly decrease Cd for higher wind speed -! -! Bin Liu, NOAA/NCEP/EMC 2018 +!> Calculate areodynamical roughness over water with input 10-m wind +!! For low-to-moderate winds, try to match the Cd-U10 relationship from COARE V3.5 (Edson et al. 2013) +!! For high winds, try to fit available observational data +!! Comparing to znot_t_v6, slightly decrease Cd for higher wind speed +!! +!!\author Bin Liu, NOAA/NCEP/EMC 2018 ! ! uref(m/s) : wind speed at 10-m height ! znotm(meter): areodynamical roughness scale over water @@ -2951,15 +2952,16 @@ SUBROUTINE znot_m_v7(uref, znotm) END SUBROUTINE znot_m_v7 !-------------------------------------------------------------------- !>\ingroup mynn_sfc +!! SUBROUTINE znot_t_v7(uref, znott) IMPLICIT NONE -! Calculate scalar roughness over water with input 10-m wind -! For low-to-moderate winds, try to match the Ck-U10 relationship from COARE algorithm -! For high winds, try to retain the Ck-U10 relationship of FY2015 HWRF -! To be compatible with the slightly decreased Cd for higher wind speed -! -! Bin Liu, NOAA/NCEP/EMC 2018 +!> Calculate scalar roughness over water with input 10-m wind +!! For low-to-moderate winds, try to match the Ck-U10 relationship from COARE algorithm +!! For high winds, try to retain the Ck-U10 relationship of FY2015 HWRF +!! To be compatible with the slightly decreased Cd for higher wind speed +!! +!!\author Bin Liu, NOAA/NCEP/EMC 2018 ! ! uref(m/s) : wind speed at 10-m height ! znott(meter): scalar roughness scale over water @@ -3350,13 +3352,14 @@ SUBROUTINE Li_etal_2010(zL, Rib, zaz0, z0zt) END SUBROUTINE Li_etal_2010 !------------------------------------------------------------------- +!>\ingroup mynn_sfc REAL function zolri(ri,za,z0,zt,zol1,psi_opt) - ! This iterative algorithm was taken from the revised surface layer - ! scheme in WRF-ARW, written by Pedro Jimenez and Jimy Dudhia and - ! summarized in Jimenez et al. (2012, MWR). This function was adapted - ! to input the thermal roughness length, zt, (as well as z0) and use initial - ! estimate of z/L. + !> This iterative algorithm was taken from the revised surface layer + !! scheme in WRF-ARW, written by Pedro Jimenez and Jimy Dudhia and + !! summarized in Jimenez et al. (2012, MWR). This function was adapted + !! to input the thermal roughness length, zt, (as well as z0) and use initial + !! estimate of z/L. IMPLICIT NONE REAL, INTENT(IN) :: ri,za,z0,zt,zol1 @@ -3522,7 +3525,8 @@ REAL function zolrib(ri,za,z0,zt,logz0,logzt,zol1,psi_opt) return end function !==================================================================== - +!>\ingroup mynn_sfc +!! SUBROUTINE psi_init(psi_opt,errmsg,errflg) integer :: N,psi_opt @@ -3627,6 +3631,8 @@ REAL function psih_unstable_full(zolf) ! ================================================================== ! ... integrated similarity functions from GFS... ! +!>\ingroup mynn_sfc +!! REAL function psim_stable_full_gfs(zolf) REAL :: zolf REAL, PARAMETER :: alpha4 = 20. @@ -3638,6 +3644,8 @@ REAL function psim_stable_full_gfs(zolf) return end function +!>\ingroup mynn_sfc +!! REAL function psih_stable_full_gfs(zolf) REAL :: zolf REAL, PARAMETER :: alpha4 = 20. @@ -3649,6 +3657,8 @@ REAL function psih_stable_full_gfs(zolf) return end function +!>\ingroup mynn_sfc +!! REAL function psim_unstable_full_gfs(zolf) REAL :: zolf REAL :: hl1,tem1 @@ -3667,6 +3677,8 @@ REAL function psim_unstable_full_gfs(zolf) return end function +!>\ingroup mynn_sfc +!! REAL function psih_unstable_full_gfs(zolf) REAL :: zolf REAL :: hl1,tem1 @@ -3685,9 +3697,8 @@ REAL function psih_unstable_full_gfs(zolf) return end function -!================================================================= -! look-up table functions - or, if beyond -10 < z/L < 10, recalculate -!================================================================= +!>\ingroup mynn_sfc +!! look-up table functions - or, if beyond -10 < z/L < 10, recalculate REAL function psim_stable(zolf,psi_opt) integer :: nzol,psi_opt real :: rzol,zolf @@ -3707,6 +3718,7 @@ REAL function psim_stable(zolf,psi_opt) return end function +!>\ingroup mynn_sfc REAL function psih_stable(zolf,psi_opt) integer :: nzol,psi_opt real :: rzol,zolf @@ -3726,6 +3738,7 @@ REAL function psih_stable(zolf,psi_opt) return end function +!>\ingroup mynn_sfc REAL function psim_unstable(zolf,psi_opt) integer :: nzol,psi_opt real :: rzol,zolf @@ -3745,6 +3758,7 @@ REAL function psim_unstable(zolf,psi_opt) return end function +!>\ingroup mynn_sfc REAL function psih_unstable(zolf,psi_opt) integer :: nzol,psi_opt real :: rzol,zolf diff --git a/physics/module_sf_noahmp_glacier.f90 b/physics/module_sf_noahmp_glacier.f90 index c4c03aaf8..174429ebb 100644 --- a/physics/module_sf_noahmp_glacier.f90 +++ b/physics/module_sf_noahmp_glacier.f90 @@ -400,6 +400,7 @@ end subroutine atm_glacier ! ================================================================================================== ! -------------------------------------------------------------------------------------------------- !>\ingroup NoahMP_LSM +!! This subroutine subroutine energy_glacier (nsnow ,nsoil ,isnow ,dt ,qsnow ,rhoair , & !in eair ,sfcprs ,qair ,sfctmp ,lwdn ,uu , & !in vv ,solad ,solai ,cosz ,zref , & !in diff --git a/physics/module_sf_ruclsm.F90 b/physics/module_sf_ruclsm.F90 index b39610bc8..482e2df16 100644 --- a/physics/module_sf_ruclsm.F90 +++ b/physics/module_sf_ruclsm.F90 @@ -19,36 +19,28 @@ MODULE module_sf_ruclsm public :: lsmruc, ruclsminit, rslf !> CONSTANT PARAMETERS -!! @{ real (kind=kind_phys), parameter :: P1000mb = 100000. real (kind=kind_phys), parameter :: xls = 2.85E6 real (kind=kind_phys), parameter :: rhowater= 1000. real (kind=kind_phys), parameter :: piconst = 3.1415926535897931 real (kind=kind_phys), parameter :: r_v = 4.6150e+2 -!! @} !> VEGETATION PARAMETERS -!! @{ INTEGER :: LUCATS integer, PARAMETER :: NLUS=50 CHARACTER*8 LUTYPE -!! @} !> SOIL PARAMETERS -!! @{ INTEGER :: SLCATS INTEGER, PARAMETER :: NSLTYPE=30 CHARACTER*8 SLTYPE -!! @} !> LSM GENERAL PARAMETERS -!! @{ INTEGER :: SLPCATS INTEGER, PARAMETER :: NSLOPE=30 REAL :: SBETA_DATA,FXEXP_DATA,CSOIL_DATA,SALP_DATA,REFDK_DATA, & REFKDT_DATA,FRZK_DATA,ZBOT_DATA, SMLOW_DATA,SMHIGH_DATA, & CZIL_DATA -!! @} CONTAINS @@ -57,8 +49,7 @@ MODULE module_sf_ruclsm !>\ingroup lsm_ruc_group !> The RUN LSM model is described in Smirnova et al.(1997) !! \cite Smirnova_1997 and Smirnova et al.(2000) \cite Smirnova_2000 -!>\section gen_lsmruc GSD RUC LSM General Algorithm -!! @{ +!>\section gen_lsmruc_ga RUC LSM General Algorithm SUBROUTINE LSMRUC( & DT,init,lsm_cold_start,KTAU,iter,NSL, & graupelncv,snowncv,rainncv,raincv, & @@ -1156,7 +1147,6 @@ SUBROUTINE LSMRUC( & !----------------------------------------------------------------- END SUBROUTINE LSMRUC -!! @} !----------------------------------------------------------------- !>\ingroup lsm_ruc_group diff --git a/physics/mp_nssl.F90 b/physics/mp_nssl.F90 index c442d204c..b67c3c348 100644 --- a/physics/mp_nssl.F90 +++ b/physics/mp_nssl.F90 @@ -21,7 +21,6 @@ module mp_nssl !>\ingroup nsslmp !> This subroutine is a wrapper around the nssl_2mom_init(). -!! \section arg_table_mp_nssl_init Argument Table !>@{ !> \section arg_table_mp_nssl_init Argument Table !! \htmlinclude mp_nssl_init.html @@ -803,7 +802,7 @@ end subroutine mp_nssl_run !>@} #if 0 -!! \section arg_table_mp_nssl_finalize Argument Table +!> \section arg_table_mp_nssl_finalize Argument Table !! \htmlinclude mp_nssl_finalize.html !! #endif diff --git a/physics/mp_thompson_pre.F90 b/physics/mp_thompson_pre.F90 index 957c1f118..3e65fd478 100644 --- a/physics/mp_thompson_pre.F90 +++ b/physics/mp_thompson_pre.F90 @@ -9,16 +9,13 @@ module mp_thompson_pre implicit none - public :: mp_thompson_pre_init, mp_thompson_pre_run, mp_thompson_pre_finalize + public :: mp_thompson_pre_run private contains - subroutine mp_thompson_pre_init() - end subroutine mp_thompson_pre_init - -!! \section arg_table_mp_thompson_pre_run Argument Table +!> \section arg_table_mp_thompson_pre_run Argument Table !! \htmlinclude mp_thompson_pre_run.html !! subroutine mp_thompson_pre_run(ncol, nlev, tgrs, tgrs_save, errmsg, errflg) @@ -44,7 +41,4 @@ subroutine mp_thompson_pre_run(ncol, nlev, tgrs, tgrs_save, errmsg, errflg) end subroutine mp_thompson_pre_run - subroutine mp_thompson_pre_finalize() - end subroutine mp_thompson_pre_finalize - end module mp_thompson_pre diff --git a/physics/mynnedmf_wrapper.F90 b/physics/mynnedmf_wrapper.F90 index a458b6155..94687491c 100644 --- a/physics/mynnedmf_wrapper.F90 +++ b/physics/mynnedmf_wrapper.F90 @@ -40,9 +40,6 @@ subroutine mynnedmf_wrapper_init (do_mynnedmf, lheatstrg, errmsg, errflg) end subroutine mynnedmf_wrapper_init - subroutine mynnedmf_wrapper_finalize () - end subroutine mynnedmf_wrapper_finalize - ! \brief This scheme (1) performs pre-mynnedmf work, (2) runs the mynnedmf, and (3) performs post-mynnedmf work !> \section arg_table_mynnedmf_wrapper_run Argument Table !! \htmlinclude mynnedmf_wrapper_run.html diff --git a/physics/mynnsfc_wrapper.F90 b/physics/mynnsfc_wrapper.F90 index efcdc888a..33d2048d5 100644 --- a/physics/mynnsfc_wrapper.F90 +++ b/physics/mynnsfc_wrapper.F90 @@ -11,9 +11,11 @@ MODULE mynnsfc_wrapper contains +!>\defgroup mynn_sfc MYNN Surface Layer Module +!> This scheme (1) performs pre-mynnsfc work, (2) runs the mynn sfc layer scheme, and (3) performs post-mynnsfc work +!>@{ !! \section arg_table_mynnsfc_wrapper_init Argument Table !! \htmlinclude mynnsfc_wrapper_init.html - !! subroutine mynnsfc_wrapper_init(do_mynnsfclay, & & errmsg, errflg) @@ -46,15 +48,9 @@ subroutine mynnsfc_wrapper_init(do_mynnsfclay, & end subroutine mynnsfc_wrapper_init - subroutine mynnsfc_wrapper_finalize () - end subroutine mynnsfc_wrapper_finalize - -!>\defgroup mynn_sfc GSD MYNN Surface Layer Scheme Module -!> \brief This scheme (1) performs pre-mynnsfc work, (2) runs the mynn sfc layer scheme, and (3) performs post-mynnsfc work -!! \section arg_table_mynnsfc_wrapper_run Argument Table +!> \section arg_table_mynnsfc_wrapper_run Argument Table !! \htmlinclude mynnsfc_wrapper_run.html !! -!###=================================================================== SUBROUTINE mynnsfc_wrapper_run( & & im,levs, & & itimestep,iter,flag_iter, & @@ -398,6 +394,6 @@ SUBROUTINE mynnsfc_wrapper_run( & END SUBROUTINE mynnsfc_wrapper_run -!###================================================================= +!>@} END MODULE mynnsfc_wrapper diff --git a/physics/ozphys_2015.f b/physics/ozphys_2015.f index 9711b45b4..85c79f733 100644 --- a/physics/ozphys_2015.f +++ b/physics/ozphys_2015.f @@ -2,11 +2,13 @@ !! This file is ozone sources and sinks. -!> This module contains the CCPP-compliant Ozone 2015 photochemistry scheme. module ozphys_2015 contains +!>\defgroup GFS_ozphys_2015 GFS Ozone Photochemistry (2015) Module +!! This module contains the CCPP-compliant Ozone 2015 photochemistry scheme. +!> @{ !> \section arg_table_ozphys_2015_init Argument Table !! \htmlinclude ozphys_2015_init.html !! @@ -29,11 +31,7 @@ subroutine ozphys_2015_init(oz_phys_2015, errmsg, errflg) end subroutine ozphys_2015_init - subroutine ozphys_2015_finalize() - end subroutine ozphys_2015_finalize - -!>\defgroup GFS_ozphys_2015 GFS Ozone Photochemistry (2015) Scheme Module -!! \brief The operational GFS currently parameterizes ozone production and +!> The operational GFS currently parameterizes ozone production and !! destruction based on monthly mean coefficients ( !! \c ozprdlos_2015_new_sbuvO3_tclm15_nuchem.f77) provided by Naval !! Research Laboratory through CHEM2D chemistry model @@ -42,7 +40,6 @@ end subroutine ozphys_2015_finalize !! \htmlinclude ozphys_2015_run.html !! !> \section genal_ozphys_2015 GFS ozphys_2015_run General Algorithm -!> @{ !> - This code assumes that both prsl and po3 are from bottom to top !! as are all other variables. !> - This code is specifically for NRL parameterization and diff --git a/physics/phys_tend.F90 b/physics/phys_tend.F90 index b444f2d97..b1d53f5f5 100644 --- a/physics/phys_tend.F90 +++ b/physics/phys_tend.F90 @@ -1,3 +1,5 @@ +!>\file phys_tend.F90 +!! module phys_tend use machine, only: kind_phys diff --git a/physics/rad_sw_pre.F90 b/physics/rad_sw_pre.F90 index 8c33c17b8..b7c3faf4c 100644 --- a/physics/rad_sw_pre.F90 +++ b/physics/rad_sw_pre.F90 @@ -1,22 +1,16 @@ -! ###################################################################################### -!>\file rad_sw_pre.f90 -!! +!>\file rad_sw_pre.F90 !! This file gathers the sunlit points for the shortwave radiation schemes. -!! -!> \defgroup rad_sw_pre GFS radiation pre routine. -!! @{ -!! -! ###################################################################################### + module rad_sw_pre contains - ! ################################################################################### +!> \defgroup rad_sw_pre GFS Radiation-SW Pre +!! This module gathers the sunlit points for the shortwave radiation schemes. +!> @{ !> \section arg_table_rad_sw_pre_run Argument Table !! \htmlinclude rad_sw_pre_run.html !! -!! \section rad_sw_pre_run -!! @{ - ! ################################################################################### +!! \section rad_sw_pre_run_gen General Algorithm subroutine rad_sw_pre_run (im, lsswr, coszen, nday, idxday, errmsg, errflg) use machine, only: kind_phys implicit none @@ -55,5 +49,5 @@ subroutine rad_sw_pre_run (im, lsswr, coszen, nday, idxday, errmsg, errflg) endif end subroutine rad_sw_pre_run -!! @} +!> @} end module rad_sw_pre diff --git a/physics/radiation_aerosols.f b/physics/radiation_aerosols.f index e7fd3631b..93ca3b1a0 100644 --- a/physics/radiation_aerosols.f +++ b/physics/radiation_aerosols.f @@ -124,35 +124,6 @@ !!!!! ========================================================== !!!!! - -!> \ingroup rad -!! \defgroup module_radiation_aerosols module_radiation_aerosols -!! This module contains climatological atmospheric aerosol schemes for -!! radiation computations. -!! -!!\version NCEP-Radiation_aerosols v5.2 Jan 2013 -!! -!!\n This module has three externally callable subroutines: -!! - aer_init() -- initialization; called at the start of run to set up -!! module parameters -!! - aer_update() -- updating aerosol data; called within the time loop -!! to check and update data sets -!! - setaer() -- mapping aeros profile, compute aeros opticals -!! -!!\n References: -!! - OPAC climatological aerosols: -!! Hou et al. 2002 \cite hou_et_al_2002; Hess et al. 1998 -!! \cite hess_et_al_1998 -!! - GOCART interactive aerosols: -!! Chin et al., 2000 \cite chin_et_al_2000 -!! Colarco et al., 2010 - jgr, v115, D14207\cite colarco_et_al_2010 -!! -!! - MERRA2 aerosol reanalysis: -!! Randles et al., 2017 - jclim, v30, 6823-6850\cite randles_et_al_2017 -!! Buchard et al., 2017 - jclim, v30, 6851-6871\cite buchard_et_al_2017 -!! -!! - Stratospheric volcanical aerosols: -!! Sato et al. 1993 \cite sato_et_al_1993 !========================================! module module_radiation_aerosols ! !........................................! @@ -491,13 +462,40 @@ module module_radiation_aerosols ! contains ! ================= +!> \defgroup mod_radiation_aerosols Radiation Aerosols Module +!> This module contains climatological atmospheric aerosol schemes for +!! radiation computations. +!! +!!\version NCEP-Radiation_aerosols v5.2 Jan 2013 +!! +!!\n This module has three externally callable subroutines: +!! - aer_init() -- initialization; called at the start of run to set up +!! module parameters +!! - aer_update() -- updating aerosol data; called within the time loop +!! to check and update data sets +!! - setaer() -- mapping aeros profile, compute aeros opticals +!! +!!\n References: +!! - OPAC climatological aerosols: +!! Hou et al. 2002 \cite hou_et_al_2002; Hess et al. 1998 +!! \cite hess_et_al_1998 +!! - GOCART interactive aerosols: +!! Chin et al., 2000 \cite chin_et_al_2000 +!! Colarco et al., 2010 - jgr, v115, D14207\cite colarco_et_al_2010 +!! +!! - MERRA2 aerosol reanalysis: +!! Randles et al., 2017 - jclim, v30, 6823-6850\cite randles_et_al_2017 +!! Buchard et al., 2017 - jclim, v30, 6851-6871\cite buchard_et_al_2017 +!! +!! - Stratospheric volcanical aerosols: +!! Sato et al. 1993 \cite sato_et_al_1993 +!! !> The initialization program is to set up necessary parameters and !! working arrays. !! !>\param NLAY number of model vertical layers (not used) !>\param me print message control flag !>\section gen_al General Algorithm -!! @{ !----------------------------------- subroutine aer_init & & ( NLAY, me ) ! --- inputs @@ -899,7 +897,6 @@ end subroutine set_volcaer !................................... end subroutine aer_init !----------------------------------- -!!@} !> This subroutine is the opac-climatology aerosol initialization @@ -911,7 +908,6 @@ end subroutine aer_init !!\param me print message control flag !! !!\section gen_clim_aerinit General Algorithm -!!@{ subroutine clim_aerinit & & ( solfwv, eirfwv, me & ! --- inputs & ) ! --- outputs @@ -1001,7 +997,6 @@ subroutine clim_aerinit & !! reads and maps the pre-tabulated aerosol optical spectral data onto !! corresponding SW radiation spectral bands. !!\section det_set_aercoef General Algorithm -!! @{ !-------------------------------- subroutine set_aercoef !................................ @@ -1436,7 +1431,6 @@ subroutine set_aercoef !................................ end subroutine set_aercoef !-------------------------------- -!! @} !> This subroutine computes mean aerosols optical properties over each !! SW radiation spectral band for each of the species components. This @@ -1699,7 +1693,6 @@ end subroutine optavg !................................... end subroutine clim_aerinit !----------------------------------- -!!@} !> This subroutine checks and updates time varying climatology aerosol @@ -1709,7 +1702,6 @@ end subroutine clim_aerinit !!\param imon month of the year !!\param me print message control flag !>\section gen_aer_upd General Algorithm -!! @{ !----------------------------------- subroutine aer_update & & ( iyear, imon, me ) ! --- inputs: @@ -2061,8 +2053,6 @@ end subroutine volc_update !................................... end subroutine aer_update !----------------------------------- -!! @} - !> This subroutine computes aerosols optical properties. !>\param prsi (IMAX,NLP1), pressure at interface in mb @@ -2089,7 +2079,6 @@ end subroutine aer_update !!\n (:,:,:,3): asymmetry parameter !!\param aerodp (IMAX,NSPC1), vertically integrated optical depth !>\section general_setaer General Algorithm -!> @{ !----------------------------------- subroutine setaer & & ( prsi,prsl,prslk,tvly,rhlay,slmsk,tracer,aerfld,xlon,xlat, & ! --- inputs @@ -2645,8 +2634,6 @@ subroutine setaer & !................................... end subroutine setaer !----------------------------------- -!> @} - !> This subroutine maps the 5 degree global climatological aerosol data !! set onto model grids, and compute aerosol optical properties for SW @@ -2675,7 +2662,6 @@ end subroutine setaer !!\n (:,:,:,3): asymmetry parameter !!\param aerodp (IMAX,NSPC+1), vertically integrated aer-opt-depth !!\section gel_aer_pro General Algorithm -!> @{ !----------------------------------- subroutine aer_property & & ( prsi,prsl,prslk,tvly,rhlay,dz,hz,tracer, & ! --- inputs: @@ -3406,7 +3392,6 @@ end subroutine radclimaer end subroutine aer_property !----------------------------------- -!> @} !> This subroutine is the gocart aerosol initialization !! program to set up necessary parameters and working arrays. !>\param solfwv (NWVTOT), solar flux for each individual wavenumber @@ -3416,7 +3401,6 @@ end subroutine aer_property !!\param me print message control flag !! !>\section gel_go_ini General Algorithm -!! @{ !----------------------------------- subroutine gocart_aerinit & & ( solfwv, eirfwv, me & @@ -4160,7 +4144,6 @@ end subroutine optavg_gocart !................................... end subroutine gocart_aerinit !----------------------------------- -!! @} !> This subroutine compute aerosol optical properties for SW !! and LW radiations. @@ -4189,7 +4172,6 @@ end subroutine gocart_aerinit !!\n (:,:,:,3): asymmetry parameter !!\param aerodp (IMAX,NSPC+1), vertically integrated aer-opt-depth !!\section gel_go_aer_pro General Algorithm -!! @{ !----------------------------------- subroutine aer_property_gocart & !................................... @@ -4516,10 +4498,8 @@ end subroutine aeropt !................................... end subroutine aer_property_gocart !----------------------------------- -!! @} ! ! ======================================================================= - !..........................................! end module module_radiation_aerosols ! !==========================================! diff --git a/physics/radiation_astronomy.f b/physics/radiation_astronomy.f index f1651ca84..f5a683bf3 100644 --- a/physics/radiation_astronomy.f +++ b/physics/radiation_astronomy.f @@ -75,8 +75,8 @@ -! \ingroup RRTMG -!> \defgroup module_radiation_astronomy RRTMG Astronomy Module +!> \defgroup module_radiation_astronomy Radiation Astronomy Module +!> @{ !> \brief This module sets up astronomical quantities for solar radiation !! calculations. !! @@ -147,12 +147,10 @@ module module_radiation_astronomy contains ! ================= -!>\ingroup module_radiation_astronomy !> This subroutine initializes astronomy process, and set up module !! constants. !!\param me print message control flag !>\section sol_init_gen sol_init General Algorithm -!! @{ subroutine sol_init & & ( me ) ! --- inputs ! --- outputs: ( none ) @@ -308,10 +306,8 @@ subroutine sol_init & return !................................... end subroutine sol_init -!! @} !----------------------------------- -!>\ingroup module_radiation_astronomy !> This subroutine computes solar parameters at forecast time. !!\param jdate ncep absolute date and time at fcst time !! (yr, mon, day, t-zone, hr, min, sec, mil-sec) @@ -327,7 +323,6 @@ end subroutine sol_init !!\param solcon sun-earth distance adjusted solar constant !! \f$(w/m^2)\f$ !>\section gen_sol_update sol_update General Algorithm -!! @{ !----------------------------------- subroutine sol_update & & ( jdate,kyear,deltsw,deltim,lsol_chg, me, & ! --- inputs @@ -638,9 +633,7 @@ subroutine sol_update & !................................... end subroutine sol_update !----------------------------------- -!! @} -!>\ingroup module_radiation_astronomy !> This subroutine computes radius vector, declination and right !! ascension of sun, and equation of time. !!\param[in] jd julian day @@ -649,7 +642,6 @@ end subroutine sol_update !!\param[out] dlt declination of sun in radians !!\param[out] alp right ascension of sun in radians !>\section solar_gen solar General Algorithm -!! @{ !----------------------------------- subroutine solar & & ( jd, fjd, & ! --- inputs @@ -804,10 +796,8 @@ subroutine solar & return !................................... end subroutine solar -!! @} !----------------------------------- -!>\ingroup module_radiation_astronomy !> This subroutine computes mean cos solar zenith angle over SW calling !! interval. !!\param xlon grids' longitudes in radians, work both on @@ -821,7 +811,6 @@ end subroutine solar !! interval !!\param coszdg average of cosz over entire sw call interval !>\section coszmn_gen coszmn General Algorithm -!! @{ !----------------------------------- subroutine coszmn & & ( xlon,sinlat,coslat,solhr, IM, me, & ! --- inputs @@ -904,10 +893,8 @@ subroutine coszmn & return !................................... end subroutine coszmn -!! @} !----------------------------------- -!>\ingroup module_radiation_astronomy !> This subroutine prints out forecast date, time, and astronomy !! quantities. !!\param[in] jd forecast julian day @@ -917,7 +904,6 @@ end subroutine coszmn !!\param[in] r1 earth-sun radius vector in meter !!\param[in] solc solar constant in \f$w/m^2\f$ !>\section prtime_gen prtime General Algorithm -!! @{ !----------------------------------- subroutine prtime & & ( jd, fjd, dlt, alp, r1, solc & ! --- inputs @@ -1033,10 +1019,10 @@ subroutine prtime & return !................................... end subroutine prtime -!! @} !----------------------------------- ! !...........................................! end module module_radiation_astronomy ! +!> @} !===========================================! diff --git a/physics/radiation_cloud_overlap.F90 b/physics/radiation_cloud_overlap.F90 index 7fa44ec07..d6169b3e5 100644 --- a/physics/radiation_cloud_overlap.F90 +++ b/physics/radiation_cloud_overlap.F90 @@ -1,3 +1,8 @@ +!>\file radiation_cloud_overlap.F90 +!! + +!>\defgroup rad_cld_ovr_mod Radiation Cloud Overlap Module +!! This module contains the calculation of cloud overlap parameters for both RRTMG and RRTMGP. module module_radiation_cloud_overlap use physparam, only : kind_phys implicit none @@ -9,12 +14,17 @@ module module_radiation_cloud_overlap end interface contains + +!>\defgroup rad_cld_ovr_mod Radiation Cloud Overlap Module +!! This module contains the calculation of cloud overlap parameters for both RRTMG and RRTMGP. +!>@{ ! ###################################################################################### ! Hogan et al. (2010) ! "Effect of improving representation of horizontal and vertical cloud structure on the ! Earth's global radiation budget. Part I: Review and parametrization" ! https://rmets.onlinelibrary.wiley.com/doi/full/10.1002/qj.647 ! ###################################################################################### +!> see Shonk et al.(2010) \cite shonk_et_al_2010 subroutine cmp_dcorr_lgth_hogan(nCol, lat, con_pi, dcorr_lgth) ! Inputs integer, intent(in) :: & @@ -44,6 +54,7 @@ end subroutine cmp_dcorr_lgth_hogan ! atmospheric General Circulation Model" ! 10.5194/acp-12-9097-2012 ! ###################################################################################### +!>\see Oreopoulos et al.(2012) \cite Oreopoulos_2012 subroutine cmp_dcorr_lgth_oreopoulos(nCol, lat, juldat, yearlength, dcorr_lgth) ! Inputs integer, intent(in) :: & @@ -84,6 +95,7 @@ end subroutine cmp_dcorr_lgth_oreopoulos ! ###################################################################################### ! ! ###################################################################################### +!>This subroutine provides the alpha cloud overlap parameter for both RRTMG and RRTMGP subroutine get_alpha_exper(nCol, nLay, iovr, iovr_exprand, dzlay, & dcorr_lgth, cld_frac, alpha) @@ -131,5 +143,5 @@ subroutine get_alpha_exper(nCol, nLay, iovr, iovr_exprand, dzlay, & return end subroutine get_alpha_exper - +!>@} end module module_radiation_cloud_overlap diff --git a/physics/radiation_clouds.f b/physics/radiation_clouds.f index 16ea93d26..edfa94439 100644 --- a/physics/radiation_clouds.f +++ b/physics/radiation_clouds.f @@ -141,10 +141,10 @@ !!!!! end descriptions !!!!! !!!!! ========================================================== !!!!! -!> \defgroup module_radiation_clouds RRTMG Clouds Module -!! @{ -!! \brief This module computes cloud related quantities for radiation +!> \defgroup module_radiation_clouds Radiation Clouds Module +!! This module computes cloud related quantities for radiation !! computations. +!>@{ !! !! Knowledge of cloud properties and their vertical structure is !! important for meteorological studies due to their impact on both the @@ -154,12 +154,6 @@ !! Forecast System (GFS) include (i) cloud liquid/ice water path; (ii) !! the fraction of clouds; (iii) effective radius of water/ice droplet: !! -!! Cloud prediction model (namelist control parameter - \b NTCW, \b IMP_PHYSICS): -!!\n NTCW=0: legacy diagnostic cloud scheme based on RH-table lookup table -!!\n NTCW>0: prognostic cloud condensate -!!\n IMP_PHYSICS =98/99: Zhao-Carr-Sundqvist MP - Xu-Randall diagnostic cloud fraction -!!\n IMP_PHYSICS =11: GFDL MP - unified diagnostic cloud fraction provided by GFDL MP -!! !! Cloud overlapping method (namelist control parameter - \b IOVR) !!\n IOVR=0: randomly overlapping vertical cloud layers !!\n IOVR=1: maximum-random overlapping vertical cloud layers @@ -175,7 +169,6 @@ !! !!\version NCEP-Radiation_clouds v5.1 Nov 2012 !! -!! @} !> This module computes cloud related quantities for radiation computations. module module_radiation_clouds @@ -260,7 +253,6 @@ module module_radiation_clouds contains ! ================= -!> \ingroup module_radiation_clouds !> This subroutine is an initialization program for cloud-radiation !! calculations and sets up boundary layer cloud top. !!\param si model vertical sigma layer interface @@ -276,7 +268,6 @@ module module_radiation_clouds !!\n =17/18: NSSL microphysics !!\param me print control flag !>\section cld_init General Algorithm -!! @{ subroutine cld_init & & ( si, NLAY, imp_physics, me ) ! --- inputs ! --- outputs: @@ -398,14 +389,11 @@ subroutine cld_init & return !................................... end subroutine cld_init -!! @} !----------------------------------- -!> \ingroup module_radiation_clouds !> Subroutine radiation_clouds_prop computes cloud related quantities !! for different cloud microphysics schemes. !>\section radiation_clouds_prop General Algorithm -!> @{ subroutine radiation_clouds_prop & & ( plyr, plvl, tlyr, tvly, qlyr, qstl, rhly, & ! --- inputs: & ccnd, ncndl, cnvw, cnvc, tracer1, & @@ -940,11 +928,9 @@ subroutine radiation_clouds_prop & !................................... end subroutine radiation_clouds_prop -!> \ingroup module_radiation_clouds !> This subroutine computes cloud related quantities using !! zhao/moorthi's prognostic cloud microphysics scheme. !>\section progcld_zhao_carr General Algorithm -!> @{ subroutine progcld_zhao_carr & & ( plyr,plvl,tlyr,tvly,qlyr,qstl,rhly,clw, & ! --- inputs: & xlat,xlon,slmsk,dz,delp, IX, NLAY, NLP1, & @@ -1244,14 +1230,11 @@ subroutine progcld_zhao_carr & !................................... end subroutine progcld_zhao_carr !----------------------------------- -!> @} !----------------------------------- -!> \ingroup module_radiation_clouds !> This subroutine computes cloud related quantities using !! zhao/moorthi's prognostic cloud microphysics scheme + pdfcld. !>\section progcld_zhao_carr_pdf General Algorithm -!! @{ subroutine progcld_zhao_carr_pdf & & ( plyr,plvl,tlyr,tvly,qlyr,qstl,rhly,clw,cnvw,cnvc, & ! --- inputs: & xlat,xlon,slmsk, dz, delp, & @@ -1546,16 +1529,13 @@ subroutine progcld_zhao_carr_pdf & return !................................... end subroutine progcld_zhao_carr_pdf -!! @} !----------------------------------- !----------------------------------- -!> \ingroup module_radiation_clouds !> This subroutine computes cloud related quantities using !! GFDL Lin MP prognostic cloud microphysics scheme. !>\section progcld_gfdl_lin General Algorithm -!! @{ subroutine progcld_gfdl_lin & & ( plyr,plvl,tlyr,tvly,qlyr,qstl,rhly,clw,cnvw,cnvc, & ! --- inputs: & xlat,xlon,slmsk,cldtot, dz, delp, & @@ -1798,11 +1778,9 @@ subroutine progcld_gfdl_lin & return !................................... end subroutine progcld_gfdl_lin -!! @} !----------------------------------- !----------------------------------- -!> \ingroup module_radiation_clouds !! This subroutine computes cloud related quantities using !! Ferrier-Aligo cloud microphysics scheme. subroutine progcld_fer_hires & @@ -2638,11 +2616,9 @@ end subroutine progcld_thompson !mz -!> \ingroup module_radiation_clouds !> This subroutine computes cloud related quantities using !! for unified cloud microphysics scheme. !>\section progclduni General Algorithm -!> @{ subroutine progclduni & & ( plyr,plvl,tlyr,tvly,ccnd,ncnd, & ! --- inputs: & xlat,xlon,slmsk,dz,delp, IX, NLAY, NLP1, cldtot, & @@ -2929,9 +2905,7 @@ subroutine progclduni & !................................... end subroutine progclduni !----------------------------------- -!> @} -!> \ingroup module_radiation_clouds !> This subroutine computes high, mid, low, total, and boundary cloud !! fractions and cloud top/bottom layer indices for model diagnostic !! output. The three cloud domain boundaries are defined by ptopc. The @@ -2952,7 +2926,6 @@ end subroutine progclduni !> \param mbot (IX,3),vertical indices for low, mid, hi cloud bases !! !>\section detail Detailed Algorithm -!! @{ subroutine gethml & & ( plyr, ptop1, cldtot, cldcnv, dz, de_lgth, alpha, & ! --- inputs: & IX, NLAY, iovr_rand, iovr_maxrand, iovr_max, & @@ -3370,7 +3343,6 @@ subroutine gethml & !................................... end subroutine gethml !----------------------------------- -!! @} !+---+-----------------------------------------------------------------+ !..Cloud fraction scheme by G. Thompson (NCAR-RAL), not intended for @@ -3962,5 +3934,5 @@ subroutine cloud_fraction_mass_flx_2 & end subroutine cloud_fraction_mass_flx_2 !........................................! end module module_radiation_clouds -!! @} +!> @} !========================================! diff --git a/physics/radiation_gases.f b/physics/radiation_gases.f index 157da8e09..0b8184e41 100644 --- a/physics/radiation_gases.f +++ b/physics/radiation_gases.f @@ -104,7 +104,8 @@ !!!!! ========================================================== !!!!! -!> \defgroup module_radiation_gases RRTMG Gases Module +!> \defgroup module_radiation_gases_mod Radiation Gases Module +!> @{ !> This module sets up ozone climatological profiles and other constant !! gas profiles, such as co2, ch4, n2o, o2, and those of cfc gases. All !! data are entered as mixing ratio by volume, except ozone which is @@ -161,21 +162,21 @@ module module_radiation_gases & VTAGGAS='NCEP-Radiation_gases v5.1 Nov 2012 ' ! & VTAGGAS='NCEP-Radiation_gases v5.0 Aug 2012 ' - integer, parameter, public :: NF_VGAS = 10 !< number of gas species - integer, parameter :: IMXCO2 = 24 !< input CO2 data longitude points - integer, parameter :: JMXCO2 = 12 !< input CO2 data latitude points - integer, parameter :: MINYEAR = 1957 !< earlist year 2D CO2 data available - - real (kind=kind_phys), parameter :: resco2=15.0 !< horizontal resolution in degree - real (kind=kind_phys), parameter :: raddeg=180.0/con_pi !< rad->deg conversion - real (kind=kind_phys), parameter :: prsco2=788.0 !< pressure limitation for 2D CO2 (mb) - real (kind=kind_phys), parameter :: hfpi =0.5*con_pi !< half of pi - - real (kind=kind_phys), parameter :: co2vmr_def = 350.0e-6 !< parameter constant for CO2 volume mixing ratio - real (kind=kind_phys), parameter :: n2ovmr_def = 0.31e-6 !< parameter constant for N2O volume mixing ratio - real (kind=kind_phys), parameter :: ch4vmr_def = 1.50e-6 !< parameter constant for CH4 volume mixing ratio - real (kind=kind_phys), parameter :: o2vmr_def = 0.209 !< parameter constant for O2 volume mixing ratio - real (kind=kind_phys), parameter :: covmr_def = 1.50e-8 !< parameter constant for CO colume mixing ratio + integer, parameter, public :: NF_VGAS = 10 ! number of gas species + integer, parameter :: IMXCO2 = 24 ! input CO2 data longitude points + integer, parameter :: JMXCO2 = 12 ! input CO2 data latitude points + integer, parameter :: MINYEAR = 1957 ! earlist year 2D CO2 data available + + real (kind=kind_phys), parameter :: resco2=15.0 ! horizontal resolution in degree + real (kind=kind_phys), parameter :: raddeg=180.0/con_pi ! rad->deg conversion + real (kind=kind_phys), parameter :: prsco2=788.0 ! pressure limitation for 2D CO2 (mb) + real (kind=kind_phys), parameter :: hfpi =0.5*con_pi ! half of pi + + real (kind=kind_phys), parameter :: co2vmr_def = 350.0e-6 ! parameter constant for CO2 volume mixing ratio + real (kind=kind_phys), parameter :: n2ovmr_def = 0.31e-6 ! parameter constant for N2O volume mixing ratio + real (kind=kind_phys), parameter :: ch4vmr_def = 1.50e-6 ! parameter constant for CH4 volume mixing ratio + real (kind=kind_phys), parameter :: o2vmr_def = 0.209 ! parameter constant for O2 volume mixing ratio + real (kind=kind_phys), parameter :: covmr_def = 1.50e-8 ! parameter constant for CO colume mixing ratio ! aer 2003 value real (kind=kind_phys), parameter :: f11vmr_def = 3.520e-10 ! aer 2003 value @@ -224,12 +225,10 @@ module module_radiation_gases contains ! ================= -!> \ingroup module_radiation_gases !> This subroutine sets up ozone, co2, etc. parameters. If climatology !! ozone then read in monthly ozone data. !!\param me print message control flag !>\section gas_init_gen gas_init General Algorithm -!! @{ !----------------------------------- subroutine gas_init & & ( me )! --- inputs: @@ -514,10 +513,8 @@ subroutine gas_init & ! !................................... end subroutine gas_init -!! @} !----------------------------------- -!> \ingroup module_radiation_gases !> This subroutine reads in 2-d monthly co2 data set for a specified !! year. Data are in a 15 degree lat/lon horizontal resolution. !!\param iyear year of the requested data for fcst @@ -528,7 +525,6 @@ end subroutine gas_init !!\param ldoco2 co2 update control flag !!\param me print message control flag !>\section gen_gas_update gas_update General Algorithm -!! @{ !----------------------------------- subroutine gas_update & & ( iyear, imon, iday, ihour, loz1st, ldoco2, me )! --- inputs @@ -899,9 +895,7 @@ subroutine gas_update & !................................... end subroutine gas_update !----------------------------------- -!! @} -!> \ingroup module_radiation_gases !> This subroutine sets up global distribution of radiation absorbing !! gases in volume mixing ratio. Currently only co2 has the options !! from observed values, all other gases are asigned to the @@ -924,7 +918,6 @@ end subroutine gas_update !!\n (:,:,9) - ccl4 !!\n (:,:,10) - cfc113 !>\section gen_getgases getgases General Algorithm -!!@{ !----------------------------------- subroutine getgases & & ( plvl, xlon, xlat, & ! --- inputs @@ -1065,10 +1058,8 @@ subroutine getgases & return !................................... end subroutine getgases -!! @} !----------------------------------- -!> \ingroup module_radiation_gases !> This subroutine sets up climatological ozone profile for radiation !! calculation. This code is originally written by Shrinivas Moorthi. !!\param prslk (IMAX,LM), exner function = \f$(p/p0)^{rocp}\f$ @@ -1078,7 +1069,6 @@ end subroutine getgases !!\param o3mmr (IMAX,LM), output ozone profile in mass mixing !! ratio (g/g) !>\section getozn_gen getozn General Algorithm -!! @{ !----------------------------------- subroutine getozn & & ( prslk,xlat, & ! --- inputs @@ -1184,10 +1174,10 @@ subroutine getozn & return !................................... end subroutine getozn -!! @} !----------------------------------- ! !........................................! end module module_radiation_gases ! +!> @} !========================================! diff --git a/physics/radiation_surface.f b/physics/radiation_surface.f index 64afd0a35..664e7d453 100644 --- a/physics/radiation_surface.f +++ b/physics/radiation_surface.f @@ -80,8 +80,8 @@ !!!!! ========================================================== !!!!! -!>\ingroup RRTMG -!> \defgroup module_radiation_surface RRTMG Surface Module +!> \defgroup radiation_surface_mod Radiation Surface Module +!> @{ !> This module sets up surface albedo for SW radiation and surface !! emissivity for LW radiation. !! @@ -123,15 +123,15 @@ module module_radiation_surface ! & VTAGSFC='NCEP-Radiation_surface v5.0 Aug 2012 ' ! --- constant parameters - integer, parameter, public :: NF_ALBD = 4 !< number of surface albedo components - integer, parameter, public :: IMXEMS = 360 !< number of longtitude points in global emis-type map - integer, parameter, public :: JMXEMS = 180 !< number of latitude points in global emis-type map + integer, parameter, public :: NF_ALBD = 4 ! number of surface albedo components + integer, parameter, public :: IMXEMS = 360 ! number of longtitude points in global emis-type map + integer, parameter, public :: JMXEMS = 180 ! number of latitude points in global emis-type map real (kind=kind_phys), parameter :: f_zero = 0.0 real (kind=kind_phys), parameter :: f_one = 1.0 real (kind=kind_phys), parameter :: epsln = 1.0e-6 real (kind=kind_phys), parameter :: rad2dg = 180.0 / con_pi - integer, allocatable :: idxems(:,:) !< global surface emissivity index array - integer :: iemslw = 1 !< global surface emissivity control flag set up in 'sfc_init' + integer, allocatable :: idxems(:,:) ! global surface emissivity index array + integer :: iemslw = 1 ! global surface emissivity control flag set up in 'sfc_init' ! public sfc_init, setalb, setemis public f_zero, f_one, epsln @@ -140,12 +140,10 @@ module module_radiation_surface contains ! ================= -!> \ingroup module_radiation_surface !> This subroutine is the initialization program for surface radiation !! related quantities (albedo, emissivity, etc.) !!\param me print control flag !>\section gen_sfc_init sfc_init General Algorithm -!! @{ !----------------------------------- subroutine sfc_init & & ( me, errmsg, errflg )! --- inputs/outputs: @@ -296,9 +294,7 @@ subroutine sfc_init & !................................... end subroutine sfc_init !----------------------------------- -!! @} -!> \ingroup module_radiation_surface !> This subroutine computes four components of surface albedos (i.e., !! vis-nir, direct-diffused) according to control flag ialbflg. !! \n 1) climatological surface albedo scheme (\cite briegleb_1992) @@ -335,7 +331,6 @@ end subroutine sfc_init !!\n ( :, 3) - uv+vis direct beam albedo !!\n ( :, 4) - uv+vis diffused albedo !>\section general_setalb setalb General Algorithm -!! @{ !----------------------------------- subroutine setalb & & ( slmsk,lsm,lsm_noahmp,lsm_ruc,use_cice_alb,snodi, & ! --- inputs: @@ -710,9 +705,7 @@ subroutine setalb & !................................... end subroutine setalb !----------------------------------- -!! @} -!> \ingroup module_radiation_surface !> This subroutine computes surface emissivity for LW radiation. !!\param xlon (IMAX), longitude in radiance, ok for both 0->2pi !! or -pi -> +pi ranges @@ -728,7 +721,6 @@ end subroutine setalb !!\param IMAX array horizontal dimension !!\param sfcemis (IMAX), surface emissivity !>\section general_setemis setemis General Algorithm -!! @{ !----------------------------------- subroutine setemis & & ( lsm,lsm_noahmp,lsm_ruc,frac_grid,cplice,use_flake, & ! --- inputs: @@ -995,9 +987,9 @@ subroutine setemis & return !................................... end subroutine setemis -!! @} !----------------------------------- !.........................................! end module module_radiation_surface ! +!> @} !=========================================! diff --git a/physics/radlw_main.F90 b/physics/radlw_main.F90 index 6d4f5750d..256240301 100644 --- a/physics/radlw_main.F90 +++ b/physics/radlw_main.F90 @@ -1,4 +1,4 @@ -!> \file radlw_main.f +!> \file radlw_main.F90 !! This file contains NCEP's modifications of the rrtmg-lw radiation !! code from AER. @@ -390,13 +390,11 @@ module rrtmg_lw contains ! ================ - subroutine rrtmg_lw_init () - end subroutine rrtmg_lw_init -!> \defgroup module_radlw_main GFS RRTMG Longwave Module -!! \brief This module includes NCEP's modifications of the RRTMG-LW radiation +!> \defgroup module_radlw_main GFS RRTMG-LW Main Module +!> This module includes NCEP's modifications of the RRTMG-LW radiation !! code from AER. -!! +!> @{ !! The RRTMG-LW package includes three files: !! - radlw_param.f, which contains: !! - module_radlw_parameters: band parameters set up @@ -420,7 +418,6 @@ end subroutine rrtmg_lw_init !! \htmlinclude rrtmg_lw_run.html !! !> \section gen_lwrad RRTMG Longwave Radiation Scheme General Algorithm -!> @{ subroutine rrtmg_lw_run & & ( plyr,plvl,tlyr,tlvl,qlyr,olyr,gasvmr_co2, gasvmr_n2o, & ! --- inputs & gasvmr_ch4, gasvmr_o2, gasvmr_co, gasvmr_cfc11, & @@ -1306,7 +1303,6 @@ subroutine rrtmg_lw_run & !................................... end subroutine rrtmg_lw_run !----------------------------------- -!> @} subroutine rrtmg_lw_finalize () end subroutine rrtmg_lw_finalize @@ -1322,7 +1318,6 @@ end subroutine rrtmg_lw_finalize !! spectral band are reduced from 256 g-point intervals to 140. !!\param me print control for parallel process !!\section rlwinit_gen rlwinit General Algorithm -!! @{ subroutine rlwinit & & ( me ) ! --- inputs ! --- outputs: (none) @@ -1519,7 +1514,6 @@ subroutine rlwinit & !................................... end subroutine rlwinit -!! @} !----------------------------------- @@ -1554,7 +1548,6 @@ end subroutine rlwinit !!\param cldfmc cloud fraction for each sub-column !!\param taucld cloud optical depth for bands (non-mcica) !!\section gen_cldprop cldprop General Algorithm -!> @{ subroutine cldprop & & ( cfrac,cliqp,reliq,cicep,reice,cdat1,cdat2,cdat3,cdat4, & ! --- inputs & nlay, nlp1, ipseed, dz, de_lgth, iovr, alpha, & @@ -1860,7 +1853,6 @@ subroutine cldprop & ! .................................. end subroutine cldprop ! ---------------------------------- -!> @} !>\ingroup module_radlw_main !>\brief This suroutine computes sub-colum cloud profile flag array. @@ -1872,7 +1864,6 @@ end subroutine cldprop !!\param alpha EXP/ER cloud overlap decorrelation parameter !!\param lcloudy sub-colum cloud profile flag array !!\section mcica_subcol_gen mcica_subcol General Algorithm -!! @{ subroutine mcica_subcol & & ( cldf, nlay, ipseed, dz, de_lgth, alpha, & ! --- inputs & lcloudy & ! --- outputs @@ -2135,7 +2126,6 @@ subroutine mcica_subcol & return ! .................................. end subroutine mcica_subcol -!! @} ! ---------------------------------- !>\ingroup module_radlw_main @@ -2179,7 +2169,6 @@ end subroutine mcica_subcol !!\param scaleminor,scaleminorn2 scale factors for minor gases !!\param indminor index of lower ref temp for minor gases !>\section setcoef_gen setcoef General Algorithm -!> @{ subroutine setcoef & & ( pavel,tavel,tz,stemp,h2ovmr,colamt,coldry,colbrd, & ! --- inputs: & nlay, nlp1, & @@ -2436,7 +2425,6 @@ subroutine setcoef & return ! .................................. end subroutine setcoef -!> @} ! ---------------------------------- !>\ingroup module_radlw_main @@ -2474,7 +2462,6 @@ end subroutine setcoef !!\param htrcl clear sky heating rate (k/sec or k/day) !!\param htrb spectral band lw heating rate (k/day) !>\section gen_rtrn rtrn General Algorithm -!! @{ ! ---------------------------------- subroutine rtrn & & ( semiss,delp,cldfrc,taucld,tautot,pklay,pklev, & ! --- inputs @@ -2832,7 +2819,6 @@ subroutine rtrn & ! .................................. end subroutine rtrn -!! @} ! ---------------------------------- @@ -2859,7 +2845,6 @@ end subroutine rtrn !!\param htrcl clear sky heating rate (k/sec or k/day) !!\param htrb spectral band lw heating rate (k/day) !!\section gen_rtrnmr rtrnmr General Algorithm -!> @{ ! ---------------------------------- subroutine rtrnmr & & ( semiss,delp,cldfrc,taucld,tautot,pklay,pklev, &! --- inputs @@ -3427,7 +3412,6 @@ subroutine rtrnmr & ! ................................. end subroutine rtrnmr ! --------------------------------- -!> @} !>\ingroup module_radlw_main !> \brief This subroutine computes the upward/downward radiative fluxes, and @@ -3453,7 +3437,6 @@ end subroutine rtrnmr !!\param htrcl clear sky heating rate (k/sec or k/day) !!\param htrb spectral band lw heating rate (k/day) !!\section gen_rtrnmc rtrnmc General Algorithm -!> @{ ! --------------------------------- subroutine rtrnmc & & ( semiss,delp,cldfmc,taucld,tautot,pklay,pklev, & ! --- inputs: @@ -3822,7 +3805,6 @@ subroutine rtrnmc & ! .................................. end subroutine rtrnmc ! ---------------------------------- -!> @} !>\ingroup module_radlw_main !>\brief This subroutine contains optical depths developed for the rapid @@ -3871,7 +3853,6 @@ end subroutine rtrnmc !!\param fracs planck fractions !!\param tautot total optical depth (gas+aerosols) !>\section taumol_gen taumol General Algorithm -!! @{ !! subprograms called: taugb## (## = 01 -16) subroutine taumol & & ( laytrop,pavel,coldry,colamt,colbrd,wx,tauaer, & ! --- inputs @@ -6882,7 +6863,6 @@ end subroutine taugb16 ! .................................. end subroutine taumol -!! @} ! ------------------------------------------------------------------------------ subroutine cldprmc(nlayers, inflag, iceflag, liqflag, cldfmc, & @@ -7791,7 +7771,7 @@ subroutine cldprmc(nlayers, inflag, iceflag, liqflag, cldfmc, & end subroutine cldprmc - +!> @} !........................................!$ end module rrtmg_lw !$ !========================================!$ diff --git a/physics/radlw_param.f b/physics/radlw_param.f index 6c107a3d8..fa7ceecb0 100644 --- a/physics/radlw_param.f +++ b/physics/radlw_param.f @@ -61,7 +61,7 @@ module module_radlw_parameters ! !........................................! -!! \section arg_table_module_radlw_parameters +!> \section arg_table_module_radlw_parameters Argument table !! \htmlinclude module_radlw_parameters.html !! @@ -72,7 +72,7 @@ module module_radlw_parameters ! public ! !> derived type for LW fluxes at top of atmosphere -!! \section arg_table_topflw_type +!! \section arg_table_topflw_type Argument Table !! \htmlinclude topflw_type.html !! type topflw_type !< define type construct for radiation fluxes at toa @@ -81,7 +81,7 @@ module module_radlw_parameters ! end type topflw_type ! !> derived type for LW fluxes at surface -!! \section arg_table_sfcflw_type +!! \section arg_table_sfcflw_type Argument Table !! \htmlinclude sfcflw_type.html !! type sfcflw_type !< define type construct for radiation fluxes at surface diff --git a/physics/radsw_main.F90 b/physics/radsw_main.F90 index 4067dd0ec..4f53749a6 100644 --- a/physics/radsw_main.F90 +++ b/physics/radsw_main.F90 @@ -1,4 +1,4 @@ -!> \file radsw_main.f +!> \file radsw_main.F90 !! This file contains NCEP's modifications of the rrtmg-sw radiation !! code from AER. @@ -410,12 +410,10 @@ module rrtmg_sw contains ! ================= - subroutine rrtmg_sw_init () - end subroutine rrtmg_sw_init - -!> \defgroup module_radsw_main GFS RRTMG Shortwave Module -!! This module includes NCEP's modifications of the RRTMG-SW radiation +!> \defgroup module_radsw_main GFS RRTMG-SW Main Module +!> This module includes NCEP's modifications of the RRTMG-SW radiation !! code from AER. +!> @{ !! !! The SW radiation model in the current NOAA Environmental Modeling !! System (NEMS) was adapted from the RRTM radiation model developed by @@ -495,7 +493,6 @@ end subroutine rrtmg_sw_init !! \htmlinclude rrtmg_sw_run.html !! !> \section gen_swrad RRTMG Shortwave Radiation Scheme General Algorithm -!> @{ !----------------------------------- subroutine rrtmg_sw_run & & ( plyr,plvl,tlyr,tlvl,qlyr,olyr, & @@ -819,13 +816,13 @@ subroutine rrtmg_sw_run & lflxprf= present ( flxprf ) lfdncmp= present ( fdncmp ) -!> -# Compute solar constant adjustment factor (s0fac) according to solcon. +!> - Compute solar constant adjustment factor (s0fac) according to solcon. ! *** s0, the solar constant at toa in w/m**2, is hard-coded with ! each spectra band, the total flux is about 1368.22 w/m**2. s0fac = solcon / s0 -!> -# Initial output arrays (and optional) as zero. +!> - Initial output arrays (and optional) as zero. hswc(:,:) = f_zero cldtau(:,:) = f_zero @@ -875,7 +872,7 @@ subroutine rrtmg_sw_run & end if endif ! end if_iswcliq -!> -# Change random number seed value for each radiation invocation +!> - Change random number seed value for each radiation invocation !! (isubcsw =1 or 2). if ( isubcsw == 1 ) then ! advance prescribed permutation seed @@ -904,13 +901,13 @@ subroutine rrtmg_sw_run & ssolar = s0fac * cosz(j1) if (iovr == 3) delgth = de_lgth(j1) ! clouds decorr-length -!> -# Prepare surface albedo: bm,df - dir,dif; 1,2 - nir,uvv. +!> - Prepare surface albedo: bm,df - dir,dif; 1,2 - nir,uvv. albbm(1) = sfcalb_nir_dir(j1) albdf(1) = sfcalb_nir_dif(j1) albbm(2) = sfcalb_uvis_dir(j1) albdf(2) = sfcalb_uvis_dif(j1) -!> -# Prepare atmospheric profile for use in rrtm. +!> - Prepare atmospheric profile for use in rrtm. ! the vertical index of internal array is from surface to top if (ivflip == 0) then ! input from toa to sfc @@ -926,7 +923,7 @@ subroutine rrtmg_sw_run & dz (k) = dzlyr (j1,kk) if (iovr == 4 .or. iovr == 5) alph(k) = alpha(j1,k) ! alpha decorrelation -!> -# Set absorber and gas column amount, convert from volume mixing +!> - Set absorber and gas column amount, convert from volume mixing !! ratio to molec/cm2 based on coldry (scaled to 1.0e-20) !! - colamt(nlay,maxgas):column amounts of absorbing gases 1 to !! maxgas are for h2o,co2,o3,n2o,ch4,o2,co, respectively @@ -970,7 +967,7 @@ subroutine rrtmg_sw_run & enddo endif -!> -# Read aerosol optical properties from 'aerosols'. +!> - Read aerosol optical properties from 'aerosols'. do k = 1, nlay kk = nlp1 - k @@ -981,7 +978,7 @@ subroutine rrtmg_sw_run & enddo enddo -!> -# Read cloud optical properties from 'clouds'. +!> - Read cloud optical properties from 'clouds'. if (iswcliq > 0) then ! use prognostic cloud method do k = 1, nlay kk = nlp1 - k @@ -1099,7 +1096,7 @@ subroutine rrtmg_sw_run & endif ! if_ivflip -!> -# Compute fractions of clear sky view: +!> - Compute fractions of clear sky view: !! - random overlapping !! - max/ran overlapping !! - maximum overlapping @@ -1130,7 +1127,7 @@ subroutine rrtmg_sw_run & if (zcf0 > oneminus) zcf0 = f_one zcf1 = f_one - zcf0 -!> -# For cloudy sky column, call cldprop() to compute the cloud +!> - For cloudy sky column, call cldprop() to compute the cloud !! optical properties for each cloudy layer. if (zcf1 > f_zero) then ! cloudy sky column @@ -1169,7 +1166,7 @@ subroutine rrtmg_sw_run & enddo endif ! end if_zcf1_block -!> -# Call setcoef() to compute various coefficients needed in +!> - Call setcoef() to compute various coefficients needed in !! radiative transfer calculations. call setcoef & ! --- inputs: @@ -1179,7 +1176,7 @@ subroutine rrtmg_sw_run & & selffac,selffrac,indself,forfac,forfrac,indfor & & ) -!> -# Call taumol() to calculate optical depths for gaseous absorption +!> - Call taumol() to calculate optical depths for gaseous absorption !! and rayleigh scattering call taumol & ! --- inputs: @@ -1189,7 +1186,7 @@ subroutine rrtmg_sw_run & & sfluxzen, taug, taur & & ) -!> -# Call the 2-stream radiation transfer model: +!> - Call the 2-stream radiation transfer model: !! - if physparam::isubcsw .le.0, using standard cloud scheme, !! call spcvrtc(). !! - if physparam::isubcsw .gt.0, using mcica cloud scheme, @@ -1223,7 +1220,7 @@ subroutine rrtmg_sw_run & endif -!> -# Save outputs. +!> - Save outputs. ! --- ... sum up total spectral fluxes for total-sky do k = 1, nlp1 @@ -1383,7 +1380,6 @@ subroutine rrtmg_sw_run & !................................... end subroutine rrtmg_sw_run !----------------------------------- -!> @} subroutine rrtmg_sw_finalize () end subroutine rrtmg_sw_finalize @@ -1394,7 +1390,6 @@ end subroutine rrtmg_sw_finalize !! factors, and look-up tables. !!\param me print control for parallel process !>\section rswinit_gen rswinit General Algorithm -!! @{ !----------------------------------- subroutine rswinit & & ( me ) ! --- inputs: @@ -1509,7 +1504,7 @@ subroutine rswinit & endif endif -!> -# Check cloud flags for consistency. +!> - Check cloud flags for consistency. if ((icldflg == 0 .and. iswcliq /= 0) .or. & & (icldflg == 1 .and. iswcliq == 0)) then @@ -1529,7 +1524,7 @@ subroutine rswinit & iovr = 1 endif -!> -# Setup constant factors for heating rate +!> - Setup constant factors for heating rate !! the 1.0e-2 is to convert pressure from mb to \f$N/m^2\f$ . if (iswrate == 1) then @@ -1540,7 +1535,7 @@ subroutine rswinit & heatfac = con_g * 1.0e-2 / con_cp ! (in k/second) endif -!> -# Define exponential lookup tables for transmittance. +!> - Define exponential lookup tables for transmittance. ! tau is computed as a function of the \a tau transition function, and ! transmittance is calculated as a function of tau. all tables ! are computed at intervals of 0.0001. the inverse of the @@ -1559,7 +1554,6 @@ subroutine rswinit & return !................................... end subroutine rswinit -!! @} !----------------------------------- !>\ingroup module_radsw_main @@ -1599,7 +1593,6 @@ end subroutine rswinit !!\param cldfrc cloud fraction of grid mean value !!\param cldfmc cloud fraction for each sub-column !!\section General_cldprop cldprop General Algorithm -!> @{ !----------------------------------- subroutine cldprop & & ( cfrac,cliqp,reliq,cicep,reice,cdat1,cdat2,cdat3,cdat4, & ! --- inputs @@ -1729,7 +1722,7 @@ subroutine cldprop & enddo enddo -!> -# Compute cloud radiative properties for a cloudy column. +!> - Compute cloud radiative properties for a cloudy column. lab_if_iswcliq : if (iswcliq > 0) then @@ -1934,7 +1927,7 @@ subroutine cldprop & endif lab_if_iswcliq -!> -# if physparam::isubcsw > 0, call mcica_subcol() to distribute +!> - if isubcsw > 0, call mcica_subcol() to distribute !! cloud properties to each g-point. if ( isubcsw > 0 ) then ! mcica sub-col clouds approx @@ -1974,7 +1967,6 @@ subroutine cldprop & !................................... end subroutine cldprop !----------------------------------- -!> @} !>\ingroup module_radsw_main !> This subroutine computes the sub-colum cloud profile flag array. @@ -1986,7 +1978,6 @@ end subroutine cldprop !!\param alpha EXP/ER cloud overlap decorrelation parameter !!\param lcloudy sub-colum cloud profile flag array !!\section mcica_sw_gen mcica_subcol General Algorithm -!> @{ ! ---------------------------------- subroutine mcica_subcol & & ( cldf, nlay, ipseed, dz, de_lgth, alpha, & ! --- inputs @@ -2043,7 +2034,7 @@ subroutine mcica_subcol & ! !===> ... begin here ! -!> -# Advance randum number generator by ipseed values. +!> - Advance randum number generator by ipseed values. call random_setseed & ! --- inputs: @@ -2052,7 +2043,7 @@ subroutine mcica_subcol & & stat & & ) -!> -# Sub-column set up according to overlapping assumption. +!> - Sub-column set up according to overlapping assumption. select case ( iovr ) @@ -2237,7 +2228,7 @@ subroutine mcica_subcol & end select -!> -# Generate subcolumns for homogeneous clouds. +!> - Generate subcolumns for homogeneous clouds. do k = 1, nlay tem1 = f_one - cldf(k) @@ -2250,7 +2241,6 @@ subroutine mcica_subcol & return ! .................................. end subroutine mcica_subcol -!> @} ! ---------------------------------- !>\ingroup module_radsw_main @@ -2279,7 +2269,6 @@ end subroutine mcica_subcol !! reference w.v. foreign-continuum data !!\param indfor index of lower ref temp for forfac !>\section setcoef_gen_rw setcoef General Algorithm -!! @{ ! ---------------------------------- subroutine setcoef & & ( pavel,tavel,h2ovmr, nlay,nlp1, & ! --- inputs @@ -2350,7 +2339,7 @@ subroutine setcoef & forfac(k) = pavel(k)*stpfac / (tavel(k)*(f_one + h2ovmr(k))) -!> -# Find the two reference pressures on either side of the +!> - Find the two reference pressures on either side of the !! layer pressure. store them in jp and jp1. store in fp the !! fraction of the difference (in ln(pressure)) between these !! two values that the layer pressure lies. @@ -2360,7 +2349,7 @@ subroutine setcoef & jp1 = jp(k) + 1 fp = 5.0 * (preflog(jp(k)) - plog) -!> -# Determine, for each reference pressure (jp and jp1), which +!> - Determine, for each reference pressure (jp and jp1), which !! reference temperature (these are different for each reference !! pressure) is nearest the layer temperature but does not exceed it. !! store these indices in jt and jt1, resp. store in ft (resp. ft1) @@ -2374,7 +2363,7 @@ subroutine setcoef & ft = tem1 - float(jt (k) - 3) ft1 = tem2 - float(jt1(k) - 3) -!> -# We have now isolated the layer ln pressure and temperature, +!> - We have now isolated the layer ln pressure and temperature, !! between two reference pressures and two reference temperatures !! (for each reference pressure). we multiply the pressure !! fraction fp with the appropriate temperature fractions to get @@ -2387,21 +2376,21 @@ subroutine setcoef & fac11(k) = fp * ft1 fac01(k) = fp * (f_one - ft1) -!> -# If the pressure is less than ~100mb, perform a different +!> - If the pressure is less than ~100mb, perform a different !! set of species interpolations. if ( plog > 4.56 ) then laytrop = k -!> -# Set up factors needed to separately include the water vapor +!> - Set up factors needed to separately include the water vapor !! foreign-continuum in the calculation of absorption coefficient. tem1 = (332.0 - tavel(k)) / 36.0 indfor (k) = min(2, max(1, int(tem1))) forfrac(k) = tem1 - float(indfor(k)) -!> -# Set up factors needed to separately include the water vapor +!> - Set up factors needed to separately include the water vapor !! self-continuum in the calculation of absorption coefficient. tem2 = (tavel(k) - 188.0) / 7.2 @@ -2429,7 +2418,6 @@ subroutine setcoef & return ! .................................. end subroutine setcoef -!! @} ! ---------------------------------- !>\ingroup module_radsw_main @@ -2471,7 +2459,6 @@ end subroutine setcoef !!\param suvbfc tot sky sfc dnwd uv-b flux !!\param suvbf0 clr sky sfc dnwd uv-b flux !>\section General_spcvrtc spcvrtc General Algorithm -!! @{ !----------------------------------- subroutine spcvrtc & & ( ssolar,cosz,sntz,albbm,albdf,sfluxzen,cldfrc, & ! --- inputs @@ -2622,7 +2609,7 @@ subroutine spcvrtc & ! !===> ... begin here -!> -# Initialize output fluxes. +!> - Initialize output fluxes. do ib = 1, nbdsw do k = 1, nlp1 fxdnc(k,ib) = f_zero @@ -2654,7 +2641,7 @@ subroutine spcvrtc & sfdf0(1) = f_zero sfdf0(2) = f_zero -!> -# Loop over all g-points in each band. +!> - Loop over all g-points in each band. lab_do_jg : do jg = 1, ngptsw @@ -2664,7 +2651,7 @@ subroutine spcvrtc & zsolar = ssolar * sfluxzen(jg) -!> -# Set up toa direct beam and surface values (beam and diff). +!> - Set up toa direct beam and surface values (beam and diff). ztdbt(nlp1) = f_one ztdbt0 = f_one @@ -2680,7 +2667,7 @@ subroutine spcvrtc & ztrab(1) = f_zero ztrad(1) = f_zero -!> -# Compute clear-sky optical parameters, layer reflectance and +!> - Compute clear-sky optical parameters, layer reflectance and !! transmittance. ! - Set up toa direct beam and surface values (beam and diff). ! - Delta scaling for clear-sky condition. @@ -2873,7 +2860,7 @@ subroutine spcvrtc & ztdbt0 = zexp4 * ztdbt0 enddo ! end do_k_loop -!> -# Call vrtqdr(), to compute the upward and downward radiation fluxes. +!> - Call vrtqdr(), to compute the upward and downward radiation fluxes. call vrtqdr & ! --- inputs: & ( zrefb,zrefd,ztrab,ztrad,zldbt,ztdbt, & @@ -2882,13 +2869,13 @@ subroutine spcvrtc & & zfu, zfd & & ) -!> -# Compute upward and downward fluxes at levels. +!> - Compute upward and downward fluxes at levels. do k = 1, nlp1 fxup0(k,ib) = fxup0(k,ib) + zsolar*zfu(k) fxdn0(k,ib) = fxdn0(k,ib) + zsolar*zfd(k) enddo -!> -# Compute surface downward beam/diffused flux components. +!> - Compute surface downward beam/diffused flux components. zb1 = zsolar*ztdbt0 zb2 = zsolar*(zfd(1) - ztdbt0) @@ -2906,7 +2893,7 @@ subroutine spcvrtc & ! sfbm0(ibd) = sfbm0(ibd) + zsolar*ztdbt0 ! sfdf0(ibd) = sfdf0(ibd) + zsolar*(zfd(1) - ztdbt0) -!> -# Compute total sky optical parameters, layer reflectance and +!> - Compute total sky optical parameters, layer reflectance and !! transmittance. ! - Set up toa direct beam and surface values (beam and diff) ! - Delta scaling for total-sky condition @@ -3126,7 +3113,7 @@ subroutine spcvrtc & endif ! end if_zc1_block enddo ! end do_k_loop -!> -# Call vrtqdr(), to compute the upward and downward radiation fluxes. +!> - Call vrtqdr(), to compute the upward and downward radiation fluxes. call vrtqdr & ! --- inputs: @@ -3136,13 +3123,13 @@ subroutine spcvrtc & & zfu, zfd & & ) -!> -# Compute upward and downward fluxes at levels. +!> - Compute upward and downward fluxes at levels. do k = 1, nlp1 fxupc(k,ib) = fxupc(k,ib) + zsolar*zfu(k) fxdnc(k,ib) = fxdnc(k,ib) + zsolar*zfd(k) enddo -!> -# Process and save outputs. +!> - Process and save outputs. !! - surface downward beam/diffused flux components zb1 = zsolar*ztdbt0 zb2 = zsolar*(zfd(1) - ztdbt0) @@ -3226,7 +3213,6 @@ subroutine spcvrtc & !................................... end subroutine spcvrtc !----------------------------------- -!> @} !>\ingroup module_radsw_main !> This subroutine computes the shortwave radiative fluxes using @@ -3269,7 +3255,6 @@ end subroutine spcvrtc !!\param suvbfc tot sky sfc dnwd uv-b flux !!\param suvbf0 clr sky sfc dnwd uv-b flux !>\section spcvrtm_gen spcvrtm General Algorithm -!! @{ !----------------------------------- subroutine spcvrtm & & ( ssolar,cosz,sntz,albbm,albdf,sfluxzen,cldfmc, & ! --- inputs @@ -3420,7 +3405,7 @@ subroutine spcvrtm & ! !===> ... begin here ! -!> -# Initialize output fluxes. +!> - Initialize output fluxes. do ib = 1, nbdsw do k = 1, nlp1 @@ -3453,7 +3438,7 @@ subroutine spcvrtm & sfdf0(1) = f_zero sfdf0(2) = f_zero -!> -# Loop over all g-points in each band. +!> - Loop over all g-points in each band. lab_do_jg : do jg = 1, ngptsw @@ -3463,7 +3448,7 @@ subroutine spcvrtm & zsolar = ssolar * sfluxzen(jg) -!> -# Set up toa direct beam and surface values (beam and diff). +!> - Set up toa direct beam and surface values (beam and diff). ztdbt(nlp1) = f_one ztdbt0 = f_one @@ -3479,7 +3464,7 @@ subroutine spcvrtm & ztrab(1) = f_zero ztrad(1) = f_zero -!> -# Compute clear-sky optical parameters, layer reflectance and +!> - Compute clear-sky optical parameters, layer reflectance and !! transmittance. ! - Set up toa direct beam and surface values (beam and diff) ! - Delta scaling for clear-sky condition @@ -3670,7 +3655,7 @@ subroutine spcvrtm & ztdbt0 = zexp4 * ztdbt0 enddo ! end do_k_loop -!> -# Call vrtqdr(), to compute the upward and downward radiation fluxes. +!> - Call vrtqdr(), to compute the upward and downward radiation fluxes. call vrtqdr & ! --- inputs: & ( zrefb,zrefd,ztrab,ztrad,zldbt,ztdbt, & @@ -3679,13 +3664,13 @@ subroutine spcvrtm & & zfu, zfd & & ) -!> -# Compute upward and downward fluxes at levels. +!> - Compute upward and downward fluxes at levels. do k = 1, nlp1 fxup0(k,ib) = fxup0(k,ib) + zsolar*zfu(k) fxdn0(k,ib) = fxdn0(k,ib) + zsolar*zfd(k) enddo -!> -# Compute surface downward beam/diffuse flux components. +!> - Compute surface downward beam/diffuse flux components. zb1 = zsolar*ztdbt0 zb2 = zsolar*(zfd(1) - ztdbt0) @@ -3703,7 +3688,7 @@ subroutine spcvrtm & ! sfbm0(ibd) = sfbm0(ibd) + zsolar*ztdbt0 ! sfdf0(ibd) = sfdf0(ibd) + zsolar*(zfd(1) - ztdbt0) -!> -# Compute total sky optical parameters, layer reflectance and +!> - Compute total sky optical parameters, layer reflectance and !! transmittance. ! - Set up toa direct beam and surface values (beam and diff) ! - Delta scaling for total-sky condition @@ -3902,7 +3887,7 @@ subroutine spcvrtm & endif ! end if_cldfmc_block enddo ! end do_k_loop -!> -# Call vrtqdr(), to perform vertical quadrature +!> - Call vrtqdr(), to perform vertical quadrature call vrtqdr & ! --- inputs: @@ -3918,7 +3903,7 @@ subroutine spcvrtm & fxdnc(k,ib) = fxdnc(k,ib) + zsolar*zfd(k) enddo -!> -# Process and save outputs. +!> - Process and save outputs. !! - surface downward beam/diffused flux components zb1 = zsolar*ztdbt0 zb2 = zsolar*(zfd(1) - ztdbt0) @@ -3988,7 +3973,6 @@ subroutine spcvrtm & return !................................... end subroutine spcvrtm -!! @} !----------------------------------- !>\ingroup module_radsw_main @@ -4004,7 +3988,6 @@ end subroutine spcvrtm !!\param zfu upward flux at layer interface !!\param zfd downward flux at layer interface !!\section General_vrtqdr vrtqdr General Algorithm -!> @{ !----------------------------------- subroutine vrtqdr & & ( zrefb,zrefd,ztrab,ztrad,zldbt,ztdbt, & ! inputs @@ -4057,11 +4040,11 @@ subroutine vrtqdr & !===> ... begin here ! -!> -# Link lowest layer with surface. +!> - Link lowest layer with surface. zrupb(1) = zrefb(1) ! direct beam zrupd(1) = zrefd(1) ! diffused -!> -# Pass from bottom to top. +!> - Pass from bottom to top. do k = 1, nlay kp = k + 1 @@ -4072,13 +4055,13 @@ subroutine vrtqdr & zrupd(kp) = zrefd(kp) + ztrad(kp)*ztrad(kp)*zrupd(k)*zden1 enddo -!> -# Upper boundary conditions +!> - Upper boundary conditions ztdn (nlp1) = f_one zrdnd(nlp1) = f_zero ztdn (nlay) = ztrab(nlp1) zrdnd(nlay) = zrefd(nlp1) -!> -# Pass from top to bottom +!> - Pass from top to bottom do k = nlay, 2, -1 zden1 = f_one / (f_one - zrefd(k)*zrdnd(k)) ztdn (k-1) = ztdbt(k)*ztrab(k) + ( ztrad(k) * & @@ -4087,7 +4070,7 @@ subroutine vrtqdr & zrdnd(k-1) = zrefd(k) + ztrad(k)*ztrad(k)*zrdnd(k)*zden1 enddo -!> -# Up and down-welling fluxes at levels. +!> - Up and down-welling fluxes at levels. do k = 1, nlp1 zden1 = f_one / (f_one - zrdnd(k)*zrupd(k)) zfu(k) = ( ztdbt(k)*zrupb(k) + & @@ -4100,7 +4083,6 @@ subroutine vrtqdr & !................................... end subroutine vrtqdr !----------------------------------- -!> @} !>\ingroup module_radsw_main !> This subroutine calculates optical depths for gaseous absorption and @@ -4141,7 +4123,6 @@ end subroutine vrtqdr !!\param taug spectral optical depth for gases !!\param taur opt depth for rayleigh scattering !>\section gen_al_taumol taumol General Algorithm -!! @{ !----------------------------------- subroutine taumol & & ( colamt,colmol,fac00,fac01,fac10,fac11,jp,jt,jt1,laytrop, & ! --- inputs @@ -5625,6 +5606,7 @@ end subroutine taumol29 end subroutine taumol !----------------------------------- +!> @} !........................................! end module rrtmg_sw ! !========================================! diff --git a/physics/radsw_param.f b/physics/radsw_param.f index b352bc785..69c8c2446 100644 --- a/physics/radsw_param.f +++ b/physics/radsw_param.f @@ -62,7 +62,7 @@ module module_radsw_parameters ! !........................................! -!! \section arg_table_module_radsw_parameters +!> \section arg_table_module_radsw_parameters Argument Table !! \htmlinclude module_radsw_parameters.html !! @@ -73,7 +73,7 @@ module module_radsw_parameters ! public ! !> derived type for SW fluxes at TOA -!! \section arg_table_topfsw_type +!! \section arg_table_topfsw_type Argument Table !! \htmlinclude topfsw_type.html !! type topfsw_type @@ -83,7 +83,7 @@ module module_radsw_parameters ! end type topfsw_type ! !> derived type for SW fluxes at surface -!! \section arg_table_sfcfsw_type +!! \section arg_table_sfcfsw_type Argument Table !! \htmlinclude sfcfsw_type.html !! type sfcfsw_type @@ -94,7 +94,7 @@ module module_radsw_parameters ! end type sfcfsw_type ! !> derived type for SW fluxes' column profiles (at layer interfaces) -!! \section arg_table_profsw_type +!! \section arg_table_profsw_type Argument Table !! \htmlinclude profsw_type.html !! type profsw_type @@ -105,7 +105,7 @@ module module_radsw_parameters ! end type profsw_type ! !> derived type for special components of surface SW fluxes -!! \section arg_table_cmpfsw_type +!! \section arg_table_cmpfsw_type Argument Table !! \htmlinclude cmpfsw_type.html !! type cmpfsw_type diff --git a/physics/rrtmg_lw_post.F90 b/physics/rrtmg_lw_post.F90 index 39601b269..d9d3aa520 100644 --- a/physics/rrtmg_lw_post.F90 +++ b/physics/rrtmg_lw_post.F90 @@ -4,9 +4,8 @@ module rrtmg_lw_post contains !>\defgroup rrtmg_lw_post GFS RRTMG scheme post -!! @{ - subroutine rrtmg_lw_post_init() - end subroutine rrtmg_lw_post_init +!! This module saves RRTMG-LW fluxes results. +!> @{ !> \section arg_table_rrtmg_lw_post_run Argument Table !! \htmlinclude rrtmg_lw_post_run.html @@ -41,8 +40,8 @@ subroutine rrtmg_lw_post_run (im, levs, ltp, lm, kd, lslwr, lwhtr, & errflg = 0 if (lslwr) then -!> -# Save calculation results -!> - Save surface air temp for diurnal adjustment at model t-steps +! Save calculation results +! Save surface air temp for diurnal adjustment at model t-steps tsflw (:) = tsfa(:) @@ -77,8 +76,5 @@ subroutine rrtmg_lw_post_run (im, levs, ltp, lm, kd, lslwr, lwhtr, & end subroutine rrtmg_lw_post_run - subroutine rrtmg_lw_post_finalize () - end subroutine rrtmg_lw_post_finalize - -!! @} +!> @} end module rrtmg_lw_post diff --git a/physics/rrtmg_lw_pre.F90 b/physics/rrtmg_lw_pre.F90 index 6da0e3100..2b63d98c5 100644 --- a/physics/rrtmg_lw_pre.F90 +++ b/physics/rrtmg_lw_pre.F90 @@ -1,12 +1,11 @@ -!>\file rrtmg_lw_pre.f90 +!>\file rrtmg_lw_pre.F90 +!! module rrtmg_lw_pre contains -!>\defgroup rrtmg_lw_pre GFS RRTMG scheme pre -!! @{ - subroutine rrtmg_lw_pre_init () - end subroutine rrtmg_lw_pre_init - +!>\defgroup rrtmg_lw_pre GFS RRTMG-LW scheme pre +!! This module contains RRTMG-LW pre module. +!> @{ !> \section arg_table_rrtmg_lw_pre_run Argument Table !! \htmlinclude rrtmg_lw_pre_run.html !! @@ -23,7 +22,5 @@ subroutine rrtmg_lw_pre_run (errmsg, errflg) end subroutine rrtmg_lw_pre_run - subroutine rrtmg_lw_pre_finalize () - end subroutine rrtmg_lw_pre_finalize -!! @} +!> @} end module rrtmg_lw_pre diff --git a/physics/rrtmg_sw_post.F90 b/physics/rrtmg_sw_post.F90 index 72e149fe1..f39cba71c 100644 --- a/physics/rrtmg_sw_post.F90 +++ b/physics/rrtmg_sw_post.F90 @@ -3,11 +3,10 @@ module rrtmg_sw_post contains -!>\defgroup rrtmg_sw_post GFS RRTMG scheme post -!! @{ - subroutine rrtmg_sw_post_init () - end subroutine rrtmg_sw_post_init - +!>\defgroup rrtmg_sw_post GFS RRTMG-SW scheme post +!! This module saves two spectral bands' surface downward and upward fluxes for +!! output. +!> @{ !> \section arg_table_rrtmg_sw_post_run Argument Table !! \htmlinclude rrtmg_sw_post_run.html !! @@ -78,8 +77,8 @@ subroutine rrtmg_sw_post_run (im, levr, levs, ltp, nday, lm, kd, lsswr, & endif ! --- surface down and up spectral component fluxes -!> - Save two spectral bands' surface downward and upward fluxes for -!! output. +! Save two spectral bands' surface downward and upward fluxes for +! output. do i=1,im nirbmdi(i) = scmpsw(i)%nirbm @@ -128,8 +127,5 @@ subroutine rrtmg_sw_post_run (im, levr, levs, ltp, nday, lm, kd, lsswr, & endif ! end_if_lsswr end subroutine rrtmg_sw_post_run - - subroutine rrtmg_sw_post_finalize () - end subroutine rrtmg_sw_post_finalize -!! @} +!> @} end module rrtmg_sw_post diff --git a/physics/rrtmgp_aerosol_optics.F90 b/physics/rrtmgp_aerosol_optics.F90 index eb7797125..e2cc95994 100644 --- a/physics/rrtmgp_aerosol_optics.F90 +++ b/physics/rrtmgp_aerosol_optics.F90 @@ -1,3 +1,6 @@ +!>\file rrtmgp_aerosol_optics.F90 +!! + module rrtmgp_aerosol_optics use machine, only: kind_phys use mo_gas_optics_rrtmgp, only: ty_gas_optics_rrtmgp @@ -21,6 +24,9 @@ module rrtmgp_aerosol_optics ! ######################################################################################### ! SUBROUTINE rrtmgp_aerosol_optics_run() ! ######################################################################################### + +!>\defgroup rrtmgp_aerosol_optics_mod GFS RRTMGP Aerosol Optics Module +!> @{ !! \section arg_table_rrtmgp_aerosol_optics_run !! \htmlinclude rrtmgp_aerosol_optics_run.html !! @@ -119,5 +125,5 @@ subroutine rrtmgp_aerosol_optics_run(doSWrad, doLWrad, nCol, nLev, nTracer, nTra end do end subroutine rrtmgp_aerosol_optics_run - +!> @} end module rrtmgp_aerosol_optics diff --git a/physics/rrtmgp_lw_cloud_optics.F90 b/physics/rrtmgp_lw_cloud_optics.F90 index 835261071..8bdd71696 100644 --- a/physics/rrtmgp_lw_cloud_optics.F90 +++ b/physics/rrtmgp_lw_cloud_optics.F90 @@ -1,3 +1,13 @@ +!> \file rrtmgp_lw_cloud_optics.F90 +!! +!> \defgroup rrtmgp_lw_cloud_optics rrtmgp_lw_cloud_optics.F90 +!! +!! \brief This module contains two routines: The first initializes data and functions +!! needed to compute the longwave cloud radiative properteis in RRTMGP. The second routine +!! is a ccpp scheme within the "radiation loop", where the shortwave optical prperties +!! (optical-depth, single-scattering albedo, asymmetry parameter) are computed for ALL +!! cloud types visible to RRTMGP. +!! module rrtmgp_lw_cloud_optics use machine, only: kind_phys use mo_rte_kind, only: wl @@ -64,12 +74,18 @@ module rrtmgp_lw_cloud_optics contains - ! ###################################################################################### - ! SUBROUTINE rrtmgp_lw_cloud_optics_init() - ! ###################################################################################### -!! \section arg_table_rrtmgp_lw_cloud_optics_init +!>\defgroup rrtmgp_lw_cloud_optics_mod GFS RRTMGP-LW Cloud Optics Module +!> \section arg_table_rrtmgp_lw_cloud_optics_init !! \htmlinclude rrtmgp_lw_cloud_optics.html !! +!> \ingroup rrtmgp_lw_cloud_optics +!! +!! RRTMGP relies heavily on derived-data-types, which contain type-bound procedures +!! that are referenced frequently throughout the RRTMGP longwave scheme. The data needed +!! to compute the shortwave cloud optical properties are initialized here and loaded into +!! the RRTMGP DDT, ty_cloud_optics. +!! +!! \section rrtmgp_sw_cloud_optics_init subroutine rrtmgp_lw_cloud_optics_init(nrghice, mpicomm, mpirank, mpiroot, & doG_cldoptics, doGP_cldoptics_PADE, doGP_cldoptics_LUT, rrtmgp_root_dir, & rrtmgp_lw_file_clouds, errmsg, errflg) @@ -375,13 +391,15 @@ subroutine rrtmgp_lw_cloud_optics_init(nrghice, mpicomm, mpirank, mpiroot, call check_error_msg('lw_cloud_optics_init',lw_cloud_props%set_ice_roughness(nrghice)) end subroutine rrtmgp_lw_cloud_optics_init - - ! ###################################################################################### - ! SUBROUTINE rrtmgp_lw_cloud_optics_run() ! ###################################################################################### -!! \section arg_table_rrtmgp_lw_cloud_optics_run +!> \section arg_table_rrtmgp_lw_cloud_optics_run !! \htmlinclude rrtmgp_lw_cloud_optics.html !! +!> \ingroup rrtmgp_lw_cloud_optics +!! +!! Compute longwave optical prperties (optical-depth) for ALL cloud types visible to RRTMGP. +!! +!! \section rrtmgp_lw_gas_optics_run subroutine rrtmgp_lw_cloud_optics_run(doLWrad, doG_cldoptics, icliq_lw, icice_lw, & doGP_cldoptics_PADE, doGP_cldoptics_LUT, doGP_lwscat, do_mynnedmf, imfdeepcnv, & imfdeepcnv_gf, imfdeepcnv_samf, nCol, nLev, nbndsGPlw , p_lay, cld_frac, cld_lwp, & @@ -540,13 +558,4 @@ subroutine rrtmgp_lw_cloud_optics_run(doLWrad, doG_cldoptics, icliq_lw, icice_lw end subroutine rrtmgp_lw_cloud_optics_run - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_cloud_optics_finalize() - ! ######################################################################################### -!! \section arg_table_rrtmgp_lw_cloud_optics_finalize -!! \htmlinclude rrtmgp_lw_cloud_optics.html -!! - subroutine rrtmgp_lw_cloud_optics_finalize() - end subroutine rrtmgp_lw_cloud_optics_finalize - end module rrtmgp_lw_cloud_optics diff --git a/physics/rrtmgp_lw_cloud_sampling.F90 b/physics/rrtmgp_lw_cloud_sampling.F90 index cb11607dc..05ce4a4bc 100644 --- a/physics/rrtmgp_lw_cloud_sampling.F90 +++ b/physics/rrtmgp_lw_cloud_sampling.F90 @@ -1,3 +1,9 @@ +!> \file rrtmgp_lw_cloud_sampling.F90 +!! +!> \defgroup rrtmgp_lw_cloud_sampling rrtmgp_lw_cloud_sampling.F90 +!! +!! \brief +!! module rrtmgp_lw_cloud_sampling use machine, only: kind_phys use mo_gas_optics_rrtmgp, only: ty_gas_optics_rrtmgp @@ -12,12 +18,16 @@ module rrtmgp_lw_cloud_sampling contains - ! ######################################################################################### - ! SUBROTUINE rrtmgp_lw_cloud_sampling_run() - ! ######################################################################################### -!! \section arg_table_rrtmgp_lw_cloud_sampling_run +!>\defgroup rrtmgp_lw_cloud_sampling_mod GFS RRTMGP-LW Cloud Sampling Module +!> \section arg_table_rrtmgp_lw_cloud_sampling_run !! \htmlinclude rrtmgp_lw_cloud_sampling_run.html !! +!> \ingroup rrtmgp_lw_cloud_sampling +!! +!! \brief This routine performs the McICA cloud-sampling and maps the shortwave cloud- +!! optical properties, defined for each spectral band, to each spectral point (g-point). +!! +!! \section rrtmgp_lw_cloud_sampling_run subroutine rrtmgp_lw_cloud_sampling_run(doLWrad, nCol, nLev, icseed_lw, iovr,iovr_convcld,& iovr_max, iovr_maxrand, iovr_rand, iovr_dcorr, iovr_exp, iovr_exprand, isubc_lw, & cld_frac, precip_frac, cloud_overlap_param, precip_overlap_param, cld_cnv_frac, & @@ -157,10 +167,4 @@ subroutine rrtmgp_lw_cloud_sampling_run(doLWrad, nCol, nLev, icseed_lw, iovr,iov end subroutine rrtmgp_lw_cloud_sampling_run - ! ######################################################################################### - ! SUBROTUINE rrtmgp_lw_cloud_sampling_finalize() - ! ######################################################################################### - subroutine rrtmgp_lw_cloud_sampling_finalize() - end subroutine rrtmgp_lw_cloud_sampling_finalize - end module rrtmgp_lw_cloud_sampling diff --git a/physics/rrtmgp_lw_gas_optics.F90 b/physics/rrtmgp_lw_gas_optics.F90 index 67a888911..e43fa4a63 100644 --- a/physics/rrtmgp_lw_gas_optics.F90 +++ b/physics/rrtmgp_lw_gas_optics.F90 @@ -1,3 +1,12 @@ +!> \file rrtmgp_lw_gas_optics.F90 +!! +!> \defgroup rrtmgp_lw_gas_optics rrtmgp_lw_gas_optics.F90 +!! +!! \brief This module contains two routines: One to initialize the k-distribution data +!! and functions needed to compute the longwave gaseous optical properties in RRTMGP. +!! The second routine is a ccpp scheme within the "radiation loop", where the longwave +!! optical prperties (optical-depth) are computed for clear-sky conditions (no aerosols). +!! module rrtmgp_lw_gas_optics use machine, only: kind_phys use mo_rte_kind, only: wl @@ -68,12 +77,20 @@ module rrtmgp_lw_gas_optics contains - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_gas_optics_init - ! ######################################################################################### +!>\defgroup rrtmgp_lw_gas_optics_mod GFS RRTMGP-LW Gas Optics Module !! \section arg_table_rrtmgp_lw_gas_optics_init -!! \htmlinclude rrtmgp_lw_gas_optics_init.html +!! \htmlinclude rrtmgp_lw_gas_optics.html +!! +!> \ingroup rrtmgp_lw_gas_optics !! +!! RRTMGP relies heavility on derived-data-types, which contain type-bound procedures +!! that are referenced frequently throughout the RRTMGP longwave scheme. The data needed +!! for the correlated k-distribution is also contained within this type. Within this module, +!! the full k-distribution data is read in, reduced by the "active gases" provided, and +!! loaded into the RRTMGP DDT, ty_gas_optics_rrtmgp. +!! +!! \section rrtmgp_lw_gas_optics_init + ! ###################################################################################### subroutine rrtmgp_lw_gas_optics_init(rrtmgp_root_dir, rrtmgp_lw_file_gas, mpicomm, & mpirank, mpiroot, minGPpres, maxGPpres, minGPtemp, maxGPtemp, active_gases_array, & errmsg, errflg) @@ -459,12 +476,10 @@ subroutine rrtmgp_lw_gas_optics_init(rrtmgp_root_dir, rrtmgp_lw_file_gas, mpicom end subroutine rrtmgp_lw_gas_optics_init - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_gas_optics_run - ! ######################################################################################### -!! \section arg_table_rrtmgp_lw_gas_optics_run +!> \section arg_table_rrtmgp_lw_gas_optics_run !! \htmlinclude rrtmgp_lw_gas_optics_run.html -!! +!! Compute longwave optical prperties (optical-depth) for clear-sky conditions. +!! \section rrtmgp_lw_gas_optics_run subroutine rrtmgp_lw_gas_optics_run(doLWrad, nCol, nLev, p_lay, p_lev, t_lay, t_lev, tsfg, & gas_concentrations, lw_optical_props_clrsky, sources, errmsg, errflg) @@ -527,10 +542,4 @@ subroutine rrtmgp_lw_gas_optics_run(doLWrad, nCol, nLev, p_lay, p_lev, t_lay, t_ end subroutine rrtmgp_lw_gas_optics_run - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_gas_optics_finalize - ! ######################################################################################### - subroutine rrtmgp_lw_gas_optics_finalize() - end subroutine rrtmgp_lw_gas_optics_finalize - end module rrtmgp_lw_gas_optics diff --git a/physics/rrtmgp_lw_pre.F90 b/physics/rrtmgp_lw_pre.F90 index d33a4e52c..1501ca319 100644 --- a/physics/rrtmgp_lw_pre.F90 +++ b/physics/rrtmgp_lw_pre.F90 @@ -1,3 +1,9 @@ +!> \file rrtmgp_lw_pre.F90 +!! +!> \defgroup rrtmgp_lw_pre rrtmgp_lw_pre.F90 +!! +!! \brief RRTMGP Longwave pre-processing routine. +!! module rrtmgp_lw_pre use machine, only: & kind_phys ! Working type @@ -7,22 +13,19 @@ module rrtmgp_lw_pre implicit none - public rrtmgp_lw_pre_run,rrtmgp_lw_pre_init,rrtmgp_lw_pre_finalize + public rrtmgp_lw_pre_run contains - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_pre_init - ! ######################################################################################### - subroutine rrtmgp_lw_pre_init () - end subroutine rrtmgp_lw_pre_init - - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_pre_run - ! ######################################################################################### +!>\defgroup rrtmgp_lw_pre_mode GFS RRTMGP-LW Pre Module !> \section arg_table_rrtmgp_lw_pre_run !! \htmlinclude rrtmgp_lw_pre_run.html !! +!> \ingroup rrtmgp_lw_pre +!! +!! \brief +!! +!! \section rrtmgp_lw_pre_run subroutine rrtmgp_lw_pre_run (doLWrad, semis, sfc_emiss_byband, errmsg, errflg) ! Inputs @@ -55,10 +58,4 @@ subroutine rrtmgp_lw_pre_run (doLWrad, semis, sfc_emiss_byband, errmsg, errflg) end subroutine rrtmgp_lw_pre_run - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_pre_finalize - ! ######################################################################################### - subroutine rrtmgp_lw_pre_finalize () - end subroutine rrtmgp_lw_pre_finalize - end module rrtmgp_lw_pre diff --git a/physics/rrtmgp_lw_rte.F90 b/physics/rrtmgp_lw_rte.F90 index a141a4e08..9109a5780 100644 --- a/physics/rrtmgp_lw_rte.F90 +++ b/physics/rrtmgp_lw_rte.F90 @@ -1,5 +1,9 @@ -! ########################################################################################### -! ########################################################################################### +!> \file rrtmgp_lw_rte.F90 +!! +!> \defgroup rrtmgp_lw_rte rrtmgp_lw_rte.F90 +!! +!! \brief This module contains the main rte longwave driver. +!! module rrtmgp_lw_rte use machine, only: kind_phys use mo_optical_props, only: ty_optical_props_1scl, ty_optical_props_2str @@ -10,21 +14,19 @@ module rrtmgp_lw_rte use rrtmgp_lw_gas_optics, only: lw_gas_props implicit none - public rrtmgp_lw_rte_init, rrtmgp_lw_rte_run, rrtmgp_lw_rte_finalize + public rrtmgp_lw_rte_run contains - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_rte_init - ! ######################################################################################### - subroutine rrtmgp_lw_rte_init() - end subroutine rrtmgp_lw_rte_init - - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_rte_run - ! ######################################################################################### -!! \section arg_table_rrtmgp_lw_rte_run +!>\defgroup rrtmgp_lw_rte_mod GFS RRTMGP-LW RTE Module +!> \section arg_table_rrtmgp_lw_rte_run !! \htmlinclude rrtmgp_lw_rte_run.html !! +!> \ingroup rrtmgp_lw_rte +!! +!! \brief This routine takes all of the longwave optical properties ,ty_optical_props_1scl, +!! and computes the longwave radiative fluxes for cloudy and clear-sky conditions. +!! +!! \section rrtmgp_lw_rte_run subroutine rrtmgp_lw_rte_run(doLWrad, doLWclrsky, use_LW_jacobian, doGP_lwscat, nCol, & nLev, top_at_1, doGP_sgs_cnv, doGP_sgs_mynn, sfc_emiss_byband, sources, & lw_optical_props_clrsky, lw_optical_props_clouds, lw_optical_props_precipByBand, & @@ -202,12 +204,5 @@ subroutine rrtmgp_lw_rte_run(doLWrad, doLWclrsky, use_LW_jacobian, doGP_lwscat, fluxlwDOWN_radtime = fluxlwDOWN_allsky end subroutine rrtmgp_lw_rte_run - - ! ######################################################################################### - ! SUBROUTINE rrtmgp_lw_rte_finalize - ! ######################################################################################### - subroutine rrtmgp_lw_rte_finalize() - end subroutine rrtmgp_lw_rte_finalize - end module rrtmgp_lw_rte diff --git a/physics/rrtmgp_sw_cloud_optics.F90 b/physics/rrtmgp_sw_cloud_optics.F90 index fd648de02..3aab115cd 100644 --- a/physics/rrtmgp_sw_cloud_optics.F90 +++ b/physics/rrtmgp_sw_cloud_optics.F90 @@ -1,3 +1,12 @@ +!> \file rrtmgp_sw_cloud_optics.F90 +!! +!> \defgroup rrtmgp_sw_cloud_optics rrtmgp_sw_cloud_optics.F90 +!! +!! \brief This module contains two routines: The first initializes data and functions +!! needed to compute the shortwave cloud radiative properteis in RRTMGP. The second routine +!! is a ccpp scheme within the "radiation loop", where the shortwave optical prperties +!! (optical-depth, single-scattering albedo, asymmetry parameter) are computed for ALL +!! cloud types visible to RRTMGP. module rrtmgp_sw_cloud_optics use machine, only: kind_phys use mo_rte_kind, only: wl @@ -64,12 +73,20 @@ module rrtmgp_sw_cloud_optics radice_uprSW ! Ice particle size lower bound for LUT interpolation contains - ! ###################################################################################### - ! SUBROUTINE sw_cloud_optics_init - ! ###################################################################################### -!! \section arg_table_rrtmgp_sw_cloud_optics_init + +!>\defgroup rrtmgp_sw_cloud_optics_mod GFS RRTMGP-SW Cloud Optics Module +!> \section arg_table_rrtmgp_sw_cloud_optics_init !! \htmlinclude rrtmgp_lw_cloud_optics.html !! +!> \ingroup rrtmgp_sw_cloud_optics +!! +!! RRTMGP relies heavily on derived-data-types, which contain type-bound procedures +!! that are referenced frequently throughout the RRTMGP shortwave scheme. The data needed +!! to compute the shortwave cloud optical properties are initialized here and loaded into +!! the RRTMGP DDT, ty_cloud_optics. +!! +!! \section rrtmgp_sw_cloud_optics_init + ! ###################################################################################### subroutine rrtmgp_sw_cloud_optics_init(doG_cldoptics, doGP_cldoptics_PADE, & doGP_cldoptics_LUT, nrghice, rrtmgp_root_dir, rrtmgp_sw_file_clouds, mpicomm, & mpirank, mpiroot, errmsg, errflg) @@ -388,12 +405,16 @@ subroutine rrtmgp_sw_cloud_optics_init(doG_cldoptics, doGP_cldoptics_PADE, end subroutine rrtmgp_sw_cloud_optics_init - ! ######################################################################################### - ! SUBROTUINE rrtmgp_sw_cloud_optics_run() - ! ######################################################################################### -!! \section arg_table_rrtmgp_sw_cloud_optics_run +!> \section arg_table_rrtmgp_sw_cloud_optics_run !! \htmlinclude rrtmgp_sw_cloud_optics.html !! +!> \ingroup rrtmgp_sw_cloud_optics +!! +!! Compute shortwave optical prperties (optical-depth, single-scattering albedo, +!! asymmetry parameter) for ALL cloud types visible to RRTMGP. +!! +!! \section rrtmgp_sw_gas_optics_run + ! ###################################################################################### subroutine rrtmgp_sw_cloud_optics_run(doSWrad, doG_cldoptics, icliq_sw, icice_sw, & doGP_cldoptics_PADE, doGP_cldoptics_LUT, do_mynnedmf, imfdeepcnv, imfdeepcnv_gf, & imfdeepcnv_samf, nCol, nLev, nDay, nbndsGPsw, idxday, cld_frac, cld_lwp, cld_reliq, & @@ -561,10 +582,4 @@ subroutine rrtmgp_sw_cloud_optics_run(doSWrad, doG_cldoptics, icliq_sw, icice_sw end subroutine rrtmgp_sw_cloud_optics_run - ! ######################################################################################### - ! SUBROTUINE rrtmgp_sw_cloud_optics_finalize() - ! ######################################################################################### - subroutine rrtmgp_sw_cloud_optics_finalize() - end subroutine rrtmgp_sw_cloud_optics_finalize - end module rrtmgp_sw_cloud_optics diff --git a/physics/rrtmgp_sw_cloud_sampling.F90 b/physics/rrtmgp_sw_cloud_sampling.F90 index c4a5de4c8..adb7cccf6 100644 --- a/physics/rrtmgp_sw_cloud_sampling.F90 +++ b/physics/rrtmgp_sw_cloud_sampling.F90 @@ -1,3 +1,7 @@ +!> \file rrtmgp_sw_cloud_sampling.F90 +!! +!> \defgroup rrtmgp_sw_cloud_sampling rrtmgp_sw_cloud_sampling.F90 +!! module rrtmgp_sw_cloud_sampling use machine, only: kind_phys use mo_gas_optics_rrtmgp, only: ty_gas_optics_rrtmgp @@ -12,12 +16,17 @@ module rrtmgp_sw_cloud_sampling contains - ! ######################################################################################### - ! SUBROTUINE rrtmgp_sw_cloud_sampling_run() - ! ######################################################################################### -!! \section arg_table_rrtmgp_sw_cloud_sampling_run +!>\defgroup rrtmgp_sw_cloud_sampling_mod GFS RRTMGP-SW Cloud Sampling Module +!> @{ +!> \section arg_table_rrtmgp_sw_cloud_sampling_run !! \htmlinclude rrtmgp_sw_cloud_sampling.html !! +!> \ingroup rrtmgp_sw_cloud_sampling +!! +!! \brief This routine performs the McICA cloud-sampling and maps the shortwave cloud- +!! optical properties, defined for each spectral band, to each spectral point (g-point). +!! +!! \section rrtmgp_sw_cloud_sampling_run subroutine rrtmgp_sw_cloud_sampling_run(doSWrad, nCol, nDay, nLev, idxday, iovr, & iovr_convcld, iovr_max, iovr_maxrand, iovr_rand, iovr_dcorr, iovr_exp, iovr_exprand, & isubc_sw,icseed_sw, cld_frac, precip_frac, cloud_overlap_param, precip_overlap_param,& @@ -161,10 +170,5 @@ subroutine rrtmgp_sw_cloud_sampling_run(doSWrad, nCol, nDay, nLev, idxday, iovr, end subroutine rrtmgp_sw_cloud_sampling_run - ! ######################################################################################### - ! SUBROTUINE rrtmgp_sw_cloud_sampling_finalize() - ! ######################################################################################### - subroutine rrtmgp_sw_cloud_sampling_finalize() - end subroutine rrtmgp_sw_cloud_sampling_finalize - +!> @} end module rrtmgp_sw_cloud_sampling diff --git a/physics/rrtmgp_sw_gas_optics.F90 b/physics/rrtmgp_sw_gas_optics.F90 index 260f65fe7..4bafa56a4 100644 --- a/physics/rrtmgp_sw_gas_optics.F90 +++ b/physics/rrtmgp_sw_gas_optics.F90 @@ -1,3 +1,13 @@ +!> \file rrtmgp_sw_gas_optics.F90 +!! +!> \defgroup rrtmgp_sw_gas_optics rrtmgp_sw_gas_optics.F90 +!! +!! \brief This module contains two routines: One to initialize the k-distribution data +!! and functions needed to compute the shortwave gaseous optical properties in RRTMGP. +!! The second routine is a ccpp scheme within the "radiation loop", where the shortwave +!! optical prperties (optical-depth, single-scattering albedo, asymmetry parameter) are +!! computed for clear-sky conditions (no aerosols) +!! module rrtmgp_sw_gas_optics use machine, only: kind_phys use mo_rte_kind, only: wl @@ -73,12 +83,23 @@ module rrtmgp_sw_gas_optics scale_by_complement_upperSW ! Absorption is scaled by concentration of scaling_gas (F) or its complement (T) contains - ! ######################################################################################### - ! SUBROUTINE sw_gas_optics_init - ! ######################################################################################### + +!>\defgroup rrtmgp_sw_gas_optics_mod GFS RRTMGP-SW Gas Optics Module +!> @{ !! \section arg_table_rrtmgp_sw_gas_optics_init !! \htmlinclude rrtmgp_sw_gas_optics.html !! +!> \ingroup rrtmgp_sw_gas_optics +!! +!! RRTMGP relies heavility on derived-data-types, which contain type-bound procedures +!! that are referenced frequently throughout the RRTMGP shortwave scheme. The data needed +!! for the correlated k-distribution is also contained within this type. Within this module, +!! the full k-distribution data is read in, reduced by the "active gases" provided, and +!! loaded into the RRTMGP DDT, ty_gas_optics_rrtmgp. +!! +!! \section rrtmgp_sw_gas_optics_init +!> @{ + ! ###################################################################################### subroutine rrtmgp_sw_gas_optics_init(rrtmgp_root_dir, rrtmgp_sw_file_gas, & active_gases_array, mpicomm, mpirank, mpiroot, errmsg, errflg) @@ -441,6 +462,7 @@ subroutine rrtmgp_sw_gas_optics_init(rrtmgp_root_dir, rrtmgp_sw_file_gas, call mpi_bcast(scaling_gas_lowerSW(iChar), & len(scaling_gas_lowerSW(iChar)), MPI_CHARACTER, mpiroot, mpicomm, mpierr) enddo + do iChar=1,nminor_absorber_intervals_upperSW call mpi_bcast(minor_gases_upperSW(iChar), & len(minor_gases_upperSW(iChar)), MPI_CHARACTER, mpiroot, mpicomm, mpierr) @@ -475,18 +497,27 @@ subroutine rrtmgp_sw_gas_optics_init(rrtmgp_root_dir, rrtmgp_sw_file_gas, minor_gases_upperSW, minor_limits_gpt_lowerSW, minor_limits_gpt_upperSW, & minor_scales_with_density_lowerSW, minor_scales_with_density_upperSW, & scaling_gas_lowerSW, scaling_gas_upperSW, scale_by_complement_lowerSW, & + + scale_by_complement_upperSW, kminor_start_lowerSW, kminor_start_upperSW, & solar_quietSW, solar_facularSW, solar_sunspotSW, tsi_defaultSW, mg_defaultSW, & sb_defaultSW, rayl_lowerSW, rayl_upperSW)) end subroutine rrtmgp_sw_gas_optics_init - ! ######################################################################################### - ! SUBROUTINE rrtmgp_sw_gas_optics_run - ! ######################################################################################### -!! \section arg_table_rrtmgp_sw_gas_optics_run +!> @} + ! ###################################################################################### +!> \section arg_table_rrtmgp_sw_gas_optics_run !! \htmlinclude rrtmgp_sw_gas_optics.html !! +!> \ingroup rrtmgp_sw_gas_optics +!! +!! Compute shortwave optical prperties (optical-depth, single-scattering albedo, +!! asymmetry parameter) for clear-sky conditions. +!! +!! \section rrtmgp_sw_gas_optics_run +!> @{ + ! ###################################################################################### subroutine rrtmgp_sw_gas_optics_run(doSWrad, nCol, nLev, ngptsGPsw, nday, idxday, p_lay, & p_lev, toa_src_sw, t_lay, t_lev, active_gases_array, gas_concentrations, solcon, & sw_optical_props_clrsky, errmsg, errflg) @@ -580,12 +611,6 @@ subroutine rrtmgp_sw_gas_optics_run(doSWrad, nCol, nLev, ngptsGPsw, nday, idxday endif end subroutine rrtmgp_sw_gas_optics_run - - ! ######################################################################################### - ! SUBROUTINE rrtmgp_sw_gas_optics_finalize - ! ######################################################################################### - subroutine rrtmgp_sw_gas_optics_finalize() - end subroutine rrtmgp_sw_gas_optics_finalize - +!> @} end module rrtmgp_sw_gas_optics diff --git a/physics/rrtmgp_sw_rte.F90 b/physics/rrtmgp_sw_rte.F90 index e1879bd7a..521aae2c1 100644 --- a/physics/rrtmgp_sw_rte.F90 +++ b/physics/rrtmgp_sw_rte.F90 @@ -1,3 +1,8 @@ +!> \file rrtmgp_sw_rte.F90 +!! +!> \defgroup rrtmgp_sw_rte rrtmgp_sw_rte.F90 +!! +!! \brief This module contains the main rte shortwave driver. module rrtmgp_sw_rte use machine, only: kind_phys use mo_optical_props, only: ty_optical_props_2str @@ -8,22 +13,21 @@ module rrtmgp_sw_rte use rrtmgp_sw_gas_optics, only: sw_gas_props implicit none - public rrtmgp_sw_rte_init, rrtmgp_sw_rte_run, rrtmgp_sw_rte_finalize + public rrtmgp_sw_rte_run contains - - ! ######################################################################################### - ! SUBROUTINE rrtmgp_sw_rte_init - ! ######################################################################################### - subroutine rrtmgp_sw_rte_init() - end subroutine rrtmgp_sw_rte_init - - ! ######################################################################################### - ! SUBROUTINE rrtmgp_sw_rte_run - ! ######################################################################################### -!! \section arg_table_rrtmgp_sw_rte_run +!>\defgroup rrtmgp_sw_rte_mod GFS RRTMGP-SW RTE Module +!> \section arg_table_rrtmgp_sw_rte_run !! \htmlinclude rrtmgp_sw_rte.html !! +!> \ingroup rrtmgp_sw_rte +!! +!! \brief This routine takes all of the shortwave optical properties ,ty_optical_props_2str, +!! and computes the shortwave radiative fluxes for cloudy and clear-sky conditions. +!! +!! \section rrtmgp_sw_rte_run Main Driver +!> @{ + ! ###################################################################################### subroutine rrtmgp_sw_rte_run(doSWrad, doSWclrsky, nCol, nLev, nDay, idxday, coszen, p_lay,& t_lay, top_at_1, doGP_sgs_cnv, doGP_sgs_mynn, iSFC, sfc_alb_nir_dir, sfc_alb_nir_dif,& sfc_alb_uvvis_dir, sfc_alb_uvvis_dif, toa_src_sw, sw_optical_props_clrsky, & @@ -211,11 +215,5 @@ subroutine rrtmgp_sw_rte_run(doSWrad, doSWclrsky, nCol, nLev, nDay, idxday, cosz endif end subroutine rrtmgp_sw_rte_run - - ! ######################################################################################### - ! SUBROUTINE rrtmgp_sw_rte_finalize - ! ######################################################################################### - subroutine rrtmgp_sw_rte_finalize() - end subroutine rrtmgp_sw_rte_finalize - +!> @} end module rrtmgp_sw_rte diff --git a/physics/rte-rrtmgp b/physics/rte-rrtmgp index f9377e81d..cec1e8e12 160000 --- a/physics/rte-rrtmgp +++ b/physics/rte-rrtmgp @@ -1 +1 @@ -Subproject commit f9377e81d33e4f73f4433501186465b84dd1111c +Subproject commit cec1e8e12d969c3c8c76574dbe4f40b366419cc7 diff --git a/physics/samfdeepcnv.f b/physics/samfdeepcnv.f index bb33b20cf..0d46acf35 100644 --- a/physics/samfdeepcnv.f +++ b/physics/samfdeepcnv.f @@ -29,13 +29,10 @@ subroutine samfdeepcnv_init(imfdeepcnv,imfdeepcnv_samf, & end subroutine samfdeepcnv_init - subroutine samfdeepcnv_finalize() - end subroutine samfdeepcnv_finalize - -!> \defgroup SAMFdeep GFS Scale-Aware Mass-Flux Deep Convection Scheme Module -!! @{ -!> \brief This subroutine contains the entirety of the SAMF deep convection +!> \defgroup SAMFdeep GFS saSAS Deep Convection Module +!> This subroutine contains the entirety of the SAMF deep convection !! scheme. +!> @{ !! !! For grid sizes larger than threshold value, as in Grell (1993) \cite grell_1993 , the SAMF !! deep convection scheme can be described in terms of three types of @@ -74,7 +71,6 @@ end subroutine samfdeepcnv_finalize !! -# For the "feedback control", calculate updated values of the state variables by multiplying the cloud base mass flux and the tendencies calculated per unit cloud base mass flux from the static control. !! !! \section samfdeep_detailed GFS samfdeepcnv Detailed Algorithm -!! @{ subroutine samfdeepcnv_run (im,km,itc,ntc,cliq,cp,cvap, & & eps,epsm1,fv,grav,hvap,rd,rv, & & t0c,delt,ntk,ntr,delp, & @@ -3442,6 +3438,5 @@ subroutine samfdeepcnv_run (im,km,itc,ntc,cliq,cp,cvap, & end subroutine samfdeepcnv_run !> @} -!! @} end module samfdeepcnv diff --git a/physics/samfshalcnv.f b/physics/samfshalcnv.f index 364049e4d..39b5cda84 100644 --- a/physics/samfshalcnv.f +++ b/physics/samfshalcnv.f @@ -1,8 +1,6 @@ !> \file samfshalcnv.f !! This file contains the Scale-Aware mass flux Shallow Convection scheme. -!> This module contains the CCPP-compliant scale-aware mass-flux -!! shallow convection scheme. module samfshalcnv use samfcnv_aerosols, only : samfshalcnv_aerosols @@ -28,14 +26,10 @@ subroutine samfshalcnv_init(imfshalcnv, imfshalcnv_samf, & end if end subroutine samfshalcnv_init - subroutine samfshalcnv_finalize() - end subroutine samfshalcnv_finalize - -!> \defgroup SAMF_shal GFS Scale-Aware Mass-Flux Shallow Convection Scheme Module -!! @{ -!> \brief This subroutine contains the entirety of the SAMF shallow convection +!> \defgroup SAMF_shal GFS saSAS Shallow Convection Module +!> This subroutine contains the entirety of the SAMF shallow convection !! scheme. -!! +!> @{ !! This routine follows the \ref SAMFdeep quite closely, although it !! can be interpreted as only having the "static" and "feedback" control !! portions, since the "dynamic" control is not necessary to find the cloud @@ -54,7 +48,6 @@ end subroutine samfshalcnv_finalize !! -# Calculate the tendencies of the state variables (per unit cloud base mass flux) and the cloud base mass flux. !! -# For the "feedback control", calculate updated values of the state variables by multiplying the cloud base mass flux and the tendencies calculated per unit cloud base mass flux from the static control. !! \section det_samfshalcnv GFS samfshalcnv Detailed Algorithm -!! @{ subroutine samfshalcnv_run(im,km,itc,ntc,cliq,cp,cvap, & & eps,epsm1,fv,grav,hvap,rd,rv, & & t0c,delt,ntk,ntr,delp, & @@ -2342,6 +2335,5 @@ subroutine samfshalcnv_run(im,km,itc,ntc,cliq,cp,cvap, & return end subroutine samfshalcnv_run !> @} -!! @} end module samfshalcnv diff --git a/physics/satmedmfvdifq.F b/physics/satmedmfvdifq.F index eb2b7ad1c..aa36eb4bf 100644 --- a/physics/satmedmfvdifq.F +++ b/physics/satmedmfvdifq.F @@ -7,20 +7,22 @@ module satmedmfvdifq contains -!> \defgroup satmedmfvdifq GFS Scale-aware TKE-based Moist Eddy-Diffusivity Mass-flux (TKE-EDMF, updated version) Scheme Module -!! @{ +!> \defgroup module_satmedmfvdifq GFS TKE-EDMF PBL Module +!! This file contains the CCPP-compliant SATMEDMF scheme (updated version) which +!! computes subgrid vertical turbulence mixing using scale-aware TKE-based moist +!! eddy-diffusion mass-flux (TKE-EDMF) parameterization (by Jongil Han). +!> @{ !! \brief This subroutine contains all of the logic for the !! scale-aware TKE-based moist eddy-diffusion mass-flux (TKE-EDMF, updated version) scheme. !! For local turbulence mixing, a TKE closure model is used. !! Updated version of satmedmfvdif.f (May 2019) to have better low level !! inversion, to reduce the cold bias in lower troposphere, !! and to reduce the negative wind speed bias in upper troposphere - !> \section arg_table_satmedmfvdifq_init Argument Table !! \htmlinclude satmedmfvdifq_init.html !! - subroutine satmedmfvdifq_init (satmedmf, - & isatmedmf,isatmedmf_vdifq, + subroutine satmedmfvdifq_init (satmedmf, & + & isatmedmf,isatmedmf_vdifq, & & errmsg,errflg) logical, intent(in ) :: satmedmf @@ -49,9 +51,6 @@ subroutine satmedmfvdifq_init (satmedmf, end subroutine satmedmfvdifq_init - subroutine satmedmfvdifq_finalize () - end subroutine satmedmfvdifq_finalize - !> \section arg_table_satmedmfvdifq_run Argument Table !! \htmlinclude satmedmfvdifq_run.html !! @@ -66,7 +65,6 @@ end subroutine satmedmfvdifq_finalize !! -# A mass-flux approach is also used to represent the stratocumulus-top-induced turbulence !! (mfscuq.f). !! \section detail_satmedmfvidfq GFS satmedmfvdifq Detailed Algorithm -!! @{ subroutine satmedmfvdifq_run(im,km,ntrac,ntcw,ntrw,ntiw,ntke, & & grav,rd,cp,rv,hvap,hfus,fv,eps,epsm1, & & dv,du,tdt,rtg,u1,v1,t1,q1,swh,hlw,xmu,garea,zvfun, & @@ -2311,5 +2309,4 @@ subroutine satmedmfvdifq_run(im,km,ntrac,ntcw,ntrw,ntiw,ntke, & return end subroutine satmedmfvdifq_run !> @} -!! @} end module satmedmfvdifq diff --git a/physics/sfc_diag.f b/physics/sfc_diag.f index c21d3a989..045ad75b0 100644 --- a/physics/sfc_diag.f +++ b/physics/sfc_diag.f @@ -1,26 +1,15 @@ !> \file sfc_diag.f !! This file contains the land surface diagnose calculation scheme. -!> \defgroup Sfc_diag Land Surface Diagnose Calculation -!! @{ - module sfc_diag contains - - subroutine sfc_diag_init - end subroutine sfc_diag_init - - subroutine sfc_diag_finalize - end subroutine sfc_diag_finalize - -!> \brief Brief description of the subroutine -!! -!! \section arg_table_sfc_diag_run Arguments + +!> \defgroup sfc_diag_mod GFS sfc_diag module +!! This module contains the land surface diagose calculation. +!> @{ +!! \section arg_table_sfc_diag_run Argument Table !! \htmlinclude sfc_diag_run.html !! -!! \section general General Algorithm -!! \section detailed Detailed Algorithm -!! @{ subroutine sfc_diag_run & & (im,grav,cp,eps,epsm1,ps,u1,v1,t1,q1,prslki, & & evap,fm,fh,fm10,fh2,tskin,qsurf,thsfc_loc, & @@ -99,4 +88,3 @@ end subroutine sfc_diag_run !> @} end module sfc_diag -!> @} diff --git a/physics/sfc_diag_post.F90 b/physics/sfc_diag_post.F90 index 36541b0fc..1a41715ef 100644 --- a/physics/sfc_diag_post.F90 +++ b/physics/sfc_diag_post.F90 @@ -1,15 +1,13 @@ -!> \file GFS_surface_diag.F90 +!> \file sfc_diag_post.F90 !! Contains code related to the surface diagnostic scheme. module sfc_diag_post contains - subroutine sfc_diag_post_init () - end subroutine sfc_diag_post_init - - subroutine sfc_diag_post_finalize() - end subroutine sfc_diag_post_finalize +!>\defgroup sfc_diag_post_mod GFS sfc_diag_post Module +!! This module contains code related to the surface diagnostic scheme. +!> @{ #if 0 !> \section arg_table_sfc_diag_post_run Argument Table !! \htmlinclude sfc_diag_post_run.html @@ -73,5 +71,5 @@ subroutine sfc_diag_post_run (im, lsm, lsm_noahmp, dry, lssav, dtf, con_eps, con endif end subroutine sfc_diag_post_run - +!> @} end module sfc_diag_post diff --git a/physics/sfc_diff.f b/physics/sfc_diff.f index c745e3c1e..fd3564e5f 100644 --- a/physics/sfc_diff.f +++ b/physics/sfc_diff.f @@ -10,7 +10,7 @@ module sfc_diff implicit none - public :: sfc_diff_init, sfc_diff_run, sfc_diff_finalize + public :: sfc_diff_run public :: stability private @@ -19,16 +19,9 @@ module sfc_diff contains - subroutine sfc_diff_init - end subroutine sfc_diff_init - - subroutine sfc_diff_finalize - end subroutine sfc_diff_finalize - -!> \defgroup GFS_diff_main GFS Surface Layer Scheme Module +!> \defgroup GFS_diff_main GFS Surface Layer Module +!> This module calculates surface roughness length. !> @{ -!> \brief This subroutine calculates surface roughness length. -!! !! This subroutine includes the surface roughness length formulation !! based on the surface sublayer scheme in !! Zeng and Dickinson (1998) \cite zeng_and_dickinson_1998. @@ -448,7 +441,6 @@ subroutine sfc_diff_run (im,rvrdm1,eps,epsm1,grav, & !intent(in) return end subroutine sfc_diff_run -!> @} !---------------------------------------- !>\ingroup GFS_diff_main @@ -852,7 +844,5 @@ SUBROUTINE znot_t_v7(uref, znott) endif END SUBROUTINE znot_t_v7 - - -!--------------------------------- +!> @} end module sfc_diff diff --git a/physics/sfc_nst.f b/physics/sfc_nst.f index 22961458d..ed4a72d1a 100644 --- a/physics/sfc_nst.f +++ b/physics/sfc_nst.f @@ -1,4 +1,4 @@ -!> \file sfc_nst.f +!>\file sfc_nst.f !! This file contains the GFS NSST model. !> This module contains the CCPP-compliant GFS near-surface sea temperature scheme. @@ -6,13 +6,14 @@ module sfc_nst contains -!>\defgroup gfs_nst_main GFS Near-Surface Sea Temperature Scheme Module -!> \brief This subroutine calls the Thermal Skin-layer and Diurnal Thermocline models to update the NSST profile. +!>\defgroup gfs_nst_main_mod GFS Near-Surface Sea Temperature Module +!! This module contains the CCPP-compliant GFS near-surface sea temperature scheme. +!> @{ +!! This subroutine calls the Thermal Skin-layer and Diurnal Thermocline models to update the NSST profile. !! \section arg_table_sfc_nst_run Argument Table !! \htmlinclude sfc_nst_run.html !! -!! \section NSST_general_algorithm GFS Near-Surface Sea Temperature Scheme General Algorithm -!> @{ +!> \section NSST_general_algorithm GFS Near-Surface Sea Temperature Scheme General Algorithm subroutine sfc_nst_run & & ( im, hvap, cp, hfus, jcal, eps, epsm1, rvrdm1, rd, rhw0, & ! --- inputs: & pi, tgice, sbc, ps, u1, v1, t1, q1, tref, cm, ch, & @@ -652,7 +653,7 @@ subroutine sfc_nst_run & enddo endif ! if ( nstf_name1 > 1 ) then ! -! include sea spray effects +!> - Include sea spray effects ! do i=1,im if(lseaspray .and. flag(i)) then @@ -692,4 +693,4 @@ subroutine sfc_nst_run & return end subroutine sfc_nst_run !> @} - end module sfc_nst \ No newline at end of file + end module sfc_nst diff --git a/physics/sfc_nst_pre.f b/physics/sfc_nst_pre.f index 04a08f591..77ff61f00 100644 --- a/physics/sfc_nst_pre.f +++ b/physics/sfc_nst_pre.f @@ -5,18 +5,16 @@ module sfc_nst_pre contains -! \defgroup GFS_NSST_PRE GFS Near-Surface Sea Temperature Pre +!> \defgroup GFS_NSST_PRE GFS Near-Surface Sea Temperature Pre !! !! The NSST scheme is one of the three schemes used to represent the !! surface in the GFS physics suite. The other two are the Noah land !! surface model and the sice simplified ice model. !! - !! \section arg_table_sfc_nst_pre_run Argument Table !! \htmlinclude sfc_nst_pre_run.html !! !> \section NSST_general_pre_algorithm General Algorithm -!! @{ subroutine sfc_nst_pre_run & (im, wet, tgice, tsfco, tsurf_wat, & tseal, xt, xz, dt_cool, z_c, tref, cplflx, @@ -95,5 +93,4 @@ subroutine sfc_nst_pre_run return end subroutine sfc_nst_pre_run -!! @} - end module sfc_nst_pre \ No newline at end of file + end module sfc_nst_pre diff --git a/physics/sfc_ocean.F b/physics/sfc_ocean.F index 79a9eb295..008f7545b 100644 --- a/physics/sfc_ocean.F +++ b/physics/sfc_ocean.F @@ -7,22 +7,19 @@ module sfc_ocean implicit none private - public :: sfc_ocean_init, sfc_ocean_run, sfc_ocean_finalize + public :: sfc_ocean_run contains - subroutine sfc_ocean_init() - end subroutine sfc_ocean_init - subroutine sfc_ocean_finalize() - end subroutine sfc_ocean_finalize - -!>\defgroup gfs_ocean_main GFS Simple Ocean Scheme Module +!>\defgroup gfs_ocean_main GFS Simple Ocean Module !! This subroutine calculates thermodynamical properties over !! open water. +!>@{ !! \section arg_table_sfc_ocean_run Argument Table !! \htmlinclude sfc_ocean_run.html !! +!!>\section gen_sfc_ocean GFS Simple Ocean scheme General Algorithm subroutine sfc_ocean_run & !................................... ! --- inputs: @@ -152,10 +149,10 @@ subroutine sfc_ocean_run & hvapi = one/hvap elocp = hvap/cp ! -! --- ... flag for open water +!> - Flag for open water do i = 1, im flag(i) = (wet(i) .and. flag_iter(i) .and. .not. use_flake(i)) -! --- ... initialize variables. all units are supposedly m.k.s. unless specified +!> - Initialize variables. all units are supposedly m.k.s. unless specified ! ps is in pascals, wind is wind speed, ! rho is density, qss is sat. hum. at surface @@ -173,7 +170,7 @@ subroutine sfc_ocean_run & cmm(i) = cm(i) * wind(i) chh(i) = rho(i) * tem -! --- ... sensible and latent heat flux over open water +!> - Calcualte sensible and latent heat flux over open water hflx(i) = rch * (tskin(i) - t1(i) * prslki(i)) @@ -184,7 +181,7 @@ subroutine sfc_ocean_run & endif enddo ! -! include sea spray effects +!> - Include sea spray effects ! do i=1,im if(lseaspray .and. flag(i)) then @@ -225,4 +222,5 @@ subroutine sfc_ocean_run & !................................... end subroutine sfc_ocean_run !----------------------------------- +!>@} end module sfc_ocean diff --git a/physics/sfc_sice.f b/physics/sfc_sice.f index b88178702..1cfa3336c 100644 --- a/physics/sfc_sice.f +++ b/physics/sfc_sice.f @@ -6,15 +6,9 @@ module sfc_sice contains - subroutine sfc_sice_init() - end subroutine sfc_sice_init -! - subroutine sfc_sice_finalize() - end subroutine sfc_sice_finalize - -!>\defgroup gfs_sice_main GFS Three-layer Thermodynomics Sea-Ice Scheme Module -!! \brief This is three-layer thermodynomics sea-ice model based on Winton (2000) \cite winton_2000. -!> \section general_sice_run GFS Sea Ice Driver General Algorithm +!>\defgroup gfs_sice_main GFS sfc_sice Module +!! This is three-layer thermodynomics sea-ice model based on Winton (2000) \cite winton_2000. +!> \section general_sice_run General Algorithm !!The model has four prognostic variables: the snow layer thickness \f$h_s\f$, the ice layer thickness !! \f$h_i\f$, the upper and lower ice layer temperatures located at the midpoints of the layers !! \f$h_i/4\f$ and \f$3h_i/4\f$ below the ice surface, respectively \f$T_1\f$ and \f$T_2\f$. The temperature of @@ -22,7 +16,7 @@ end subroutine sfc_sice_finalize !! the top of the ice or snow, \f$T_s\f$, is determined from the surface energy balance. !! The model consists of a zero-heat-capacity snow layer overlying two equally thick sea ice layers (Figure 1). !! The upper ice layer has a variable heat capacity to represent brine pockets. -!! \image html GFS_sice_wonton2000_fig1.png "Fig.1 Schematic representation of the three-layer model" width=5cm +!! \image html GFS_sice_wonton2000_fig1.png "Fig.1 Schematic representation of the three-layer model" width=900 !! The ice model main program ice3lay() performs two functions: !! - \b Calculation \b of \b ice \b temperature !!\n The surface temperature is determined from the diagnostic balance between @@ -34,7 +28,7 @@ end subroutine sfc_sice_finalize !! mass fluxes at the upper and lower surfaces, 2) to convert snow below !! the water line to ice, and 3) to equalize the thickness of the two !! ice layers. -!> \section detailed_sice_run GFS Sea Ice Driver Detailed Algorithm +!> \section detailed_sice_run Detailed Algorithm !! !! \section arg_table_sfc_sice_run Argument Table !! \htmlinclude sfc_sice_run.html diff --git a/physics/sflx.f b/physics/sflx.f index 61fe015cc..1e4dc3832 100644 --- a/physics/sflx.f +++ b/physics/sflx.f @@ -110,7 +110,6 @@ !!\param[out] smcref real, soil moisture threshold (volumetric) !!\param[out] smcmax real, porosity (sat val of soil mois) !>\section general_sflx GFS Noah LSM General Algorithm -!! @{ subroutine gfssflx &! --- inputs: & ( nsoil, couple, icein, ffrozp, dt, zlvl, sldpth, & & swdn, swnet, lwdn, sfcems, sfcprs, sfctmp, & @@ -5799,5 +5798,4 @@ end subroutine wdfcnd !................................... end subroutine gfssflx -!! @} !----------------------------------- diff --git a/physics/sgscloud_radpost.F90 b/physics/sgscloud_radpost.F90 index a7e68732c..57e62cc6f 100644 --- a/physics/sgscloud_radpost.F90 +++ b/physics/sgscloud_radpost.F90 @@ -1,21 +1,13 @@ -!> \file SGSCloud_RadPost.F90 +!> \file sgscloud_radpost.F90 !! Contains the post (interstitial) work after the call to the radiation schemes: !! 1) Restores the original qc & qi - module sgscloud_radpost contains - subroutine sgscloud_radpost_init () - end subroutine sgscloud_radpost_init - - subroutine sgscloud_radpost_finalize () - end subroutine sgscloud_radpost_finalize - -!>\defgroup sgscloud_radpost GSD sgscloud_radpost_run Module -!>\ingroup gsd_mynn_edmf -!! This interstitial code restores the original resolved-scale clouds (qc and qi). -!! \section arg_table_sgscloud_radpost_run Argument Table +!>\defgroup sgscloud_radpost_mod sgscloud_radpost_run Module +!> This interstitial code restores the original resolved-scale clouds (qc and qi). +!> \section arg_table_sgscloud_radpost_run Argument Table !! \htmlinclude sgscloud_radpost_run.html !! subroutine sgscloud_radpost_run( & @@ -65,5 +57,4 @@ subroutine sgscloud_radpost_run( & ! print*,"qc_save:",qc_save(1,1)," qc:",qc(1,1) end subroutine sgscloud_radpost_run - end module sgscloud_radpost diff --git a/physics/sgscloud_radpre.F90 b/physics/sgscloud_radpre.F90 index 63c90131c..5e43ba492 100644 --- a/physics/sgscloud_radpre.F90 +++ b/physics/sgscloud_radpre.F90 @@ -1,4 +1,4 @@ -!>\file SGSCloud_RadPre.F90 +!>\file sgscloud_radpre.F90 !! Contains the preliminary (interstitial) work to the call to the radiation schemes: !! 1) Backs up the original qc & qi !! 2) Adds the partioning of convective condensate into liqice/ice for effective radii @@ -6,23 +6,11 @@ !! scale) qc, qi and cloud fraction coming from the microphysics scheme. !! 4) Recompute the diagnostic high, mid, low, total and bl clouds to be consistent with radiation -!> \defgroup sgsrad_group GSD sgscloud_radpre_run Module module sgscloud_radpre contains -!> \section arg_table_sgscloud_radpre_init Argument Table -!! \htmlinclude sgscloud_radpre_init.html -!! - subroutine sgscloud_radpre_init () - end subroutine sgscloud_radpre_init - -!> \section arg_table_sgscloud_radpre_finalize Argument Table -!! \htmlinclude sgscloud_radpre_finalize.html -!! - subroutine sgscloud_radpre_finalize () - end subroutine sgscloud_radpre_finalize - +!> \defgroup sgsradpre_group sgscloud_radpre_run Module !> This interstitial code adds the subgrid clouds to the resolved-scale clouds !! if there is no resolved-scale clouds in that particular grid box. It can also !! specify a cloud fraction for resolved-scale clouds, using Xu-Randall (1996), @@ -37,8 +25,7 @@ end subroutine sgscloud_radpre_finalize !! clouds(:,:,4) - layer cloud ice water path ! !! clouds(:,:,5) - mean effective radius for ice cloud ! !! -!>\section sgscloud_radpre GSD SGS Scheme General Algorithm -!> @{ +!>\section sgscloud_radpre_mod SGS Cloud Scheme Pre General Algorithm subroutine sgscloud_radpre_run( & im,levs, & flag_init,flag_restart, & @@ -298,5 +285,4 @@ subroutine sgscloud_radpre_run( & endif ! timestep > 1 end subroutine sgscloud_radpre_run - end module sgscloud_radpre diff --git a/physics/tridi.f b/physics/tridi.f index 0103b388f..79d5a8e7d 100644 --- a/physics/tridi.f +++ b/physics/tridi.f @@ -219,4 +219,3 @@ subroutine tridit(l,n,nt,cl,cm,cu,rt,au,at) !----------------------------------------------------------------------- return end subroutine tridit -!> @} diff --git a/physics/ugwp_driver_v0.F b/physics/ugwp_driver_v0.F index 844acf722..1165f45ee 100644 --- a/physics/ugwp_driver_v0.F +++ b/physics/ugwp_driver_v0.F @@ -1,4 +1,5 @@ !>\file ugwp_driver_v0.F +!! This file contains CIRES UGWP v0 driver ! !===================================================================== @@ -6,9 +7,11 @@ !ugwp-v0 subroutines: GWDPS_V0 and fv3_ugwp_solv2_v0 ! !===================================================================== -!>\ingroup cires_ugwp_run -!> @{ -!! Note for the sub-grid scale orography scheme in UGWP-v0: Due to degraded forecast +!>\ingroup cires_ugwp_run_mod +!>\defgroup ugwp_driverv0_mod GFS UGWP V0 Driver Module +!! This is the CIRES UGWP V0 driver module +!! +!! Note for the sub-grid scale orography scheme in UGWP-v0: Due to degraded forecast !! scores of simulations with revised schemes for subgrid-scale orography effects in FV3GFS, !! EMC reinstalled the original gwdps-code with updated efficiency factors for the mountain !! blocking and OGW drag. The GFS OGW is described in the separate section (\ref GFS_GWDPS) @@ -17,12 +20,14 @@ !! C768 resolutions and work in progress to introduce the optimal choice for the scale-aware !! representations of the efficiency factors that will reflect the better simulations of GW !! activity by FV3 dynamical core at higher horizontal resolutions. With the MERRA-2 VMF -!! function for NGWs (\ref slat_geos5_tamp) and operational OGW drag scheme (\ref GFS_GWDPS), +!! function for NGWs (\ref slat_geos5_tamp_v0) and operational OGW drag scheme (\ref GFS_GWDPS), !! FV3GFS simulations can successfully forecast the recent major mid-winter sudden stratospheric !! warming (SSW) events of 2018-02-12 and 2018-12-31 (10-14 days before the SSW onset; !! Yudin et al. 2019 \cite yudin_et_al_2019). The first multi-year (2015-2018) FV3GFS simulations !! with UGWP-v0 also produce the equatorial QBO-like oscillations in the zonal wind and temperature anomalies. -!! + +!>Modified/revised version of gwdps.f with bug fixes, tofd, appropriate +!! computation of reference level for OGW+COORDE diagnostics. SUBROUTINE GWDPS_V0(IM, km, imx, do_tofd, & Pdvdt, Pdudt, Pdtdt, Pkdis, U1,V1,T1,Q1,KPBL, & PRSI,DEL,PRSL,PRSLK,PHII, PHIL,DTP,KDT, @@ -35,7 +40,7 @@ SUBROUTINE GWDPS_V0(IM, km, imx, do_tofd, ! ugwp_v0 ! ! modified/revised version of gwdps.f (with bug fixes, tofd, appropriate -! computation of kref for OGW + COORDE diagnostics +! computation of reference level for OGW + COORDE diagnostics ! all constants/parameters inside cires_ugwp_initialize.F90 !---------------------------------------- @@ -914,9 +919,10 @@ end subroutine gwdps_v0 !=============================================================================== !23456============================================================================== -!>\ingroup cires_ugwp_run -!> @{ -!! +!>\ingroup cires_ugwp_run_mod +!! A modification of the Scinocca (2003) \cite scinocca_2003 algorithm for +!! NGWs with non-hydrostatic and rotational +!!effects for GW propagations and background dissipation subroutine fv3_ugwp_solv2_v0(klon, klev, dtime, & tm1 , um1, vm1, qm1, & prsl, prsi, philg, xlatd, sinlat, coslat, @@ -1483,5 +1489,3 @@ subroutine fv3_ugwp_solv2_v0(klon, klev, dtime, !--------------------------------------------------------------------------- return end subroutine fv3_ugwp_solv2_v0 - - diff --git a/physics/unified_ugwp.F90 b/physics/unified_ugwp.F90 index 9e93bd5fc..6e7ad29ea 100644 --- a/physics/unified_ugwp.F90 +++ b/physics/unified_ugwp.F90 @@ -1,5 +1,6 @@ !> \file unified_ugwp.F90 !! This file combines three two orographic GW-schemes cires_ugwp.F90 and drag_suite.F90 under "unified_ugwp" suite: + !! 1) The "V0 CIRES UGWP" scheme (cires_ugwp.F90) as implemented in the FV3GFSv16 atmosphere model, which includes: !! a) the "traditional" EMC orograhic gravity wave drag and flow blocking scheme of gwdps.f !! b) the v0 cires ugwp non-stationary GWD scheme @@ -53,7 +54,10 @@ module unified_ugwp ! ------------------------------------------------------------------------ ! CCPP entry points for CIRES Unified Gravity Wave Physics (UGWP) scheme v0 ! ------------------------------------------------------------------------ -!>@brief The subroutine initializes the unified UGWP +!>\defgroup unified_ugwp_mod GFS Unified Gravity Wave Physics Module +!! This is the CCPP entry points for unified GWP scheme v0. +!> @{ +!>@brief The subroutine initializes the unified UGWP. !> \section arg_table_unified_ugwp_init Argument Table !! \htmlinclude unified_ugwp_init.html !! @@ -154,7 +158,7 @@ end subroutine unified_ugwp_init ! finalize of unified_ugwp (_finalize) ! ----------------------------------------------------------------------- -!>@brief The subroutine finalizes the CIRES UGWP +!>@brief The subroutine finalizes the GFS UGWP !> \section arg_table_unified_ugwp_finalize Argument Table !! \htmlinclude unified_ugwp_finalize.html @@ -190,18 +194,58 @@ end subroutine unified_ugwp_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 unified_ugwp_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 backgroufnd dissipation is represented by the subroutine \ref 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). +!> This subroutine executes the CIRES UGWP Version 0. +!! +!> \section gen_unified_ugwp GFS Unified GWP Scheme 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 backgroufnd dissipation is represented by the subroutine +!! \ref 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. +!! 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 slat_geos5_tamp_v0() 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_unified_ugwp_run Argument Table !! \htmlinclude unified_ugwp_run.html !! -!> \section gen_unified_ugwp CIRES UGWP Scheme General Algorithm -!! @{ +! \section det_unified_ugwp GFS Unified GWP Scheme Detailed Algorithm subroutine unified_ugwp_run(me, master, im, levs, ntrac, dtp, fhzero, kdt, & lonr, oro, oro_uf, hprime, nmtvr, oc, theta, sigma, gamma, elvmax, clx, oa4, & varss,oc1ss,oa4ss,ol4ss,dx,dusfc_ls,dvsfc_ls,dusfc_bl,dvsfc_bl,dusfc_ss, & @@ -518,6 +562,5 @@ subroutine unified_ugwp_run(me, master, im, levs, ntrac, dtp, fhzero, kdt, end subroutine unified_ugwp_run -!! @} !>@} end module unified_ugwp diff --git a/physics/unified_ugwp_post.F90 b/physics/unified_ugwp_post.F90 index 3af459d76..e137df43f 100644 --- a/physics/unified_ugwp_post.F90 +++ b/physics/unified_ugwp_post.F90 @@ -1,18 +1,13 @@ !> \file unified_ugwp_post.F90 -!! This file contains +!! This file saves CIRES UGWP diagnostics. module unified_ugwp_post contains !>\defgroup unified_ugwp_post unified_UGWP Scheme Post -!! @{ - - subroutine unified_ugwp_post_init () - end subroutine unified_ugwp_post_init - -!>@brief The subroutine initializes the unified UGWP - -!> \section arg_table_unified_ugwp_post_run Argument Table +!> @{ +!! The subroutine saves CIRES UGWP diagnostics. +!! \section arg_table_unified_ugwp_post_run Argument Table !! \htmlinclude unified_ugwp_post_run.html !! subroutine unified_ugwp_post_run (ldiag_ugwp, dtf, im, levs, & @@ -70,8 +65,5 @@ subroutine unified_ugwp_post_run (ldiag_ugwp, dtf, im, levs, & end subroutine unified_ugwp_post_run - subroutine unified_ugwp_post_finalize () - end subroutine unified_ugwp_post_finalize - -!! @} +!> @} end module unified_ugwp_post diff --git a/physics/zhaocarr_gscond.f b/physics/zhaocarr_gscond.f index d35e08342..50f9358f4 100644 --- a/physics/zhaocarr_gscond.f +++ b/physics/zhaocarr_gscond.f @@ -7,8 +7,7 @@ module zhaocarr_gscond implicit none - public :: zhaocarr_gscond_init, zhaocarr_gscond_run, & - & zhaocarr_gscond_finalize + public :: zhaocarr_gscond_init, zhaocarr_gscond_run private logical :: is_initialized = .False. contains @@ -51,12 +50,6 @@ subroutine zhaocarr_gscond_init (imp_physics, & is_initialized = .true. end subroutine zhaocarr_gscond_init -! \brief Brief description of the subroutine -! -!> \section arg_table_zhaocarr_gscond_finalize Argument Table -!! - subroutine zhaocarr_gscond_finalize - end subroutine zhaocarr_gscond_finalize !> \defgroup condense GFS gscond Main !> @{