stilt.config.ModelParams#

class stilt.config.ModelParams(*, n_hours: int = -24, numpar: int = 200, hnf_plume: bool = True, rm_dat: bool = True, timeout: int | None = None, exe_dir: pathlib.Path | None = None, varsiwant: list[typing.Literal['time', 'indx', 'long', 'lati', 'zagl', 'sigw', 'tlgr', 'zsfc', 'icdx', 'temp', 'samt', 'foot', 'shtf', 'tcld', 'dmas', 'dens', 'rhfr', 'sphu', 'lcld', 'zloc', 'dswf', 'wout', 'mlht', 'rain', 'crai', 'pres', 'whtf', 'temz', 'zfx1']]=<factory>) → None[source]#

Simulation length, particle count, and particle output settings.

Parameters#

Parameter

Description

Default

n_hours

Length of each simulation, in hours. Negative runs backward in time.

-24

numpar

Number of particles released per simulation. More particles give a less noisy footprint and take longer to run.

200

hnf_plume

Apply a vertical Gaussian plume model to particles in the hyper near-field. This shrinks their effective dilution depth and raises the influence of fluxes close to the receptor. Requires varsiwant to include dens, tlgr, sigw, foot, mlht, and samt.

True

rm_dat

Delete HYSPLIT’s particle files (PARTICLE_STILT.DAT and PARTICLE.DAT) once they have been read, to save disk space.

True

timeout

Time limit for one hycs_std run, in seconds. A run that exceeds it is stopped and recorded as a failed simulation, and the worker moves on to the next one. Unset waits indefinitely, so a hung HYSPLIT process can hold a batch worker until its job ends.

None

exe_dir

Directory holding a custom hycs_std build to run in place of the one bundled with PYSTILT. It is saved with each trajectory’s parameters. A build that writes release-time (t = 0) rows to PARTICLE_STILT.DAT gives exact release heights for multipoint and slant receptors.

None

varsiwant

Particle variables hycs_std writes to the trajectory output. The default is the set footprints need, plus pres for pressure weighting.

['time', 'indx', 'long', 'lati', 'zagl', 'foot', 'mlht', 'pres', 'dens', 'samt', 'sig...