/SBW-pyATM

individual-based model of SBW dispersal

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

SBW-pyATM

This is the Python-based Atmospheric Transport Model for Spruce Budworm as published in January 2022:

Garcia, M., B.R. Sturtevant, R. Saint-Amant, J.J. Charney, J. Delisle, Y. Boulanger, P.A. Townsend, and J. Régnière, 2022: "Modeling weather-driven long-distance dispersal of spruce budworm moths (Choristoneura fumiferana). Part 1: Model description." Agricultural and Forest Meteorology, doi: 10.1016/j.agrformet.2022.108815.

Contact: matt.e.garcia@gmail.com

The paper is an Open-Access #OA publication that is free to everyone. Note that a link to Supplemental Information (PDF) is also provided on that publication page.

Additional information and materials for that paper are located at:


Repository contents:

LICENSE (text of GPLv3)

README.md (this file)

docs

  • WRF simulations Technical Document (PDF)
  • pyATM Technical Document (PDF)

source

tests

  • Solar calculations (Solar_test.py)
  • Circadian liftoff times (Circadian_test.py)

htcondor

preprocess

  • htcondor

postprocess

  • htcondor

Python requirements:

To use the SBW–pyATM code, you will need the following packages and libraries in your local python installation:

  • python standard libraries: copy, datetime, warnings, os, sys
  • basemap (a.k.a. mpl_toolkits.basemap)
  • basemap-data-hires
  • gdal (via osgeo)
  • iso8601
  • matplotlib
  • netCDF4
  • numpy
  • pandas
  • pyproj
  • scipy.interpolate
  • wrf-python (as wrf)

I recommend the Anaconda package installation for python, and then using the conda package manager, but the pip package manager works just as well.

The components of the pyATM software, including their external and inter-dependencies, are described in the pyATM Technical Document (see the docs folder, above).


Usage:

Details regarding model execution, including the use of HTCondor, are forthcoming.

Details regarding pre-processing operations and post-processing options are forthcoming.


Model Operation:

Flowcharts describing the order of operations during a model simulation are included in the pyATM Technical Document (see the docs folder, above).