# Pamhyr2

Pamhyr is a free and open source graphical user interface for 1D hydro-sedimentary
modelling of rivers.

## Features

+ Edit a complex river hydraulics network
+ Define the river geometry
+ Define boundary conditions
+ Define lateral contribution
+ Edit river friction
+ Add reservoirs
+ Add hydraulic structures
+ Generate initial conditions
+ Edit river sedimentary layers
+ Save the study in a unique file
+ Run Mage 8 on a study and visualize results

Let see the
[documentation](https://gitlab.irstea.fr/theophile.terraz/pamhyr/-/wikis/home)
for more details.

## Install

### GNU/Linux

[See documentation](https://gitlab.irstea.fr/theophile.terraz/pamhyr/-/wikis/home/en/Install%20on%20GNULinux)

### Windows

[See documentation](https://gitlab.irstea.fr/theophile.terraz/pamhyr/-/wikis/home/en/Install%20on%20Windows)

### From source code

```shell
# Get mage
mkdir mage
cd mage

curl -L -o mage.tgz https://gitlab.irstea.fr/jean-baptiste.faure/mage/-/releases/v8.3.2/downloads/packages/mage_linux.tgz
tar xf mage.tgz

cd ..

# Get Pamhyr2 source code
git clone https://gitlab.irstea.fr/theophile.terraz/pamhyr/
cd pamhyr

# Install dependencies
pip3 install -r requirements.txt

# Run pamhyr
./src/pamhyr.py
```