stilt.config.FootprintConfig#

class stilt.config.FootprintConfig(*, grid: stilt.config.spatial.Grid | None = None, geometry: Optional[Annotated[stilt.config.geometry.FileGeometrySpec | stilt.config.geometry.H3GeometrySpec | stilt.config.geometry.WindowsGeometrySpec, FieldInfo(annotation=NoneType, required=True, discriminator='kind')]] = None, cells_per_target: Annotated[float, Gt(gt=0)] = 4.0, geometry_hash: str | None = None, smooth_factor: float = 1.0, time_integrate: bool = False, transforms: list[Any] = <factory>) → None[source]#

Footprint settings: the grid, smoothing, and particle transforms.

The config and each variant hold these as their defaults and overrides, and every footprint keeps the settings it was calculated with.

grid is the raster the footprint is computed on. Leave both grid and geometry unset for a variant that only produces trajectories. Give geometry to name the polygons the footprint will be aggregated to, and the grid is derived from them with stilt.Grid.from_geometry(). When both are given, grid is used as is and geometry is kept with the footprint.

Parameters#

Parameter	Description	Default
`grid`	Domain and resolution of the footprint. Leaving it unset with no `geometry` gives a run that produces trajectories only.	`None`
`geometry`	Polygons the footprint will be aggregated to (`kind` of `file`, `h3`, or `windows`). Used to derive `grid` when it is unset, and stored with the footprint.	`None`
`cells_per_target`	Grid cells across the smallest `geometry` cell when `grid` is derived.	`4.0`
`geometry_hash`	Hash of the built `geometry` (`Mesh.hash`), used to tell whether the geometry changed after a footprint was made. Filled in automatically when `geometry` is set.	`None`
`smooth_factor`	Factor on the width of the Gaussian smoothing kernel. 0 turns smoothing off.	`1.0`
`time_integrate`	Sum the footprint over time into a single layer instead of hourly layers.	`False`
`transforms`	Particle transforms applied in order before the footprint is computed. Each entry’s `kind` is a built-in name (`averaging_kernel`, `pressure_weighting`, `first_order_lifetime`) or the import path of your own class.	`[]`