Skip to content

IBM/SWATgym

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

41 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

SWATgym

SWATgym is a reinforcement learning environment based on the Soil and Water Assessment Tool (SWAT). SWAT is a physics based, continuous time, semi-distributed river basin model that has been widely used to evaluate the effects of crop management decisions on water resources (Arnold et al., 2012). SWATgym demonstrates the application of reinforcement learning to crop management and enables one to evaluate various decision-making strategies on a full growing season.

Similar to the original SWAT model (Arnold et al., 1998), SWATgym operates on a daily time step and considers various processes including:

  • crop growth,
  • hydrology,
  • nutrient cycles,
  • weather,
  • management inputs (fertilizer, irrigation).

Getting Started

All dependencies are included in the environment.yml file.

  1. Install SWATgym from source by running
git clone https://github.com/IBM/SWATgym
  1. After cloning, create a virtual environment e.g., using Conda:
conda env create --name swat_env --file=environment.yml
  1. Activate the environment: conda activate swat_env

  2. Run an example with a Random policy agent: python main.py

References

Arnold et al., 1998. Large area hydrologic modeling and assessment part I: model development. Journal of the American Water Resources Association, 34 (1), 73–89.

Arnold et al., 2012. SWAT: model use, calibration, and validation. Transactions of the ASABE, 55 (4), 1491–1508.

Citing this work

@article{madondo2023swat,
  title={A SWAT-based Reinforcement Learning Framework for Crop Management},
  author={Madondo, Malvern and Azmat, Muneeza and Dipietro, Kelsey and Horesh, Raya and Jacobs, Michael and Bawa, Arun and Srinivasan, Raghavan and O'Donncha, Fearghal},
  journal={arXiv preprint arXiv:2302.04988},
  year={2023}
}

About

SWATgym: a reinforcement learning environment for crop management.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published