Salome HOME
Merge branch 'BR_2018_V8_5' into BR_PY3
[modules/hydro.git] / doc / salome / tutorial / english / english_interpolationZ.rst
index a97662fbd6f1747cf964bc42e427d59c8aa135d0..0470ed4f5786729c5484792a47204048e83fd29e 100644 (file)
@@ -50,29 +50,29 @@ Calculation of the Z interpolation at the mesh nodes
 
 The altitude field is constituted by means of the following Python script that must be generated and then run.
 
-Le script utilise une association des régions du cas de calcul HYDRO aux groupes de noeuds correspondants dans le maillage.
-Une commande du module HYDROSOLVER facilite la définition de cette association.
+In the script, the regions of the HYDRO calculation case are associated to the corrresponding faces group of the mesh.
+A specific command in HYDROSOLVER module helps to build this association.
 
-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*.
+The HYDROSOLVER module is activated with a selection in the module list (combo box) or its icon in the toolbar: |HYDROSolver|.
+Activate the command *Generate interpolz.py* in the *Hydro* menu.
 
-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.
+Select the calculation case in the study tree, under the folder *HYDRO / CALCULATION CASE*.
+Its name appears in the first line of the dialog: *Calculation case*.
 
-Le chemin complet du script à créer doit être renseigné dans la rubrique *Output path* (le nom du script doit se terminer par .py).
+In the *Output path* field, give the full path of the Python script to create (script name must end with .py).
 
-Il faut désigner le fichier du maillage de départ construit à l'étape précédente dans rubrique *MED file*.
+In the *MED file* field, select the mesh field produced at the previous step.
 
-La valeur *Undefined Z* est utilisée quand le module HYDRO ne sait pas calculer l'altitude en un point.
-C'est utilisé a postériori pour détecter d'éventuels problèmes de définition des zones de calcul dans le cas de calcul.
+*Undefined Z* is used when he HYDRO module does not know how to calculate the altitude on a point.
+This may be used to help in case of problems in the zones definition in the calculation case.
 
 The interpolation of point clouds can be done in two ways, depending on whether the clouds are denser than the mesh, or vice versa.
 For very dense point clouds, it suffices to take the altitude of the closest point in the cloud.
 If the mesh is denser than the cloud, it is better to use linearised interpolation, obtained by previous triangulation of the point cloud. 
 This last method is more accurate but slightly more costly, computationally. 
 
-Il faut sélectionner les bons noms de régions en correspondance avec les noms des groupes de noeuds des faces,
-en laissant la sélection à *None* pour les autres groupes.
+The region names must be selected in correspondance of their group of faces (representing the same geometric face),
+and, for the other groups, the selection should be *None*. 
 
   |genereInterpolz|
 
@@ -80,10 +80,11 @@ The script produces several files, whose names are derived from the original fil
 which are stored in the original file's directory: 
 
  * garonne_1.med: original file (z coordinate = 0) 
- * garonne_1.xyz: xyz file (ASCII) of the altitudes at the nodes 
- * garonne_1Z.med: intermediate step of the script 
+ * garonne_1.xyz: xyz file (ASCII) of the altitudes at the nodes *(optional)*
  * garonne_1F.med: calculated value of the Z coordinate and “BOTTOM” field with the Z-value at each node 
 
+**Remark** : The Z coordinate on mesh nodes is not used by TELEMAC, but is useful for visual control in SMESH.
+
 To run the script, the HYDRO module for the study must be active. If resuming work on a study that was previously saved, 
 the HYDRO module must be activated before running the script 
 (simply select HYDRO at least once in order for the data stored in the study file to be read). 
@@ -94,7 +95,7 @@ It displays an execution trace in the Python console that is displayed by defaul
 
 It is also possible to edit the following script:
 
-The script needs to be copied and modified as needed for the region names used in the calculation case and for the named groups of mesh nodes.
+The script needs to be copied and modified as needed for the region names used in the calculation case and for the named groups of mesh faces.
 
 .. literalinclude:: ../interpolZ.py
     :lines: 1-