# gaillot18/stage-m2-chps-modeles-riviere architecture

> Architecture diagram of the GitHub repository gaillot18/stage-m2-chps-modeles-riviere, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/gaillot18/stage-m2-chps-modeles-riviere
- Repository: https://github.com/gaillot18/stage-m2-chps-modeles-riviere

## Overview

This repository is a command-line research application for studying and computing 1D Saint-Venant river models. Users provide model parameters and input files; a selected kinematic, diffusive, or dynamic solver computes area and discharge over space and time, with exact-solution programs available for comparison. Each model offers serial, OpenMP, and MPI finite-volume Rusanov variants. Shared code handles file I/O, vector operations, display, and geometry. The README documents the command-line and Docker usage; several detailed solver connections are represented at subsystem level because not all implementation excerpts are shown.

Main entry points: [`Application/Fonctions-communes/Sources/entree-sortie.c`](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Fonctions-communes/Sources/entree-sortie.c) (File I/O), [`Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov/main.cpp`](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov/main.cpp) (Diffusive serial), [`Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-openmp/main.cpp`](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-openmp/main.cpp) (Diffusive OpenMP), [`Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-mpi/main.cpp`](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-mpi/main.cpp) (Diffusive MPI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shared["Shared support"]
  node_io["File I/O<br/>[entree-sortie.c]"]
  node_vectors["Vector operations<br/>[calcul-vecteur.c]"]
  node_display["Display<br/>[affichage.cpp]"]
  node_geometry["River geometry<br/>[geometrie.c]"]
end

subgraph group_exact["Exact solutions"]
  node_exact_k["Kinematic exact<br/>[main.cpp]"]
  node_exact_d["Diffusive exact<br/>[main.cpp]"]
  node_exact_y["Dynamic exact<br/>[main.cpp]"]
end

subgraph group_models["River models"]
  node_kin_serial["Kinematic serial<br/>[main.cpp]"]
  node_kin_omp["Kinematic OpenMP<br/>[main.cpp]"]
  node_kin_mpi["Kinematic MPI<br/>[main.cpp]"]
  node_diff_serial["Diffusive serial<br/>[main.cpp]"]
  node_diff_omp["Diffusive OpenMP<br/>[main.cpp]"]
  node_diff_mpi["Diffusive MPI<br/>[main.cpp]"]
  node_dyn_serial["Dynamic serial<br/>[main.cpp]"]
  node_dyn_omp["Dynamic OpenMP<br/>[main.cpp]"]
  node_dyn_mpi["Dynamic MPI<br/>[main.cpp]"]
end

node_cli(("CLI user"))
node_input["Input files"]
node_output["Result files"]

node_cli -.->|"selects run"| node_kin_serial
node_cli -.->|"selects run"| node_kin_omp
node_cli -.->|"selects run"| node_kin_mpi
node_cli -.->|"selects run"| node_diff_serial
node_cli -.->|"selects run"| node_diff_omp
node_cli -.->|"selects run"| node_diff_mpi
node_cli -.->|"selects run"| node_dyn_serial
node_cli -.->|"selects run"| node_dyn_omp
node_cli -.->|"selects run"| node_dyn_mpi
node_input -.->|"provides parameters"| node_kin_serial
node_input -.->|"provides parameters"| node_kin_omp
node_input -.->|"provides parameters"| node_kin_mpi
node_input -->|"provides parameters"| node_diff_serial
node_input -->|"provides parameters"| node_diff_omp
node_input -->|"provides parameters"| node_diff_mpi
node_input -.->|"provides parameters"| node_dyn_serial
node_input -.->|"provides parameters"| node_dyn_omp
node_input -.->|"provides parameters"| node_dyn_mpi
node_kin_serial -.->|"reads and writes"| node_io
node_kin_omp -.->|"reads and writes"| node_io
node_kin_mpi -.->|"reads and writes"| node_io
node_diff_serial -->|"reads and writes"| node_io
node_diff_omp -->|"reads and writes"| node_io
node_diff_mpi -->|"reads inputs"| node_io
node_dyn_serial -.->|"reads and writes"| node_io
node_dyn_omp -.->|"reads and writes"| node_io
node_dyn_mpi -.->|"reads and writes"| node_io
node_io -.->|"writes results"| node_output
node_exact_k -->|"uses file I/O"| node_io
node_exact_d -->|"uses file I/O"| node_io
node_exact_y -->|"uses file I/O"| node_io
node_diff_serial -.->|"uses geometry"| node_geometry
node_diff_omp -.->|"uses geometry"| node_geometry
node_diff_mpi -.->|"uses geometry"| node_geometry

click node_io "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Fonctions-communes/Sources/entree-sortie.c"
click node_vectors "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Fonctions-communes/Sources/calcul-vecteur.c"
click node_display "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Fonctions-communes/Sources/affichage.cpp"
click node_geometry "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Fonctions-communes/Sources/geometrie.c"
click node_exact_k "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-cinematique/Sources/solution-exacte/main.cpp"
click node_exact_d "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/solution-exacte/main.cpp"
click node_exact_y "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-dynamique/Sources/solution-exacte/main.cpp"
click node_kin_serial "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-cinematique/Sources/volume-fini-rusanov/main.cpp"
click node_kin_omp "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-cinematique/Sources/volume-fini-rusanov-openmp/main.cpp"
click node_kin_mpi "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-cinematique/Sources/volume-fini-rusanov-mpi/main.cpp"
click node_diff_serial "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov/main.cpp"
click node_diff_omp "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-openmp/main.cpp"
click node_diff_mpi "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-mpi/main.cpp"
click node_dyn_serial "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-dynamique/Sources/volume-fini-rusanov/main.cpp"
click node_dyn_omp "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-dynamique/Sources/volume-fini-rusanov-openmp/main.cpp"
click node_dyn_mpi "https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-dynamique/Sources/volume-fini-rusanov-mpi/main.cpp"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_io,node_vectors,node_display,node_geometry,node_cli toneBlue
class node_exact_k,node_exact_d,node_exact_y toneAmber
class node_kin_serial,node_kin_omp,node_kin_mpi,node_diff_serial,node_diff_omp,node_diff_mpi,node_dyn_serial,node_dyn_omp,node_dyn_mpi toneMint
class node_input,node_output toneIndigo
```

## Components

### Shared support

- [File I/O](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Fonctions-communes/Sources/entree-sortie.c): `Application/Fonctions-communes/Sources/entree-sortie.c`
- [Vector operations](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Fonctions-communes/Sources/calcul-vecteur.c): `Application/Fonctions-communes/Sources/calcul-vecteur.c`
- [Display](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Fonctions-communes/Sources/affichage.cpp): `Application/Fonctions-communes/Sources/affichage.cpp`
- [River geometry](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Fonctions-communes/Sources/geometrie.c): `Application/Problemes/Fonctions-communes/Sources/geometrie.c`

### Exact solutions

- [Kinematic exact](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-cinematique/Sources/solution-exacte/main.cpp): `Application/Problemes/Saint-Venant-1D-cinematique/Sources/solution-exacte/main.cpp`
- [Diffusive exact](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/solution-exacte/main.cpp): `Application/Problemes/Saint-Venant-1D-diffusif/Sources/solution-exacte/main.cpp`
- [Dynamic exact](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-dynamique/Sources/solution-exacte/main.cpp): `Application/Problemes/Saint-Venant-1D-dynamique/Sources/solution-exacte/main.cpp`

### River models

- [Kinematic serial](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-cinematique/Sources/volume-fini-rusanov/main.cpp): `Application/Problemes/Saint-Venant-1D-cinematique/Sources/volume-fini-rusanov/main.cpp`
- [Kinematic OpenMP](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-cinematique/Sources/volume-fini-rusanov-openmp/main.cpp): `Application/Problemes/Saint-Venant-1D-cinematique/Sources/volume-fini-rusanov-openmp/main.cpp`
- [Kinematic MPI](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-cinematique/Sources/volume-fini-rusanov-mpi/main.cpp): `Application/Problemes/Saint-Venant-1D-cinematique/Sources/volume-fini-rusanov-mpi/main.cpp`
- [Diffusive serial](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov/main.cpp): `Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov/main.cpp`
- [Diffusive OpenMP](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-openmp/main.cpp): `Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-openmp/main.cpp`
- [Diffusive MPI](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-mpi/main.cpp): `Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-mpi/main.cpp`
- [Dynamic serial](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-dynamique/Sources/volume-fini-rusanov/main.cpp): `Application/Problemes/Saint-Venant-1D-dynamique/Sources/volume-fini-rusanov/main.cpp`
- [Dynamic OpenMP](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-dynamique/Sources/volume-fini-rusanov-openmp/main.cpp): `Application/Problemes/Saint-Venant-1D-dynamique/Sources/volume-fini-rusanov-openmp/main.cpp`
- [Dynamic MPI](https://github.com/gaillot18/stage-m2-chps-modeles-riviere/blob/main/Application/Problemes/Saint-Venant-1D-dynamique/Sources/volume-fini-rusanov-mpi/main.cpp): `Application/Problemes/Saint-Venant-1D-dynamique/Sources/volume-fini-rusanov-mpi/main.cpp`

### Other components

- **CLI user**
- **Input files**
- **Result files**

## Connections

- CLI user → Kinematic serial: selects run (evidence: `README.md`)
- CLI user → Kinematic OpenMP: selects run (evidence: `README.md`)
- CLI user → Kinematic MPI: selects run (evidence: `README.md`)
- CLI user → Diffusive serial: selects run (evidence: `README.md`)
- CLI user → Diffusive OpenMP: selects run (evidence: `README.md`)
- CLI user → Diffusive MPI: selects run (evidence: `README.md`)
- CLI user → Dynamic serial: selects run (evidence: `README.md`)
- CLI user → Dynamic OpenMP: selects run (evidence: `README.md`)
- CLI user → Dynamic MPI: selects run (evidence: `README.md`)
- Input files → Kinematic serial: provides parameters
- Input files → Kinematic OpenMP: provides parameters
- Input files → Kinematic MPI: provides parameters
- Input files → Diffusive serial: provides parameters (evidence: `Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov/main.cpp`)
- Input files → Diffusive OpenMP: provides parameters (evidence: `Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-openmp/main.cpp`)
- Input files → Diffusive MPI: provides parameters (evidence: `Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-mpi/main.cpp`)
- Input files → Dynamic serial: provides parameters
- Input files → Dynamic OpenMP: provides parameters
- Input files → Dynamic MPI: provides parameters
- Kinematic serial → File I/O: reads and writes
- Kinematic OpenMP → File I/O: reads and writes
- Kinematic MPI → File I/O: reads and writes
- Diffusive serial → File I/O: reads and writes (evidence: `Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov/main.cpp`)
- Diffusive OpenMP → File I/O: reads and writes (evidence: `Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-openmp/main.cpp`)
- Diffusive MPI → File I/O: reads inputs (evidence: `Application/Problemes/Saint-Venant-1D-diffusif/Sources/volume-fini-rusanov-mpi/main.cpp`)
- Dynamic serial → File I/O: reads and writes
- Dynamic OpenMP → File I/O: reads and writes
- Dynamic MPI → File I/O: reads and writes
- File I/O → Result files: writes results
- Kinematic exact → File I/O: uses file I/O (evidence: `Application/Problemes/Saint-Venant-1D-cinematique/Sources/solution-exacte/main.cpp`)
- Diffusive exact → File I/O: uses file I/O (evidence: `Application/Problemes/Saint-Venant-1D-diffusif/Sources/solution-exacte/main.cpp`)
- Dynamic exact → File I/O: uses file I/O (evidence: `Application/Problemes/Saint-Venant-1D-dynamique/Sources/solution-exacte/main.cpp`)
- Diffusive serial → River geometry: uses geometry
- Diffusive OpenMP → River geometry: uses geometry
- Diffusive MPI → River geometry: uses geometry
