CCPP Scientific Documentation
v4.1.0
Namelist Options Description

The SCM and the UFS Atmosphere access runtime configurations from file input.nml. This file contains various namelists records that control aspects of the I/O, dynamics, physics etc. Most physics-related options are in reords &gfs_physics_nml and &cires_ugwp_nml. When using the GFDL microphysics scheme, variables in namelist &gfdl_cloud_microphysics_nml are also used. Additional specifications for stochastic physics are in namelists &stochy_nam and &nam_sfcperts.

  • Namelist &gfdl_cloud_microphysics_nml is only relevant when the GFDL microphysics is used, and its variables are defined in module_gfdl_cloud_microphys.F90.
  • Namelist &cires_ugwp_nml specifies options for the use of CIRES Unified Gravity Wave Physics Version 0.
  • Namelist &gfs_physics_nml pertains to all of the suites used, but some of the variables are only relevant for specific parameterizations. Its variables are defined in file GFS_typedefs.F90 in the host model.
  • Namelist &stochy_nam specifies options for the use of SPPT, SKEB and SHUM, while namelist &nam_sfcperts specifies whether and how stochastic perturbations are used in the Noah Land Surface Model.
NML Description
option DDT in Host Model Description Default Value
&gfs_physics_nml
fhzero gfs_control_type hour between clearing of diagnostic buckets 0.0
h2o_phys gfs_control_type flag for stratosphere h2o scheme .false.
ldiag3d gfs_control_type flag for 3D diagnostic fields .false.
lssav gfs_control_type logical flag for storing diagnostics .false.
cplflx gfs_control_type logical flag for cplflx collection .false.
cplwav gfs_control_type logical flag for cplwav collection .false.
cplchm gfs_control_type logical flag for chemistry collection .false.
lsidea gfs_control_type logical flag for idealized physics .false.
oz_phys gfs_control_type flag for old (2006) ozone physics .true.
oz_phys_2015 gfs_control_type flag for new (2015) ozone physics .false.
fhcyc gfs_control_type frequency for surface data cycling in hours 0.0
use_ufo gfs_control_type flag for using unfiltered orography surface option .false.
pre_rad gfs_control_type flag for testing purpose .false.
ncld gfs_control_type number of hydrometeors 1
imp_physics gfs_control_type choice of microphysics scheme:
  • 11: GFDL microphysics scheme
  • 8: Thompson microphysics scheme
  • 10: Morrison-Gettelman microphysics scheme
99
pdfcld gfs_control_type flag for PDF clouds .false.
fhswr gfs_control_type frequency for shortwave radiation (secs) 3600.
fhlwr gfs_control_type frequency for longwave radiation (secs) 3600.
levr gfs_control_type number of vertical levels for radiation calculations -99
nfxr gfs_control_type second dimension of radiation input/output array fluxr 39+6
iflip gfs_control_type control flag for vertical index direction
  • 0: index from TOA to surface
  • 1: index from surface to TOA
1
icliq_sw gfs_control_type sw optical property for liquid clouds
  • 0: input cloud optical depth, ignoring iswcice setting
  • 1: cloud optical property scheme based on Hu and Stamnes (1993) [89] method
  • 2: cloud optical property scheme based on Hu and Stamnes (1993) [89] - updated
1
iovr_sw gfs_control_type control flag for cloud overlap in SW radiation
  • 0: random overlapping clouds
  • 1: max/ran overlapping clouds
  • 2: maximum overlap clouds (mcica only)
  • 3: decorrelation-length overlap (mcica only)
1
iovr_lw gfs_control_type control flag for cloud overlap in LW radiation
  • 0: random overlapping clouds
  • 1: max/ran overlapping clouds
  • 2: maximum overlap clouds (mcica only)
  • 3: decorrelation-length overlap (mcica only)
1
ictm gfs_control_type external data time/date control flag
  • -2: same as 0, but superimpose seasonal cycle from climatology data set
  • -1: use user provided external data for the forecast time, no extrapolation
  • 0: use data at initial condition time, if not available, use latest, no extrapolation
  • 1: use data at the forecast time, if not available, use latest and extrapolation
  • yyyy0: use yyyy data for the forecast time, no further data extrapolation
  • yyyy1: use yyyy data for the forecast. if needed, do extrapolation to match the fcst time
1
crick_proof gfs_control_type control flag for eliminating CRICK
  • .true.: apply layer smoothing to eliminate CRICK
  • .false.: do not apply layer smoothing
.false.
ccnorm gfs_control_type control flag for in-cloud condensate mixing ratio
  • .true.: normalize cloud condensate
  • .false.: not normalize cloud condensate
.false.
norad_precip gfs_control_type control flag for not using precip in radiation (Ferrier scheme)
  • .true.: snow/rain has no impact on radiation
  • .false.: snow/rain has impact on radiation
.false.
ialb gfs_control_type SW surface albedo control flag:
  • 0: using climatology surface albedo scheme for SW
  • 1: using MODIS based land surface albedo for SW
