Configuration#

The main output project schema is stilt.config.ModelConfig. It layers named meteorology streams, footprint definitions, and executor settings on top of the STILT parameter surface. The field tables below are rendered directly from the live Pydantic model metadata so the parameter descriptions stay in sync with the code.

Tip

If you are new to PYSTILT, start with the configuration guide before diving into the reference details below. The guide focuses on the most common configuration fields. This API reference is comprehensive and includes all fields, but it may be overwhelming if you are just getting started.

Config objects#

`ModelConfig`	Project-level config: STILT params plus met and footprint definitions.
`MetConfig`	Meteorology file discovery, optional downloading, and optional subgridding.
`FootprintConfig`	Settings for a single named footprint product.
`Bounds`	Immutable geographic bounding box (always lon/lat degrees).
`Grid`	Footprint grid: lon/lat bounds, optional output projection, cell resolution.
`RuntimeSettings`	Typed runtime settings shared across CLI, workers, and executors.

Parameters#

`ModelParams`	Core STILT run controls.
`TransportParams`	HYSPLIT transport and turbulence parameterization.
`ErrorParams`	Transport error trajectory parameters for XY and ZI perturbations.

Transform specifications#

`VerticalOperatorTransformSpec`	Declarative built-in transform for applying a vertical operator.
`FirstOrderLifetimeTransformSpec`	Declarative built-in transform for first-order lifetime decay.