# Debian and related distributions

Note

The plugin has been developed and tested against Ubuntu 20.04 and QGIS 3.22.

## Requirements

- 3.22 =< QGIS =< 3.99

### Simulation softwares

#### OpenFOAM and porousMultiphaseFoam

Note

The plugin has been tested against OpenFOAM v2106 with the `dev` flavor (see the official documentation about sub-packages).

For convenience or offline use, we replicate here some of the OpenFOAM installation instructions but please refer to the official documentation for updated steps:

    curl -s https://dl.openfoam.com/add-debian-repo.sh | sudo bash
    sudo apt install -y openfoam2106-dev

Then install the `porousMultiphaseFoam` package:

    git clone --depth=1 --branch=v2303 --single-branch https://github.com/phorgue/porousMultiphaseFoam.git
    cd porousMultiphaseFoam/
    . /usr/lib/openfoam/openfoam2106/etc/bashrc
    ./Allwmake
    ./Allwclean

#### Metis

> TO DOC

### Others

Note

3rd party softwares and related Python packages are listed into the requirements/apt.txt file. Please refer to it to get updated information about what to install.

- Gmsh (version 4.*): get it from the official website.

- FFMPEG (for video export)

- MPICH

Typically:

    sudo apt install gmsh=4* ffmpeg mpich

### Python packages

From Debian repositories:

    sudo apt install python3-mpi4py python3-opengl python3-rtree

From the Python Package Index (PyPi):

    python3 -m pip install --upgrade mpi4py==3.1.3 rtree==0.9.7