stilt.config.TransportParams#
- class stilt.config.TransportParams(*, capemin: float = -1.0, cmass: int = 0, conage: int = 48, cpack: int = 1, delt: int = 1, dxf: int = 1, dyf: int = 1, dzf: float = 0.01, efile: str = '', emisshrs: float = 0.01, frhmax: float = 3.0, frhs: float = 1.0, frme: float = 0.1, frmr: float = 0.0, frts: float = 0.1, frvs: float = 0.01, hscale: int = 10800, ichem: int = 8, idsp: int = 2, initd: int = 0, k10m: int = 1, kagl: int = 1, kbls: int = 1, kblt: int = 5, kdef: int = 0, khinp: int = 0, khmax: int = 9999, kmix0: int = 150, kmixd: int = 3, kmsl: Literal[0, 1] | None = None, kpuff: int = 0, krand: int = 4, seed: int | None = None, krnd: int = 6, kspl: int = 1, kwet: int = 1, kzmix: int = 0, maxdim: int = 1, maxpar: int | None = None, mgmin: int = 10, mhrs: int = 9999, nbptyp: int = 1, ncycl: int = 0, ndump: int = 0, ninit: int = 1, nstr: int = 0, nturb: int = 0, nver: int = 0, outdt: int = 0, p10f: int = 1, pinbc: str = '', pinpf: str = '', poutf: str = '', qcycle: int = 0, rhb: float = 80.0, rht: float = 60.0, splitf: int = 1, tkerd: float = 0.18, tkern: float = 0.18, tlfrac: float = 0.1, tout: float = 0.0, tratio: float = 0.75, tvmix: float = 1.0, veght: float = 0.5, vscale: int = 200, vscaleu: int = 200, vscales: int = -1, w_option: int = 0, wbbh: int = 0, wbwf: int = 0, wbwr: int = 0, wvert: bool = False, z_top: float = 25000.0, zicontroltf: int = 0, ziscale: float | list[float] | list[list[float]] = 1.0) None[source]#
HYSPLIT transport and turbulence parameterization.
Parameters#
Parameter |
Description |
Default |
|---|---|---|
|
Minimum CAPE (J/kg) for convective mixing; -1 disables CAPE-triggered enhanced mixing. |
|
|
Compute grid output in concentration units (0) or mass units (1). |
|
|
Particle age in hours for puff/particle conversion handling. |
|
|
Binary concentration-grid packing mode. |
|
|
Integration timestep in minutes; 0 lets HYSPLIT choose automatically. |
|
|
Horizontal X-grid adjustment factor for ensemble runs. |
|
|
Horizontal Y-grid adjustment factor for ensemble runs. |
|
|
Vertical grid adjustment factor for ensemble runs. |
|
|
Temporal emissions file name; blank disables file-driven emissions. |
|
|
Duration of emissions in fractional hours. |
|
|
Maximum horizontal puff-rounding value. |
|
|
Standard horizontal puff-rounding fraction for merging. |
|
|
Mass-rounding fraction used by enhanced merging. |
|
|
Mass-removal fraction used by enhanced merging. |
|
|
Temporal puff-rounding fraction. |
|
|
Vertical puff-rounding fraction. |
|
|
Horizontal Lagrangian timescale in seconds. |
|
|
Initial particle distribution mode. |
|
|
Use 10 m winds and 2 m temperatures as the lowest meteorology level when available. |
|
|
PBL stability method: fluxes (1) or wind/temperature profiles (2). |
|
|
PBL turbulence scheme; PYSTILT defaults to Hanna (5). |
|
|
Horizontal turbulence from vertical mixing (0) or deformation (1). |
|
|
Maximum particle age read from PARINIT during continuous restart runs. |
|
|
Maximum particle or trajectory age in hours. |
|
|
Minimum mixing depth in meters. |
|
|
Mixing-depth method: input, temperature, TKE, or modified Richardson. |
|
|
Interpret start altitudes as AGL (0) or MSL (1). When unset, PYSTILT derives this from each receptor’s altitude_ref. |
|
|
Horizontal puff-growth mode: linear (0) or empirical (1). |
|
|
Random-number mode for turbulence, repeatability, and diagnostic no-mixing runs. |
|
|
Optional HYSPLIT random-number seed written to SETUP.CFG. Use with krand values that preserve a fixed initial seed; krand=4 and 10-13 still randomize the initial seed. |
|
|
Enhanced-merging interval in hours. |
|
|
Standard particle-splitting interval in hours. |
|
|
Use meteorological precipitation, or an external ARL rain file when set to 2. |
|
|
Vertical mixing adjustment mode; 0 none, 1 PBL-average, 2 TVMIX scaling. |
|
|
Maximum pollutant species carried on one particle, mainly for chemistry runs. |
|
|
Maximum number of particles allowed in a simulation. |
|
|
Minimum meteorological subgrid size. |
|
|
Trajectory restart duration limit in hours. |
|
|
Number of particle-size bins created around each pollutant size entry. |
|
|
Particle initialization mode for restart, add, or replace workflows. |
|
|
Trajectory restart interval in hours. |
|
|
Turbulence mode selector; 0 is on/default, 1 disables turbulence. |
|
|
Trajectory vertical split number. |
|
|
Minutes between STILT endpoint writes to PARTICLE.DAT; negative disables output. |
|
|
Dust threshold-velocity sensitivity factor. |
|
|
Emission cycling period in hours; 0 disables cycling. |
|
|
Relative-humidity threshold used to define cloud base. |
|
|
Relative-humidity threshold below which cloud top is considered to end. |
|
|
Automatic horizontal split-size factor; negative disables auto sizing. |
|
|
Unstable TKE ratio w’²/(u’²+v’²). |
|
|
Stable TKE ratio w’²/(u’²+v’²). |
|
|
Fraction of the vertical Lagrangian timescale used to set the STILT timestep. |
|
|
Trajectory output interval in minutes. |
|
|
Advection stability ratio. |
|
|
Scale factor applied to vertical mixing coefficients for selected KZMIX modes. |
|
|
Height threshold used to accumulate STILT footprint residence time. |
|
|
Vertical Lagrangian timescale in seconds for neutral PBL conditions. |
|
|
Vertical Lagrangian timescale in seconds for unstable PBL conditions. |
|
|
Vertical Lagrangian timescale in seconds for stable PBL conditions. |
|
|
Vertical motion method; 0 met vertical velocity, 1 isob, 2 isen, 3 dens, 4 sigma. |
|
|
Height where fixed vertical motion switches from rise to fall. |
|
|
Fixed fall velocity used by vertical-motion options 9 or 10. |
|
|
Fixed rise velocity used by vertical-motion option 9. |
|
|
Use the WRF vertical interpolation scheme for vertical velocity when true. |
|
|
Top of model domain, in meters above ground level; defaults to 25000.0 |
|
|
Enable domain-wide PBL scaling from a ZICONTROL file. |
|
|
Manually scale the mixed-layer height. Scalars expand across the run; lists define shared hourly factors. |
|