Salome HOME
IPAL52868: Confusing error message when computing an imported mesh w/o algo assigned
[modules/smesh.git] / doc / salome / gui / SMESH / input / pattern_mapping.doc
index 969b9fc5e066a39b75acea62020432974a51864c..b42795e5d3eb2c6709c72f41f657a38a900a26a7 100644 (file)
@@ -14,17 +14,19 @@ The smp file contains 4 sections:
 
 -# The first line indicates the total number of pattern nodes (N).
 -# The next N lines describe nodes coordinates. Each line contains 2
-node coordinates for a 2D pattern or 3 node coordinates for a 3D pattern.
-Note, that node coordinates of a 3D pattern can be defined only by relative values in range [0;1].
+  node coordinates for a 2D pattern or 3 node coordinates for a 3D pattern.
+  Note, that node coordinates of a 3D pattern can be defined only by
+  relative values in range [0;1].
 -# The key-points line contains the indices of the nodes to be mapped on geometrical
-vertices (for a 2D pattern only). Index n refers to the node described 
-on the n-th line of section 2. The index of the first node zero. For a 3D pattern the key points are not specified.
+  vertices (for a 2D pattern only). Index n refers to the node described 
+  on the n-th line of section 2. The index of the first node is
+  zero. For a 3D pattern the key points are not specified.
 -# The remaining lines describe nodal connectivity of elements, one line
-for each element. Each line holds indices of nodes forming an element.
-Index n refers to the node described on the n-th line of section 2.
-The first node index is zero. There must be 3 or 4 indices on each
-line for a 2D pattern (only 2d elements are allowed) and 4, 5, 6 or 8
-indices for a 3D pattern (only 3d elements are allowed).
+  for each element. Each line holds indices of nodes forming an element.
+  Index n refers to the node described on the n-th line of section 2.
+  The first node index is zero. There must be 3 or 4 indices on each
+  line for a 2D pattern (only liner 2d elements are allowed) and 4, 5, 6 or 8
+  indices for a 3D pattern (only linear 3d elements are allowed).
 
 A 2D pattern must contain at least one element and at least one
 key-point. All key-points must lie on boundaries.
@@ -107,21 +109,24 @@ In this dialog you should specify:
 
 <ul>
 <li> \b Pattern, which can be loaded from .smp pattern file previously
-created manually or generated automatically from an existing mesh or submesh.</li>
+  created manually or generated automatically from an existing mesh or
+  sub-mesh.</li>
 <li> \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;</li>
+  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;</li>
 <li> \b Vertex to which the first key-point should be mapped;</li>
 </ul>
+
 Alternatively, it is possible to select <b>Refine selected mesh elements</b> 
 check-box and apply the pattern to <ul>
-<li> <b>Mesh Face</b> instead of a geometric Face</li>
-<li> and select \b Node instead of vertex.</li>
+  <li> <b>Mesh Face</b> instead of a geometric Face</li>
+  <li> and select \b Node instead of vertex.</li>
 </ul>
+
 Additionally it is possible to: <ul>
 <li> <b>Reverse the order of key-points</b>. By default, the vertices of
-     a face are ordered counterclockwise.</li>
+  a face are ordered counterclockwise.</li>
 <li> Enable to <b> Create polygons near boundary</b> </li>
 <li> and <b>Create polyhedrons near boundary</b></li>
 </ul>
@@ -133,17 +138,18 @@ Additionally it is possible to: <ul>
 In this dialog you should specify:
 <ul>
 <li> \b Pattern, which can be loaded from .smp pattern file previously
-created manually or generated automatically from an existing mesh or submesh.</li>
+  created manually or generated automatically from an existing mesh or
+  sub-mesh.</li>
 <li> A 3D block (Solid) object.</li>
 <li> Two vertices that specify the order of nodes in the resulting
   mesh.</li>
 </ul>
+
 Alternatively, it is possible to select <b>Refine selected mesh elements</b> 
-checkbox and apply the pattern to
+check-box and apply the pattern to
 <ul>
-<li> One or several <b>Mesh volumes</b> instead of a geometric 3D
-object</li>
-<li> and select two /b Nodes instead of vertices.</li> 
+  <li> One or several <b>Mesh volumes</b> instead of a geometric 3D object</li>
+  <li> and select two \b Nodes instead of vertices.</li> 
 </ul>
 Additionally it is possible to:
 <ul>
@@ -152,7 +158,7 @@ Additionally it is possible to:
 </ul>
 
 <br>
-<h3> Automatic Generation </h3>
+<h3> Automatic Pattern Generation</h3>
 
 To generate a pattern automatically from an existing mesh or sub-mesh,
 click \b New button.
@@ -164,8 +170,8 @@ The following dialog box will appear:
 In this dialog you should specify:
 
 <ul>
-<li> <b>Mesh or Submesh</b>, which is a meshed geometrical face (for a
-2D pattern) or a meshed solid (for a 3D pattern). Mesh nodes lying on
+<li> <b>Mesh or Sub-mesh</b>, which is a meshed geometrical face (for a
+2D pattern) or a meshed solid block (for a 3D pattern). Mesh nodes lying on
 the face vertices become key-points of the pattern. </li>
 <li> A custom <b>Pattern Name </b> </li>
 <li>Additionally, for a 2D pattern you may choose to 
@@ -204,17 +210,17 @@ The mapping algorithm for a 2D case is as follows:
   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
+- The coordinates 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
+  possible to find, where the points at the intersection of iso-lines
   and boundaries are mapped. Then it is possible to find
-  the direction of mapped isolinesection and, filally, the poitions of
+  the direction of mapped iso-line section and, finally, the positions 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. 
 position of the node is found as an average of the positions on mapped
 iso-lines. 
 \image html image97.gif
 
 The 3D algorithm is similar.