0
iems gfs_control_type LW surface emissivity control flag (ab 2-digit integer) :
  • a: =0 set surface air/ground t same for LW radiation
  • =1 set surface air/ground t diff for LW radiation
  • b: =0 use fixed surface emissivity = 1.0 (black-body)
  • =1 use varying climatology surface emissivity (veg based)
  • =2 future development (not yet)
0
iaer gfs_control_type 4-digit aerosol flag (dabc for aermdl, volcanic, LW, SW):
  • d:tropospheric aerosol model scheme flag
    =0 or none, opac-climatology aerosol scheme
    =1 use gocart climatology aerosol scheme
    =2 use gocart prognostic aerosol scheme
    =5 opac-clim new spectral mapping
  • a:=0 use background stratospheric aerosol
    =1 include stratospheric volcanic aerosol
  • b:=0 no tropospheric aerosol in LW radiation
    =1 include tropospheric aerosol in LW
  • c:=0 no tropospheric aerosol in SW radiation
    =1 include tropospheric aerosol in SW
1
ico2 gfs_control_type \(CO_2\) data source control flag:
  • 0: prescribed value (380 ppmv)
  • 1: yearly global averaged annual mean from observations
  • 2: monthly 15 degree horizontal resolution from observations
0
isubc_sw gfs_control_type subgrid cloud approximation control flag in SW radiation:
  • 0: no McICA approximation in SW radiation
  • 1: use McICA with prescribed permutation seeds (test mode)
  • 2: use McICA with randomly generated permutation seeds
0
isubc_lw gfs_control_type subgrid cloud approximation control flag in LW radiation:
  • 0: no McICA approximation in LW radiation
  • 1: use McICA with prescribed permutatition seeds (test mode)
  • 2: use McICA with randomly generated permutation seeds
0
isol gfs_control_type solar constant scheme control flag:
  • 0: fixed value = 1366.0 \(W m^{-2}\) (old standard)
  • 10: fixed value = 1360.8 \(W m^{-2}\) (new standard)
  • 1: NOAA ABS-scale TSI table (yearly) with 11-yr cycle approximation
  • 2: NOAA TIM-scale TSI table (yearly) with 11-yr cycle approximation
  • 3: CMIP5 TIM-scale TSI table (yearly) with 11-yr cycle approximation
  • 4: CMIP5 TIM-scale TSI table (monthly) with 11-yr cycle approximation
0
lwhtr gfs_control_type logical flag for output of longwave heating rate .true.
swhtr gfs_control_type logical flag for output of shortwave heating rate .true.
cnvgwd gfs_control_type logical flag for convective gravity wave drag scheme dependent on maxval(cdmbgwd(3:4) == 0.0) .false.
shal_cnv gfs_control_type logical flag for calling shallow convection .false.
lmfshal gfs_control_type flag for mass-flux shallow convection scheme in the cloud fraction calculation shal_cnv .and. (imfshalcnv > 0)
lmfdeep2 gfs_control_type flag for mass-flux deep convection scheme in the cloud fraction calculation imfdeepcnv == 2 .or. 3 .or.4
cal_pre gfs_control_type logical flag for calling precipitation type algorithm .false.
redrag gfs_control_type logical flag for applying reduced drag coefficient for high wind over sea in GFS surface layer scheme .false.
dspheat gfs_control_type logical flag for using TKE dissipative heating to temperature tendency in hybrid EDMF and TKE-EDMF schemes .false.
hybedmf gfs_control_type logical flag for calling hybrid EDMF PBL scheme .false.
satmedmf gfs_control_type logical flag for calling TKE EDMF PBL scheme .false.
isatmedmf gfs_control_type flag for scale-aware TKE-based moist EDMF scheme
  • 0: initial version of satmedmf (Nov.2018)
  • 1: updated version of satmedmf (as of May 2019)
0
do_mynnedmf gfs_control_type flag to activate MYNN-EDMF scheme .false.
random_clds gfs_control_type logical flag for whether clouds are random .false.
trans_trac gfs_control_type logical flag for convective transport of tracers .false.
lheatstrg gfs_control_type logical flag for canopy heat storage parameterization .false.
shinhong gfs_control_type flag for scale-aware Shinhong PBL scheme .false.
do_ysu gfs_control_type flag for YSU PBL scheme .false.
cnvcld gfs_control_type logical flag for convective cloud .false.
imfshalcnv gfs_control_type flag for mass flux shallow convective scheme:
  • 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)
  • 4: new Tiedtke scheme (CAPS)
  • 0: modified Tiedtke's eddy-diffusion shallow convective scheme
  • -1: no shallow convection used
1
imfdeepcnv gfs_control_type flag for mass-flux deep convective scheme:
  • -1: Chikira-Sugiyama deep convection (with cscnv = .T.)
  • 1: July 2010 version of SAS convective scheme (operational version as of 2016)
  • 2: scale- & aerosol-aware mass-flux deep convective scheme (2017)
  • 3: scale- & aerosol-aware Grell-Freitas scheme (GSD)
  • 4: new Tiedtke scheme (CAPS)
