If R, RStudio or any of the required R packages below are not installed on your computer please follow the instructions below. Either way, I recommend to update R and the required packages to the most recent versions to avoid any compatibility issues.
I am still working on some issues with the SWATplusR package. Thus, the package is currently not available for installation. I will provide the installation of the package (by adding an access token to the github repository) by March 18 latest, that you have enough time for the installation and that we still can fix issues with the installation before the meeting starts.
Please download the latest R version (currently 3.5.2) from the Comprehensive R Archive Network (CRAN) for your operating system: https://cran.r-project.org/ and install it on your computer. If you run linux on your computer I recommend an installation via the terminal. For Ubuntu bionic beaver (and maybe other recent debian distributions) this is a helpful link: https://linuxize.com/post/how-to-install-r-on-ubuntu-18-04/
RStudio is my preferred integrated development environment (IDE) for R . It provides plenty of functionality for R package devlopment, to manage your R projects and much more. For the hands on tutorial it might be easier to follow if you work in the same programming environment. Please go to the RStudio website and install Rstudio for your operating system: https://www.rstudio.com/products/rstudio/download/#download.
After installing base R and Rstudio you should be able to run Rstudio. Rstudio should automatically recognize the R version you just installed as your default one. The console of Rstudio should show something like this on startup:
#> R version 3.5.1 (2018-07-02) -- "Feather Spray"
#> Copyright (C) 2018 The R Foundation for Statistical Computing
#> Platform: x86_64-pc-linux-gnu (64-bit)
#>
#> R is free software and comes with ABSOLUTELY NO WARRANTY.
#> You are welcome to redistribute it under certain conditions.
#> Type 'license()' or 'licence()' for distribution details.
#>
#> Natural language support but running in an English locale
#>
#> R is a collaborative project with many contributors.
#> Type 'contributors()' for more information and
#> 'citation()' on how to cite R or R packages in publications.
#>
#> Type 'demo()' for some demos, 'help()' for on-line help, or
#> 'help.start()' for an HTML browser interface to help.
#> Type 'q()' to quit R.To install an R package from CRAN you simply execute the function install.package("name_of_the_package"). During this short tutorial we require different R packages that I recommend to install beforehand. Please copy the following lines of code in to the console of Rstudio (the window that shows: >) and press enter to run each line of code.
# Install required packages from CRAN
install.packages(c("devtools", "tidyverse", "lubridate", "lhs", "hydroGOF", "sensitivity", "fast", "sf", "here", "plotly"))
# Install the pasta package from my github repository (I use it a lot and will explain why)
devtools::install_github("chrisschuerz/pasta")Especially installing the sf package can cause troubles on Linux, as it requires gdal (that maybe comes with QGIS). If you cannot resolve the troubles, please contact me. In general it is not essential to have the sf package installed. We might use it at the end of the course to visualize some maps.
If R or any of the required packages are already installed on your computer, but you have not updated them for a while I recommend to do so. I did not check any downwards compability of my R packages yet nor did I check if the code I will present works with older versions of R or any of the packages. So please check if your computer is up to date :).
The SWATplusR package is not yet available from CRAN. It is however available from one of my github repositories. The R package devtools provides an easy way to install an R package directly from github. As it is still under development, I avoid to leave it out in the open. Therefore, the function below requires the correct auth_token in the command below to install from the non-public repository. I will add the token a few days before our meeting.
devtools::install_github("chrisschuerz/SWATplusR", auth_token = ???)If you encounter any problems I recommend to post an issue in the issue section of this github repository: https://github.com/chrisschuerz/SWAT_D_2019/issues. Thus, others that encounter the same problems can read if a solution was already posted.