SWAT+

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.
https://github.com/swat-model/swatplus

Category: Hydrosphere
Sub Category: Freshwater and Hydrology

Keywords

hydrology modeling nutrients water watershed

Last synced: about 22 hours ago
JSON representation

Repository metadata

Soil and Water Assessment Tool +

README.md

Release

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.

Documentation and References

SWAT+ Source Documentation on GitHub

SWAT+ Input/Output Documentation on Gitbook

SWAT at TAMU

Older SWAT+ versions on Bitbucket

Citation (CITATION.cff)

# This CITATION.cff file is for the SWAT+ Github repository

cff-version: 1.2.0
title: Soil and Water Assessment Tool Plus (SWAT+)
message: >-
  Please cite SWAT+ using the metadata from
  "preferred-citation".
date-released: 2024-08-28
type: software
authors:
  - given-names: Jeffrey G.
    family-names: Arnold
    email: jeff.arnold@usda.gov
    affiliation: >-
      Grassland Soil and Water Research Laboratory, USDA
      Agricultural Research Service (ARS)
  - given-names: Natalja
    family-names: Čerkasova
    email: natalja.cerkasova@gmail.com
    affiliation: >-
      Blackland Research & Extension Center, Texas A&M
      Agrilife Research, USA; Klaipeda University, Marine
      Research Institute, Lithuania
    orcid: 'https://orcid.org/0000-0003-2894-3935'
  - given-names: Michael J.
    family-names: White
    email: mike.white2@usda.gov
    affiliation: >-
      Grassland Soil and Water Research Laboratory, USDA
      Agricultural Research Service (ARS)
    orcid: 'https://orcid.org/0000-0002-1641-0077'
  - given-names: Ryan
    family-names: Bailey
    email: ryant.bailey@colostate.edu
    affiliation: Colorado State University, Fort Collins, Colorado, USA
    orcid: 'https://orcid.org/0000-0002-6539-1474'
  - given-names: Kelly
    family-names: Thorp
    email: kelly.thorp@usda.gov
    affiliation: >-
      Grassland Soil and Water Research Laboratory, USDA
      Agricultural Research Service (ARS)
    orcid: 'https://orcid.org/0000-0001-9168-875X'
  - given-names: Jaehak
    family-names: Jeong
    email: jaehak.jeong@ag.tamu.edu
    affiliation: >-
      Blackland Research & Extension Center, Texas A&M
      Agrilife Research, Temple, USA
  - given-names: Xuesong
    family-names: Zhang
    affiliation: USDA-ARS Hydrology and Remote Sensing Laboratory
    email: Xuesong.Zhang@usda.gov
    orcid: 'https://orcid.org/0000-0003-4711-7751'
  - given-names: Taci
    family-names: Ugraskan
    email: taci.ugraskan@usda.gov
    affiliation: USDA-ARS Grassland Soil and Water Research Laboratory
  - given-names: Ann
    family-names: Griensven
    name-particle: van
    email: ann.van.griensven@vub.be
    orcid: 'https://orcid.org/0000-0002-2105-6287'
    affiliation: >-
      Vrije Universiteit Brussel, IHE-Delft Institute for
      Water Education
  - given-names: Hendrik
    family-names: Rathjens
    affiliation: Stone Environmental Inc.
    orcid: 'https://orcid.org/0000-0002-7152-9767'
  - given-names: Cibin
    family-names: Raj
    email: craj@psu.edu
    affiliation: >-
      Penn State University, Department of Agricultural and
      Biological Engineering
    orcid: 'https://orcid.org/0000-0001-5374-8504'
  - given-names: Ximing
    family-names: Cai
    email: xmcai@illinois.edu
    affiliation: >-
      Civil and Environmental Engineering, University of
      Illinois at Urbana-Champaign
    orcid: 'https://orcid.org/0000-0002-7342-4512'
  - given-names: William F.
    family-names: Geter
    email: Frank.Geter@colostate.edu
    affiliation: >-
      Department of Civil and Environmental Engineering,
      Colorado State University, Fort Collins, USA
  - given-names: Olaf
    family-names: David
    email: odavid@colostate.edu
    affiliation: >-
      Department of Civil and Environmental Engineering,
      Colorado State University, Fort Collins, USA
  - given-names: Jack R.
    family-names: Carlson
    email: Jack.Carlson@colostate.edu
    affiliation: >-
      Department of Civil and Environmental Engineering,
      Colorado State University, Fort Collins, USA
  - given-names: Kieu N.
    family-names: Le
    email: kle@fieldtomarket.org
    affiliation: >-
      Field to Market: The Alliance for Sustainable
      Agriculture
    orcid: 'https://orcid.org/0000-0002-1662-4796'
identifiers:
  - type: doi
    value: 10.5281/zenodo.14983534
    description: Current release
repository-code: 'https://github.com/swat-model/swatplus'
url: 'https://swatplus.gitbook.io/docs'
abstract: >-
  The Soil and Water Assessment Tool Plus (SWAT+) is a public domain
  model jointly developed by the USDA Agricultural Research Service (USDA-ARS),
  Texas A&M AgriLife Research(part of The Texas A&M University System),
  Colorado State University, USDA-ARS Hydrology and Remote Sensing Laboratory,
  and other entities. SWAT+ is a small watershed to river basin-scale model used
  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.
keywords:
  - SWAT+
  - Soil and Water Assessment Tool
  - Environmental Model
  - Watershed model
  - Hydrological Model
license: LGPL-2.1

Owner metadata


GitHub Events

Total
Last Year

Committers metadata

Last synced: 4 days ago

Total Commits: 557
Total Committers: 19
Avg Commits per committer: 29.316
Development Distribution Score (DDS): 0.54

Commits in past year: 267
Committers in past year: 15
Avg Commits per committer in past year: 17.8
Development Distribution Score (DDS) in past year: 0.491

Name Email Commits
fgeter f****r@g****m 256
Taci Ugraskan 1****n 136
od o****d@c****u 61
Celray James CHAWANDA c****a@o****m 23
Jeff Arnold J****d@a****u 16
Natalja Čerkasova n****a@a****t 12
jjeong2019 j****j@t****u 12
Liang-Jun Zhu c****j@g****m 11
Mike-Fuchs m****s@l****e 5
copilot-swe-agent[bot] 1****t 4
Cheng Feng v****c@g****m 4
Natalja 7****C 4
Leonard Bernard-Jannin l****n@g****m 3
Nbsammons 1****s 3
Gaurav Atreya a****e@g****m 2
Jeff Arnold 1****s 2
Jack Carlson 1****5 1
Jaehak Jeong J****g@b****u 1
Mike Taves m****s@g****m 1

Committer domains:


Issue and Pull Request metadata

Last synced: 6 days ago

Total issues: 12
Total pull requests: 109
Average time to close issues: 9 months
Average time to close pull requests: 3 days
Total issue authors: 9
Total pull request authors: 17
Average comments per issue: 0.58
Average comments per pull request: 0.15
Merged pull request: 64
Bot issues: 0
Bot pull requests: 0

Past year issues: 5
Past year pull requests: 56
Past year average time to close issues: 6 months
Past year average time to close pull requests: 4 days
Past year issue authors: 5
Past year pull request authors: 11
Past year average comments per issue: 1.0
Past year average comments per pull request: 0.25
Past year merged pull request: 26
Past year bot issues: 0
Past year bot pull requests: 0

More stats: https://issues.ecosyste.ms/repositories/lookup?url=https://github.com/swat-model/swatplus

Top Issue Authors

  • jenskiesel (2)
  • pssp240425 (2)
  • kieungocle (2)
  • ashehad (1)
  • AnnaWend (1)
  • ghost (1)
  • QQ605586042 (1)
  • JarvisMoritz (1)
  • Arcenic4444 (1)

Top Pull Request Authors

  • tugraskan (52)
  • fgeter (17)
  • odav (14)
  • jjeong2019 (4)
  • Copilot (3)
  • crazyzlj (3)
  • celray (3)
  • arnoldjjms (2)
  • leonard-bernard-jannin (2)
  • pssp240425 (2)
  • VictorCFeng (1)
  • jaclynt (1)
  • jopator (1)
  • Mike-Fuchs (1)
  • mwtoews (1)

Top Issue Labels

Top Pull Request Labels


Dependencies

.github/workflows/build.yml actions
  • actions/checkout v4 composite
  • actions/download-artifact v2 composite
  • actions/upload-artifact v2 composite
  • fortran-lang/setup-fortran v1 composite
  • softprops/action-gh-release v2 composite
.github/workflows/test.yml actions
  • actions/checkout v4 composite
  • fortran-lang/setup-fortran v1 composite
.github/workflows/doc.yml actions
  • actions/checkout v4 composite
  • actions/configure-pages v5 composite
  • actions/deploy-pages v4 composite
  • actions/upload-pages-artifact v3 composite

Score: 7.2485040723706105