1
lgfdlmprad gfs_control_type flag for GFDL mp scheme and radiation consistency .false.
cdmbgwd(4) gfs_control_type multiplication factors for mountain blocking(1), orographic gravity wave drag(2)
  • [1]: GWDPS mountain blocking
  • [2]: GWDPS orographic gravity wave drag
  • [3]: the modulation total momentum flux of NGWs by intensities of the total precipitation
  • [4]: TKE for future tests and applications
2.0,0.25,1.0,1.0
prslrd0 gfs_control_type pressure level above which to apply Rayleigh damping 0.0d0
lsm gfs_control_type flag for land surface model to use
  • 1: Noah LSM
  • 2: RUC LSM
1
lsoil gfs_control_type number of soil layers 4
ivegsrc gfs_control_type flag for vegetation type dataset choice:
  • 0: USGS
  • 1: IGBP(20 category)
  • 2: UMD (13 category)
2
isot gfs_control_type flag for soil type dataset choice:
  • 0: Zobler soil type (9 category)
  • 1: STATSGO soil type (19 category)
0
mom4ice gfs_control_type flag controls mom4 sea ice .false.
debug gfs_control_type flag for debug printout .false.
nstf_name(5) gfs_control_type NSST related paramters:
  • 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_control_type flag for NSST analysis in gcycle/sfcsub .false.
effr_in gfs_control_type logical flag for using input cloud effective radii calculation .false.
aero_in gfs_control_type logical flag for using aerosols in Morrison-Gettelman microphysics .false.
iau_delthrs gfs_control_type incremental analysis update (IAU) time interval in hours 6
iaufhrs gfs_control_type forecast hours associated with increment files -1
Parameters Specific to csawmg Suite
crtrh(3) gfs_control_type critical relative humidity at the surface, PBL top and at the top of the atmosphere 0.90,0.90,0.90
cscnv gfs_control_type logical flag for Chikira-Sugiyama deep convection .false.
do_aw gfs_control_type flag for Arakawa-Wu scale-awere adjustment .false.
do_awdd gfs_control_type flag to enable treating convective tendencies following Arakwaw-Wu for downdrafts (2013) .false.
do_sb_physics gfs_control_type logical flag for SB2001 autoconversion or accretion .true.
do_cldice gfs_control_type flag for cloud ice processes for MG microphysics .true.
hetfrz_classnuc gfs_control_type flag for heterogeneous freezing for MG microphysics .false.
mg_nccons gfs_control_type flag for constant droplet concentration for MG microphysics .false.
mg_nicons gfs_control_type flag for constant ice concentration for MG microphysics .false.
mg_ngcons gfs_control_type flag for constant graupel concentration for MG microphysics .false.
sed_supersat gfs_control_type flag for allowing supersaturation after sedimentation for MG microphysics .true.
mg_do_graupel gfs_control_type flag for turning on prognostic graupel (with fprcp=2) .true.
mg_do_hail gfs_control_type flag for turning on prognostic hail (with fprcp=2) .false.
shcnvcw gfs_control_type logical flag for shallow convective cloud .false.
xkzm_h gfs_control_type background vertical diffusion for heat and q 1.0d0
xkzm_m gfs_control_type background vertical diffusion for momentum 1.0d0
xkzm_s gfs_control_type sigma threshold for background mom. diffusion 1.0d0
xkzminv gfs_control_type maximum background value of heat diffusivity in the inversion layer 0.3
microp_uniform gfs_control_type logical flag for uniform subcolumns for MG microphysics .true.
mg_do_ice_gmao gfs_control_type logical flag for turning on gmao ice autoconversion in MG microphysics .false.
mg_do_liq_liu gfs_control_type logical flag for turning on Liu liquid treatment in MG microphysics .true.
mg_dcs gfs_control_type autoconversion size threshold for cloud ice to snow in MG microphysics 200.0
mg_alf gfs_control_type tuning factor for alphas (alpha = 1 - critical relative humidity) 1.0
mg_ts_auto_ice(2) gfs_control_type autoconversion time scale for ice in MG microphysics 180.0,180.0
mg_qcvar gfs_control_type cloud water relative variance in MG microphysics 1.0
mg_rhmini gfs_control_type relative humidity threshold parameter for nucleating ice 1.01
mg_ncnst gfs_control_type constant droplet num concentration \(m^{-3}\) 100.e6
mg_ninst gfs_control_type constant ice num concentration \(m^{-3}\) 0.15e6
mg_ngnst gfs_control_type constant graupel/hail num concertration \(m^{-3}\) 0.10e6
mg_berg_eff_factor gfs_control_type berg efficiency factor 2.0
mg_qcmin(2) gfs_control_type min liquid and ice mixing ratio in MG macro clouds 1.0d-9, 1.0d-9
mg_precip_frac_method gfs_control_type type of precipitation fraction method 'max_overlap'
fprcp gfs_control_type number of frozen precipitation species in MG microphysics
  • 0: no prognostic rain and snow
  • 1: MG2
  • 2: MG3
