Open source flood risk modelling toolbox for Canada!
Updated and tested against QGIS 3.16.14 (Qt 5.15.2)
We welcome/encourage any comments, bugs, or issues you have or find. Please create a GitHub 'issue' ticket (on the issue tab) to let us know about these things.
Happy flood risk modelling!
Check out the new documentation!
v1.1.0 is released with three major new features:
- Very nice sphinx/readTheDocs documentation thanks in large part to Dhanyatha. This is much easier to browse than the previous pdfs and facilitates preservation of previous, current, and development (and eventually French) versions of the manual.
- new module providing workflow and tools for performing sensitivity analysis on a L1 or L2 CanFlood models. This can be helpful in understanding and communicating the uncertainty in your model, as well as help identify which parameters should be prioritized during data collection.
- per-asset Sampling for Complex Geometries providing more flexibility in how hazard variables are sampled from complex geometires.
-
Ensure the QGIS version 'tested' above is installed and working on your system (Qgis all releases download page). Ensure the 'processing' plugin is installed and enabled in QGIS.
-
Ensure the required python packages or dependencies shown in the requirements file are installed. Typically, this step is skipped and users just attempt to use the tool until an error is thrown. As of last test, a default install of QGIS 3.16.6 included all the CanFlood dependencies except 'openpyxl' (needed by the 'results - BCA' tools). Instructions for installing additional python packages in QGIS are provided here.
-
Install the plugin from the QGIS repository (Plugins > Manage and Install... > All > search for CanFlood > Install). If a dependency error is thrown, see 'troubleshooting' below. If successful, you should see the three CanFlood buttons on your toolbar and a 'CanFlood' entry in the 'Plugins' menu.
-
If you're re-installing or upgrading, it is safest to first uninstall CanFlood and restart QGIS before continuing with a new install.
-
We recommend implementing the QGIS DEBUG logger for more detailed readouts and CanFlood model debugging. See this post for insturctions.
Install from the QGIS plugin repository.
As both QGIS and CanFlood are active open source projects, getting your installation configured can be challenging, especially if you lack admin privileges to your machine and have no pyqgis experience. Some installations of QGIS may not come pre-installed with all the required python packages and dependencies listed in the requirements file. If you get a ModuleNotFound error, your QGIS install does not have the required packages. This can easily be remedied by a user with admin privileges and working pyqgis knowledge. The following solution provides some guidance on installing third party python modules, but you'll likely need admin privileges.
To get started with CanFlood, we recommend reading the documentation and working through the tutorials.
As CanFlood is an active open-sourced project, users will often encounter errors which can be frustrating. To work through these errors, we recommend first checking to see if there is a similar issue on the above 'Issues' tab. If so, hopefully the thread will resolve the problem, if not, reply to the thread with more details on your problem and why the posted solution did not work.
If there is no issue ticket yet, follow the instructions here.
We agree. Consider contacting a CanFlood developer to sponsor improvement that suites your needs, or joining the development community. Whether you'd like to integrate CanFlood modelling with some existing local databases, or integrate some other flood risk models into your analysis, or develop new output styles, the CanFlood project wants to hear from you. Please post a new issue here with an 'enhancement' label.