X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fpattern_mapping.doc;fp=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fpattern_mapping.doc;h=ef7f8ba66a704be2910dfba199764ad1a3e4665f;hb=ccac421ca7a3b986d981a0287ad2b87178f1ab90;hp=8421b1d87c2b39ae94bedc9c8e61420cf3396b26;hpb=ca1d1004c329914aa7d042b707c3c0a9c18c16bf;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/pattern_mapping.doc b/doc/salome/gui/SMESH/input/pattern_mapping.doc
index 8421b1d87..ef7f8ba66 100644
--- a/doc/salome/gui/SMESH/input/pattern_mapping.doc
+++ b/doc/salome/gui/SMESH/input/pattern_mapping.doc
@@ -99,92 +99,118 @@ From the \b Modification menu choose the Pattern Mapping item or click
The following dialog box will appear:
-\n 2D pattern
+\n For a 2D pattern
\image html patternmapping1.png
In this dialog you should specify:
- - A face with the number of vertices equal to the number of
+
- \b Pattern, which can be loaded from .smp pattern file previously
+created manually or generated automatically from an existing mesh or submesh.
+- \b Face with the number of vertices equal to the number of
key-points in the pattern; the number of key-points on internal
boundaries of the pattern must also be equal to the number of vertices
on internal boundaries of the face;
- - A vertex to which the first key-point should be mapped;
- - If the order of key-points is reversed or not. (The order of vertices of
- a face is counterclockwise looking from the outside).
+- \b Vertex to which the first key-point should be mapped;
+Alternatively, it is possible to select Refine selected mesh elements
+checkbox and apply the pattern to
+- Mesh Face instead of a geometric Face
+- and select \b Node instead of vertex.
+
+Additionally it is possible to:
+- Reverse the order of key-points By default, the vertices of
+ a face are ordered counterclockwise.
-
+
- Enable to Create polygons near boundary
+- and Create polyhedrons near boundary
-
-\n 3D pattern
+\n For a 3D pattern
\image html patternmapping2.png
In this dialog you should specify:
+- \b Pattern, which can be loaded from .smp pattern file previously
+created manually or generated automatically from an existing mesh or submesh.
- A 3D block (Solid) object;
- Two vertices that specify the order of nodes in the resulting mesh.
+Alternatively, it is possible to select Refine selected mesh elements
+checkbox and apply the pattern to
+- One or several Mesh volumes instead of a geometric 3D
+object
+- and select two /b Nodes instead of vertices.
+Additionally it is possible to:
+- Enable to Create polygons near boundary
+- and Create polyhedrons near boundary
-
-Then you either load a .smp pattern file previously created manually
-by clicking on the "Load pattern" button, or click on the \b
-New button for automatic generation of the pattern.
+\n Automatic Generation
-For automatic generation you should specify a geometrical face (for a
-2D pattern) or a solid (for a 3D pattern) with a mesh built on it. Mesh nodes lying on
-face vertices become key-points of the pattern. Additionally, for a 2D
-pattern you may choose the way of getting nodes coordinates by
-projecting nodes on the face instead of using
-"positions on face" generated by mesher (if there is any). Faces
-having a seam edge can't be used for automatic pattern creation.
+To generate a pattern automatically from an existing mesh or submesh,
+click \b New button.
-When creating a pattern from an existing mesh, there are two possible
-cases:
+The following dialog box will appear:
-- A sub-mesh on face/solid is selected. A pattern is created from the 2d/3d
-elements bound to a face/solid by mesher. For 2D pattern, node coordinates are either
-"positions on face" computed by mesher, or coordinates got by node
-projection on a geometrical surface, according to the user choice. For
-3D pattern, nodes coordinates correspond to the nodes computed by mesher.
-- A mesh where the main shape is a face/solid, is selected. A pattern is
-created from all the 2d/3d elements in a mesh. In addition, for 2D
-pattern, if all mesh elements are build by mesher, the user can select
-the way of getting nodes coordinates, else all nodes are projected on
-a face surface.
+\image html a-patterntype1.png
-\image html a-patterntype.png
+In this dialog you should specify:
- 2D Pattern Creation dialog box
+
+- Mesh or Submesh, which is a meshed geometrical face (for a
+2D pattern) or a meshed solid (for a 3D pattern). Mesh nodes lying on
+the face vertices become key-points of the pattern.
+- A custom Pattern Name
+- Additionally, for a 2D pattern you may choose to
+Project nodes on the face to get node coordinates instead of using
+"positions on face" generated by the mesher (if there is any). The faces
+having a seam edge cannot be used for automatic pattern creation.
+
-\image html a-patterntype1.png
+When a pattern is created from an existing mesh, two cases are possible:
+
+- A sub-mesh on a face/solid is selected. The pattern is created from the 2d/3d
+elements bound to the face/solid by the mesher. For a 2D pattern, the node coordinates are either
+"positions on face" computed by the mesher, or coordinates got by node
+projection on a geometrical surface, according to the user choice. For
+a 3D pattern, the node coordinates correspond to the nodes computed by
+the mesher.
+- A mesh, where the main shape is a face/solid, is selected. The pattern is
+created from all 2d/3d elements in a mesh. In addition, if all mesh
+elements of a 2D pattern are built by the mesher, the user can select
+how to get node coordinates, otherwise all nodes are projected on
+a face surface.
- 3D Pattern Creation dialog box
Mapping algorithm
-The mapping algorithm for 2D case is as follows:
-
-- Key-points are set in the order that they are encountered when
- walking along a pattern boundary so that elements are on the left. The
- first key-point is preserved.
-- Find geometrical vertices corresponding to key-points by vertices
- order in a face boundary; here, "Reverse order of key-points" flag is
- taken into account. \image html image95.gif
-- Boundary nodes of a pattern are mapped onto edges of a face: a
- node located between certain key-points on a pattern boundary is
- mapped on a geometrical edge limited by corresponding geometrical
- vertices. Node position on an edge reflects its distance from two
- key-points. \image html image96.gif
-- Coordinates of a non-boundary node in a parametric space of a face
- are defined as following. In a parametric space of a pattern, a node
- lays at the intersection of two iso-lines, each of which intersects a
- pattern boundary at least at two points. Knowing mapped positions of
- boundary nodes, we find where isoline-boundary intersection points are
- mapped to, and hence we can find mapped isolines direction and then,
- two node positions on two mapped isolines. The eventual mapped
- position of a node is found as an average of positions on mapped
- isolines. \image html image97.gif
-
-For 3D case the algorithm is similar.
+The mapping algorithm for a 2D case is as follows:
+
+- The key-points are set counterclockwise in the order corresponding
+ to their location on the pattern boundary. The first key-point is preserved.
+- The geometrical vertices corresponding to the key-points are found
+ on face boundary. Here, "Reverse order of key-points" flag is set.
+\image html image95.gif
+- The boundary nodes of the pattern are mapped onto the edges of the face: a
+ node located between two key-points on the pattern boundary is
+ mapped on the geometrical edge limited by the corresponding geometrical
+ vertices. The node position on the edge depends on its distance from the
+ key-points.
+\image html image96.gif
+- The cordinates of a non-boundary node in the parametric space of the face
+ are defined in the following way. In the parametric space of the
+ pattern, the node lies at the intersection of two iso-lines. Both
+ of them intersect the pattern boundary at two
+ points at least. If the mapped positions of boundary nodes are known, it is
+ possible to find, where the points at the intersection of isolines
+ and boundaries are mapped. Then it is possible to find
+ the direction of mapped isolinesection and, filally, the poitions of
+ two nodes on two mapped isolines. The eventual mapped
+ position of the node is found as an average of the positions on mapped
+ isolines.
+\image html image97.gif
+
+The 3D algorithm is similar.
See Also a sample TUI Script of a
\ref tui_pattern_mapping "Pattern Mapping" operation.