0
pdfflag gfs_control_type pdf flag for MG macro physics 4
cs_parm(10) gfs_control_type tunable parameters for Chikira-Sugiyama convection 8.0,4.0,1.0e3,3.5e3,20.0,1.0,-999.,1.,0.6,0.
iccn gfs_control_type flag for using IN and CCN forcing in MG2/3 microphysics .false.
rhcmax gfs_control_type maximum critical relative humidity 0.9999999
Parameters Specific to GSD_v0 Suite
ltaerosol gfs_control_type logical flag for using aerosol climotology in Thompson MP scheme .false.
lradar gfs_control_type logical flag for computing radar reflectivity in Thompson MP scheme .false.
ttendlim gfs_control_type temperature tendency limiter per time step in K/s, set to < 0 to deactivate -999.0
do_mynnsfclay gfs_control_type flag to activate MYNN-SFCLAY scheme .false.
grav_settling gfs_control_type flag to activate gravitational settling of cloud droplets as described in Nakanishi (2000) [133] 0
bl_mynn_mixlength gfs_control_type flag for different version of mixing length formulation
  • 0: Original form from Nakanishi and Niino (2009) [132] . NO scale-awareness is applied to the master mixing length, regardless of "scaleware" setting
  • 1: HRRR operational form 201609-201807. Designed to work without the mass-flux scheme. Uses BouLac mixing length in free atmosphere.
  • 2: HRRR operational form 201807-present. Designed to be compatible with mass-flux scheme activated (default)
2
bl_mynn_edmf gfs_control_type flag to activate the mass-flux scheme
  • 0: deactivate mass-flux scheme
  • 1: activate dynamic multiplume mass-flux scheme
0
bl_mynn_edmf_mom gfs_control_type flag to activate the transport of momentum
  • 0: deactivate momentum transport in mass-flux scheme
  • 1: activate momentum transport in dynamic multiplume mass-flux scheme. bl_mynn_edmf must be set to 1
1
bl_mynn_edmf_tke gfs_control_type flag to activate the transport of TKE
  • 0: deactivate TKE transport in mass-flux scheme
  • 1: activate TKE transport in dynamic multiplume mass-flux scheme. bl_mynn_edmf must be set to 1
0
bl_mynn_edmf_part gfs_control_type flag to partitioning the MF and ED areas 0
bl_mynn_edmf_tkeadvect gfs_control_type activate computation of TKE advection (not yet in use for FV3)
  • false: deactivate TKE advection
  • true: activate TKE advection
.false.
bl_mynn_edmf_tkebudget gfs_control_type flag to activate TKE budget 0
bl_mynn_edmf_cloudpdf gfs_control_type flag to determine which cloud PDF to use
  • 0: use Sommeria-Deardorff subgrid cloud PDF
  • 1: use Kuwano-Yoshida subgrid cloud PDF
  • 2: use modified Chaboureau-Bechtold subgrid cloud PDF
2
bl_mynn_edmf_cloudmix gfs_control_type flag to activate mixing of cloud species
  • 0: deactivate the mixing of any water species mixing ratios
  • 1: activate the mixing of all water species mixing ratios
1
bl_mynn_mixqt gfs_control_type flag to mix total water or individual species
  • 0: mix individual water species separately
  • 1: DO NOT USE
0
icloud_bl gfs_control_type flag to coupling SGS clouds to radiation
  • 0: deactivate coupling subgrid clouds to radiation
  • 1: activate subgrid cloud coupling to radiation (highly suggested)
1
lsoil_lsm gfs_control_type number of soil layers internal to land surface model -1
ldiag_ugwp GFS_control_type flag for CIRES UGWP diagnostics .false.
do_ugwp GFS_control_type flag for CIRES UGWP revised OGW
  • .T.: revised gwdps_v0
  • .F.: GFS operational orographic gwdps
