Salome HOME
Update SMESH documentation
[modules/smesh.git] / doc / salome / gui / SMESH / input / constructing_meshes.doc
index 995ee43774abdcd2c90ffa944fbd091afb08a435..efbd97403cd83793192ee8192d1a698a785bba35 100644 (file)
@@ -5,8 +5,8 @@
 \n Construction of a mesh consists of:
 <ul>
 <li>Selecting a geometrical object for meshing</li>
-<li>Applying \ref basic_meshing_algos_page "meshing algorithms" and
-\ref about_hypo_page "hypotheses" which will be used at computation of
+<li>Applying \subpage basic_meshing_algos_page "meshing algorithms" and
+\subpage about_hypo_page "hypotheses" which will be used at computation of
 this mesh.</li>
 </ul>
 
@@ -15,7 +15,7 @@ this mesh.</li>
 <li>In the \b Mesh menu select <b>Create Mesh</b> or click <em>"Create
 Mesh"</em> button in the toolbar. 
 
-\image html image32.gif
+\image html image32.png
 <center><em>"Create Mesh" button</em></center>
 
 The following dialog box will appear: 
@@ -27,7 +27,7 @@ The following dialog box will appear:
 it is "Mesh_1". Then select the object you wish to mesh in the Object
 Browser and click the "Add" button.
 
-\image html image120.gif
+\image html image120.png
 <center><em>"Add" button</em></center>
 
 Now you can define 1d Algorithm and 1d Hypotheses, which will be
@@ -35,13 +35,13 @@ applied to the edges of your object. (Note that any object has edges,
 even if their existence is not apparent, for example, a sphere has 4
 edges). Click the <em>"Add Hypothesis"</em>  button to add a hypothesis.
 
-\image html image121.gif
+\image html image121.png
 <center><em>"Add Hypothesis" button</em></center>
 
 Click the <em>"Edit Hypothesis"</em> button to define values for the
 current hypothesis.
 
-\image html image122.gif
+\image html image122.png
 <center><em>"Edit Hypothesis" button</em></center>
 
 The use of additional hypotheses is optional (i.e. you may leave
@@ -73,11 +73,41 @@ Automatic Tetrahedralization or Hexahedralization.  The program will
 automatically generate a 3D mesh with the most appropriate
 settings. In the same way you can apply this functionality for meshing
 2D objects, in which case 3D algorithms are not applied.</li>
-<li>Now, when everything is ready, select your mesh in the <b>Object
+
+<li> After the mesh object is created and all hypotheses are assigned and
+before the mesh computation, it is possible to see the mesh preview.
+
+For this, select the mesh in the Object Browser. From the \b Mesh menu
+select \b Preview or click "Preview" button in the
+toolbar or activate "Preview" item from the pop-up menu.
+
+\image html mesh_precompute.png
+<center><em>"Preview" button</em></center>
+
+Select <b>1D mesh</b> or <b>2D mesh</b> preview mode in the Preview dialog. 
+
+
+\image html preview_mesh_1D.png "1D mesh preview shows nodes computed on geometry edges"
+
+\image html preview_mesh_2D.png "2D mesh preview shows edge mesh elements, computed on geometry faces"
+
+<b>Compute</b> button computes the whole mesh.
+
+When the Preview dialog is closed, the question about the storage of temporarily
+created mesh elements appers:
+
+\image html preview_tmp_data.png
+
+These elenents can be reused in the next mesh computation.
+</li>
+
+
+<li>It is equally possible to skip the Preview and \b Compute the mesh
+after the hypotheses are assigned. For this, select your mesh in the <b>Object
 Browser</b>. From the \b Mesh menu select \b Compute or click "Compute" button of the
 toolbar. 
 
-\image html image28.gif
+\image html image28.png
 <center><em>"Compute" button</em></center>
 
 The Mesh Computation information box appears.
@@ -90,12 +120,21 @@ failure is provided.
 \image html meshcomputationfail.png
 
 After you select the error, <b>Show Subshape</b> button allows
-visualizing the mesh elements that cause it.
+visualizing the geometrical entity that causes it.
+
+\image html failed_computation.png "Example of the invalid input mesh"
 
-\image html failed_computation.png
+\Note Mesh Computation Information box does not appear if you set
+"Mesh computation/Show a computation result notification" preference 
+to the "Never" value. This option gives the possibility to control mesh
+computation reporting. There are the following possibilities: always
+show information box, only if an error occurs or never. 
+By default, the information box is always shown after mesh computation operation.
 
-<b>Publish Subshape</b> button allows importing it in a separate MED
-or UNV file.
+<b>Publish Subshape</b> button publishes the subshape, whose meshing
+failed, in GEOM component as a child of the mesh geometry, which
+allows analyzing the problem geometry and creating a submesh on it in
+order to locally tune hypotheses.
 
 <b>NOTE</b> It is possible to define a 1D or a 2D mesh in a
 python script and then use such submeshes in the construction of a 3D