QRaven

A QGIS Plugin to help generate input files for Raven

QRaven aims to simplify the creation of the primary input file (.RVI) and HRU/Basin definition file (.RVH) for the Raven hydrological modelling framework. It allows the user to choose all the options for the RVI file and it automates the setup, as well as the use of the BasinMaker python library. It can run a model, draw the hydrograph and open RavenView using the default web browser.

• QGIS (3.20 and above) must be installed. Prior versions may not work with the plugin
  • https://qgis.org/en/site/forusers/download.html
• To use the BasinMaker options, Docker must be installed on your computer and properly configured. Linux users must make sure to follow the post-installation steps provided by Docker
  • https://docs.docker.com/get-docker/
• QRaven works on Linux and Windows. It should work on Mac as well, but testing must be done

• Go to the releases page and download the .zip file : https://github.com/Scriptbash/QRaven/releases
• Open QGIS, go to "Plugins", click on "Manage and Install plugins"

• Finally, click on the "Install from ZIP" menu, select the downloaded .zip file and click on "Install"

• Click on the QRaven icon in your toolbar or go in the "Plugins" menu, select the QRaven option and click on "Generate Raven input files"

• You will have three main tabs

  • Raven RVI
  • BasinMaker RVH
  • Run Model

• Raven RVI tab

  • Use this tab to create the RVI file. The plugin does not validate the inputs, meaning that the RVI file generated may not work in Raven if the configuration made is invalid

  • Select and enter all the information to add inside the RVI file. Once done, click on the "Write" button to generate the RVI file. Make sure to have selected a valid directory inside the "Output Directory" field and that your user has write permissions to it

  • Screenshots

    

    

    

• BasinMaker RVH tab

  • Use this tab to launch BasinMaker and generate the RVH files

  • This section was tested on Linux and Windows, but needs to be tested MacOS

  • Like the RVI file, select the parameters values and select the files to process

  • When a file is added, more parameters fields unlock and will need to be filled

  • At the end of the process, the shapefile results are added to the QGIS canvas and the results folder is copied in the output directory chosen

  • Screenshots

    

    

    

• Run Model tab

  • Use this tab to run your Raven model. This section basically attempts to mimic the RavenViewLite4 Excel file

  • A Raven executable must be provided as well as an input and output directory

  • The file name prefix is the same name as the model

  • The RunName is only required if the command :RunName is used in the .rvi file

  • Once Raven has finished processing the model, the hydrograph can be viewed by clicking on the "Draw hydrograph" button

  • By clicking on the RavenView button, RavenView will open a new tab in the user's default web browser

  • Screenshots

    

    

If you run into any issue, have a question or feedback while using QRaven, please open an issue here : https://github.com/Scriptbash/QRaven/issues