.false.
do_tofd GFS_control_type flag for turbulent orographic form drag .false.
do_sppt gfs_control_type flag for stochastic SPPT option .false.
do_shum gfs_control_type flag for stochastic SHUM option .false.
do_skeb gfs_control_type flag for stochastic SKEB option .false.
do_sfcperts gfs_control_type flag for stochastic surface perturbations option .false.
&nam_sfcperts
nsfcpert gfs_control_type number of weights for stochastic surface perturbation 0
pertz0 gfs_control_type magnitude of perturbation of momentum roughness length -999.
pertzt gfs_control_type magnitude of perturbation of heat to momentum roughness length ratio -999.
pertshc gfs_control_type magnitude of perturbation of soil hydraulic conductivity -999.
pertlai gfs_control_type magnitude of perturbation of leaf area index -999.
pertalb gfs_control_type magnitude of surface albedo perturbation -999.
pertvegf gfs_control_type magnitude of perturbation of vegetation fraction -999.
iseed_sfc compns_stochy_mod random seeds (if 0 use system clock) 0
sfc_tau compns_stochy_mod time scales -999.
sfc_lscale compns_stochy_mod length scales -999.
sppt_land compns_stochy_mod .false.
&stochy_nam
use_zmtnblck compns_stochy_mod flag for mountain blocking. .T. = do not apply perturbations below the dividing streamline that is diagnosed by the gravity wave drag, mountain blocking scheme .false.
ntrunc compns_stochy_mod spectral resolution (e.g. T126) of random patterns -999
lon_s, lat_s compns_stochy_mod number of longitude and latitude point for the Gaussian grid -999
fhstoch compns_stochy_mod forecast hour to write out random pattern in order to restart the pattern for a different forecast (used in DA), file is stoch_out.F<HHH> -999.0
stochini compns_stochy_mod set to true if wanting to read in a previous random pattern (input file need to be named stoch_ini) .false.
sppt compns_stochy_mod amplitude of random patterns -999.
sppt_tau compns_stochy_mod decorrelation timescales in seconds -999.
sppt_lscale compns_stochy_mod decorrelation spatial scales in meters -999.
sppt_logit compns_stochy_mod logit transform for SPPT to bounded interval [-1,+1] .false.
iseed_sppt compns_stochy_mod seeds for setting the random number sequence (ignored if stochini is true) 0
sppt_sigtop1, sppt_sigtop2 compns_stochy_mod sigma levels to taper perturbations to zeros 0.1, 0.025
sppt_sfclimit compns_stochy_mod reduce amplitude of SPPT near surface (lowest 2 levels) .false.
shum compns_stochy_mod amplitude of stochastic boundary layer specific humidity perturbations -999.
shum_tau compns_stochy_mod decorrelation time scales in seconds -999.
shum_lscale compns_stochy_mod decorrelation spatial scales in meters -999.
shum_sigefold compns_stochy_mod e-folding lengthscale (in units of sigma) of specific humidity perturbations 0.2
skeb compns_stochy_mod stochastic KE backscatter amplitude -999.
skeb_tau compns_stochy_mod decorrelation timescales in seconds -999.
skeb_lscale compns_stochy_mod decorrelation spatial scales in meter -999.
iseed_skeb compns_stochy_mod seeds for setting the random number sequnce (ignored if stochini is true) 0
skeb_vfilt compns_stochy_mod 0
skebnorm compns_stochy_mod 0: random pattern is stream function,1: pattern is kenorm, 2: pattern is vorticity 0
skeb_varspect_opt compns_stochy_mod Gaussian or power law variance spectrum for SKEB (0: Gaussian, 1: power law) 0
skeb_npass compns_stochy_mod number of passes of smoother for dissipation estimate 11
skeb_vdof compns_stochy_mod the number of degrees of freedom in the vertical for the SKEB random pattern 5
skeb_sigtop1, skeb_sigtop2 compns_stochy_mod sigma levels to taper perturbations to zeros 0.1, 0.025
skebint compns_stochy_mod 0
&gfdl_cloud_microphysics_nml
sedi_transport gfdl_cloud_microphys_mod logical flag for turning on horizontal momentum transport during sedimentation .true.
do_sedi_w gfdl_cloud_microphys_mod .true. to turn on vertical motion transport during sedimentation. (not supported in GFS physics) .false.
do_sedi_heat gfdl_cloud_microphys_mod logical flag for turning on horizontal heat transport during sedimentation .true.
rad_snow gfdl_cloud_microphys_mod logical flag for considering snow in cloud fraction calculation .true.
rad_graupel gfdl_cloud_microphys_mod logical flag for considering graupel in cloud fraction calculation .true.
rad_rain gfdl_cloud_microphys_mod logical flag for considering rain in cloud fraction calculation .true.
cld_min gfdl_cloud_microphys_mod minimum cloud fraction. If total cloud condensate exceeds 1.0e-6 kg/kg, cloud fraction cannot be less than cld_min 0.05
const_vi gfdl_cloud_microphys_mod logical flag for using constant cloud ice fall speed .false.
const_vs gfdl_cloud_microphys_mod logical flag for using constant snow fall speed .false.
const_vg gfdl_cloud_microphys_mod logical flag for using constant graupel fall speed .false.
const_vr gfdl_cloud_microphys_mod logical flag for using constant rain fall speed .false.
vi_fac gfdl_cloud_microphys_mod tunable factor for cloud ice fall or the constant cloud ice fall speed when const_vi is .true. 1.
vr_fac gfdl_cloud_microphys_mod tunable factor for rain fall or the constant rain fall speed when const_vr is .true. 1.
vs_fac gfdl_cloud_microphys_mod tunable factor for snow fall or the constant snow fall speed when const_vs is .true. 1.
vg_fac gfdl_cloud_microphys_mod tunable factor for graupel fall or the constant graupel fall speed when const_vg is .true. 1.
vi_max gfdl_cloud_microphys_mod maximum fall speed for cloud ice 0.5
vs_max gfdl_cloud_microphys_mod maximum fall speed for snow 5.0
vg_max gfdl_cloud_microphys_mod maximum fall speed for graupel 8.0
vr_max gfdl_cloud_microphys_mod maximum fall speed for rain 12.0
qi_lim gfdl_cloud_microphys_mod cloud ice limiter to prevent large ice built up in cloud ice freezing and deposition 1.
prog_ccn gfdl_cloud_microphys_mod logical flag for activating prognostic CCN (not supported in GFS Physics) .false.
do_qa gfdl_cloud_microphys_mod .true. to activate inline cloud fraction diagnosis in fast saturation adjustment. .false. to activate inline cloud fraction diagnosis in major cloud microphysics .true.
fast_sat_adj gfdl_cloud_microphys_mod logical flag for adjusting cloud water evaporation (cloud water -> water vapor), cloud water freezing (cloud water -> cloud ice), cloud ice deposition (water vapor -> cloud ice) when fast saturation adjustment is activated (do_sat_adj = .true. in fv_core_nml block) .true.
tau_l2v gfdl_cloud_microphys_mod time scale for evaporation of cloud water to water vapor. Increasing(decreasing) tau_l2v can decrease(boost) deposition of cloud water to water vapor 300.
tau_v2l gfdl_cloud_microphys_mod time scale for condensation of water vapor to cloud water. Increasing(decreasing) tau_v2l can decrease(boost) condensation of water vapor to cloud water 150.
tau_g2v gfdl_cloud_microphys_mod time scale for sublimation of graupel to water vapor. Increasing(decreasing) tau_g2v can decrease(boost) sublimation of graupel to water vapor 900.
tau_g2r gfdl_cloud_microphys_mod time scale for graupel melting. Increasing(decreasing) tau_g2r can decrease(boost) melting of graupel to rain (graupel-> rain) 600.
tau_v2g gfdl_cloud_microphys_mod time scale for deposition of water vapor to graupel. Increasing(decreasing) tau_v2g can decrease(boost) deposition of water vapor to graupel (water vapor -> graupel) 21600.
tau_l2r gfdl_cloud_microphys_mod time scale for autoconversion of cloud water to rain. Increasing(decreasing) tau_l2r can decrese(boost) autoconversion of cloud water to rain (cloud water -> rain) 900.
tau_r2g gfdl_cloud_microphys_mod time scale for freezing of rain to graupel. Increasing(decreasing) tau_r2g can decrease(boost) freezing of rain to graupel (rain->graupel) 900.
tau_i2s gfdl_cloud_microphys_mod time scale for autoconversion of cloud ice to snow. Increasing(decreasing) tau_i2s can decrease(boost) autoconversion of cloud ice to snow (cloud ice -> snow) 1000.
tau_imlt gfdl_cloud_microphys_mod time scale for cloud ice melting. Increasing(decreasing) tau_imlt can decrease(boost) melting of cloud ice to cloud water or rain (cloud ice -> cloud water or rain) 600.
tau_smlt gfdl_cloud_microphys_mod time scale for snow melting. Increasing(decreasing) tau_smlt can decrease(boost) melting of snow to cloud water or rain (snow-> cloud water or rain) 900.
rthresh gfdl_cloud_microphys_mod critical cloud water radius for autoconversion (cloud water -> rain). Increasing(decreasing) of rthresh makes the autoconversion harder(easier) 10.0e-6
dw_land gfdl_cloud_microphys_mod base value for subgrid deviation/variability over land 0.20
dw_ocean gfdl_cloud_microphys_mod base value for subgrid deviation/variability over ocean 0.10
ql_gen gfdl_cloud_microphys_mod maximum value for cloud water generated from condensation of water vapor (water vapor-> cloud water) 1.0e-3
qi_gen gfdl_cloud_microphys_mod maximum value of cloud ice generated from deposition of water vapor (water vapor->cloud ice) or freezing(cloud water -> cloud ice). Increasing(decreasing) qi_gen can increas(decrease) cloud ice 1.82e-6
ql_mlt gfdl_cloud_microphys_mod maximum value of cloud water allowed from melted cloud ice (cloud ice -> cloud water or rain). Exceedance of which will become rain. Increasing(decreasing) ql_mlt can increase(decrease) cloud water and decrease(increase) rain 2.0e-3
qs_mlt gfdl_cloud_microphys_mod maximum value of cloud water allowed from melted snow (snow -> cloud water or rain). Exceedance of which will become rain. Increasing(decreasing) qs_mlt can increas(decrease) cloud water and decrease (increase) rain 1.0e-6
ql0_max gfdl_cloud_microphys_mod threshold of cloud water to rain autoconversion (cloud water -> rain). Increasing(decreasing) ql0_max can increase(decrease) rain and decrease(increase) cloud water 2.0e-3
qi0_max gfdl_cloud_microphys_mod maximum value of cloud ice generated from other sources like convection. Exceedance of which will become snow. Increasing(decreasing) qi0_max can increase(decrease) cloud ice and decrease(increase) snow 1.0e-4
qi0_crt gfdl_cloud_microphys_mod threshold of cloud ice to snow autoconversion (cloud ice -> snow). Increasing(decreasing) qi0_crt can increase(decrease) cloud ice and decrease(increase) snow 1.0e-4
qs0_crt gfdl_cloud_microphys_mod threshold of snow to graupel autoconversion (snow -> graupel). Increasing(decreasing) qs0_crt can increase(decrease) snow and decrease(increase) graupel 1.0e-3
qc_crt gfdl_cloud_microphys_mod minimum value of cloud condensate to allow partial cloudiness. Partial cloud can only exist when total cloud condensate exceeds qc_crt 5.0e-8
c_psaci gfdl_cloud_microphys_mod accretion efficiency of cloud ice to snow (cloud ice -> snow). Increasing(decreasing) of c_psaci can boost(decrease) the accretion of cloud ice to snow 0.02
c_pgacs gfdl_cloud_microphys_mod accretion efficiency of snow to graupel (snow -> graupel). Increasing(decreasing) of c_pgacs can boost(decrease) the accretion of snow to graupel 2.0e-3
rh_inc gfdl_cloud_microphys_mod relative humidity increment for complete evaporation of cloud water and cloud ice 0.25
rh_inr gfdl_cloud_microphys_mod relative humidity increment for sublimation of snow 0.25
rh_ins gfdl_cloud_microphys_mod relative humidity increment for minimum evaporation of rain 0.25
rthresh gfdl_cloud_microphys_mod critical cloud water radius for autoconversion(cloud water->rain). Increasing(decreasing) of rthresh makes the autoconversion harder(easier) 1.0e-5
ccn_l gfdl_cloud_microphys_mod base CCN over land. Increasing(decreasing) ccn_l can on the one hand boost(decrease) the autoconversion of cloud water to rain, on the other hand make the autoconversion harder(easier). The unit is \(cm^{-3}\) 270.
ccn_o gfdl_cloud_microphys_mod base CCN over ocean. Increasing(decreasing) ccn_o can on the one hand boost(decrease) the autoconversion of cloud water to rain, on the other hand make the autoconversion harder(easier). The unit is \(cm^{-3}\) 90.
c_paut gfdl_cloud_microphys_mod autoconversion efficiency of cloud water to rain (cloud water -> rain). Increasing(decreasing) of c_paut can boost(decrease) the autoconversion of cloud water to rain 0.55
c_cracw gfdl_cloud_microphys_mod accretion efficiency of cloud water to rain (cloud water -> rain). Increasing(decreasing) of c_cracw can boost(decrease) the accretion of cloud water to rain 0.9
sat_adj0 gfdl_cloud_microphys_mod adjust factor for condensation of water vapor to cloud water (water vapor->cloud water) and deposition of water vapor to cloud ice 0.9
use_ppm gfdl_cloud_microphys_mod true to use PPM fall scheme; false to use time-implicit monotonic fall scheme .false.
use_ccn gfdl_cloud_microphys_mod true to compute prescribed CCN. It should be .true. when prog_ccn = .false. .false.
mono_prof gfdl_cloud_microphys_mod true to turn on terminal fall with monotonic PPM scheme. This is used together with use_ppm=.true. .true.
z_slope_liq gfdl_cloud_microphys_mod true to turn on vertically subgrid linear monotonic slope for autoconversion of cloud water to rain .true.
z_slope_ice gfdl_cloud_microphys_mod true to turn on vertically subgrid linear monotonic slope for autoconversion of cloud ice to snow .false.
de_ice gfdl_cloud_microphys_mod true to convert excessive cloud ice to snow to prevent ice over-built from other sources like convection scheme (not supported in GFS physics) .false.
fix_negative gfdl_cloud_microphys_mod true to fix negative water species using nearby points .false.
icloud_f gfdl_cloud_microphys_mod flag (0,1,or 2) for cloud fraction diagnostic scheme 0
irain_f gfdl_cloud_microphys_mod flag (0 or 1) for cloud water autoconversion to rain scheme. 0: with subgrid variability; 1: no subgrid variability 0
mp_time gfdl_cloud_microphys_mod time step of GFDL cloud microphysics (MP). If mp_time isn't divisible by physics time step or is larger than physics time step, the actual MP time step becomes dt/NINT[dt/MIN(dt,mp_time)] 150.
alin gfdl_cloud_microphys_mod parameter a in Lin et al.(1983). Constant in empirical formula for \(U_R\). Increasing(decreasing) alin can boost(decrease) accretion of cloud water by rain and rain evaporation 842.
clin gfdl_cloud_microphys_mod parameter c in Lin et al.(1983). Constant in empirical formula for \(U_S\). Increasing(decreasing) clin can boost(decrease) accretion of cloud water by snow, accretion of cloud ice by snow, snow sublimation and deposition, and snow melting 4.8
t_min gfdl_cloud_microphys_mod temperature threshold for instant deposition. Deposit all water vapor to cloud ice when temperature is lower than t_min 178.
t_sub gfdl_cloud_microphys_mod temperature threshold for sublimation. Cloud ice, snow or graupel stops(starts) sublimation when temperature is lower(higher) then t_sub 184.
mp_print gfdl_cloud_microphys_mod .true. to turn on GFDL cloud microphysics debugging print out. (not supported in GFS physics) .false.
&cires_ugwp_nml
knob_ugwp_version cires_ugwp_module parameter selects a version of the UGWP implementation in FV3GFS-127L
  • 0: default version delivered to EMC in Jan 2019 for implementation
  • 1: version of UGWP under development that plans to consider the physics-based sources of NGWs (knob_ugwp_wvspec [2:4]), options for stochastic and deterministic excitation of waves (knob_ugwp_stoch), and switches between different UGWP schemes (knob_ugwp_solver)
