Salome HOME
Merge branch 'BR_H2018_DRAFT' into BR_2018_V8_5
[modules/hydro.git] / doc / salome / tutorial / interpolationZ.rst
index f74aee8c430d6d4e1a5ca6805907b7c5d42b193c..faaf79ad2ae16e5080438cbdeab535824b045aac 100644 (file)
@@ -53,16 +53,16 @@ Calcul de l'interpolation en Z aux noeuds du maillage
 
 La constitution du champ d'altitude se fait au moyen d'un script Python, qu'il faut préparer, puis exécuter.
 
-Le script utilise une association des régions du cas de calcul HYDRO aux groupes de noeuds correspondants dans le maillage.
+Le script utilise une association des régions du cas de calcul HYDRO aux groupes de faces correspondants dans le maillage.
 Une commande du module HYDROSOLVER facilite la définition de cette association.
 
-Il faut maintenant activer le module HYDROSolveur, via la liste défilante des modules, ou son icône dans le bandeau : |HYDROSolver|.
+Il faut maintenant activer le module HYDROSOLVER, via la liste défilante des modules, ou son icône dans le bandeau : |HYDROSolver|.
 Nous utilisons la commande *Generate interpolz.py* du menu *Hydro*.
 
 Il faut sélectionner le cas de calcul dans la rubrique *HYDRO / CALCULATION CASE* de l'arbre d'étude.
 Son nom apparaît dans la première ligne *Calculation cas* du dialogue.
 
-Le chemin compplet du script à créer doit être renseigné dans la rubrique *Output path*.
+Le chemin complet du script à créer doit être renseigné dans la rubrique *Output path* (le nom du script doit se terminer par .py).
 
 Il faut désigner le fichier du maillage de départ construit à l'étape précédente dans rubrique *MED file*.
 
@@ -76,7 +76,7 @@ Quand le maillage est plus dense que le nuage, il vaut mieux prendre l'altitude
 une triangulation préalable du nuage de points. Cette dernière méthode est plus précise
 mais un peu plus coûteuse.
 
-Il faut sélectionner les bons noms de régions en correspondance avec les noms des groupes de noeuds des faces,
+Il faut sélectionner les bons noms de régions en correspondance avec les noms des groupes de faces,
 en laissant la sélection à *None* pour les autres groupes.
 
   |genereInterpolz|
@@ -85,22 +85,25 @@ Le script produit plusieurs fichiers dont le nom se déduit du nom du fichier ma
 avec des suffixes différents, rangés dans le répertoire du fichier d'origine :
 
 * garonne_1.med  : fichier d'origine (coordonnée z = 0)
-* garonne_1.xyz  : fichier xyz (ASCII) des altitudes aux noeuds
-* garonne_1Z.med : étape intermédiaire du script
+* garonne_1.xyz  : fichier xyz (ASCII) des altitudes aux noeuds *(optionnel)*
 * garonne_1F.med : coordonnée Z à sa valeur calculée, et champ "BOTTOM" avec la valeur Z aux noeuds
 
+**Remarque** : La modification de la coordonnée Z des noeuds du maillage n'est pas nécessaire à TELEMAC,
+mais utile pour une visualisation de contrôle du maillage.
+
 Pour exécuter le script, il faut que le module HYDRO soit bien actif dans l'étude.
-Si l'on reprend une étude précédemment sauvegardée, il faut avoir activé le module HYDRO avant
-de lancer le script (il suffit de sélectionner HYDRO au moins une fois,
+**Si l'on reprend une étude précédemment sauvegardée, il faut avoir activé le module HYDRO avant
+de lancer le script** (il suffit de sélectionner HYDRO au moins une fois,
 pour que les données stockées dans le fichier d'étude soient lues).
 Nous exécutons le script avec la commande du menu *File / Load Script...*.
-Le script bloque l'interface graphique le temps de son exécution. Il affiche une trace d'exécution dans la console
+Le script bloque l'interface graphique le temps de son exécution qui dépend de la taille du maillage
+et des nuages de point de bathymétrie. Il affiche une trace d'exécution dans la console
 Python qui est affichée par défaut dans les modules GEOM et SMESH.
 
 Il est aussi possible d'adapter manuellement le script ci-dessous :
 
 Il faut recopier le script et l'adapter en fonction des noms de régions utilisés dans le cas de calcul
-et des noms de groupes de noeuds dans le maillage.
+et des noms de groupes de faces dans le maillage.
 
 .. literalinclude:: interpolZ.py
     :lines: 1-