Resources

Documentation

Download instructions

To download the WET installation package, or the source codes of WET and FABM-PCLake, you must first register a free Gitlab account. When signing into the WET and FABM-PCLake Gitlab pages, you will get access to the software, an "Issues" board (effectively a discussion and user support forum) and wikis.

Why do you need to register to access WET or FABM-PCLake?

WET and FABM-PCLake are free, open source, software packages. However, in order for the developer team at Aarhus University to have internal support for offering ongoing maintenance and future improvements to WET and FABM-PCLake, we need to demonstrate the strength and impact of the software tools through the collection of some basic information on how many is using the software.

We have prepared a short instructional video on how to register a Gitlab account, and then downloading and installing WET. The procedure for downloading the FABM-PCLake code is fully equivalent to the procedure for downloading WET.

Prerequisites

Before installing WET, please make sure you have already installed QGIS. We recommend using QGIS Brighton 2.6.1 (available for download here: http://qgis.org/downloads/QGIS-OSGeo4W-2.6.1-1-Setup-x86.exe ), as this version of QGIS is also compatible with the QSWAT hydrological model (available for download here: http://swat.tamu.edu/software/qswat/). QGIS Brighton has been used during the initial development and testing of WET.

Preparing user-defined input files for WET (optional)

On this page, you can learn how to prepare and use user-defined input files for meteorological data, water and nutrient loads.

To read in user defined inputs, the following procedure must be followed:

1.       Prepare user input files in correct format

2.       Create WET project

3.       Place user input files in specific subdirectory of your WET project

4.       Select “User-defined” input in WET

    - this can currently be done in step 4.1 (weather forcing) and step 4.4 (water and nutrient load)

 

To be able to read user defined data from external input files, three individual files may currently be prepared for WET:

1.       meteo_file.dat (meteorological data)

2.       inflow.dat (inflow of water)

3.       inflow_chem.dat (nutrient concentrations in the inflowing water)

 

Once the files have been created, you should create a new WET project in QGIS. This will generate a WET working directory with ..\CLIMATE\ and ..\INFLOWS_OUTFLOWS\ subdirectories. Once the WET project has been created, and you receive the message “The model directory was successfully created”, you should navigate to these subdirectories and place the custom user files here before continuing the model setup in WET.

 

Placing meteo_file.dat in correct folder:

Your meteo_file.dat should be saved to a “User_xxxxx” folder, which you should create within the “CLIMATE” subdirectory of your WET projects’ working directory, where xxxxx may be any text string (without spaces). For example: \WET_projects\lake_ravn\CLIMATE\User_ravn\meteo_file.dat

 

Placing inflow.dat and inflow_chem.dat in correct folder:

Your inflow.dat and inflow_chem.dat files should be saved to a “User_xxxxx” folder, which you should create within the “INFLOWS_OUTFLOWS” subdirectory of your WET projects’ working directory, where xxxxx may be any text string (without spaces). For example: \WET_projects\lake_ravn\INFLOWS_OUTFLOWS\User_ravn\inflow.dat
\WET_projects\lake_ravn\INFLOWS_OUTFLOWS\User_ravn\inflow_chem.dat

 

1. Preparing meteo_file.dat

The meteorological data file comprises eight columns (and rows at preferably subdaily temporal resolution), including (in this order):

1.       Date [yyyy-mm-dd]
2.       Time [hh:mm:ss]
3.       Eastward component (U10) of wind at 10m height [m/s]
4.       Northward component (V10) of wind at 10m height [m/s]

Note: if only the wind speed is known, and not direction and thereby the wind components, then set the U10 column to the recorded wind speed and the V10 column to 0.

5.       Air pressure [hPa]
6.       Air temperature [°C]
7.       Dew-point temperature [°C]

Note: by default in WET, dew-point temperature is used, as “hum_method” is set to 3 in airsea.nml (under the “Parameters” menu in WET).
Alternative 1: relative humidity (%) may be used instead (ranging 0-100), whereby the user must change “hum_method” to 1 in airsea.nml (accessed under the “Parameters” menu in WET).
Alternative 2: wet bulp temperature (°C) may be used instead, whereby the user must change “hum_method” to 2 in airsea.nml (accessed under the “Parameters” menu in WET).

8.       Cloud cover fraction (ranging 0-1) [-]

 

The file must be saved in tab or space delimited ascii (text) format and have the filename and extension “meteo_file.dat”. Note the fixed format of the date (yyyy-mm-dd) and time (hh:mm:ss), which must be followed. If a file is prepared in MS Excel, note that MS Excel may change the date and time formats (each single time the file is opened in excel), and users may therefore need to change the date and time formats in excel just before saving file in a tab or space delimited text file. 

 

An example of a meteo_file.dat file of correct format can be found here.

 

2. Preparing inflow.dat

In WET, the inflow data file currently represents the aggregated inflow for the entire system. Hence, if data from multiple inflows exist, these should be aggregated into a total inflow value. Note that the model will automatically interpolate (by linear interpolation) between inflow values listed in the file. This means that data in the inflow file do not need to be equidistant (i.e. the time step may vary in the inflow file, for example reflecting actual gauging dates).

The inflow data file comprises three columns including (in this order):

1.       Date [yyyy-mm-dd]
2.       Time [hh:mm:ss]
3.       Discharge [m3/s]

 

An example of an inflow.dat file of correct format can be found here.


3. Preparing inflow_chem.dat

In WET, the inflow chemistry data file currently represents the aggregated inflow for the entire system. Hence, if nutrient data from multiple inflows exist, these should be aggregated into a total inflow value (i.e. flow-weighted inflow concentrations). Note that the model will automatically interpolate (by linear interpolation) between concentration values listed in the file. This means that data in the inflow chemistry file do not need to be equidistant (i.e. the time step may vary in the inflow file, for example reflecting data and dates of actual sampling dates).

The inflow chemistry data file comprises nine columns including (in this order):

1.       Date [yyyy-mm-dd]
2.       Time [hh:mm:ss]
3.       Particulate organic phosphorus concentration (PPOM) [mg P/L]
4.       Dissolved organic phosphorus concentration (PDOM) [mg P/L]
5.       Phosphate concentration [mg P/L]
6.       Particulate organic nitrogen concentration (NPOM) [mg N/L]
7.       Dissolved organic nitrogen concentration (NDOM) [mg N/L]  
8.       Nitrate concentration [mg N/L]
9.       Ammonium concentration [mg N/L]

 

An example of an inflow_chem.dat file of correct format can be found here.

Papers

WET was originally developed by: Nielsen, A., Bolding, K., Hu, F. and Trolle, D. 2017. The original publication on the concept of WET was published in Environmental Modelling and Software. Please cite this publication when using WET:

 

Nielsen, A., Bolding, K., Hu, F. and Trolle, D. 2017. An open source QGIS-based workflow for model application and experimentation with aquatic ecosystems. Environmental Modelling and Software 95: 358-364.

 

The aquatic ecosystem core of WET is the FABM-PCLake model. FABM-PCLake was developed by Hu et al. 2016, and can be cited as:

 

Hu, F., Bolding, K., Bruggeman, J., Jeppesen, E., Flindt, M. R., van Gerven, L., Janse, J. H., Janssen, A. B. G., Kuiper, J. J., Mooij, W. M., and Trolle, D. 2016. FABM-PCLake – linking aquatic ecology with hydrodynamics. Geoscientific Model Development 9: 2271-2278.

Wikis

Wiki pages for WET and FABM-PCLake will soon be available here

Instructional videos

The instructional videos have been created mainly to support new users of WET. The videos are voice-over screencasts that demonstrate how users can access, install and apply the software.

User groups

There are separate user groups for WET and FABM-PCLake (code), both hosted on the Gitlab pages. The "Issues" board on the WET and FABM-PCLake Gitlab pages effectively comprises our User Group forums. Here, you may read through the posts and answers by other users, and post your own issues or ideas for new developments.