fluxfootprint documentation

Contents:

• fluxfootprints package
  • Submodules
  • fluxfootprints.compare module
  • fluxfootprints.ep_footprint module
  • fluxfootprints.ffp_xr module
  • fluxfootprints.footprint_plotting module
  • fluxfootprints.improved_ffp module
  • fluxfootprints.tools module
  • fluxfootprints.volk module
  • Module contents
• fluxfootprints
  • fluxfootprints package
• Flux Footprints: Key Concepts
  • What is a flux footprint and how is it represented mathematically?
  • How are footprint values calculated in modelling?
  • What meteorological parameters are crucial for footprint prediction models?
  • How does atmospheric stability affect the footprint?
• Outline of Flux Measurement Footprint Estimation Approaches
  • 1. Analytical Models and (Semi-)Empirical Parameterizations
  • 2. Lagrangian Particle Models / Lagrangian Stochastic (LS) Models
  • 3. Large Eddy Simulations (LES)
  • 4. Ensemble-Averaged Closure Models / Eulerian Models
• Quick-start notebook 1
  • Requirements
  • 1) Set Paths
  • 2) Load Configuration & Data
  • 3) Build the Footprint Climatology
  • 4) Summarize to Daily / Monthly
  • 5) Quick Visualization
  • 6) Export 80% Contours to a GeoPackage
  • 7) Export GeoTIFF Rasters
  • 8) Export Contour Stats to CSV
  • Tips & Troubleshooting
• Quick-start notebook 2
  • Import Supporting Libraries
  • Import Fluxfootprints
  • 1. Load site config and half-hourly data
  • 2. Build the footprint climatology object (computes f_2d per timestep)
  • 3. Summarize to daily & monthly
  • 4. Export 50% and 80% footprint contours to a GeoPackage + CSV stats
  • 5. Export footprint fields as GeoTIFF rasters
• LS Footprint Example
  • 1) Setup
  • 2) Load site configuration and data
  • 3) Choose a time slice and prepare LS model inputs
  • 4) Run the model
  • 5) Visualize the footprint
  • 6) Optional: 80% source area contour
  • 7) Save outputs (optional)
  • 8) Tips & next steps
• Wang Footprint Example
  • 1) Provide inputs
  • 2) Compute the 1‑D cross‑wind‑integrated footprint (f_y(x))
  • 3) Practical distances by cumulative contribution
  • 4) (Optional) Reconstruct a 2‑D footprint (f(x, y))
  • 5) Save results
  • Troubleshooting
  • Next steps