X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fconstructing_meshes.doc;h=2481807fd0888fdda36ee1c0c880f28b4a8cb8c0;hb=69aa7507f2647f99203fa4b526f99c77d8c43471;hp=f28be8601fb47c83ebfef2fab0ed2fbc4a8d3d52;hpb=fd96feab4b58b9ebe8706e44b35006e0122d682e;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/constructing_meshes.doc b/doc/salome/gui/SMESH/input/constructing_meshes.doc
index f28be8601..2481807fd 100644
--- a/doc/salome/gui/SMESH/input/constructing_meshes.doc
+++ b/doc/salome/gui/SMESH/input/constructing_meshes.doc
@@ -10,13 +10,16 @@ To create a mesh on geometry, it is necessary to create a mesh object by choosin
taken into account by the chosen meshing algorithms.
Then you can launch mesh generation by invoking \ref compute_anchor "Compute" command.
+The generated mesh will be automatically shown in the Viewer. You can
+switch off automatic visualization or limit mesh size until which it is
+automatically shown in \ref mesh_preferences_page (Automatic update entry).
\note Sometimes \a hypotheses term is used to refer to both algorithms
and hypotheses.
Mesh generation on the geometry is performed in the bottom-up
flow: nodes on vertices are created first, then edges are divided into
-segments using nodes on vertices; the node of segments are then
+segments using nodes on vertices; the nodes of segments are then
used to mesh faces; then the nodes of faces are used to mesh
solids. This automatically assures the conformity of the mesh.
@@ -38,8 +41,9 @@ creation and specify the meshing parameters on sub-meshes only; then
only the sub-shapes, for which an algorithm and a hypothesis (if any)
have been defined will be discretized.
-\n Construction of a mesh on a geometry includes at least two (mesh
-creation and computing) of the following steps:
+\n Construction of a mesh on a geometry includes at least two
+(\ref create_mesh_anchor "mesh creation" and
+\ref compute_anchor "computing") of the following steps:
- \ref create_mesh_anchor "Creation of a mesh object", where you
can specify meshing parameters to apply to all sub-shapes of the
@@ -187,13 +191,9 @@ creation and computing) of the following steps:
which is a 2D object, you do not need to define a 3D Algorithm and
Hypotheses.
- In the Object Browser the structure of the new mesh will be
+ In the Object Browser the structure of the new mesh is
displayed as follows:
-
-
\image html image88.jpg
-
-
It contains:
- a mesh name (Mesh_mechanic);
@@ -203,6 +203,13 @@ creation and computing) of the following steps:
to the hypotheses chosen at the construction of the mesh;
- Applied algorithms folder containing the references
to the algorithms chosen at the construction of the mesh.
+ - SubMeshes on Face folder containing the sub-meshes
+ defined on geometrical faces. There also can be folders for
+ sub-meshes on vertices, edges, wires, shells, solids and
+ compounds.
+ - Groups of Faces folder containing the groups of mesh
+ faces. There also can be folders for groups of nodes, edges,
+ volumes 0D elements and balls.
There is an alternative way to assign Algorithms and Hypotheses by
@@ -212,15 +219,28 @@ creation and computing) of the following steps:
CustomMeshers.xml file located in the home directory. CustomMeshers.xml
file must describe sets of hypotheses in the
same way as ${SMESH_ROOT_DIR}/share/salome/resources/smesh/StdMeshers.xml
- file does (sets of hypotheses are enclosed between
- tags).
-
-
+ file does (sets of hypotheses are enclosed between \
+ tags). For example:
+~~~~~~{.xml}
+
+
+
+
+
+
+
+~~~~~~
+ If the file contents are incorrect, there can be an error at
+ activation of Mesh module: "fatal parsing error: error
+ triggered by consumer in line ..."
+
+
\image html hypo_sets.png
List of sets of hypotheses. Tag [custom] is
automatically added to the sets defined by the user.
-
-
+
\note
- \a "Automatic" in the names of predefined sets of hypotheses
does not actually mean that they are suitable for meshing any
@@ -249,7 +269,9 @@ information box:
Previewing the mesh
Before \ref compute_anchor "the mesh computation", it is also possible
-to see the mesh preview.
+to see the mesh preview. This operation allows to incrementally
+compute the mesh, dimension by dimension, and to discard an
+unsatisfactory mesh.
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
@@ -294,24 +316,24 @@ There is an example of sub-mesh order modifications taking a Mesh created on a B
shape. The main Mesh object:
- 1D Wire discretisation with Number of Segments=20
- - 2D Triangle (Mefisto) with HypothesisMax Element Area
+
- 2D Triangle: Mefisto with HypothesisMax Element Area
The first sub-mesh Submesh_1 created on Face_1 is:
- 1D Wire discretisation with Number of Segments=4
- - 2D Triangle (Mefisto) with Hypothesis MaxElementArea=1200
+ - 2D Triangle: Mefisto with Hypothesis MaxElementArea=1200
The second sub-mesh Submesh_2 created on Face_2 is:
- 1D Wire discretisation with Number of Segments=8
- - 2D Triangle (Mefisto) with Hypothesis MaxElementArea=1200
+ - 2D Triangle: Mefisto with Hypothesis MaxElementArea=1200
And the last sub-mesh Submesh_3 created on Face_3 is:
- 1D Wire discretisation with Number of Segments=12
- - 2D Triangle (Mefisto) with Hypothesis MaxElementArea=1200
+ - 2D Triangle: Mefisto with Hypothesis MaxElementArea=1200
The sub-meshes become concurrent if they share sub-shapes that can be
@@ -367,8 +389,8 @@ will see the following information.
It is equally possible to skip \ref evaluate_anchor "the Evaluation"
and \ref preview_anchor "the Preview" and to \b Compute the mesh after
the hypotheses are assigned. For this, select your mesh in
-the Object Browser. From the \b Mesh menu select \b Compute or
-click "Compute" button of the toolbar.
+the Object Browser. From the \b Mesh menu or the context menu
+select \b Compute or click \a "Compute" button of the toolbar.
\image html image28.png
@@ -382,6 +404,7 @@ re-computed and the Mesh Computation information box will be shown
with the same contents. (To fully re-compute the mesh, invoke
\ref clear_mesh_anchor "Clear Mesh Data" command before).
+\anchor meshing_result_anchor
If the mesh computation has been a success, the box shows information
on the number of entities of different types in the mesh.
@@ -393,8 +416,9 @@ failure is provided in \b Errors table.
\image html meshcomputationfail.png
-After you select an error, Show Sub-shape button allows
-visualizing in magenta the geometrical entity that causes the error.
+After you select an error in \b Errors table, Show Sub-shape button allows
+visualizing in magenta the geometrical entity meshing of which failed
+(Name of this entity or its ID and type is shown in \a Sub-shape column).
\image html failed_computation.png
@@ -425,7 +449,7 @@ to facilitate their analysis.
\note Mesh Computation Information box does not appear if you set
-"Mesh computation/Show a computation result notification" preference
+\ref show_comp_result_pref "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 the information box, show only if an error occurs or never.