agustin-alesso / swatplus

Soil and Water Assessment Tool +

SWAT+

The Soil and Water Assessment Tool Plus SWAT+ is an open source model jointly developed by the USDA Agricultural Research Service (USDA-ARS) and Texas A&M AgriLife Research, part of The Texas A&M University System. Model contributions have been made by Colorado State University and others. SWAT+ is a small watershed to river basin-scale model to simulate the quality and quantity of surface and ground water and predict the environmental impact of land use, land management practices, and climate change. SWAT is widely used in assessing soil erosion prevention and control, non-point source pollution control and regional management in watersheds.

This repository contains the latest SWAT+ source code and some test data to create and test the executable for various compiler and platforms.

Repository

Get the SWAT+ sources by cloning the forked repository using git.

$ git clone https://github.com/<user>/swatplus.git

Or, download the sources directly from the artifacts, unzip. Use a tagged version (preferred).

$ wget https://github.com/swat-model/swatplus/archive/refs/tags/61.0.zip

Directory Structure

The directory structure is shown below. The build directory gets created and populated during the generation of the cmake files and the cmake build.

swatplus
├── build
│   ├── ...
│   ├── *.mod
│   ├── Testing
│   └── CMakeFiles
│       ├── Makefile.cmake
│       ├── ...
│       └── swatplus-<ver>.dir
│           ├── *.mod.tstamp
│           ├── src
│           └── ...
├── data                      ---> contains all data sets for testing
│   ├── Ames_sub1
│   ├── <other>
│   └── ...
├── src                       ---> contains all swatplus Fortran source files
│   └── *.f90
├── test                      ---> contains all unit tests sources
│   ├── check.py
│   └── ...
├── doc                       ---> contains all hosted documentation
├── CMakeLists.txt            ---> cmake project file
├── ford.md.in                ---> FORD Documentation creation project
├── README.md                 ---> this file
└── ...

Developing SWAT+

This GitHub repository is setup to build, test, and deploy SWAT+ using the CMake tool. CMake is a cross-platform build tool that can be used at the command line but it is also supported through various IDEs, etc. More information can be found at http://cmake.org.

In addition to CMake, the following tools are also needed:

• git tool for version control
• make tool (for building)
• gfortran or ifort/ifx compiler and linker (for compiling/linking)
• python3 (for testing, optional)
• ford (for documentation generation)

Use the operating system's preferred way of adding those tools to your installation. There is certainly more than one way of getting and installing them.

The following sections are emphasizing various development aspects.

• Configuring, Building, Installing SWAT+ using cmake

• Scenario Testing

• Tagging and Versioning

• Developing in Visual Studio

• FORTRAN Coding Conventions (alpha)

Documentation and References

SWAT+ Source Documentation on GitHub

SWAT+ Input/Output Documentation on Gitbook

SWAT at TAMU

Older SWAT+ versions on Bitbucket