Processing math: 9%
CCPP Scientific Documentation
v4.1.0
All Classes Namespaces Files Functions Variables Modules Pages
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