Skip to content

Commit d13e6fc

Browse files
authored
Update README.md
1 parent c3a0aef commit d13e6fc

1 file changed

Lines changed: 43 additions & 0 deletions

File tree

README.md

Lines changed: 43 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,2 +1,45 @@
11
# QRaven
22
A QGIS Plugin to help generate input files for Raven
3+
4+
## Description
5+
6+
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 (except for the hydrological processes at the moment) and it automates the setup, as well as the use of the BasinMaker python library.
7+
8+
## Getting Started
9+
10+
### Dependencies
11+
12+
* QGIS (3.24 and above) must be installed. Prior versions may not work with the plugin
13+
* 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
14+
* QRaven works on Linux and should work on Windows and Mac as well
15+
16+
### Installing
17+
18+
* Go to the releases page and dowload the .zip file : https://github.com/Scriptbash/QRaven/releases
19+
* Open QGIS, go to "Plugins", click on "Manage and Install plugins". Finally, click on the "Install from ZIP" menu, select the dowloaded .zip file and click on "Install"
20+
21+
### How to use QRaven
22+
23+
* Click on the QRaven icon in your toolbar ![image](https://user-images.githubusercontent.com/98601298/162262632-ead9b9aa-2034-4e5b-bba2-859040995ed5.png) or go in the "Plugins" menu, select the QRaven option and click on "Generate Raven input files"
24+
* You will have two main tabs
25+
* Raven RVI
26+
* BasinMaker RVH
27+
28+
* Raven RVI tab
29+
* Use this tab to create your RVI file. The plugin __does not__ validate your inputs, meaning that the RVI file generated may not work in Raven if the configuration you make is invalid
30+
* Select and enter all the information you want to add inside the RVI file. Once your are 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 you have write permissions to it
31+
* Screenshots
32+
* ![image](https://user-images.githubusercontent.com/98601298/162264611-48160e69-9435-49f0-ae0f-5b6d912644d5.png)
33+
* ![image](https://user-images.githubusercontent.com/98601298/162264955-e076fcb2-9c10-4fd6-981e-1472dcf7ae60.png)
34+
* BasinMaker RVH tab
35+
* Use this tab to lauch BasinMaker and generate the RVH files
36+
* This section is still in development, coming soon...
37+
38+
39+
40+
41+
42+
43+
## Help
44+
45+
If you run into any issue, question or feedback while using QRaven, please open an issue here : https://github.com/Scriptbash/QRaven/issues

0 commit comments

Comments
 (0)