Format du fichier .par

David Dorchies — 2016-10-14T16:56:32Z

Un fichier des variables paramétrées est par créé par scénario (et contenant les informations également pour ses variantes éventuelles) et est par défaut mis à jour automatiquement lors de l'enregistrement du scénario dans EdiSic. Le fichier se nomme [Nom du projet XML]_[N° de scénario].par.

Dans le nom du fichier ci-dessus, nous avons fait le choix de conserver le nom du projet initial [Nom du projet XML] dans le nom, même si le nom du projet est ensuite modifié, que ce soit par la commande "enregistrer sous" d'EdiSic, ou à la main sous Windows ou sous Dos. Si vous avez une routine générant ce fichier pour des exécutions automatiques, vous n'aurez donc pas à la modifier même si le nom du fichier projet est ensuite modifié.

C'est un fichier texte contenant des lignes et des colonnes. Les séparateurs acceptés pour les colonnes sont les espaces, la tabulation, le point-virgule et la virgule. Le format est le suivant :

Les lignes ne commençant ni par « L » ni par « X » sont ignorées. Par convention, les lignes de commentaires commencent par le double symbole « // ».
Les lignes commençant par X1, X2, X3, ... Xn servent à définir la valeur de la variable paramétrée
Les lignes commençant par L1, L2, L3, ... Ln servent à définir la localisation d'une variable paramétrée dans le réseau

EdiSic permet de définir la localisation des variables paramétrées à partir des interfaces de saisie du mode hydraulique (cf. gestion des variables paramétrées). Mais il est aussi possible de définir de nouvelles variables paramétrées directement dans le fichier .par en définissant leur localisation dans le réseau à l'aide des lignes commençant par L.

Une fois que des variables ont été définies comme variables paramétrées dans l'interface EdiSic, des noms (X1, X2, etc) sont affectés automatiquement en prenant le premier nom disponible non utilisé, par ordre croissant. Il n'est pas possible ensuite de les modifier dans la version actuelle d' EdiSic (sauf éventuellement en retouchant directement le fichier xml à la main).

Syntaxe des lignes commençant par X

Pour une valeur fixe, la syntaxe sera :
X[n] [Valeur]
Exemple :
X1 0.25

Par une valeur évoluant en fonction du temps (Loi fonction du temps), la syntaxe sera

X[n] LOI [E ou R]

X[n] [Temps en secondes] [Valeur]

X[n] [Temps en secondes] [Valeur]

...

Le paramètre [E ou R] permet de choisir entre le mode échelon [E] ou le mode rampe [R].

Exemple pour un tour d'eau évoluant à 0, 1 et 2 heures :

// Loi fonction du temps en mode "E" Echelon

X1 LOI E

X1 0 -0.1

X1 3600 -0.2

X1 7200 -0.1

Syntaxe des lignes commençant par L

