Advanced / Configuration Setup / Namelist Variables

This section provides a summary of the SETUP.CFG namelist file parameters required in configuring the model to perform certain specialized calculations. The default value is shown in bold with each variable and a link to the User's Guide page with a more detailed discussion of the options. The namelist options that only affect trajectories are shown in italics.

• CAPEMIN=-1 -1 no convection; -2 Grell convection scheme; -3 extreme convection; >0 enhanced vertical mixing when CAPE exceeds this value (J/kg)
• AREA=0 set emission area shape square (0) or circle (1)
• CMASS=0 compute grid concentrations (0) or grid mass (1)
• CMTFN=' ' center-of-mass trajectory output file name
• CONAGE=24 particle to or from puff conversions at conage (hours)
• CPACK=1 binary concentration packing 0:none 1:nonzero 2:points 3:polar
• DELT=0.0 integration time step (0=autoset GT-0=constant LT-0=minimum)
• DXF=1.0 horizontal X-grid adjustment factor for ensemble
• DYF=1.0 horizontal Y-grid adjustment factor for ensemble
• DZF=0.01 vertical (0.01 ~ 250m) factor for ensemble
• EFILE=' ' temporal emission file name
• FRHMAX=3.0 maximum value for the horizontal rounding parameter
• FRHS=1.00 standard horizontal puff rounding fraction for merge
• FRME=0.10 mass rounding fraction for enhanced merging
• FRMR=0.0 mass removal fraction during enhanced merging
• FRTS=0.10 temporal puff rounding fraction
• FRVS=0.01 vertical puff rounding fraction
• GEMAGE=48 particle or puff transfer to the global model after gemage (hours)
• HSCALE=10800.0 horizontal Lagrangian time scale (sec)
• ICHEM=0 chemistry conversion modules 0:none 1:matrix 2:convert 3:dust ...
• IDSP=1 particle dispersion scheme 1:HYSPLIT 2:STILT
• INITD=0 initial distribution, particle, puff, or combination
• IVMAX=20 number of variables written to PARTICLE_STILT.DAT. Must equal the number of variables listed for variable VARSIWANT
• K10M=1 use surface 10m winds / 2m temperature (1) or skip (0)
• KAGL=1 trajectory output heights are written as AGL (1) or as MSL (0)
• KBLS=1 boundary layer stability derived from 1:fluxes 2:wind_temperature
• KBLT=2 boundary layer turbulence parameterizations 1:Beljaars 2:Kanthar 3:TKE 4:Measured 5:Hanna
• KDEF=0 horizontal turbulence 0=vertical 1=deformation
• KHINP=0 when non-zero sets the age (h) for particles read from PINPF
• KHMAX=9999 maximum duration (h) for a particle or trajectory
• KMIXD=0 mixed layer obtained from 0:input 1:temperature 2:TKE 3:modified Richardson #
• KMIX0=150 minimum mixing depth
• KMSL=0 starting heights default to AGL=0 or MSL=1
• KPUFF=0 horizontal puff dispersion linear (0) or empirical (1) growth
• KRAND=0 method to calculate random number 0=precompute if NUMPAR greater than 5000 or dynamic if NUMPAR less than or equal to 5000; 1=precalculated; 2=calculated in pardsp; 3=none; 4=random initial seed number and calculated in pardsp; 10=same as 0 with random initial seed for non-dispersion applications; 11=same as 1 with random initial seed for non-dispersion applications; 12=same as 2 with random initial seed for non-dispersion applications; 13=same as 3 with random initial seed for non-dispersion applications
• KRND=6 enhanced merge interval (hours)
• KSPL=1 standard splitting interval (hours)
• KWET=0 precipitation from an external file
• KZMIX=0 vertical mixing adjustments: 0=none 1=PBL-average 2=scale_TVMIX
• MAXDIM=1 maximum number of pollutants to carry on one particle
• MAXPAR=10000 maximum number of particles carried in simulation
• MESSG='MESSAGE' diagnostic message file base name
• MGMIN=10 minimum meteorological subgrid size
• MHRS=9999 trajectory restart duration limit (hours)
• NBPTYP=1 number of redistributed particle size bins per pollutant type
• NINIT=1 particle initialization (0-none; 1-once; 2-add; 3-replace)
• NCYCL=0 pardump output cycle time
• NDUMP=0 dump particles to/from file 0-none or nhrs-output interval
• NSTR=0 trajectory restart time interval in hours
• NTURB=0 Turbulence flag 0-on; 1-off
• NUMPAR=2500 number of puffs or particles to released per cycle
• NVER=0 trajectory vertical split number
• P10F=1.0 dust threshold velocity sensitivity factor
• PINBC=' ' particle input file name for time-varying boundary conditions
• PINPF=' ' particle input file name for initialization or boundary conditions
• PLRISE=1 plume rise option 1-Briggs; 2-Sofiev; 3-Freitas used when heat/fire radiative power is nonzero in emissions input file
• POUTF=' ' particle output file name
• QCYCLE=0.0 optional cycling of emissions (hours)
• RHB=80 is the RH defining the base of a cloud
• RHT=60 is the RH defining the top of a cloud
• SEED=-1 set the seed for the random number generator. (v988 and higher)
• SPLITF=1.0 automatic size adjustment (<0=disable) factor for horizontal splitting
• TERRFLG=0 If terrain not available in meteological file estimate from surface pressure (0) or terrain.asc file (1).
• TFMT=1 trajectory dump format (use 1 or 2). Format 2 writes more digits below the decimal point for trajectory diagnostic outputs.
• TKERD=0.18 unstable turbulent kinetic energy ratio = w'2/(u'2+v'2)
• TKERN=0.18 stable turbulent kinetic energy ratio
• TLFRAC=0.1 The fraction of the Lagrangian vertical time scale used to calculate the dispersion time step in the STILT dispersion scheme.
• TM_PRES=0 trajectory diagnostic output pressure variable marker flag
• TM_TPOT=0 trajectory diagnostic output potential temperature
• TM_TAMB=0 trajectory diagnostic output ambient temperature
• TM_RAIN=0 trajectory diagnostic output rainfall rate
• TM_MIXD=0 trajectory diagnostic output mixed layer depth
• TM_TERR=0 trajectory diagnostic output terrain height
• TM_DSWF=0 trajectory diagnostic output downward short-wave flux
• TM_RELH=0 trajectory diagnostic output relative humidity
• TOUT=60 trajectory output interval in minutes
• TRATIO=0.75 advection stability ratio
• TVMIX=1.0 vertical mixing scale factor
• VARSIWANT='TIME','INDX','LONG','LATI','ZAGL','SIGW','TLGR','ZSFC','TEMP','SAMT','FOOT','SHTF','DMAS','DENS','RHFR','SPHU','DSWF','WOUT','MLHT','PRES' variables written to PARTICLE_STILT.DAT.
• VBUG=0 insect additional horizontal speed (m/s) added to trajectories
• VDIST='VMSDIST' diagnostic file vertical mass distribution
• VEGHT=0.5 Height below which particle's time is spent is tallied to calculate footprint for PARTICLE_STILT.DAT less than or equal to 1.0: fraction of PBL height; greater than 1.0: height AGL (m)
• VINIT=1 initial turbulent velocity. Draw from distribution (1) set to 0 (0)
• VSCALEU=200.0 vertical Lagrangian time scale (sec) for unstable PBL
• VSCALES=5.0 vertical Lagrangian time scale (sec) for stable PBL
• WBWR=0.0 trajectory fixed rise velocity (m/s) required if vertical motion option = 9
• WBWF=0.0 trajectory fixed fall velocity (m/s, >0) required if vertical motion option = 9 or 10
• WBBH=0.0 trajectory height at which vertical velocity switches from rise to fall (m) required if vertical motion option = 9
• WVERT=.TRUE. Vertical interpolation scheme for WRF fields .FALSE.:HYSPLIT scheme .TRUE.:WRF scheme