Calcul_et_exploitation - Artelia/Mascaret GitHub Wiki
Il est possible d'exporter des fichiers de configuration du modèle:
- exporter le fichier de paramètre, le xcas
- exporter le fichier de géométrie, le geo
- exporter les fichiers des casiers
- exporter l'ensemble des fichiers d'un modèle
( voir §5.1.1)
Ce menu permet d'exporter un modèle pour l'exécution dans un format compressé (.zip ou .tar.gz). Le repertoire après décompression pourra ensuite être utilisé pour lancer le modèle sur un autre ordinateur ou VM.
1. Choisir le noyau de modélisation:
- Sélectionnez le noyau de modélisation utilisé pour la création du fichier XCAS.
- Les options disponibles sont :
- Steady: pour les modèles stationnaires
- Unsteady: pour les modèles instationnaires
- Transcritical unsteady: pour les modèles transcritiques
2. Choisir un événement (optionnel):
- Si vous exportez un modèle avec un événement, sélectionnez l'événement souhaité dans la liste déroulante.
3. Choisir un run d'initialisation ou un fichier de reprise de calcul (optionnel):
- Si vous exportez un modèle Unsteady ou Transcritical unsteady, vous devez choisir un run d'initialisation déjà existant ou un fichier de reprise de calcul (*.lig).
- Le run d'initialisation fournit les conditions initiales pour le modèle et générera un fichier ".lig".
- Le fichier de reprise de calcul sera simplement copié dans le répertoire.
4. Choisir le répertoire d'exportation et le nom du fichier:
- Indiquez le répertoire où le fichier compressé sera stocké.
- Saisissez le nom du fichier compressé.
- Choisissez le type de compression:
- zip : format de compression standard, compatible avec la plupart des logiciels d'archivage.
- tar.gz : format de compression plus efficace que ZIP, mais moins compatible.
5. Editer les paramètres (optionnel):
- Cliquez sur le bouton "Edit parameters" pour modifier les différents paramètres de sortie du modèle.
- Les modifications apportées aux paramètres seront prises en compte lors de la création des fichiers du modèle.
6. Exporter le modèle:
- Cliquez sur le bouton "Export" pour lancer l'exportation du modèle.
Remarque :
Le fichier compressé (.zip ou .tar.gz) contient tous les fichiers nécessaires pour l'exécution du modèle : les différents fichiers de paramètres, ainsi que les lois et le fichier de condition initiale si nécessaire.
Dans le plugin Mascaret, cliquer sur le pictogramme 'Run' depuis la fenêtre principale.
Différentes fenêtres s'affichent pour :
- définir le solveur de calcul : permanent, fluvial ou transcritique
- définir un nom : indiquer le noyau utilisé, la description des événements, etc.
- Si on choisit un nom déjà utilisé les résultats seront écrasés.
- définir un scénario : indiquer les paramètres testés, etc.
La fenêtre principale affiche le dernier run effectué.
Remarque :
Le nombre des casiers et liaisons actives prises en compte dans le calcul est indiqué dans la zone d'informations lors de l'utilisation de l'executable.
Après un run, on peut en sauvegarder les différents fichiers grâce au bouton exporter 
.
Il y a deux façons différentes pour lancer le calcul :
- En utilisant l'executable
- En utilisant l'API de mascaret.
Pour faire ce choix du type de lancement, il faut aller dans Help > Setting > Options et cocher "Use Mascaret API" pour utiliser les API (si la case est décochée, l'executable est utilisé).
Présentation de la structure de l'interface graphique:
Il y a deux modes possibles :
- le "single mode" où est visualisé un seul résultat. Il permet de visualiser facilement les évolutions temporelles ou le long de la branche avec la barre de défilement.
- le "comparing mode" où il est possible de comparer différent résultats.
Dans les deux cas, il est possible d'afficher/masquer les courbes en cliquant sur la légende. Il est également possible de zoomer, rétablir ou enregistrer l'image à partir de cette fenêtre. De même, il est également possible d'exporter les résultats obtenus aux formats csv.
Il est aussi possible de sélectionner les colonnes (à la souris et grâce aux boutons ↑ ou ctrl) puis les copier dans un tableur grâce à Crtl+C, Crtl+V.
💡 Astuce :
Après avoir sélectionné un champ d'un menu déroulant, il est possible de passer aux autres champs grâce aux flèches ↑ et ↓ du clavier.
Dans le cas du "comparing mode", il y a la possibilité d'ajouter ou de supprimer les courbes tout en choisissant l'axe.
Il faut noter que pour supprimer une courbe, il faut bien la sélectionner en premier lieu.
Le choix a été fait de limiter à 4 résultats de comparaison pour éviter une surcharge du graphique.
Resultats sur les branches
En cliquant sur une branche, on affiche le profil en long de la branche sélectionnée :
- Le menu de chart permet d'afficher différentes grandeurs de calcul du modèle comme par exemple:
-
Levels : niveaux (NGF), avec les courbes profil en long du fond (noir), ligne d'eau à l'instant sélectionné (bleu foncé, toujours identique pour le lit mineur et lit majeur), enveloppe maximale sur l'événement simulé (rouge), laisses de crue.
-
Les croix figurant les laisses de crues sont affichées avec leur valeur :
- en vert lorsqu'elles sont au-dessus de la ligne d'eau maximale
- en violet lorsqu'elles sont au-dessous de la ligne d'eau maximale
-
La ligne d'eau instantanée évolue lorsqu'on fait évoluer le temps.
-
Il également possible de visualiser les cotes de débordement le long du profil pour la rive droite et gauche.
-
Flow rates : évolution temporelle du débit, avec les courbes lit mineur (vert), lit majeur (bleu clair) et débit total (bleu foncé) et débit maximum sur l'événement simulé (rouge).
-
Minor friction coefficient : valeurs du Ks lit mineur
-
Major friction coefficient : valeurs du Ks lit majeur
-
Froude number : nombre de Froude à l'instant sélectionné, afin de détecter les passages en régime critique (Fr=1) et transcritique (Fr>1). Ces régimes peuvent parfois être responsable des plantages dans le noyau fluvial non permanent mais indiquent à minima les secteurs dans lesquels la solution calculée est inexacte (attenuation du terme d'inertie)
-
Water depth : hauteur d'eau (par rapport au point bas des sections) à l'instant sélectionné
-
Resultats sur les profils
En cliquant sur un profil en travers, cela permet de voir l'évolution de différentes grandeurs simulées au niveau du profil (ou section) sur la durée de l'événement. Les observations disponibles sont également affichées (en particulier pour Levels=niveaux et Flows rates=débits).
On peut passer d'un point de sortie à un autre grâce à la barre de défilement ou la combobox.
- Le menu de droite (le choix de la variable) permet d'afficher différentes grandeurs sortie du modèle comme:
- Levels : évolution temporelle du niveau (NGF), avec les courbes en hauteur (bleu foncé, toujours identique pour le lit mineur et lit majeur), hauteur maximale jusqu'à l'instant concerné (rouge, par défaut non sélectionnée), laisse de crue
- Flow rates : évolution temporelle du débit, avec les courbes lit mineur (vert) lit majeur (bleu clair) et débit total (bleu foncé) et débit maximum jusqu'à l'instant concerné (rouge, par défaut non sélectionné). cf. copie d'écran ci-dessous
- Minor friction coefficient : valeur du Ks lit mineur
- Major friction coefficient : valeur du Ks lit majeur
- Froude number : évolution temporelle du coefficient de Froude, afin de détecter les passages en régime critique (Fr=1) sur transcritique (Fr>1, responsable des plantages dans le noyau fluvial non permanent)
- Water depth : hauteur d'eau (par rapport au point bas de la section)
Enfin dans le cas d'observation, il est possible de les visualiser mais également de cacluler des scores associés voir § 5.8
Pour voir la structure de l'interface § 5.3
Ce menu permet, en cliquant sur le profil choisi, de visualiser les hauteurs d'eau pour un événement dans ce profil.
Grâce au bouton ou à la barre de défilement, on peut s'intéresser soit à la hauteur max 
, ou à une hauteur obtenue à une date précise.
De plus, la discrétisation est recalculée à partir de la planimétrie et peut être visualisée. Cela est fait pour chaque partie du profil (lit mineur, lit majeur gauche, ...).
Pour recalculer la discrétisation, le calcul part du point bas de chaque partie du profil. Puis la largeur hydraulique à chaque hauteur de planimétrie est obtenue (intersection entre l'altitude du plan et le profil). La largeur, la débitance et la surface à chaque altitude sont aussi récupérées et affichées dans des tableaux se trouvant sous le graphique.
A partir de cette discrétisation, nous calculons les valeurs de largeurs miroirs, de sections mouillées et de périmètres mouillés dans le cas du Zmax mais également pour chaque partie du profil (lit mineur, lit majeur gauche, ...).
Il faut noter que le choix a été fait de partir de la discrétisation pour le calcul des sections mouillées et périmètres mouillés pour mieux correspondre au modèle numérique qui se base sur la planimétrie et les largeurs hydrauliques pour son calcul. Par exemple, la section mouillée est l'aire d'un polygone qui correspond aux planimétrie en gris dans la figure ci-dessus.
Pour voir la structure de l'interface § 5.3
Casier
- Cliquer sur l'icône de visualisation puis sur un casier.
- Sélectionner la hauteur d'eau, la surface ou le volume du casier.
Il est possible de changer de casier avec la barre de défilement et également de comparer des résultats avec le "Comparing Mode".
liaison
- Cliquer sur l'icône de visualisation puis sur une liaison.
- Sélectionner le débit ou la vitesse d'échange dans la liaison
Il est possible de changer de liaison avec la barre de défilement et également de comparer des résultats avec le "Comparing Mode".
Pour voir la structure de l'interface § 5.3
-
Cliquer sur l'icône
pour activer le choix du graphique. -
Après il faut sélectionner en fonction du type d'ouvrage mobile :
- le profil où se trouve l'ouvrage mobile
- le seuil qui est mobile
- la liaison qui est mobile
Une interface graphique s'ouvre en affichant les variables lié au mouvement de l'ouvrage ainsi que le tableau de données associé.
Il est également possible comparer des résultats avec le "Comparing Mode".
Cliquer sur l'icône 'Delete run' 
Sélectionner les runs à supprimer
Cliquer sur 'Delete selection'.
