En raison du déménagement des baies serveurs, les services gitlab.irstea.fr et mattermost.irstea.fr seront interrompus le samedi 2 octobre 2021 au matin. Ils devraient revenir à la normale dans la journée.

Commit 2c6cc288 authored by Dorchies David's avatar Dorchies David
Browse files

Add working example for V5

parent 03b2e24d
......@@ -5,3 +5,7 @@
# vscode IDE
.vscode/
# Program outputs
/compteur
/*.TXT
# Ignore everything in this directory
*
# Except this file
!.gitignore
# Ignore everything in this directory
*
# Except this file
!.gitignore
# Ignore everything in this directory
*
# Except this file
!.gitignore
# VGEST
VGEST is software developped in Pascal which serve to calculate water volume limits to be respected in reservoirs set up in parallel on a hydrographic network, to allow the best future satisfaction of a common downstream management objective.
\ No newline at end of file
VGEST is software developped in Pascal by Jean-Claude Bader. It serves to calculate water volume limits to be respected in reservoirs set up in parallel on a hydrographic network, to allow the best future satisfaction of a common downstream management objective (low-water support or flood lamination).
*Bader, J.-C., Dorchies, D., 2016. Calcul des limites de volumes d’eau à respecter dans des réservoirs implantés en parallèle sur un réseau hydrographique, pour permettre la meilleure satisfaction future d’un objectif commun de gestion à l’aval (soutien d’étiage ou laminage de crue) : logiciel VGEST - Application au cas du bassin de la Seine (Amélioration et extension de la méthode précédemment développée dans le cadre du programme Climaware). IRD, Montpellier. https://www.documentation.ird.fr/hor/fdi:010070461*
## Requirements
VGEST has only been tested on Windows XP or superior.
* Download Free Pascal I386 for Windows 32 bits: https://www.freepascal.org/down/i386/win32.html
* Install it by running the downloaded executable
## Compilation
At the root folder of this repository type the following command line (Adapt the path of `fpc.exe` according to your Free Pascal installation path):
```
C:\FPC\bin\i386-win32\fpc.exe src\VGEST.PAS && move /Y src\VGEST.exe .
```
## Get started with the example
The `example` directory contains all the configuration for calculating statistics about respecting a maximum flow of 110 m<sup>3</sup>/s at Paris. These statistics are calculated from the Seine River Basin naturalised flow database between 1993/01/01 and 2009/12/31.
Copy the files contained in the `example` directory to the root directory and run `VGEST.exe`.
# Ignore everything in this directory
*
# Except this file
!.gitignore
# Ignore everything in this directory
*
# Except this file
!.gitignore
PARIS_05
data.txt
BATCH
1
01/01/1994
31/12/2009
# Ignore everything in this directory
*
# Except this file
!.gitignore
01/01 110.000000
Paramètres décrivant la station objectif, les réservoirs situés à l'amont et les temps de propagation
ALFOR_16
3
YONNE
SEINE
AUBE
70
125
136
FORMAT DU FICHIER :
1ere ligne : en-tête obligatoire
2eme ligne : identifiant de station aval du système (chaîne de 8 caractères)
3eme ligne : nombre K de réservoirs
K noms de réservoir (1 par ligne)
K temps de propagation D entre restitution de réservoir et station aval (1 par ligne, en heure)
Paramètres décrivant la station objectif, les réservoirs situés à l'amont et les temps de propagation
ARCIS_24
1
AUBE
17
FORMAT DU FICHIER :
1ere ligne : en-tête obligatoire
2eme ligne : identifiant de station aval du système (chaîne de 8 caractères)
3eme ligne : nombre K de réservoirs
K noms de réservoir (1 par ligne)
K temps de propagation D entre restitution de réservoir et station aval (1 par ligne, en heure)
paramètres des contraintes et consignes du réservoir Aube (scénario : réalité d'après rapport Florine Dehay, ENGEES 2012)
AUBE
0 Qemin (m3/s)
1.35E+02 Qemax (m3/s)
0 Qsmin (m3/s)
35 Qsmax (m3/s)
181.2 Vtot (million de m3)
0 3 QMres
1 91 305
1 2 1
1 -1 2
3 8 2 6 3 4 4
0 3 QVres
1 91 305
1 2 1
1 -1 2
3 8 2 6 3 4 4
0 1 QMref
1
1
1 -1 130
0 1 QVref
1
1
1 -1 130
FORMAT DU FICHIER :
ligne 0 : en-tête obligatoire
ligne 1 : nom du réservoir (chaîne de 8 caractères)
lignes 2 à 6 : Qemin, Qemax, Qsmin, Qsmax, V,
4 groupes de lignes (pour QMres, QVres, QMref et QVref respectivement) composé chacun de :
ligne 1 : Type (entre 0 et 2), Nombre N de dates pivot (entre 1 et 10) et Borne (si Type <>0). Le débit vaut alors Q défini dans les lignes suivantes si Type=0, max(Q,QV(t-1)-borne) si Type=1 et min(Q,QV(t-1)+borne) si Type = 2
ligne 2 : N dates pivot entières croissantes (quantièmes de changement de valeurs de Q, inférieurs à 366)
ligne 3 : N valeurs entières comprises entre 1 et M(<=N), correspondant aux catégories de valeurs de Q
lignes 4 à 3+M : nombre X (entier entre 1 et 5), puis X couples de valeurs Ai (décroissant),Bi interprétés comme suit : si QMnat>A1 alors Q=B1, sinon, si QMnat>A2 alors Q=B2, sinon…,si QMnat>Ax alors Q=Bx, sinon Q=QMnat
notations :
Qemin et Qemax : débitance min et max du canal de prise
Qsmin et Qsmax : débitance min et max du canal de restitution
QMres et QMref : débit réservé et débit de référence, juste à l'aval de la prise
QVres et QVref : débit réservé et débit de référence juste à l'aval de la restitution
Vtot : volume total du réservoir
QMnat : débit observé juste à l'amont de la prise
QV : débit observé juste à l'aval de la restitution
Paramètres décrivant le réseau local de stations hydrométriques du réservoir Aube (pour le calcul des débits naturels à la prise et à la restitution)
AUBE
1 1 Na et Ni
ARCIS_24 identifiant aval
TRANN_01 identifiant amont
LASSI_20 identifiant intermédiaire
17 DV
47 DM
49 Dam
17 Dint
3594.600098 Sav
2529.01001 SV
1572.040039 SM
1557.060059 Sam
876.530029 Sint
FORMAT DU FICHIER :
ligne 1 : en-tête obligatoire
ligne 2 : nom du réservoir
ligne 3 : nombre Na (0 à 2) de stations amont et Ni (0 à 1) de stations intermédiaires. Si Na=0, les données n'occupent que 3 lignes
ligne 4 : identifiant de station aval du réseau local (8 caractères)
Na lignes d'identifiants de stations amont du réseau local (8 caractères)
Ni ligne d'identifiant de station intermédiaires du réseau local (8 caractères)
Na valeurs de DV (temps de propagation (h) entre point de restitution et station aval du réseau local)
Na valeurs de DM temps de propagation (h) entre point de prise et station aval du réseau local)
Na valeurs de Dam (temps de propagation (h) entre les stations amont et la station aval du réseau local)
Ni valeurs de Dint (temps de propagation (h) entre les stations intermédiaires et la station aval du réseau local)
Sav (superficie de BV à la station aval)
Na valeurs de SV (superficie de BV au point de restitution)
Na valeurs de SM (superficie de BV au point de prise)
Na valeurs de Sam (superficie de BV à station amont)
Ni valeurs de Sint (superficie de BV à station intermédiaire
\ No newline at end of file
Paramètres décrivant la station objectif, les réservoirs situés à l'amont et les temps de propagation
CHALO_21
1
MARNE
31
FORMAT DU FICHIER :
1ere ligne : en-tête obligatoire
2eme ligne : identifiant de station aval du système (chaîne de 8 caractères)
3eme ligne : nombre K de réservoirs
K noms de réservoir (1 par ligne)
K temps de propagation D entre restitution de réservoir et station aval (1 par ligne, en heure)
Paramètres décrivant la station objectif, les réservoirs situés à l'amont et les temps de propagation
COURL_23
1
YONNE
41
FORMAT DU FICHIER :
1ere ligne : en-tête obligatoire
2eme ligne : identifiant de station aval du système (chaîne de 8 caractères)
3eme ligne : nombre K de réservoirs
K noms de réservoir (1 par ligne)
K temps de propagation D entre restitution de réservoir et station aval (1 par ligne, en heure)
Paramètres décrivant la station objectif, les réservoirs situés à l'amont et les temps de propagation
GURGY_02
1
YONNE
19
FORMAT DU FICHIER :
1ere ligne : en-tête obligatoire
2eme ligne : identifiant de station aval du système (chaîne de 8 caractères)
3eme ligne : nombre K de réservoirs
K noms de réservoir (1 par ligne)
K temps de propagation D entre restitution de réservoir et station aval (1 par ligne, en heure)
paramètres des contraintes et consignes du réservoir Marne (scénario : réalité d'après rapport Florine Dehay, ENGEES 2012)
MARNE
0 Qemin (m3/s)
4.08E+02 Qemax (m3/s)
0 Qsmin (m3/s)
50 Qsmax (m3/s)
354.5 Vtot (million de m3)
0 3 QMres
1 91 305
1 2 1
1 -1 7
1 -1 11
0 3 QVres
1 91 305
1 2 1
1 -1 7
1 -1 11
0 6 QMref
1 91 121 182 274 305
1 2 3 4 3 1
1 -1 160
1 -1 140
1 -1 120
1 -1 90
0 5 QVref
1 182 274 289 305
1 2 3 4 1
1 -1 140
1 -1 75
1 -1 100
1 -1 120
FORMAT DU FICHIER :
ligne 0 : en-tête obligatoire
ligne 1 : nom du réservoir (chaîne de 8 caractères)
lignes 2 à 6 : Qemin, Qemax, Qsmin, Qsmax, V,
4 groupes de lignes (pour QMres, QVres, QMref et QVref respectivement) composé chacun de :
ligne 1 : Type (entre 0 et 2), Nombre N de dates pivot (entre 1 et 10) et Borne (si Type <>0). Le débit vaut alors Q défini dans les lignes suivantes si Type=0, max(Q,QV(t-1)-borne) si Type=1 et min(Q,QV(t-1)+borne) si Type = 2
ligne 2 : N dates pivot entières croissantes (quantièmes de changement de valeurs de Q, inférieurs à 366)
ligne 3 : N valeurs entières comprises entre 1 et M(<=N), correspondant aux catégories de valeurs de Q
lignes 4 à 3+M : nombre X (entier entre 1 et 5), puis X couples de valeurs Ai (décroissant),Bi interprétés comme suit : si QMnat>A1 alors Q=B1, sinon, si QMnat>A2 alors Q=B2, sinon…,si QMnat>Ax alors Q=Bx, sinon Q=QMnat
notations :
Qemin et Qemax : débitance min et max du canal de prise
Qsmin et Qsmax : débitance min et max du canal de restitution
QMres et QMref : débit réservé et débit de référence, juste à l'aval de la prise
QVres et QVref : débit réservé et débit de référence juste à l'aval de la restitution
Vtot : volume total du réservoir
QMnat : débit observé juste à l'amont de la prise
QV : débit observé juste à l'aval de la restitution
Paramètres décrivant le réseau local de stations hydrométriques du réservoir Marne (pour le calcul des débits naturels à la prise et à la restitution)
MARNE
2 1 Na et Ni
CHALO_21 identifiant aval
STDIZ_04 identifiant amont1
LOUVE_19 identifiant amont2
VITRY_25 identifiant intermédiaire
31 DV1
31 DV2
42 DM1
45 DM2
42 Dam1
45 Dam2
42 Dint
6291.549805 Sav
2515.2254 SV1
533.1845124 SV2
2289.949951 SM1
485.429993 SM2
2347.530029 Sam1
461.73999 Sam2
2109.139893 Sint
FORMAT DU FICHIER :
ligne 1 : en-tête obligatoire
ligne 2 : nom du réservoir
ligne 3 : nombre Na (0 à 2) de stations amont et Ni (0 à 1) de stations intermédiaires. Si Na=0, les données n'occupent que 3 lignes
ligne 4 : identifiant de station aval du réseau local (8 caractères)
Na lignes d'identifiants de stations amont du réseau local (8 caractères)
Ni ligne d'identifiant de station intermédiaires du réseau local (8 caractères)
Na valeurs de DV (temps de propagation (h) entre point de restitution et station aval du réseau local)
Na valeurs de DM temps de propagation (h) entre point de prise et station aval du réseau local)
Na valeurs de Dam (temps de propagation (h) entre les stations amont et la station aval du réseau local)
Ni valeurs de Dint (temps de propagation (h) entre les stations intermédiaires et la station aval du réseau local)
Sav (superficie de BV à la station aval)
Na valeurs de SV (superficie de BV au point de restitution)
Na valeurs de SM (superficie de BV au point de prise)
Na valeurs de Sam (superficie de BV à station amont)
Ni valeurs de Sint (superficie de BV à station intermédiaire
\ No newline at end of file
Markdown is supported
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment