Hydrological Analysis Using Whitebox Geospatial Analysis Tools
Contents
Purpose
The purpose of this tutorial is to guide the user through the process of analyzing the hydrology of an area based on the local elevations. This tutorial uses the opensource software Whitebox Geospatial Analyst Tools and explores some of the most useful of the hydrology tools included in it. The intent of this tutorial is for the user to understand the process underwent, an to be able to build off of it for their specific purposes.
This tutorial assumes that the user has some experience with GIS software.
Introduction
This tutorial uses Whitebox 3.4.0, an open source GIS software that was developed within the In the Center for Hydrogeomatics in Guelph University. As a result this software package has a heavy focus on hydrological analysis. For this reason Whitebox was chosen for this tutorial on hydrological analysis. The area of focus in this tutorial is Calabogie Ontario. This location was chosen because the Calabogie peak adds some relief to the area, and the author knew it well enough to tell if there were any errors that occurred during the process.
This tutorial uses a single input, a Digital Elevation model, and produces a multitude of outputs from it, adding information that could be used for future analysis. The process that will be undergone in this tutorial is displayed in the image below. To understand the context of each tool used in this tutorial please refer back to this image as needed.
Data Acquisition
In this tutorial the only necessary layer is a Digital Elevation Model (DEM) file of your area of interest. In this tutorial we are focusing on Calabogie, ON. It is recommended that you use tthis same dataset for following along. It can be acquired and downloaded here. A sample of this data is shown bellow.
For the event that the dropbox link has become inactive the process of obtaining this data is described below to make this tutorial relevant for longer. Access the Government of Canada Geospatial Data Extraction Application here.
In the “Select Clipping Area” bar enter change the selection to "Predefined Clipping Area" and then select "Drainage areas" from the drop down list that appears.
This produces a long list of sequential drainage area names. Search through the names until you find "02KE000" and select it. I found this on the 17th page of drainage area names.
The map extent on the right side of the web page should now match the image below.
Under “Select Data to be extracted” Select “Elevation – Digital elevation model”.
Under “Select options and submit job” fill all of the required boxes so that it matches the figure below. Make sure to enter the email address that you would like to have the file sent to in the “Email Address” field.
An email will be sent to the entered email address shortly which contains a URL for the direct download of the data.
If neither of these options are available, any DEM in a tiff format can be used.
Acquiring and Installing Whitebox 3.4.0
Whitebox version: 3.4.0 (The current version of Whitebox as of 2017 is 3.4.0 and this was the version used for this tutorial. A list of the download links for Windows, Mac and Linux platforms can be found here.)
After the correct .zip file has been downloaded and extracted to your directory of choice the installation process is complete.
It is important that your machine has version 8 or higher of the Java SE Runtime Environment before trying to run Whitebox. This can be acquired here
Getting Started
Launching Whitebox 3.4.0
After the file has been extracted the contents should look similar to the image below
Double click on the "WhiteboxGIS.jar" file in order to launch the program.
Note: If you are running Windows 10 on your computer you may need to double click on the "Whitebox.bat" file to launch it instead.
Setting up a working Directory
For this Tutorial I created a working directory before starting any analysis processes. This step is not necessary, though it will aid in the organization of this project. Create a folder called "WhiteboxTutorial", or something similar. Within this folder create one folder called "Data", and another called "DataProducts"
The final product will look like the image below.
Place the DEM.tif data file into the "Data" folder. All files created from the DEM file will be placed in the "DataProducts" folder. i.e. all files output by Whitebox tools while going through this tutorial. Also, project files will be saved directly within the "WhiteboxTutorial" folder itself.
Adding Elevation Data and Saving the Map Project
To add the elevation data to the project select the icon in the top left of the Whitebox window, highlighted in red in the image below. (or use the hotkey Ctrl + L)
A popup window will then appear. In this window navigate to the location of the Calabogie DEM data file and select open.
You will likely recive a popup message like the one below. Select okay to add your data to the map.
To save your project select "Save Map" under the "Cartography" tab. (or use the hotkey Ctrl + S)
In the pop up window that appears navigate to the location that you would like to save the project and select "Save".
You should now be ready for analysis.
Hydrological Analysis
Now that our preparation has been completed we can move on to the analysis section of this tutorial.
DEM Pre-Processing
Pre-processing is an important first step in any hydrological analysis as this process identifies and corrects all features within the DEM that may disrupt the flow analysis. More confidence can be put in the output of all future hydrological analysis with this data due to these corrections.
In this tutorial the "Fill Depressions"
Flow Pointer
Flow Accumulation
Isobasin
Extract Streams
Sub-basins
Watershed Analysis
Pour Points
Watershed
Conclusion
In conclusion, this tutorial was aimed to give the user the skills to create workflows using the QGIS Processing Toolbox while also creating a workshop for slope and terrain analysis. This tutorial also gives the user the very basic introduction into the GIS world of Python scripting as well. The Python scripts that were exported can be slightly edited to preform the same geoprocessing tasks but with different parameters if necessary.
Resource Links
QGIS version 2.18 Documentation
GDAL - Geospatial Data Abstraction Library
Interpolation - GIS Dictionary
Python - Learn Python the Hard Way
References
Crosetto, M., Tarantola, S., & Saltelli, A. (2000). Sensitivity and uncertainty analysis in spatial modelling based on GIS. Agriculture, Ecosystems and Environment, 81(1), 71-79. doi:10.1016/S0167-8809(00)00169-9
Hutchinson, M.F., 1998. Interpolation of Rainfall Data with Thin Plate Smoothing Splines – Part II: Analysis of Topographic Dependence. Journal of Geographic Information and Decision Analysis, vol.2, no. 2, pp. 152-167, 1998.
R.E. Crochiere and L.R. Rabiner. (1983). Multirate Digital Signal Processing. Englewood Cliffs, NJ: Prentice–Hall.