0
knob_ugwp_doaxyz cires_ugwp_module parameter controls application of the momentum deposition for NGW-schemes
  • 0: the momentum tendencies due to NGWs are calculated, but tendencies do not change the horizontal winds
  • 1: default value; it changes the horizontal momentum tendencies and horizontal winds
1
knob_ugwp_doheat cires_ugwp_module parameter controls application of the heat deposition for NGW-schemes
  • 0: the temperature tendencies due to NGWs are calculated but tendencies do not change the temperature state
  • 1: default value; it changes the temperature tendencies and kinetic temperature
1
knob_ugwp_dokdis cires_ugwp_module parameter controls application of the eddy diffusion due to instability of NGWs
  • 0: the eddy diffusion tendencies due to NGWs are calculated but tendencies do not change the model state vector
  • 1: it computes eddy diffusion coefficient due to instability of NGWs; in UGWP v0, eddy viscosity, heat conductivity and tracer diffusion are not activated
0
knob_ugwp_solver cires_ugwp_module parameter controls the selection of UGWP-solvers(wave propagation, dissipation and wave breaking) for NGWs
  • 1: represents the discrete multi-wave solver with background dissipation and linear wave saturation
  • 2: represents the spectral deterministic solver with background dissipation and spectral saturation
  • 3: represents the discrete multi-wave solver with the background dissipation, extension of Alexander sand Dunkerton (1999)
  • 4: represents the spectral solver with background dissipation, extension of Doppler Spread Theory of Hines (1997)
