odav / sp-scratch

SWAT+ Documentation

SWAT+

The Soil and Water Assessment Tool Plus SWAT+ is a public domain 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. 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 repository using git.

$ git clone https://github.com/odav/swatplus.git

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

$ wget https://github.com/odav/swatplus/archive/refs/tags/61.3.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
├── 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)

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, Testing, and Installing SWAT+ using cmake

• Scenario Testing

• Tagging and Versioning

• Developing in Visual Studio

• FORTRAN Coding Conventions

Documentation and References

Previous SWAT+ versions on Bitbucket

SWAT+ Documentation

SWAT at TAMU