This repo is archived

Development will continue on https://github.com/HHNK/leggertool

Legger

Toolset for assigning 'legger' profiles to channels (hydro objects), based on the water gradiant calculated with 3di model results

Current version is tested for QGIS version 3.4 and 3.12 and ThreeDiToolbox version 1.13

Installation

Steps for installation of this QGIS plugin:

1. Make sure the 64-bit version of QGIS 3.4 or higher is installed.

2. Install the 3di QGIS plugin. See installation instruction on: https://github.com/nens/threedi-qgis-plugin/wiki

3. The following Python packages are required for the tool, that don't (necessarly) come with every QGIS package:

   • shapely
   • pandas
   • descartes

   If these packages indeed are missing, download the wheels for pandas 0.23.4 and descartes 1.1.0 Download shapely from the site: https://www.lfd.uci.edu/~gohlke/pythonlibs/#shapely Probably you need the version Shapely‑1.xxx.xxx‑cp37‑cp37m‑win_amd64.whl

4. Find the program root of your QGIS installation or OSGeo4w64 installation (Windows Batch file). Start the commandline through the OSGeo4W??.bat file. Check if everything is working well be testing with the command pip. Sometimes you first have to run the command bin\py3_env.bat

5. For PANDAS and DESCARTES: It might be required to update pip before installing pandas and descartes:

    python -m pip install --upgrade pip
    pip install wheel
   

   Then:

    python -m pip install path/to/wheel/wheel.whl
   

   or navigate to folder where wheel is downloaded to and:

    python -m pip install wheel.whl
   

   A short-cut might be to not work with wheels. It's a bit faster, but be careful with package versions. Type in command prompt, and replace between <..> with package name (like pandas), example:

    python -m pip install <package>
   

6. For installing SHAPELY start a command prompt (cmd) and go to the QGIS or OSgeo4w64 root directory (cd xxxx) First remove the old version of shapely

    del apps\python37\lib\site-packages\shapely.pth
   

   and install new version

   bin\python -m pip install --force-reinstall <<path to downloaded whl file>>
   

7. Copy the legger tool directory (the directory containing this readme) to the qgis plugin folder This folder is situated under: <>\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\legger

   Make sure the name of the folder is called "legger"

Alternative steps

8. If the plugin doesn't recognize packages (like the just installed pandas and descartes) you can copy the packages to: <>\AppData\Roaming\QGIS\QGIS3\profiles\default\python\plugins\legger\external

   In practice that means you already have a Python installed where these packages can be installed to. Just make sure you have Python 3.7.x installed when you decide to take this route.

development remarks

after adding an icon in the media folder and link in the file resources.qrc, generate a new resources.py with the command:

pyrcc4 -o resources.py resources.qrc