From 9ac0185646aa3867e4c9fab46d2d0c8a7ff1ca4d Mon Sep 17 00:00:00 2001
From: Dorchies David <david.dorchies@irstea.fr>
Date: Sat, 7 Nov 2020 16:09:40 +0100
Subject: [PATCH] feat: new reservoir ruleset

Fix #4
---
 example/PARAMETR/BARRAGES/6/AUBE.1      | 48 +++++++++++++++++++++++
 example/PARAMETR/BARRAGES/6/MARNE.1     | 48 +++++++++++++++++++++++
 example/PARAMETR/BARRAGES/6/SEINE.1     | 48 +++++++++++++++++++++++
 example/PARAMETR/BARRAGES/6/YONNE.1     | 52 +++++++++++++++++++++++++
 example/PARAMETR/BARRAGES/6/version.txt |  1 +
 5 files changed, 197 insertions(+)
 create mode 100644 example/PARAMETR/BARRAGES/6/AUBE.1
 create mode 100644 example/PARAMETR/BARRAGES/6/MARNE.1
 create mode 100644 example/PARAMETR/BARRAGES/6/SEINE.1
 create mode 100644 example/PARAMETR/BARRAGES/6/YONNE.1
 create mode 100644 example/PARAMETR/BARRAGES/6/version.txt

