GRASS-HRU

From ILMS-Wiki
(Difference between revisions)
Jump to: navigation, search
(Schritt 4: Outlet Watersheds)
(Download)
 
(76 intermediate revisions by 4 users not shown)
Line 1: Line 1:
[[Bild:Grasshru.png|thumb|rechts|GRASS-HRU]] The complete process chain for the HRU derivation was implemented according to a service-oriented application in GRASS-GIS. The execution enironment is strictly separated from the operating environment by using a preconfigured, virtual machine which is in charge of data preparation and the calculation of HRUs in GRASS-GIS. A plug-in developed for QGIS creates an intuitive, wizard-driven and transparent environment for the execution of the process chain.
+
[[de:GRASS-HRU]]
 +
[[pt:GRASS-HRU]]
 +
[[File:Grasshru.png|thumb|rechts|GRASS-HRU]] The complete process chain for the HRU derivation was implemented according to a service-oriented application in GRASS-GIS. The execution environment is strictly separated from the operating environment by using a preconfigured, virtual machine which is in charge of data preparation and the calculation of HRUs in GRASS-GIS. A plug-in developed for QGIS creates an intuitive, wizard-driven and transparent environment for the execution of the process chain.
  
==Download and Installation of GRASS-HRU==
+
== Download/Installation of GRASS-HRU==
  
=== Downloading the hard disk image (''Virtual Appliance'') and QGIS-Plugin  ===
+
=== Download ===
The following files should be downloaded from http://www.geoinf.uni-jena.de:
+
*grass-hru.mf
+
*grass-hru.ovf
+
*grass-hrus.vmdk
+
Together they create a so-called ''Virtual Appliance'' which will be required in the following section.
+
In addition, the QGIS plug-in for HRU derivation should be downloaded from the same website:
+
*hruwps.zip
+
  
=== Installing the VirtualBox ===
+
Use the installation package for a complete and easy installation:
[[Bild:Vbox_setup.jpg|thumb|links|Installation von VirtualBox]]
+
The derivation of HRUS with GRASS-GIS, which will be explained below, requires a virtualization software which hosts a linux system and all software and scripts needed. VirtualBox should be used - the current version 3.2.10 can be downloaded at
+
http://www.virtualbox.org/wiki/Downloads.
+
The wizard leads you through the steps of the installation process. It should be noted that:
+
*a temporary deactivation of the network connection is necessary and therefore not unusual
+
*all necessary drivers should be installed
+
  
After a successful installation VirtualBox can be launched and the import of a preconfigured hard disk image can start:
+
{| class="wikitable"
# Datei -> Appliance importieren
+
|-
# Load the Appliance under '''Auswählen''' (see above) (file ''grass-hru.ovf'')<br/>[[Bild:Import_app.jpg]]<br/><br/>
+
! !! Download
# Apply the imported configuration of the Appliance and end the import process with '''Abschließen''' <br/>[[Bild:Import_app_2.jpg]]<br/><br/>
+
|-
# The appliance is being imported...<br/>[[Bild:Import_app_3.jpg]]<br/><br/>
+
| Installer (Windows) || [<!--http://www.geoinf.uni-jena.de/~c3schs/grass-hru/ILMS-3.1.zip-->http://jams.uni-jena.de/ilmswiki/files/ILMS_v3.1_2.zip ILMS_v3.1_2.zip]
# ...and will be available through an entry in the VirtualBox main window (GRASS-HRU 1.0)<br/>[[Bild:Import_app_4.jpg]]<br/><br/>
+
|}
  
=== Installing QuantumGIS ===
+
(follow the instructions given [[GRASS-HRU_Manual_install|here]] to do a manual installation of GRASS-HRU)
[[Bild:Qgis_setup.jpg|thumb|links|Installation von QunatumGIS]]The current version of QuantumGIS is available at http://www.qgis.org/wiki/Download. The ''Standalone Installer'' is recommended - the download address for version 1.6 is http://qgis.org/downloads/QGIS-OSGeo4W-1.6.0-14615-Setup.exe.
+
Please note: For the HRU derivation the GRASS plug-in for QuantumGIS is not required but it is included in the installer version 1.6. As an alternative, the installer version 1.4 of QuantumGIS can be used, which does not install a GRASS plug-in and therefore reduces the filesize. (http://qgis.org/downloads/QGIS-1.4.0-1-No-GrassSetup.exe)
+
  
===Installing the Plug-in===
+
=== Installation ===
To install the actual plug-in for HRU derivation in QuantumGIS the following steps have to be followed:
+
For installing the GRASS-HRU software package, please follow these steps:
# Unzip the zip archive ''hruwps.zip'', which has been dowloaded (see above), into the plug-in file of QuantumGIS. According to the QuantumGIS version the folder is called
+
# Unpack the downloaded GRASS-HRU archive in your desired location
#*../QuantumGIS/python/plugins ''or''
+
# <span style="color:red;">Currently, the automatic detection of 32/64 bit system failed in some cases - so it is recommended to edit the setup.cfg manually ("version" in section "general": "32bit" or "64bit")</span> 
#*../QuantumGIS/apps/qgis/python/plugins
+
# Choose the setup file (setup.exe) and execute it as an administrator (right click the file -> Execute as Administrator)
# start QuantumGIS
+
# Whenever asked for permission to install software/drivers during setup, please confirm
# Plugins -> Plugins verwalten<br/>[[Bild:Qgis_plugin_2.jpg]]<br/><br/>
+
# During installation, you are prompted to restart the computer – please quit setup, reboot and restart the setup script (with administrator rights) again
# Search for ''HRU WPS-Client'' in the ''QGIS Plugin Manager'', activate it and confirm with '''Ok''' <br/>[[Bild:Qgis_plugin.jpg]]<br/><br/>
+
# Once the installation has finished, close the installer by pressing the "exit setup" button
# The tool for HRU derivation can be started by using a separate button in the menu bar<br/>[[Bild:Qgis_plugin_3.jpg]]<br/><br/>
+
  
==Preparation==
+
==Starting GRASS-HRU==
Before starting the HRU derivation, the following steps have to be completed:
+
In order to start the HRU delineation process, please start GRASS-HRU as follows:
# Run the newly created ''Virtual Appliance'' with the name "GRASS-HRU 1.0" by double-clicking on the corresponding entry on the VirtualBox window (or the button "Starten"). The following boot process in a separate window has to be carried out completely and can be minimized when the login prompt appears (do'''not''' close!). The virtual machine is working in the background during the whole HRU derivation process.<br/>[[Bild:Start_app_1.jpg]]<br/>Please note: By entering http://localhost in the address bar of the internet browser you can check if the virtual machine has been successfully started and if a connection with the machine is possible. A website containing the words "It works!" should appear.
+
# Click on ''Extras -> Netzlaufwerk verbinden'' in the Windows explorer and enter it as file '''http://localhost/in'''. Additionally, you can choose a free hard disk letter, e.g. '''Z:'''<br/>[[Bild:Start_app_2.jpg]]<br/><br/>All input data should now be stored in this folder. The existing subfolder ''/gehlberg'' contains example data for input and result layers. New subfolders for the required input data can be created in the new network folder.
+
# Now the plug-in can be started from QuantumGIS. In order to do so, start QuantumGIS and click on the GRASS-HRU-Icon (see above) - the plug-in for HRU derivation opens. By clicking on the magnifying glass to the right of the address bar a message on successful connection should appear. <br/>[[Bild:Grass_hru_1.jpg]]<br/><br/>
+
  
==Details on the HRU derivation Using the Wizard==
+
# From the GRASS-HRU installation folder, please start the GRASS-HRU Launcher by double-clicking GRASS-HRU.exe
 +
# From the menu bar, start the GRASS server appliance by clicking the green start icon and wait, until the appliance has fully booted
 +
# Press the GRASS-HRU@QGIS button to launch the bundled QGIS version
 +
# Activate the GRASS-HRU plugin in QGIS by following these steps:
 +
#* choose "Plugins -> Manage Extension..." from the QGIS menu
 +
#* tick the checkbox in front of GRASS-HRU
 +
# Start the GRASS-HRU wizard by choosing its launcher button from the toolbar: [[File:Grasshru.png|30x30px|text-bottom]]
 +
# After you have finished using GRASS-HRU, stop the GRASS server appliance by clicking the red stop button
 +
 
 +
==Details on the HRU Derivation Using the Wizard==
 
===Step 0: Setup===
 
===Step 0: Setup===
 
*Selection of the digital terrain model (DGM) in GeoTiff format and a shapefile format, each by using the button ''Datei'' next to the input field.
 
*Selection of the digital terrain model (DGM) in GeoTiff format and a shapefile format, each by using the button ''Datei'' next to the input field.
*Selection of additional data layers (land use, soil, geology) by clicking on the button ''Hinzufügen'' to the right hand side of the ''Data Layer'' chart.
+
*Selection of additional data layers (land use, soil, geology) by clicking on the add button on the right hand side of the ''Data Layer'' chart. For each of the entries, right click it and choose the appropriate parameter file name
 
*Opening a  bounding box (first left mouse click: top left-hand corner, second left mouse click: bottom right-hand corner, right mouse click: delete bounding box). The resulting bounding box should comprise the complete catchment area to be analysed.  
 
*Opening a  bounding box (first left mouse click: top left-hand corner, second left mouse click: bottom right-hand corner, right mouse click: delete bounding box). The resulting bounding box should comprise the complete catchment area to be analysed.  
[[Bild:Grass_hru_2.jpg]]
+
[[File:Grass_hru_2.jpg]]
  
 
===Step 1: Preparation===
 
===Step 1: Preparation===
 
*It is possible to delete local sinks from the DGM. In case the current DGM has not been filled yet, ''default filling'' should be selected from the methodology list.
 
*It is possible to delete local sinks from the DGM. In case the current DGM has not been filled yet, ''default filling'' should be selected from the methodology list.
*For the calculation of slope and slope oreintation no further input is neccessary.
+
*For the calculation of slope and slope orientation no further input is necessary.
[[Bild:Grass_hru_3.jpg]]
+
[[File:Grass_hru_3.jpg]]
  
 
===Step 2: Reclass===
 
===Step 2: Reclass===
*According to the different indices (DEM, Slope und Aspect) the corresponding map is classified.
+
*According to the different indices (DEM, Slope and Aspect) the corresponding map is classified.
 
*The standard areas and values can be applied or modified. In case of a modification values cannot be below or above the corresponding minima and maxima.  
 
*The standard areas and values can be applied or modified. In case of a modification values cannot be below or above the corresponding minima and maxima.  
 
*If a data set should not be used for HRU derivation, it can be deselected (Checkbox ''not required'').
 
*If a data set should not be used for HRU derivation, it can be deselected (Checkbox ''not required'').
[[Bild:Grass_hru_4.jpg]]
+
[[File:Grass_hru_4.jpg]]
  
 
===Step 3: Waterflow===
 
===Step 3: Waterflow===
 
*For the derivation of the water supply network, flow accumulation and flow direction and for partial catchment areas a threshold value ''Minimum Size Of Basins'' is required.
 
*For the derivation of the water supply network, flow accumulation and flow direction and for partial catchment areas a threshold value ''Minimum Size Of Basins'' is required.
*This parameter determines, for example, the degree of detail of the water network or the number of partial catchment areas. The threshold value determines the smalles, derivable partial catchment area and is indicated in cells (number of pixels).
+
*This parameter determines, for example, the degree of detail of the water network or the number of partial catchment areas. The threshold value determines the smaller, derivable partial catchment area and is indicated in cells (number of pixels).
 
*Example: A value of 1500 (and an assumed solution of 25m) results in a designation of partial catchment areas bigger than (1500*25*25)/1000000 = 0.9375km² ~ 1km².   
 
*Example: A value of 1500 (and an assumed solution of 25m) results in a designation of partial catchment areas bigger than (1500*25*25)/1000000 = 0.9375km² ~ 1km².   
[[Bild:Grass_hru_5.jpg]]
+
[[File:Grass_hru_5.jpg]]
  
 
===Step 4: Outlet Watersheds===
 
===Step 4: Outlet Watersheds===
*The following steps are neccessary for the calculation of a map showing partial watersheds derived from their water levels:
+
*The following steps are necessary for the calculation of a map showing partial watersheds derived from their water levels:
 
*#Pan the water level and supply map up in the key, so both data sets are visible.
 
*#Pan the water level and supply map up in the key, so both data sets are visible.
*#Check with the zoom tool wether the singular water levels lie exactly on the derived water supply network. If not, modify the level layer until '''all levels in the watershed''' lie on the water sections. To do so, please proceed as follows:  
+
*#Check with the zoom tool whether the singular water levels lie exactly on the derived water supply network. If not, modify the level layer until '''all levels in the watershed''' lie on the water sections. To do so, please proceed as follows:  
*##Select the level layer on the key and activate the vector editing mode of QuantumGIS [[Bild:Qgis_tool_1.jpg|30px]]  
+
*##Select the level layer on the key and activate the vector editing mode of QuantumGIS [[File:Qgis_tool_1.jpg|30px]]  
*##Take the tool for panning vector points [[Bild:Qgis_tool_2.jpg|30px]] and relocate the corresponging watersheds  
+
*##Take the tool for panning vector points [[File:Qgis_tool_2.jpg|30px]] and relocate the corresponding watersheds  
*##Finally, cancel the edit mode by clicking on [[Bild:Qgis_tool_1.jpg|30px]] again and agree to save changes
+
*##Finally, cancel the edit mode by clicking on [[File:Qgis_tool_1.jpg|30px]] again and agree to save changes
*#If all water levels in the catchment area have the correct position in the water network, those levels relevant to the calculation have to be selected - use the marker tool [[Bild:Qgis_tool_3.jpg|30px]].  
+
*#If all water levels in the catchment area have the correct position in the water network, those levels relevant to the calculation have to be selected - use the marker tool [[File:Qgis_tool_3.jpg|30px]].  
 
*Choose the shapefile attribute on the selection list ''Name of corresponding attribute (ID)'' which represents a unique parameter for the level ('''integer and > 0''', e.g. level ID).  
 
*Choose the shapefile attribute on the selection list ''Name of corresponding attribute (ID)'' which represents a unique parameter for the level ('''integer and > 0''', e.g. level ID).  
[[Bild:Grass_hru_6.jpg]]
+
[[File:Grass_hru_6.jpg]]
 +
 
 +
===Step 5: Overlay===
 +
*The intersection of all data layers creates small areas (specific layers can be disregarded by deselecting them). Those areas are not suitable as HRUs and should therefore be eliminated.
 +
*For this purpose a threshold value is defined (''Size of smallest area to remove'') which determines the minimum size of an HRU (in cells).
 +
*Example: A value of 8 (and an assumed solution of 25m) results in a designation of HRUs which is bigger than (8*25*25) = 5000m² =0.5ha 
 +
[[File:Grass_hru_7.jpg]]
 +
 
 +
===Step 6: Topology===
 +
*For the determination of the topological connection of HRUs (and water segments) no specific parameter input is necessary.
 +
*The module calculates
 +
**the N:1 topology (HRUs can drain in only one neighboring HRU/river section)
 +
**the N:M topology (HRUs can drain in several neighboring HRUs/river sections)
 +
**water topology (topological combination of all river sections)
 +
*The option ''Enable discrete reaches'' is an extension of the topological derivation and its development has not yet been finished.
 +
[[File:Grass_hru_8.jpg]]
  
===Schritt 5: Overlay===
+
===Step 7: Statistics===
*Bei der Verschneidung aller Datenlayer (bestimmte Layer können durch Abwählen auch unberücksichtigt bleiben) entstehen Kleinstflächen, welche als HRUs ungeeignet sind und deswegen eliminiert werden sollten.
+
*The existing HRU map in grid format (Geo Tiff) is now converted into a shapefile. In doing so, additional features of a single HRU can be selected which are taken to the attribute chart or are supposed to be calculated.  
*Zu diesem Zweck wird ein Schwellenwert definiert (''Size of smallest area to remove''), welcher die Minimumgröße einer HRU (in Zellen) festlegt.
+
[[File:Grass_hru_9.jpg]]
*Beispiel: Ein Wert von 8 (und eine angenommene Auflösung von 25m) führt zur Ausweisung von HRUs, welche größer als (8*25*25) = 5000m² =0.5ha sind. 
+
[[Bild:Grass_hru_7.jpg]]
+
===Schritt 6: Topology===
+
*Für die Bestimmung der topologischen Verknüpfung von HRUs (und Gewässersegmenten) ist keine gesonderte Parametereingabe erforderlich.
+
*Das Modul berechnet
+
**die N:1 Topologie (HRUs können in nur eine benachbarte HRU/einen Gewässerabschnitt entwässern)
+
**die N:M Topologie (HRUs können in mehrere benachbarte HRUs/Gewässerabschnitte entwässern)
+
**die Gewässertopologie (topologische Verknüpfung aller Gewässersegmente)
+
*Die Option ''Enable discrete reaches'' ist eine Erweiterung des Verfahrens zur Topologie-Ableitung und momentan in der Entwicklung noch nicht abgeschlossen.
+
[[Bild:Grass_hru_8.jpg]]
+
===Schritt 7: Statistics===
+
*Die bis hierher im Rasterformat vorliegende HRU-Karte (GeoTiff) wird in diesem Schritt in ein Shapefile konvertiert, wobei ausgewählt werden kann, welche zusätzlichen Eigenschaften einer einzelnen HRU in die Attributtabelle übernommen bzw. berechnet werden sollen.
+
[[Bild:Grass_hru_9.jpg]]
+

Latest revision as of 19:05, 4 March 2019

GRASS-HRU
The complete process chain for the HRU derivation was implemented according to a service-oriented application in GRASS-GIS. The execution environment is strictly separated from the operating environment by using a preconfigured, virtual machine which is in charge of data preparation and the calculation of HRUs in GRASS-GIS. A plug-in developed for QGIS creates an intuitive, wizard-driven and transparent environment for the execution of the process chain.

Contents

Download/Installation of GRASS-HRU

Download

Use the installation package for a complete and easy installation:

Download
Installer (Windows) ILMS_v3.1_2.zip

(follow the instructions given here to do a manual installation of GRASS-HRU)

Installation

For installing the GRASS-HRU software package, please follow these steps:

  1. Unpack the downloaded GRASS-HRU archive in your desired location
  2. Currently, the automatic detection of 32/64 bit system failed in some cases - so it is recommended to edit the setup.cfg manually ("version" in section "general": "32bit" or "64bit")
  3. Choose the setup file (setup.exe) and execute it as an administrator (right click the file -> Execute as Administrator)
  4. Whenever asked for permission to install software/drivers during setup, please confirm
  5. During installation, you are prompted to restart the computer – please quit setup, reboot and restart the setup script (with administrator rights) again
  6. Once the installation has finished, close the installer by pressing the "exit setup" button

Starting GRASS-HRU

In order to start the HRU delineation process, please start GRASS-HRU as follows:

  1. From the GRASS-HRU installation folder, please start the GRASS-HRU Launcher by double-clicking GRASS-HRU.exe
  2. From the menu bar, start the GRASS server appliance by clicking the green start icon and wait, until the appliance has fully booted
  3. Press the GRASS-HRU@QGIS button to launch the bundled QGIS version
  4. Activate the GRASS-HRU plugin in QGIS by following these steps:
    • choose "Plugins -> Manage Extension..." from the QGIS menu
    • tick the checkbox in front of GRASS-HRU
  5. Start the GRASS-HRU wizard by choosing its launcher button from the toolbar: Grasshru.png
  6. After you have finished using GRASS-HRU, stop the GRASS server appliance by clicking the red stop button

Details on the HRU Derivation Using the Wizard

Step 0: Setup

  • Selection of the digital terrain model (DGM) in GeoTiff format and a shapefile format, each by using the button Datei next to the input field.
  • Selection of additional data layers (land use, soil, geology) by clicking on the add button on the right hand side of the Data Layer chart. For each of the entries, right click it and choose the appropriate parameter file name
  • Opening a bounding box (first left mouse click: top left-hand corner, second left mouse click: bottom right-hand corner, right mouse click: delete bounding box). The resulting bounding box should comprise the complete catchment area to be analysed.

Grass hru 2.jpg

Step 1: Preparation

  • It is possible to delete local sinks from the DGM. In case the current DGM has not been filled yet, default filling should be selected from the methodology list.
  • For the calculation of slope and slope orientation no further input is necessary.

Grass hru 3.jpg

Step 2: Reclass

  • According to the different indices (DEM, Slope and Aspect) the corresponding map is classified.
  • The standard areas and values can be applied or modified. In case of a modification values cannot be below or above the corresponding minima and maxima.
  • If a data set should not be used for HRU derivation, it can be deselected (Checkbox not required).

Grass hru 4.jpg

Step 3: Waterflow

  • For the derivation of the water supply network, flow accumulation and flow direction and for partial catchment areas a threshold value Minimum Size Of Basins is required.
  • This parameter determines, for example, the degree of detail of the water network or the number of partial catchment areas. The threshold value determines the smaller, derivable partial catchment area and is indicated in cells (number of pixels).
  • Example: A value of 1500 (and an assumed solution of 25m) results in a designation of partial catchment areas bigger than (1500*25*25)/1000000 = 0.9375km² ~ 1km².

Grass hru 5.jpg

Step 4: Outlet Watersheds

  • The following steps are necessary for the calculation of a map showing partial watersheds derived from their water levels:
    1. Pan the water level and supply map up in the key, so both data sets are visible.
    2. Check with the zoom tool whether the singular water levels lie exactly on the derived water supply network. If not, modify the level layer until all levels in the watershed lie on the water sections. To do so, please proceed as follows:
      1. Select the level layer on the key and activate the vector editing mode of QuantumGIS Qgis tool 1.jpg
      2. Take the tool for panning vector points Qgis tool 2.jpg and relocate the corresponding watersheds
      3. Finally, cancel the edit mode by clicking on Qgis tool 1.jpg again and agree to save changes
    3. If all water levels in the catchment area have the correct position in the water network, those levels relevant to the calculation have to be selected - use the marker tool Qgis tool 3.jpg.
  • Choose the shapefile attribute on the selection list Name of corresponding attribute (ID) which represents a unique parameter for the level (integer and > 0, e.g. level ID).

Grass hru 6.jpg

Step 5: Overlay

  • The intersection of all data layers creates small areas (specific layers can be disregarded by deselecting them). Those areas are not suitable as HRUs and should therefore be eliminated.
  • For this purpose a threshold value is defined (Size of smallest area to remove) which determines the minimum size of an HRU (in cells).
  • Example: A value of 8 (and an assumed solution of 25m) results in a designation of HRUs which is bigger than (8*25*25) = 5000m² =0.5ha

Grass hru 7.jpg

Step 6: Topology

  • For the determination of the topological connection of HRUs (and water segments) no specific parameter input is necessary.
  • The module calculates
    • the N:1 topology (HRUs can drain in only one neighboring HRU/river section)
    • the N:M topology (HRUs can drain in several neighboring HRUs/river sections)
    • water topology (topological combination of all river sections)
  • The option Enable discrete reaches is an extension of the topological derivation and its development has not yet been finished.

Grass hru 8.jpg

Step 7: Statistics

  • The existing HRU map in grid format (Geo Tiff) is now converted into a shapefile. In doing so, additional features of a single HRU can be selected which are taken to the attribute chart or are supposed to be calculated.

Grass hru 9.jpg

Personal tools
In other languages