SIC^2 : Logiciel de Simulation Intégrée des Canaux et de leur Contrôle
Format du fichier .par
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.1Syntaxe 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