Description of Namelist Variables
Description of Namelist Variables
---------------------------------
For WRF-NMM users, please see Chapter 5 of the WRF-NMM User's Guide for
&time_control
Note: if it is more than 1 day, one may use both run_days and run_hours
or just run_hours. e.g. if the total run length is 36 hrs, you may
Note: the start time is used to name the first wrfout file.
It also controls the start time for nest domains, and the time to restart
interval_seconds = 10800, ; time interval between incoming real data, which will be the interval
input_from_file (max_dom) = T, ; whether nested run will have input files for domains other than 1
fine_input_stream (max_dom) = 0, ; field selection from nest input for its initialization
0: all fields are used; 2: only static and time-varying, masked land
io_form_auxinput2
cycling = F, ; whether this run is a cycling run, if so, initializes look-up table for Thompson schemes only
io_form_history = 2, ; 2 = netCDF
io_form_restart = 2, ; 2 = netCDF
io_form_input = 2, ; 2 = netCDF
= 4, ; PHD5 format
= 5, ; GRIB1 format
; 0 = no print
; 1 = no print
all_ic_times = .false., ; whether to write out wrfinput for all processing times
override_restart_timers = .false., ; whether to change the alarms from what is previously set
write_hist_at_0h_rst = .false., ; whether to output history file at the start of restart run
auxinput4_inname = "wrflowinp_d<domain>"
io_form_auxhist3 =2 ; netcdf
inputout_begin_y =0
inputout_begin_mo =0
inputout_begin_d =0
inputout_begin_h =3
inputout_begin_m =0
inputout_begin_s =0
inputout_end_y =0
inputout_end_mo =0
inputout_end_d =0
inputout_end_h = 12
inputout_end_m =0
inputout_end_s =0 ; the above shows that the input-formatted data are output
&domains
time_step_fract_den = 10
time_step_dfi = 60, ; time step for DFI, may be different from regular time_step
dx (max_dom) = 10000, ; grid length in x direction; ARW: unit in meters, NMM: unit in degrees (e.g. 0.667)
dy (max_dom) = 10000, ; grid length in y direction; ARW: unit in meters, NMM: unit in degrees (e.g. 0.0658)
parent_grid_ratio (max_dom) = 1, ; parent-to-nest domain grid size ratio: for real-data cases
the ratio has to be odd; for idealized cases,
smooth_option =0 ; smoothing option for parent domain, used only with feedback
; 1 = linear in pressure
; 2 = linear in log(pressure)
; 1 = isothermal
; 3 = constant theta
use_levels_below_ground = .true. ; in vertical interpolation, use levels below input surface level
use_surface = .true. ; use the input surface level data in the vertical interp and extrap
; 1 = linear
; 2 = quadratic
zap_close_levels = 500 ; ignore isobaric level above surface if delta p (Pa) < zap_close_levels
lowest_lev_from_sfc = .false. ; place the surface value into the lowest eta location
force_sfc_in_vinterp =1 ; use the surface level as the lower boundary when interpolating
sfcp_to_sfcp = .false. ; Optional method to compute model's surface pressure when incoming
; data only has surface pressure and terrain, but not SLP
smooth_cg_topo = .false. ; Smooth the outer rows and columns of domain 1's topography w.r.t.
use_tavg_for_tsk = .false. ; whether to use diurnally averaged surface temp as skin temp. The
aggregate_lu = .false. ; whetger to aggregate the grass, shrubs, trees in dominant landuse;
default is false.
rh2qv_wrt_liquid = .true., ; whether to compute RH with respect to water (true) or ice (false)
of levels must agree with the number of eta surfaces allocated (e_vert). Users may alternatively request
only the number of levels (with e_vert), and the real program will compute values. The computation assumes
a known first several layers, then generates equi-height spaced levels up to the top of the model.
Note that this moving nest option needs to be activated at the compile time by adding -DMOVE_NESTS
move_cd_x(max_moves) = 1,1,0,-1,; the number of parent domain grid cells to move in i direction
move_cd_y(max_moves) = 1,0,-1,1,; the number of parent domain grid cells to move in j direction
at each move.
Namelist variables for controling the automatic moving nest:
Note that this moving nest option needs to be activated at the compile time by adding -DMOVE_NESTS
and -DVORTEX_CENTER to the ARCHFLAGS. This option uses an mid-level vortex following algorthm to
max_vortex_speed(max_dom) = 40 ; used to compute the search radius for the new vortex position
corral_dist(max_dom) =8 ; how many coarse grid cells the moving nest is allowed to get
target_cfl(max_dom) = 1.2,1.2 ; vertical and horizontal CFL <= to this value implies
exceed 100 s
&dfi_control
; 0 = uniform
; 1 = Lanczos
; 2 = Hamming
; 3 = Blackman
; 4 = Kaiser
; 5 = Potter
; 6 = Dolph window
; 7 = Dolph
; 8 = recursive high-order
dfi_bckstop_year = 2004 ; four-digit year of stop time for backward DFI integration
dfi_fwdstop_year = 2004 ; four-digit year of stop time for forward DFI integration
&physics
Note: even the physics options can be different in different nest domains,
= 0, no microphysics
= 1, Kessler scheme
= 95, Ferrier (old Eta) microphysics, operational NAM (WRF NMM) version
For non-zero mp_physics options, to keep Qv .GE. 0, and to set the other moisture
= 1, ; except for Qv, all other moist arrays are set to zero
mp_zero_out_thresh = 1.e-8 ; critical value for moist array threshold, below which
default value = 0
default value = 0
no_mp_heating =0 ; normal
= 0, no longwave radiation
= 1, rrtm scheme
= 3, cam scheme
= 4, rrtmg scheme
= 0, no shortwave radiation
= 1, Dudhia scheme
= 3, cam scheme
= 4, rrtmg scheme
from this.
by namelist value.
= 0, no surface-layer
= 0: no
= 1: Single-layer, UCM
= 0, no boundary-layer
= 1, YSU scheme
sf_sfclay_physics=1 or 2 as well as 5
MYNNSFC (sf_sfclay_physics = 5)
mfshconv (max_dom) = 1,; whether to turn on new day-time EDMF QNSE (0=no)
topo_wind (max_dom) = 0, turn off, =1, turn on topographic surface wind correction from Jimenez
= 0, no cumulus
= 2, Betts-Miller-Janjic scheme
= 14, New GFS simplified Arakawa-Schubert scheme from YSU (ARW only)
shcu_physics (max_dom) independent shallow cumulus option (not tied to deep convection)
= 1, Grell 3D ensemble scheme (use with cu_physics=5) (PLACEHOLDER: SWITCH NOT YET
IMPLEMENTED--use ishallow)
convtrans_avglen_m = 30, averaging time for convective transport output variables (minutes) (GD and G3 only)
= 1, default option
any other number, consult the code, know what you are doing.
seaice_threshold = 271 ; tsk < seaice_threshold, if water point and 5-layer slab
; and Noah scheme, set to land point, permanent ice, set temps
; auxinput4_inname = "wrflowinp_d<domain>",
rdmaxalb = .true. ; use snow albedo from geogrid; false means using values from table
rdlai2d = .false. ; use LAI from input; false means using values from table
bucket_mm = -1. ; bucket reset value for water accumulations (value in mm, -1.=inactive)
bucket_J = -1. ; bucket reset value for energy accumulations (value in J, -1.=inactive)
lagday = 150 ; days over which tmn is computed using skin temperature
topo_shading (max_dom) =0 ; neighboring-point shadow effects for solar radiation (1=on, 0=off)
omlcall =0 ; activate simple ocean mixed layer model (0=no, 1=yes); works with
sf_surface_physics = 1 only
oml_hml0 = 50 ; oml model can be initialized with a constant depth everywhere (m)
; sf_sfclay=1 and 11
; 0=default
; 2=Donelan Cd + Garratt
; sf_sfclay=5
iz0tlnd =0 ; thermal roughness length for sfclay and myjsfc (0 = old, 1 = veg dependent Chen-Zhang Czil)
mp_tend_lim = 10., ; limit on temp tendency from mp latent heating from radar data assimilation
prec_acc_dt (max_dom) = 0., ; number of minutes in precipitation bucket (ARW only) - will add three
nens =1 ; an integer that controls the random number stream which will then
&noah_mp
; 2 = On
; 1 = Ball-Berry; 2 = Jarvis
; 1 = Modified two-stream;
; 1 = BATS; 2 = CLASS
; 1 = semi-implicit
; 2 = full-implicit
&fdda
=2 ; spectral nudging
gfdda_interval_m (max_dom) = 360 ; time interval (in min) between analysis times (must use minutes)
gfdda_end_h (max_dom) =6 ; time (in hours) to stop nudging after start of forecast
if_zfac_uv (max_dom) =0 ; 0= nudge u and v in all layers, 1= limit nudging to levels above k_zfac_uv
k_zfac_uv (max_dom) = 10 ; 10=model level below which nudging is switched off for u and v
if_zfac_t (max_dom) =0 ; 0= nudge temp in all layers, 1= limit nudging to levels above k_zfac_t
k_zfac_t (max_dom) = 10 ; 10=model level below which nudging is switched off for temp
if_zfac_q (max_dom) =0 ; 0= nudge qvapor in all layers, 1= limit nudging to levels above k_zfac_q
k_zfac_q (max_dom) = 10 ; 10=model level below which nudging is switched off for qvapor
if_ramping =0 ; 0= nudging ends as a step function, 1= ramping nudging down at end of period
dtramp_min = 60.0 ; time (min) for ramping function, 60.0=ramping starts at last analysis time,
sgfdda_inname = "wrfsfdda_d<domain>" ; defined name for sfc nudgingi in input file (from program obsgrid)
sgfdda_end_h (max_dom) =6 ; time (in hours) to stop sfc nudging after start of forecast
sgfdda_interval_m (max_dom) = 180 ; time interval (in min) between sfc analysis times (must use minutes)
rinblw = 250.0 ; radius of influence used to determine the confidence (or weights) for
the analysis, which is based on the distance between the grid point to the nearest
fgdtzero (max_dom) = 0, ; 1= nudging tendencies are set to zero in between fdda calls
if_zfac_ph (max_dom) = 0, ; 0= nudge ph in all layers, 1= limit nudging to levels above k_zfac_ph
k_zfac_ph (max_dom) = 10, ; 10= model level below which nudging is switched off for ph
dk_zfac_t (max_dom) = 1,
dk_zfac_ph (max_dom) = 1,
in time_control namelist
obs_coef_mois = 6.E-4, ; nudging coefficient for water vapor mixing ratio, unit: s-1
obs_coef_pstr = 0. ; nudging coefficient for surface pressure, unit: s-1 (not used)
obs_ionf (max_dom) =2 ; freq in coarse grid timesteps for obs input and err calc
turn off the FDDA before the pure forecast (=1 on)
obs_dtramp = 40 ; time period in minutes over which the nudging is ramped down
obs_nudgezrampr1_uv = 50 ; Vert infl ramp-to-zero height for LML obs, regime 1, winds
obs_nudgezfullr2_uv = 50 ; Vert infl full weight height for LML obs, regime 2, winds
obs_nudgezrampr2_uv = 50 ; Vert infl ramp-to-zero height for LML obs, regime 2, winds
obs_nudgezfullr4_uv = -5000 ; Vert infl full weight height for LML obs, regime 4, winds
obs_nudgezrampr4_uv = 50 ; Vert infl ramp-to-zero height for LML obs, regime 4, winds
obs_nudgezfullr1_t = 50 ; Vert infl full weight height for LML obs, regime 1, temperature
obs_nudgezrampr1_t = 50 ; Vert infl ramp-to-zero height for LML obs, regime 1, temperature
obs_nudgezfullr2_t = 50 ; Vert infl full weight height for LML obs, regime 2, temperature
obs_nudgezrampr2_t = 50 ; Vert infl ramp-to-zero height for LML obs, regime 2, temperature
obs_nudgezfullr4_t = -5000 ; Vert infl full weight height for LML obs, regime 4, temperature
obs_nudgezrampr4_t = 50 ; Vert infl ramp-to-zero height for LML obs, regime 4, temperature
obs_nudgezfullr1_q = 50 ; Vert infl full weight height for LML obs, regime 1, moisture
obs_nudgezrampr1_q = 50 ; Vert infl ramp-to-zero height for LML obs, regime 1, moisture
obs_nudgezfullr2_q = 50 ; Vert infl full weight height for LML obs, regime 2, moisture
obs_nudgezrampr2_q = 50 ; Vert infl ramp-to-zero height for LML obs, regime 2, moisture
obs_nudgezfullr4_q = -5000 ; Vert infl full weight height for LML obs, regime 4, moisture
obs_nudgezrampr4_q = 50 ; Vert infl ramp-to-zero height for LML obs, regime 4, moisture
obs_nudgezfullmin = 50 ; Min depth through which vertical infl fcn remains 1.0
obs_nudgezrampmin = 50 ; Min depth (m) through which vert infl fcn decreases from 1 to 0
obs_nudgezmax = 3000 ; Max depth (m) in which vert infl function is nonzero
obs_sfcfact = 1.0 ; Scale factor applied to time window for surface obs
obs_sfcfacr = 1.0 ; Scale factor applied to horiz radius of influence for surface obs
obs_dpsmx = 7.5 ; Max pressure change (cb) allowed within horiz radius of influence
&scm
&dynamics
0 = no turbulence or explicit
by specifying km_opt.
0 = without damping
2 = with Rayleigh damping (dampcoef inverse time scale [1/s] e.g. .003; idealized case only
3 = with w-Rayleigh damping (dampcoef inverse time scale [1/s] e.g. .05;
diff_6th_factor = 0.12, ; 6th-order numerical diffusion non-dimensional rate (max value 1.0
0 = without damping
1 = with damping
base_pres = 10^5 ; real-data, em ONLY, base sea-level pres (Pa), DO NOT CHANGE
use_baseparam_fr_nml = .f., ; whether to use base state parameters from the namelist
emdiv (max_dom) = 0.01, ; external-mode filter coef for mass coordinate model
mix_full_fields(max_dom) = .true., ; used with diff_opt = 2; value of ".true." is recommended, except for
tke_drag_coefficient(max_dom) = 0., ; surface drag coefficient (Cd, dimensionless) for diff_opt=2 only
tke_heat_flux(max_dom) = 0., ; surface thermal flux (H/(rho*cp), K m/s) for diff_opt=2 only
2=monotonic, 3=5th order WENO, 4=5th-order WENO with positive definite filter
time_step_sound (max_dom) =4/ ; number of sound steps per time-step (0=set automatically)
0 = no (default)
1 = yes
do_gradp (max_dom) = .true., ; whether to do horizontal pressure gradient calculations (idealized) (inactive)
fft_filter_lat = 45. ; the latitude above which the polar filter is turned on
tracer_opt(max_dom) =0 ;
&bdy_control
specified (max_dom) = .false., ; specified boundary conditions (only can be used for domain 1)
nested (max_dom) = .false., ; nested boundary conditions (must be used for nests)
idtadt = 1, ; fundamental timesteps between calls to Euler advection, dynamics (NMM only)
idtadc =1 ; fundamental timesteps between calls to Euler advection, chemistry (NMM only)
vmax_ratio(max_bogus) = -999. ; ratio for representative maximum winds, 0.75 for 45 km grid, and
&namelist_quilt This namelist record controls asynchronized I/O for MPI applications.
&grib2:
compression = 40, ; The compression method to encode the output grib2 message.
&diags:
0=NO, 1=YES
could be 2
(p_hyd). The p_hyd option is the default and less noisy. Total
packages.