User Guide#
These pages show how to set up a project, run it, and use the results. If you are new to PYSTILT, start with Your First Footprint.
Setting up a project
Receptors: where and when you measured (towers, columns, satellites)
Meteorology: use your own ARL files or download them from NOAA
Configuration: what goes in
config.yamlProject Folders And Reruns: what is in a project folder, and how reruns work
Running simulations
Where To Run: pick where to run
On Your Computer: on your computer or in a notebook
On An HPC Cluster (Slurm): on an HPC cluster
Working with results
Load And Plot Results: load, plot, and aggregate footprints and trajectories
Transport Error: the modelled enhancement from a flux field, and its transport uncertainty
Wind Error Statistics: estimate the wind-error statistics a transport-error run needs
Background: the mole fraction at the trajectory endpoints, as a background for the receptor
Plume Background: a background from the soundings a forward-run plume did not reach
Column and satellite measurements
Reading Retrieval Products: read TROPOMI, OCO-2 or TCCON files into a table of soundings, or add your own instrument
Satellite And Column Observations: turn satellite soundings or column retrievals into receptors
Slant Columns: instruments that look along a tilted path (EM27/SUN, TCCON, off-nadir satellites)
Particle Weighting (Transforms): averaging kernels, pressure weighting, and your own particle weights
Coming from other STILT tools
Under the hood
How PYSTILT Tracks Finished Work: how PYSTILT tracks finished work
In The Cloud (Kubernetes): cloud workers (experimental)