1
knob_ugwp_ndx4lh cires_ugwp_module parameter controls the selection of the horizontal wavenumber(wavelength) for NGW schemes
  • 1: selects the \(4xdx\) sub-grid wavelength, where dx is the horizontal resolution of the model configuration (C96-400km; C768-52km)
2
knob_ugwp_wvspec cires_ugwp_module four-dimensional array defines number of waves in each arimuthal propagation (as defined by knob_ugwp_azdir) for GWs excited due to the following four sources:
(1) sub-grid orography (knob_ugwp_wvspec[1]=1),
(2) convective (knob_ugwp_wvspec[2]=25),
(3) frontal (knob_ugwp_wvspec[3]=25) activity,
(4) knob_ugwp_wvspec[4] represents number of wave excited by dynamical imbalances that may mimic both convective and front-jet mechanisms of GW triggering.
In UGWP v0, first two elements of the array, knob_ugwp_wvspec(1:2), control number of waves for stationary (OGW) and nonstationary waves (NGWs).
1,32,32,32
knob_ugwp_azdir cires_ugwp_module four-dimensional array that defines number of azimuths for propagation of GWs triggered by four types of physics-based sources (orography, convection, front-jets, and dynamical imbalance). In UGWP v0, first two elements of the array, knob_ugwp_azdir(1:2), control number of azimuths for OGW and NGWs respectively. 2,4,4,4
knob_ugwp_stoch cires_ugwp_module four-dimensional array that control stochastic selection of GWs triggered by four types of physics-based sources.
Default values:0,0,0,0 - reflect determinstic selection of GW parameters without stochastic selection
0,0,0,0
knob_ugwp_effac cires_ugwp_module four-dimensional array that control efficiency of GWs triggerd by four types of physics-based sources.
Default values: 1.,1.,1.,1. - reflect that calculated GW-tendencies will be applied for the model state.
1.,1.,1.,1.
launch_level cires_ugwp_module parameter has been introduced by EMC during implementation. It defines the interface model level from the surface at which NGWs are launched.
Default value for FV3GFS-64L, launch_level=25 and for FV3GFS-128L, launch_level=52.
55