Format du fichier .par

Un fichier des variables paramétrées est par créé par scénario 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.

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.

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)

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