diff --git a/example/PARAMETR/BARRAGES/6/AUBE.1 b/example/PARAMETR/BARRAGES/6/AUBE.1
new file mode 100644
index 0000000..44cb4f8
--- /dev/null
+++ b/example/PARAMETR/BARRAGES/6/AUBE.1
@@ -0,0 +1,48 @@
+Contraintes et consignes du réservoir Aube (règles actuelles d'après F.Dehay, ENGEES 2012). Débit réservé considéré seulement à la prise et débit de référence non considéré. 
+AUBE									
+1	0	0			Qemin	(m3/s) en fonction de V (hm3)							
+1	0	1.35E+02		Qemax	(m3/s) en fonction de V (hm3)							
+1	0	0			Qsmin	(m3/s) en fonction de V (hm3)							
+1	0	35			Qsmax	(m3/s) en fonction de V (hm3)							
+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	1		QVres						
+1							
+1							
+1	-1	0							
+0	1		QMref						
+1									
+1									
+1	-1	9999							
+0	1		QVref						
+1									
+1									
+1	-1	9999							
+									
+FORMAT DU FICHIER :									
+ligne 1 : en-tête obligatoire (version)
+ligne 2	: nom du réservoir								
+ligne 3 : barème V-> Qemin (effectif (entre 1 et 10), valeurs de V (hm3) croissantes, valeurs de Qemin (m3/s))
+ligne 4 : barème V-> Qemax (effectif, valeurs de V (hm3) croissantes, valeurs de Qemax (m3/s))
+ligne 5 : barème V-> Qsmin (effectif, valeurs de V (hm3) croissantes, valeurs de Qsmin (m3/s))
+ligne 6 : barème V-> Qsmax (effectif, valeurs de V (hm3) croissantes, valeurs de Qsmax (m3/s))
+ligne 7 : volume Vtot (hm3, valeur max possible de 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, compris entre 1 et 365)								
+	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 :
+	V : volume d'eau exploitable présent dans le réservoir	
+	Qemin et Qemax : débitance min et max de la prise (limites physiques)								
+	Qsmin et Qsmax : débitance min et max de la restitution	(limites physiques)							
+	QMres et QMref : débit réservé (valeur qu'on souhaite voir dépassée) et débit de référence (valeur qu'on souhaite ne pas voir dépassée) dans le cours d'eau à l'aval immédiat de la prise								
+	QVres et QVref : débit réservé (valeur qu'on souhaite voir dépassée) et débit de référence (valeur qu'on souhaite ne pas voir dépassée) dans le cours d'eau à l'aval immédiat de la restitution								
+	Vtot : volume exploitable total du réservoir, compris entre le sommet de la tranche morte (ou le sommet du volume de garde) et le niveau maximal de sécurité								
+	QMnat : débit du cours d'eau à l'amont immédiat de la prise								
+	QV : débit du cours d'eau à l'aval immédiat de la restitution										
+									
diff --git a/example/PARAMETR/BARRAGES/6/MARNE.1 b/example/PARAMETR/BARRAGES/6/MARNE.1
new file mode 100644
index 0000000..06986a0
--- /dev/null
+++ b/example/PARAMETR/BARRAGES/6/MARNE.1
@@ -0,0 +1,48 @@
+Contraintes et consignes du réservoir Marne (règles actuelles d'après F.Dehay, ENGEES 2012). Débit réservé considéré seulement à la prise et débit de référence non considéré. 
+MARNE										
+1	0	0			Qemin	(m3/s) en fonction de V (hm3)								
+1	0	4.08E+02		Qemax	(m3/s) en fonction de V (hm3)								
+1	0	0			Qsmin	(m3/s) en fonction de V (hm3)								
+1	0	50			Qsmax	(m3/s) en fonction de V (hm3)								
+354.5			Vtot	(million de m3)								
+0	3		QMres							
+1	91	305								
+1	2	1								
+1	-1	7								
+1	-1	11								
+0	1		QVres							
+1								
+1								
+1	-1	0																
+0	1		QMref							
+1					
+1
+1	-1	9999															
+0	1		QVref							
+1					
+1						
+1	-1	9999																
+										
+FORMAT DU FICHIER :									
+ligne 1 : en-tête obligatoire (version)
+ligne 2	: nom du réservoir								
+ligne 3 : barème V-> Qemin (effectif (entre 1 et 10), valeurs de V (hm3) croissantes, valeurs de Qemin (m3/s))
+ligne 4 : barème V-> Qemax (effectif, valeurs de V (hm3) croissantes, valeurs de Qemax (m3/s))
+ligne 5 : barème V-> Qsmin (effectif, valeurs de V (hm3) croissantes, valeurs de Qsmin (m3/s))
+ligne 6 : barème V-> Qsmax (effectif, valeurs de V (hm3) croissantes, valeurs de Qsmax (m3/s))
+ligne 7 : volume Vtot (hm3, valeur max possible de 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, compris entre 1 et 365)								
+	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 :
+	V : volume d'eau exploitable présent dans le réservoir	
+	Qemin et Qemax : débitance min et max de la prise (limites physiques)								
+	Qsmin et Qsmax : débitance min et max de la restitution	(limites physiques)							
+	QMres et QMref : débit réservé (valeur qu'on souhaite voir dépassée) et débit de référence (valeur qu'on souhaite ne pas voir dépassée) dans le cours d'eau à l'aval immédiat de la prise								
+	QVres et QVref : débit réservé (valeur qu'on souhaite voir dépassée) et débit de référence (valeur qu'on souhaite ne pas voir dépassée) dans le cours d'eau à l'aval immédiat de la restitution								
+	Vtot : volume exploitable total du réservoir, compris entre le sommet de la tranche morte (ou le sommet du volume de garde) et le niveau maximal de sécurité								
+	QMnat : débit du cours d'eau à l'amont immédiat de la prise								
+	QV : débit du cours d'eau à l'aval immédiat de la restitution										
+									
diff --git a/example/PARAMETR/BARRAGES/6/SEINE.1 b/example/PARAMETR/BARRAGES/6/SEINE.1
new file mode 100644
index 0000000..3c3c89d
--- /dev/null
+++ b/example/PARAMETR/BARRAGES/6/SEINE.1
@@ -0,0 +1,48 @@
+Contraintes et consignes du réservoir Seine (règles actuelles d'après F.Dehay, ENGEES 2012). Débit réservé considéré seulement à la prise et débit de référence non considéré. 
+SEINE									
+1	0	0			Qemin	(m3/s) en fonction de V (hm3)							
+1	0	2.00E+02		Qemax	(m3/s) en fonction de V (hm3)							
+1	0	0.8			Qsmin	(m3/s) en fonction de V (hm3)							
+1	0	35			Qsmax	(m3/s) en fonction de V (hm3)							
+212.9			Vtot	(million de m3)							
+0	4		QMres						
+1	91	274	335						
+1	2	1	2						
+1	-1	3							
+3	10	3	8	4	6	5			
+0	1		QVres						
+1						
+1						
+1	-1	0										
+0	1		QMref						
+1						
+1						
+1	-1	9999														
+0	1		QVref						
+1						
+1						
+1	-1	9999													
+									
+FORMAT DU FICHIER :									
+ligne 1 : en-tête obligatoire (version)
+ligne 2	: nom du réservoir								
+ligne 3 : barème V-> Qemin (effectif (entre 1 et 10), valeurs de V (hm3) croissantes, valeurs de Qemin (m3/s))
+ligne 4 : barème V-> Qemax (effectif, valeurs de V (hm3) croissantes, valeurs de Qemax (m3/s))
+ligne 5 : barème V-> Qsmin (effectif, valeurs de V (hm3) croissantes, valeurs de Qsmin (m3/s))
+ligne 6 : barème V-> Qsmax (effectif, valeurs de V (hm3) croissantes, valeurs de Qsmax (m3/s))
+ligne 7 : volume Vtot (hm3, valeur max possible de 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, compris entre 1 et 365)								
+	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 :
+	V : volume d'eau exploitable présent dans le réservoir	
+	Qemin et Qemax : débitance min et max de la prise (limites physiques)								
+	Qsmin et Qsmax : débitance min et max de la restitution	(limites physiques)							
+	QMres et QMref : débit réservé (valeur qu'on souhaite voir dépassée) et débit de référence (valeur qu'on souhaite ne pas voir dépassée) dans le cours d'eau à l'aval immédiat de la prise								
+	QVres et QVref : débit réservé (valeur qu'on souhaite voir dépassée) et débit de référence (valeur qu'on souhaite ne pas voir dépassée) dans le cours d'eau à l'aval immédiat de la restitution								
+	Vtot : volume exploitable total du réservoir, compris entre le sommet de la tranche morte (ou le sommet du volume de garde) et le niveau maximal de sécurité								
+	QMnat : débit du cours d'eau à l'amont immédiat de la prise								
+	QV : débit du cours d'eau à l'aval immédiat de la restitution										
+									
diff --git a/example/PARAMETR/BARRAGES/6/YONNE.1 b/example/PARAMETR/BARRAGES/6/YONNE.1
new file mode 100644
index 0000000..02fe766
--- /dev/null
+++ b/example/PARAMETR/BARRAGES/6/YONNE.1
@@ -0,0 +1,52 @@
+contraintes et consignes du réservoir Yonne (règles actuelles d'après F.Dehay, ENGEES 2012). Débit réservé considéré à la restitution et nul à la prise; débit de référence non considérés; QSmax = QSmax0 physique
+YONNE
+1	0	1.00E+20		Qemin	(m3/s) en fonction de V (hm3)
+1	0	1.00E+20		Qemax	(m3/s) en fonction de V (hm3)
+1	0	0			Qsmin	(m3/s) en fonction de V (hm3)
+6	0	2.2	21.5	55.7	57.07	74	45.88	47.62	55.48	61.74	61.91	284		Qsmax	(m3/s) en fonction de V (hm3)
+74			Vtot	(million de m3)
+0	1		QMres
+1
+1
+1	-1	0
+0	10	QVres
+1	60	91	121	152	182	244	274	305	335	Dates
+1	2	3	4	5	6	5	3	2	1	Catégories
+1	-1	0.6
+1	-1	1.2
+1	-1	1.7
+1	-1	1.8
+1	-1	1.9
+1	-1	2
+0	1		QMref
+1
+1
+1	-1	0
+0	1	QVref
+1
+1
+1	-1	9999
+
+FORMAT DU FICHIER :
+ligne 1 : en-tête obligatoire (version)
+ligne 2	: nom du réservoir
+ligne 3 : barème V-> Qemin (effectif (entre 1 et 10), valeurs de V (hm3) croissantes, valeurs de Qemin (m3/s))
+ligne 4 : barème V-> Qemax (effectif, valeurs de V (hm3) croissantes, valeurs de Qemax (m3/s))
+ligne 5 : barème V-> Qsmin (effectif, valeurs de V (hm3) croissantes, valeurs de Qsmin (m3/s))
+ligne 6 : barème V-> Qsmax (effectif, valeurs de V (hm3) croissantes, valeurs de Qsmax (m3/s))
+ligne 7 : volume Vtot (hm3, valeur max possible de 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, compris entre 1 et 365)
+	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 :
+	V : volume d'eau exploitable présent dans le réservoir
+	Qemin et Qemax : débitance min et max de la prise (limites physiques)
+	Qsmin et Qsmax : débitance min et max de la restitution	(limites physiques)
+	QMres et QMref : débit réservé (valeur qu'on souhaite voir dépassée) et débit de référence (valeur qu'on souhaite ne pas voir dépassée) dans le cours d'eau à l'aval immédiat de la prise
+	QVres et QVref : débit réservé (valeur qu'on souhaite voir dépassée) et débit de référence (valeur qu'on souhaite ne pas voir dépassée) dans le cours d'eau à l'aval immédiat de la restitution
+	Vtot : volume exploitable total du réservoir, compris entre le sommet de la tranche morte (ou le sommet du volume de garde) et le niveau maximal de sécurité
+	QMnat : débit du cours d'eau à l'amont immédiat de la prise
+	QV : débit du cours d'eau à l'aval immédiat de la restitution
+
diff --git a/example/PARAMETR/BARRAGES/6/version.txt b/example/PARAMETR/BARRAGES/6/version.txt
new file mode 100644
index 0000000..872c089
--- /dev/null
+++ b/example/PARAMETR/BARRAGES/6/version.txt
@@ -0,0 +1 @@
+2012, Qres prises (+ restit Yonne), pas de Qref, QSmax(Yonne)=QSmax0, pas de limite sur le gradient de QS(Yonne)
\ No newline at end of file
-- 
GitLab