Skip to contents

Introduction to svatools

svatools

Project Status: Active - The project has reached a stable, usable state and is being actively developed. License: MIT

The goal of svatools is to help with the SWAT+ model input data preparation. There are mostly functions, which were developed for the implementation of modeling tasks in the OPTAIN project. These tools are intended to fill the gaps in the SWAT+ workflow along side the main tools developed by Christoph Schuerz. Therefore, we highly recommend trying and using these tools:

  • SWATfarmR - R tool for preparing management schedules for SWAT model;
  • SWATplusR - R tool for sensitivity analyse, model calibration and validation;
  • SWATbuildR1 - R tool for building SWAT+ setups;
  • SWATdoctR2 - A collection of functions in R and routines for SWAT model calibration and model diagnostics.

Detailed information about packages, workflow steps, input data, SWAT+ parameters, model calibration, validation, etc., could be found in the SWAT+ modeling protocol.

Installation

You can install the development version of svatools from GitHub with:

# install.packages("devtools")
devtools::install_github("biopsichas/svatools")
# euptf2 package is needed and used for soil parameter functions
devtools::install_github("tkdweber/euptf2")

Data

All the data required to run and test package is installed with package in extdata folder. Exact location on computer could be found running lines below. Please run it on your system to get it for you.

library(svatools)
temp_path <- system.file("extdata", package = "svatools")
print(temp_path)
#> [1] "C:/Users/laptop/AppData/Local/R/win-library/4.2/svatools/extdata"

Templates

In order to use svatools package functions with your data you should prepare your data to be inline with templates we have provided in extdata folder. Such are:

  • calibration_data.xlsx - template for loading calibration (water flow and water quality variables) data.
  • weather_data.xlsx - template for loading weather variables.
  • soil_lookup.xlsx - example of loading soil parameters dataset.
  • GIS/ - folder with GIS layers needed to run some functions.
  • CORDEX-BC/ - folder with example climate data.

Data prepared according to templates can be directly loaded into R and all the functions applied as described.