Les lignes commençant par L contiennent un ensemble de colonnes avec des couples [Type d'objet]=[Valeur]. La signification des types d'objet est la suivante :

BF : n° du Bief
ND : n° du Noeud
PR : n° de la Prise
ST : n° de la Structure d'ouvrage
OUV : n° d'Ouvrage
SN : n° de Section
PBF : n° de la Portion de bief (pour les Strickler et les infiltrations)
CAR : Variable à paramétrer sur l'objet (voir la liste des variables ci-dessous)

Le numéro des biefs, des noeuds et des sections est visible dans l'infobulle qui apparaît lorsqu'on passe la souris sur les différents objets du réseau dans la vue arborescente d'EdiSic. Le fichier .par écrit par EdiSic comporte la ligne « L » en commentaire pour chaque variable définie à titre d'exemple de syntaxe.

Il est possible de définir plusieurs localisations pour un seule variable. Un avertissement sans conséquence s'affichera lors de la simulation et la même valeur sera appliquée aux différentes localisation demandée.

Voici différents exemple de localisation pour différents objets du réseau :

Type d'objet	Syntaxe de la ligne
Débit de la prise n°1 du noeud n°1	`L1 ND=1 PR=1 CAR=Q`
Ouverture de la vanne de l'ouvrage du premier niveau de structure de la prise n°1 du noeud n°2	`L2 ND=2 PR=1 ST=1 OUV=1 CAR=W`
Coefficient de débit de la vanne de l'ouvrage n°1 de la structure en travers située dans la section n°4 du bief n°1	`L3 BF=1 SN=4 OUV=1 CAR=CoefQR`
Strickler de la première portion de Strickler du bief n°1	`L4 BF=1 PBF=1 CAR=KMin`

La liste des variables disponibles par le paramètre CAR est la suivante (attention les minuscules et majuscules sont importants) :

Variable	Signification	Localisation possible
Q	Débit ou débit objectif	Prise avec une condition limite en débit ou avec un débit objectif contrôlant un ouvrage (`ND=... PR=... CAR=Q`)
Z	Cote de l'eau	Prise avec une condition limite en cote (`ND=... PR=... CAR=Z1`)
KMin	Strickler du lit mineur	Portion de bief (`BF=... PBF=... CAR=KMin`)
KMoy	Strickler du lit moyen	Portion de bief (`BF=... PBF=... CAR=KMoy`)
Inf	Infiltration	Portion de bief (`BF=... PBF=... CAR=Inf`)

Aux interfaces d'EdiSic les frottements sont indiqués en Strickler en Français et en Manning en Anglais et en Espagnol. Mais de manière interne, ces frottements sont écrits dans les fichiers .xml ainsi que dans les fichiers .par en Strickler. Si vous êtes plutôt anglo-saxon et avez l'habitude de manipuler des Manning il faudra cependant penser à les convertir (Ks = 1/n) en Strickler si vous les écrivez dans un fichier .par.

On pourra aussi piloter des paramètres d'ouvrages en travers (BF=... SN=... OUV=...) et les ouvrages de prises (ND=... PR=... ST=... OUV=...). Les variables disponibles sont les suivantes :

Variable	Signification	Type d'ouvrage possible
CoteRadier	Cote du radier	Tous les ouvrages
Largeur	Largeur	Toutes les vannes et seuils sauf vanne circulaire et tube
Ouverture	Ouverture de vanne	Toutes les vannes sauf GEC-Alsthom
CoefQR	Coefficient de débit rectangulaire	Toutes les équations de vannes et seuil sauf Goussard
SurverseHauteur	Hauteur de la pelle	Toutes les vannes
CoefQSurverse	Coefficient de débit de la surverse	Toutes les vannes avec surverse au dessus de la pelle
TanAl	Fruit des berges	Vannes et seuils trapézoïdaux, vannes GEC-Alsthom
CoefQT	Coefficient de débit triangulaire	Vannes et seuils trapézoïdaux et vannes GEC avec équation CEM02
CoteAxe	Cote de l'axe	Vannes GEC-Alsthom
Rayon	Rayon de la vanne	Vannes GEC-Alsthom
D	Caractéristique "D" de la loi de Goussard	Vannes AMIL
JMax	Perte de charge maximale	Vannes GEC-Alsthom
S1S2	Rapport des surfaces pour le filtrage	Vannes AVIS, AVIO, Mixtes
Decal	Décalage de prise	Vannes AVIS, AVIO, Mixtes
Decrement	Décrément	Vannes AMIL, AVIS, AVIO
CoteAmont	Cote amont max.	Vannes AMIL

Exemple de fichier .par

// Localisation définie par EdiSic

//Nd : OFF 3 > Pr : Prise1 > CL Débit 

// L1 Nd=3 Pr=1 Car=Q

// Loi fonction du temps en mode "E" Echelon

X1 LOI E

X1 0 -0.1

X1 3600 -0.2

X1 7200 -0.1

// Ajout par l'utilisateur de Nd : DAM > Pr : Prise 1 > CL Débit

L2 Nd=1 pr=1 car=Q

// Loi fonction du temps en mode "R" Rampe

X2 LOI R

X2 0 2.5

X2 3600 3

X2 7200 2.5 

// Ajout par l'utilisateur des Nd 3 et 5 Prise 1 avec débit fixe de 0.4 m3/s

L3 Nd=3 Pr=1 Car=Q

L3 Nd=5 Pr=1 Car=Q

X3 -0.4

Gestion des variables paramétrées

Pierre-Olivier Malaterre — 2011-11-16T16:21:06Z

Introduction

Certaines variables peuvent être "paramétrées". C'est à dire qu'au lieu de leur affecter une valeur fixe, on leur assigne un nom de variable (ex. : X1, X2, etc), et la valeur prise par cette variable sera lue dans un fichier texte contenant ces variables ainsi que leur valeur.

L'intérêt de cette option est de pouvoir générer ou modifier ce fichier .par à la main ou par un programme extérieur (Notepad, MatLab, Scilab, R, etc), et ainsi de piloter des simulations avec des variables facilement modifiées. Des utilisations possibles par exemple sont pour des séquences automatiques de calcul, pour des analyses de sensibilité, de l'optimisation, du calage, etc.

Comment paramétrer une variables ?

Pour "Paramétrer" une variable du modèle (Condition au limite de prise, caractéristique d'un ouvrage, Manning-Strickler, infiltration...), il faut cliquer sur les outils situés à droite du champ à paramétrer :

La génération des noms des variables (X1, X2, etc) se fait de manière automatique, avec la lettre X, et un nombre qui est incrémenté automatiquement.

Il est aussi possible d'ajouter des variables paramétrées en renseignant directement le fichier .par (voir le format du fichier .par pour plus de détails).

Manipulation du fichier des variables paramétrées dans EdiSic

Le menu "Variable paramétrées" dans le mode Hydraulique permet d'avoir une vision synthétique de ces variables ainsi que leur valeurs par défaut. Au moment de l'exécution du calcul hydraulique du scénario (et éventuellement de la variante correspondante), si le fichier .par est trouvé et si la valeur de la variable est trouvée, alors c'est cette valeur qui sera utilisée. Sinon ce sera la valeur par défaut.

SIC^2 : Logiciel de Simulation Intégrée des Canaux et de leur Contrôle