Legacy Installation Guide

Requirements and warnings

This plugin has only been tested on Windows. No functionality on other platforms guaranteed and the installation will be different than the one explained below.

Installation requires external Python dependencies that need to be installed to the QGIS environment. This might cause issues and errors that I cannot predict especially when another module with external Python dependencies is installed. The entire risk as to the quality and performance is with you.

WARNING

This is the legacy installation method without the complementary installation script. Usage entirely at your own risk. Updates to this guide are not guaranteed when Python dependencies change.

Last updated: 26.7.2020

External Python module installation with administrator access

WARNING

This is the legacy installation method without the complementary installation script. Usage entirely at your own risk. Updates to this guide are not guaranteed when Python dependencies change.

Last updated: 26.7.2020 First we will install GDAL and Fiona. Due to QGIS functionalities this cannot be done automatically through pip and instead we need to download the modules ourselves. Go to: https://www.lfd.uci.edu/~gohlke/pythonlibs/ and find the files listed below.

You must download the right version depending on your operating system (32x OR 64x):

  • GDAL

    • GDAL-3.0.4-cp37-cp37m-win_amd64.whl (64-bit OS)

    • OR

    • GDAL-3.0.4-cp37-cp37m-win32.whl (32-bit OS)

  • Fiona

    • Fiona-1.8.13-cp37-cp37m-win_amd64.whl (64-bit OS)

    • OR

    • Fiona-1.8.13-cp37-cp37m-win32.whl (32-bit OS)

Next up: Start up OSGeo4W Shell as administrator (Important!).

This should pop up by searching in Windows start up menu. (Press windows key on your keyboard and type “OSGeo4W Shell”).

First, the OSGeo4w Shell must run a py3_env.bat file that is located in “Your QGIS installation folder path”bin.

So, to get there, you must type or copy in the OSGeo4W Shell:

cd /D "Your QGIS installation folder path without the quotes"\\bin

Next up, run the py3_env.bat file by typing in the Shell:

py3_env

To install the just downloaded files the OSGeo4W Shell must be in the same directory as the downloaded files. Go to where your GDAL-..-.whl and Fiona-…-.whl files are and copy the url (Example URL: F:\Users\nikke\Downloads).

We’ll change the OSGeo4W Shell location by typing or copying into the Shell:

cd /D "paste your url here without the quotes"
The GDAL and Fiona installation depends on which version of both you downloaded.
If you have the 64x bit version, type or copy these into the OSGeo4W Shell
Note: Install the GDAL file first.
python -m pip install GDAL-3.0.4-cp37-cp37m-win_amd64.whl

Press Enter and when installation is completed, type or copy:

python -m pip install Fiona-1.8.13-cp37-cp37m-win_amd64.whl

Else if you have the 32x bit versions, use these:

python -m pip install GDAL-3.0.4-cp37-cp37m-win32.whl

Press Enter and when installation is completed, type or copy in to the Shell:

python -m pip install Fiona-1.8.13-cp37-cp37m-win32.whl

Hopefully the installation succeeds without issues. Next up we will install geopandas. Type in the OSGeo4W Shell:

python -m pip install geopandas

Next, we will install python-ternary. Type in the OSGeo4W Shell:

python -m pip install python-ternary

Next, we will install sklearn. Type in the OSGeo4W Shell:

python -m pip install sklearn

Next, we will install seaborn. Type in the OSGeo4W Shell:

python -m pip install seaborn

Next, we will install powerlaw. Type in the OSGeo4W Shell:

python -m pip install powerlaw

And we are done! Installing the plugin itself is easy.

External Python module installation without administrator access

First we will install GDAL and Fiona. Due to QGIS functionalities this cannot be done automatically through pip and instead we need to download the modules ourselves. Go to: https://www.lfd.uci.edu/~gohlke/pythonlibs/ and find the files listed below. You must download the right version depending on your operating system (32x OR 64x):

  • GDAL

    • GDAL-3.0.4-cp37-cp37m-win_amd64.whl (64-bit OS)

    • OR

    • GDAL-3.0.4-cp37-cp37m-win32.whl (32-bit OS)

  • Fiona

    • Fiona-1.8.13-cp37-cp37m-win_amd64.whl (64-bit OS)

    • OR

    • Fiona-1.8.13-cp37-cp37m-win32.whl (32-bit OS)

Next up: Start up OSGeo4W Shell.

This should pop up by searching for it in the Windows start up menu. (Press windows key on your keyboard and just type “OSGeo4W Shell”).

First, the OSGeo4w Shell must run a py3_env.bat file that is located in “Your QGIS installation folder path”bin. Sometimes the OSGeo4W Shell properly starts there and you can skip this part but if not:

You must type or copy in the OSGeo4W Shell:

cd /D "Your QGIS installation folder path without the quotes"\bin

To install the just downloaded files the OSGeo4W Shell must be in the same directory as the downloaded files. Go to where your GDAL-..-.whl and Fiona-…-.whl files are and copy the url (Example URL: F:\Users\nikke\Downloads).

We’ll change the OSGeo4W Shell location by typing or copying into the Shell:

cd /D "paste your url here without the quotes"
The GDAL and Fiona installation depends on which version of both you downloaded.
If you have the 64x bit version, type or copy these into the OSGeo4W Shell
Note: Install the GDAL file first.
python -m pip install GDAL-3.0.4-cp37-cp37m-win_amd64.whl --user

Press Enter and when installation is completed, type or copy:

python -m pip install Fiona-1.8.13-cp37-cp37m-win_amd64.whl --user

Else if you have the 32x bit versions, use these:

python -m pip install GDAL-3.0.4-cp37-cp37m-win32.whl --user

Press Enter and when installation is completed, type or copy in to the Shell:

python -m pip install Fiona-1.8.13-cp37-cp37m-win32.whl --user

Hopefully the installation succeeds without issues. Next up we will install geopandas. Type in the OSGeo4W Shell:

python -m pip install geopandas --user

Next, we will install python-ternary. Type in the OSGeo4W Shell:

python -m pip install python-ternary --user

Next, we will install sklearn. Type in the OSGeo4W Shell:

python -m pip install sklearn --user

Next, we will install seaborn. Type in the OSGeo4W Shell:

python -m pip install seaborn --user

Next, we will install powerlaw. Type in the OSGeo4W Shell:

python -m pip install powerlaw --user

And we are done! Installing the plugin itself is easy.

Plugin installation from .zip file

After installing Python modules, you may install the plugin in QGIS. Go to Plugins -> Manage and Install Plugins… and choose Install from ZIP. Input the .zip file with the plugin and install (fracture_analysis_2d.zip).