# 1. Installation and troubleshooting

This plugin runs with QGIS 3.0 and above.

On Microsoft Windows, QGIS includes all the software dependencies needed by the plugin.

On macOS and Linux, please make sure that Scipy and Matplotlib with Qt5 backend are installed.

On macOS:

    $ sudo pip3.6 install matplotlib scipy

On Ubuntu (Debian and similar):

    $ sudo apt install python3-scipy python3-matplotlib python3-pyqt5.qtwebkit

On Fedora and similar:

    $ sudo dnf install python3-scipy python3-matplotlib python3-matplotlib-qt5

On macOS make sure to run the script located under /Applications/Python 3.6/Install Certificates.command, after Python has been installed, to update the SSL certificates bundle.

On Fedora, please follow these instructions.

The plugin can be installed using the QGIS Plugins Manager, that is accessible through the QGIS menu as Plugins -> Manage and install plugins. Please note that the Settings of the Plugins Manager contain a checkbox to Show also experimental plugins. If that option is checked, the latest version of the plugin that is marked as experimental will be available for installation. Otherwise, the latest stable version will be installable. Experimental versions contain new functionalities that may have not been properly tested yet, and that could cause the plugin or QGIS to break or to behave unexpectedly.

Some users reported issues about upgrading the plugin to its latest version. We recommend to reinstall the plugin instead, in order to make sure the new installation is done in a clean folder.

## 1.1. Mirror

A mirror of this repository, hosted in Pavia (Italy), is available at https://mirror.openquake.org/git/GEM/oq-irmt-qgis.git.

## 1.2. How to run tests on Ubuntu 18.04 LTS

In order to run tests on Ubuntu 18.04 LTS and above, QGIS has to be installed as described above and the following additional packages are required: `python3-scipy`, `python3-nose`, `python3-coverage`, `python3-mock`

If the environment is not already set, run the script `run-env-linux.sh`, providing the required argument (in most cases, specifying the directory /usr)

    $ source scripts/run-env-linux.sh /usr

Then, move to the `svir` directory and run

    $ make test