Introduction au fonctionnement de SMESH
=======================================
-Pour spécifier le maillage, on définit en général un algorithme par défaut avec son paramétrage :
+Pour spécifier le maillage, on définit en général un algorithme par défaut avec son paramétrage :
dans SMESH, on parle des *hypothèses* de l'algorithme.
Cet algorithme et ces hypothèses s'appliquent partout sauf modification portant sur une partie de
la géométrie (*sub shape*).
-On peut donc créer des sous maillages sur une face ou un groupe de faces,
+On peut donc créer des sous maillages sur une face ou un groupe de faces,
une edge ou un groupe d'edges, pour définir des algorithmes et/ou des hypothèses spécifiques.
Lors du maillage, la géométrie de la pièce à mailler est explorée en partant de la dimension 1 (edges),
la définition de sous maillages de la ou des faces concernées sera prise en compte, sinon non.
De même, suivant l'algorithme choisi pour une face, l'onglet 1D du dialogue de maillage est actif on non.
-Il en résulte que, dans certains cas, pour certaines *sub shapes*, plusieurs algorithmes et/ou hypothèses
+Il en résulte que, dans certains cas, pour certaines *sub shapes*, plusieurs algorithmes et/ou hypothèses
sont définis, et il faut alors établir des priorités. Ces situations sont détectées automatiquement
et l'utilisateur se voit proposer des choix.
====================================================
Ici, nous allons spécifier un maillage triangle par défaut sur l'ensemble du domaine, et particulariser
-le maillage du lit mineur, pour obtenir des triangles allongés dans le sense de l'écoulement.
+le maillage du lit mineur, pour obtenir des triangles allongés dans le sens de l'écoulement.
Nous sélectionnons la géométrie *HYDRO_garonne_1* dans l'arbre d'étude, et lançons la définition du maillage :
menu *Mesh/Create Mesh* ou icône |mesh_init|.
Dans le dialogue *Create Mesh*, nous choisissons l'algorithme de maillage *Netgen 1D-2D* qui va s'appliquer
-par défaut sur l'ensemble de la géométrie.
+par défaut sur l'ensemble de la géométrie.
|Capture_CreateMesh|
-Il faut préciser les hypothèses de maillage :
+Il faut préciser les hypothèses de maillage :
Nous cliquons sur le bouton actif dans la ligne *Hypothesis* pour choisir un type d'hypothèses,
et choisissons *Netgen 2D Parameters*.
Il est possible de renommer le maillage, soit directement, soit via le dialogue d'édition, à partir du menu contextuel.
-Toujours à partir du dialogue d'édition |mesh_edit|, il est possible changer l'algorithme,
+Toujours à partir du dialogue d'édition |mesh_edit|, il est possible changer l'algorithme,
ou de modifier les hypothèses : |mesh_hypo_edit|.
Sous maillages
Nous sélectionnons le maillage dans l'arbre d'étude et créons un sous maillage (menu contextuel *Create Sub Mesh*).
Dans le dialogue qui s'affiche, il faut renseigner la géométrie, en cliquant dans l'arbre d'étude sur la face *litMineur*
-contenue dans *HYDRO_garonne_1*. Pour cette selection, il faut que la flèche du dialogue sur la ligne *Geometry* soit active.
+contenue dans *HYDRO_garonne_1*. Pour cette sélection, il faut que la flèche du dialogue sur la ligne *Geometry* soit active.
Elle l'est par défaut.
Il est utile de renommer tout de suite le sous-maillage (première ligne du dialogue).
Nous choisissons l'algorithme *Quadrangle (Medial Axis projection)*. Cet algorithme reconstruit un axe hydraulique fictif,
-découpe la rivière en quadrangles, normalement à l'axe hydraulique.
+découpe la rivière en quadrangles, normalement à l'axe hydraulique.
|Capture_CreateSubMesh|
-Il reste à définir la longeur des quadrangles, leur nombre dans la section de la rivière.
+Il reste à définir la longueur des quadrangles, leur nombre dans la section de la rivière.
Dans l'onglet *1D* du dialogue du sous maillage *litMineur*, nous choisissons l'algorithme *Wire Discretisation*
l'hypothèse *Local Length*, et prenons une longueur de 100 (mètres). Il est utile de renommer l'hypothèse à ce stade.
**remarque** : Les hypothèses et algorithmes peuvent être partagés entre plusieurs maillages et sous maillages,
-ce qui permet de modifier en un seul endroit tout ce qui doit rester cohérent. du coup, il est utile d'avoir des noms
-significatifs pour les identifier.
+ce qui permet de modifier en un seul endroit tout ce qui doit rester cohérent. du coup, **il est utile d'avoir des noms
+significatifs pour les identifier**.
|Capture_HypothesisLocalLength|
Nous validons la définition du sous maillage avec le bouton *Apply and Close*.
-La longueur que nous avons défini s'applique à la fois longitudinalement et transversalement. Pour contrôler le
+La longueur que nous avons définie s'applique à la fois longitudinalement et transversalement. Pour contrôler le
nombre de mailles transversales, il faut un nouveau sous maillage, appliqué au groupe d'edges *SectionsGaronne*.
Nous créons donc un sous maillage sur *SectionsGaronne*, en prenant cette fois comme algorithme *Wire Discretisation*
|Capture_HypothesisNbSegments|
-Nous validons la définiton du sous maillage avec le bouton *Apply and Close*.
+Nous validons la définition du sous maillage avec le bouton *Apply and Close*.
Il faut établir une priorité entre deux définitions :
|Capture_WarningOrder| |Capture_OrderingSubMeshes|
======================
Après avoir validé, le maillage est prêt pour être généré.
-Pour générer le maillage, il faut le selectionner, et utiliser le menu contextuel *Compute*.
+Pour générer le maillage, il faut le sélectionner, et utiliser le menu contextuel *Compute*.
Une boite d'information s'affiche à la fin du calcul et donne des statistiques élémentaires.
|Capture_MeshComputationSucceed|
L'icône du maillage a changé dans l'arbre d'étude, et indique l'état *généré correctement*.
Le maillage n'est pas encore fini pour nos besoins, mais nous pouvons déjà le voir.
-Pour l'afficher, *show* puis *FitAll* |vtk_view_fitall| et vue de dessus |vtk_view_top| (*-OZ*)
+Pour l'afficher, *show* puis *FitAll* |vtk_view_fitall| et vue de dessus |vtk_view_top| (*-OZ*)
dans la barre d'icônes du viewer 3D.
Pour découper les quadrangles, nous utilisons le menu *Modification/Cutting of Quadrangles*.
-Dans le dialogue, nous cochons *apply to all*, *use diagonal 1-3* puis *preview* :
+Dans le dialogue, nous cochons *apply to all*, *use diagonal 1-3* puis *preview* :
la modification proposée apparaît,
-il est possible de zoomer avec la molette de la souris pour verifier.
+il est possible de zoomer avec la molette de la souris pour vérifier.
Nous validons par *Apply and Close*.
Contrôle du maillage
Orientation des mailles
-----------------------
-Pour les maillages surfaciques XY, **SALOME oriente par défaut les triangles dans le sens contraire à ce qu'attend TELEMAC**.
-SALOME oriente les triangles avec la normale sortante vers le bas. On peut le vérifier avec la couleur des mailles
+Pour les maillages surfaciques XY, **SALOME peut orienter par défaut les triangles dans le sens contraire à ce qu'attend TELEMAC**,
+selon le sens de saisie des différentes lignes. SALOME peut donc orienter les triangles d'une face
+avec la normale sortante vers le bas. On peut le vérifier avec la couleur des mailles
(bleu plus foncé sur l'envers que sur l'endroit) ou en utilisant la commande *Orientation of Faces* du menu contextuel
de la vue 3D du maillage. Cette commande dessine une flèche par triangle. Sur l'envers de la face, on ne voit qu'un point.
Pour voir les flèches, il faut changer l'angle de vue.
Pour réorienter les faces, nous utilisons le menu *Modification / Orientation* et cochons l'option *Apply to All*.
-Après validation, les faces changent de couleur (bleu plus clair).
+Après validation, les faces changent de couleur (bleu plus clair).
Triangles surcontraints
-----------------------
Création des groupes, Enregistrement du maillage
================================================
-Pour définir les groupes dans le maillage, nous utilisons la commande *Create Groups from Geometry*
+Les groupes de noeuds et d'éléments sont utiles pour 'étape d'interpolation de la bathymétrie,
+et pour la définition des conditions limites.
+
+Pour définir les groupes dans le maillage, nous utilisons la commande *Create Groups from Geometry*
du menu contextuel du maillage.
-Nous sélectionnons tous les groupes et sub Shapes de la géometrie *HYDRO_garonne_2*
+Nous sélectionnons tous les groupes et sub Shapes de la géometrie *HYDRO_garonne_2*
et constituons successivement des groupes d'**éléments** et de **noeuds**.
|Capture_CreateGroupsFromGeometry|
nous utilisons la commande du menu *File / Export / MED file*.
.. only:: html
-
+
:ref:`ref_exempleInondation`
