]> SALOME platform Git repositories - modules/smesh.git/commitdiff
Salome HOME
Update docs
authoreap <eap@opencascade.com>
Thu, 14 May 2015 09:51:53 +0000 (12:51 +0300)
committereap <eap@opencascade.com>
Thu, 14 May 2015 09:51:53 +0000 (12:51 +0300)
12 files changed:
doc/salome/gui/SMESH/input/area.doc
doc/salome/gui/SMESH/input/borders_at_multi_connection.doc
doc/salome/gui/SMESH/input/borders_at_multi_connection_2d.doc
doc/salome/gui/SMESH/input/convert_to_from_quadratic_mesh.doc
doc/salome/gui/SMESH/input/extrusion_along_path.doc
doc/salome/gui/SMESH/input/free_borders.doc
doc/salome/gui/SMESH/input/free_edges.doc
doc/salome/gui/SMESH/input/length_2d.doc
doc/salome/gui/SMESH/input/make_2dmesh_from_3d.doc
doc/salome/gui/SMESH/input/pattern_mapping.doc
doc/salome/gui/SMESH/input/smoothing.doc
doc/salome/gui/SMESH/input/taper.doc

index f650a3fd65b1b867cd932b75fd99cdbf9560104e..765d4d4f407fd96e4eb654f2fee07481f67d14e2 100644 (file)
@@ -3,9 +3,7 @@
 \page area_page Area
 
 \n \b Area mesh quality control is based on the algorithm of area
-calculation of  meshing elements. It can be applied to meshes
-consisting of 2D meshing elements with 3 and 4 nodes (triangles and
-quadrangles).
+calculation of mesh faces.
 
 <em>To apply the Area quality control to your mesh:</em>
 <ol>
@@ -17,7 +15,7 @@ quadrangles).
 \image html image35.png
 <center><em>"Area" button</em></center>
 
-Your mesh will be displayed in the viewer with its elements colored
+Your mesh will be displayed in the viewer with its faces colored
 according to the applied mesh quality control criterion:
 
 \image html image5.jpg
index 8f92d3995f3db08ca621e6d4ef32b8892c259f75..b4f14481ffbc2041c80560332c6cf7432a7b390d 100644 (file)
@@ -2,9 +2,8 @@
 
 \page borders_at_multi_connection_page Borders at multi-connection
 
-\n This mesh quality control highlights borders of faces consisting of
-edges belonging to several faces. The amount of faces is specified by
-user.
+\n This mesh quality control highlights segments according to number
+of elements, faces and volumes, the segment belongs to.
 
 \image html image151.gif
 
@@ -13,4 +12,4 @@ In this picture the borders at multi-connection are displayed in blue.
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_borders_at_multiconnection "Borders at Multi-Connection quality control" operation.
 
-*/
\ No newline at end of file
+*/
index a0fe042901e342e59449695a0bee67095cf0336c..e0e78959b4772e4aafe51a8144c226ebbc54333b 100644 (file)
@@ -2,12 +2,12 @@
 
 \page borders_at_multi_connection_2d_page Borders at multi-connection 2D
 
-\n This mesh quality control highlights borders of elements of mesh,
-consisting of edges belonging to several elements of mesh.
+\n This mesh quality control highlights borders of faces (links
+between nodes) according to number of faces the link belongs to.
 
 \image html image127.gif
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_borders_at_multiconnection_2d "Borders at Multi-Connection quality control" operation.
 
-*/
\ No newline at end of file
+*/
index d321a2f2037333f5463f03a09970d7fdeb2870f9..a8ad620b563aa770efb9340a624f9c291d7ae9db 100644 (file)
@@ -14,7 +14,7 @@ quadratic meshes.
 <em>To produce a conversion:</em>
 <ol>
 <li>Select a mesh or a sub-mesh in the Object Browser or in the
-Viewer.</li>
+  Viewer.</li>
 <li>From the Modification menu or from the contextual menu in the
   Object Browser choose <b> Convert to/from Quadratic Mesh</b> item,
   or click <em>"Convert to/from quadratic"</em> button in the
index 7151f77b844f6c40d282da07f9de4004be7ddb22..03717c77fb60f1ed6d72d70c02a03bc73f8f3b6f 100644 (file)
@@ -3,8 +3,9 @@
 \page extrusion_along_path_page Extrusion along Path
 
 \n In principle, <b>Extrusion along Path</b> works in the same way
-as \ref extrusion_page "Extrusion", the main difference is that we define not a vector,
-but a path of extrusion which must be a 1D mesh or 1D sub-mesh. 
+as \ref extrusion_page "Extrusion", the main difference is that we
+define not a vector, but a path of extrusion which must be an 1D mesh
+or 1D sub-mesh.
 To get an idea of how this algorithm works, examine several examples,
 starting from the most simple case of extrusion along a straight edge.
 In the examples the sample mesh will be extruded along different
@@ -66,8 +67,8 @@ six coincident nodes and two coincident faces in the resulting
 mesh.</center>
 
 \image html circle_angles_after.png
-<center>The same, but using angles {45, -45, 45, -45, 45, -45, 45,
--45}</center>
+<center>The same, but using angles {45, -45, 45, -45, 45, -45, 45, -45}
+</center>
 
 <br><em>To use Extrusion along Path:</em>
 <ol>
@@ -93,7 +94,7 @@ The following dialog will appear:
       of following means:
       <ul>
         <li><b>Select the whole mesh, sub-mesh or group</b> activating this
-          checkbox.</li>
+          check-box.</li>
         <li>Choose mesh elements with the mouse in the 3D Viewer. It is
           possible to select a whole area with a mouse frame.</li>
         <li>Input the element IDs directly in <b>Node IDs</b>, <b>Edge
@@ -107,10 +108,10 @@ The following dialog will appear:
     <li>Define the \b Path along which the elements will be extruded.<br>
       Path definition consists of several elements:
       <ul>
-        <li><b>Mesh or submesh</b> - 1D mesh or sub-mesh, along which
+        <li><b>Mesh or sub-mesh</b> - 1D mesh or sub-mesh, along which
         proceeds the extrusion.</li>
-        <li><b>Start node</b> - the start node. It is used to define
-        the direction of extrusion. </li>
+        <li><b>Start node</b> - the start node of the Path. It is used
+        to define the direction of extrusion. </li>
       </ul>
     </li>
   <li>If you activate <b>Generate Groups</b> check-box, the <em>result elements</em>
index 824fbd9e04a5bbb0c0dbeb8dbc2b9c2402c1a39a..86e5e2a372d170d2b3b8bca208c9211d9f958970 100644 (file)
@@ -3,7 +3,7 @@
 \page free_borders_page Free borders
 
 \n This mesh quality control highlights borders of faces consisting of
-edges belonging to one face only.
+1D elements (segments) belonging to one face only.
 
 \image html free_borders1.png
 
index 2d51733fca1afe8ab55c9fda25563e9e42361588..1a5720ee2fd121ceef9ed79ff99cca91d7ab52e9 100644 (file)
@@ -2,8 +2,8 @@
 
 \page free_edges_page Free edges
 
-\n This mesh quality control highlights borders of  elements of mesh
-consisting of edges belonging to one element of mesh only.
+\n This mesh quality control highlights borders of faces
+consisting of node links belonging to one face only.
 
 \image html free_edges.png
 <center>In this picture some elements of mesh have been deleted and
@@ -12,4 +12,4 @@ the "holes" are outlined in red.</center>
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_free_edges "Free Edges quality control" operation.  
 
-*/
\ No newline at end of file
+*/
index 4ed5b69e6a408857ce3e01af34ae6adb0c99f644..b3599ae29f4426612687f0138bb597f01b30ae26 100644 (file)
@@ -3,8 +3,7 @@
 \page length_2d_page Length 2D
 
 \n This quality control criterion consists of calculation of length of
-the edges combining the meshing elements (triangles and quadrangles)
-of your mesh.
+the links between corner nodes of mesh faces.
 
 <em>To apply the Length 2D quality criterion to your mesh:</em>
 <ol>
@@ -16,7 +15,8 @@ of your mesh.
 \image html image34.png
 <center><em>"Length 2D" button</em></center>
 
-Your mesh will be displayed in the viewer with its elements colored according to the applied mesh quality control criterion:
+Your mesh will be displayed in the viewer with links colored according
+to the applied mesh quality control criterion:
 
 \image html length2d.png
 </li>
@@ -25,4 +25,4 @@ Your mesh will be displayed in the viewer with its elements colored according to
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_length_2d "Length 2D quality control" operation.  
 
-*/
\ No newline at end of file
+*/
index 8b9486e0add10ce364606681523542249c35fd7d..3dfec30d59f7f1e9ca637d48d5ef842c797743a1 100644 (file)
@@ -28,8 +28,8 @@ the type of operation you would like to perform.</li>
 \n "Create boundary elements" dialog allows creation of boundary elements
 of two types.
 <ul>
-<li><b>2D from 3D</b> creates mesh faces on free facets of volume elements</li>
-<li><b>1D from 2D</b> creates mesh edges on free edges of mesh faces</li>
+<li><b>2D from 3D</b> creates missing mesh faces on free facets of volume elements</li>
+<li><b>1D from 2D</b> creates missing mesh edges on free edges of mesh faces</li>
 </ul>
 Here a <em>free facet</em> means a facet shared by only one volume, a <em>free edge</em>
 means an edge shared by only one mesh face.
@@ -41,7 +41,7 @@ In this dialog:
   <ul>
   <li><b>This mesh</b> adds elements in the selected mesh.</li>
   <li><b>New mesh</b> adds elements to a new mesh. The new mesh appears
-  in the Object Browser with the name that you can change in the adjacent box. </li>
+    in the Object Browser with the name that you can change in the adjacent box. </li>
   </ul></li>
 <li>activate <b>Copy source mesh</b> checkbox to copy all elements of
 the selected mesh to the new mesh, else the new mesh will contain only
index 969b9fc5e066a39b75acea62020432974a51864c..0fee46ccc870ebd42ea98aebc82fb54ac10f40f4 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.
index dc15270a8e460109cfb6310c3f97df9fc8ad15b5..eb74611cfcae525b7a58a85b480b1311e579b3f5 100644 (file)
@@ -2,8 +2,9 @@
 
 \page smoothing_page Smoothing
 
-\n Smoothing is used to adjust the locations of element corners
-(nodes) to reduce distortions in these elements.
+\n Smoothing is used to improve quality of 2D mesh by adjusting the
+locations of element corners (nodes). \note Depending on smoothing
+method and mesh geometry smoothing can decrease quality of elements.
 
 <em>To apply smoothing to the elements of your mesh:</em>
 <ol>
@@ -23,23 +24,25 @@ The following dialog will appear:
 <ul>
 <li>specify the IDs of the elements which will be smoothed:
 <ul>
-<li><b>Select the whole mesh, submesh or group</b> activating this
-checkbox; or</li>
+<li><b>Select the whole mesh, sub-mesh or group</b> activating this
+  check-box; or</li>
 <li>choose mesh elements with the mouse in the 3D Viewer. It is
-possible to select a whole area with a mouse frame; or</li> 
-<li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
-viewer; or</li>
-<li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
-about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
+  possible to select a whole area with a mouse frame; or</li> 
+<li>input the element IDs directly in <b>ID Elements</b> field. The
+  selected elements will be highlighted in the viewer; or</li>
+<li>apply Filters. <b>Set filters</b> button allows to apply a filter
+  to the selection of elements. See more about filters in the 
+  \ref filtering_elements "Selection filter library" page.</li>
 </ul>
 </li>
 
-<li>define the <b>Fixed nodes ids</b> that should remain at their location during
-smoothing. If a mesh is built on a shape, the nodes built on its
-geometric edges are always fixed. If the smoothing is applied to a part
-of the mesh, the nodes of boundary elements are also
-fixed. It is possible to additionally fix any other nodes. The fixed nodes can be
-selected manually or by filters, just as the smoothed elements.</li>
+<li>define the <b>Fixed nodes ids</b> that should remain at their
+  location during smoothing. If a mesh is built on a shape, the nodes
+  built on its geometric edges are always fixed. If the smoothing is
+  applied to a part of the mesh (a set of element), the nodes on
+  boundary of the element set are also fixed. It is possible to
+  additionally fix any other nodes. The fixed nodes can be selected
+  manually or by filters, just as the smoothed elements.</li>
 <li>choose the <b>Smoothing Method:</b>
 <ul>
 <li>\b Laplacian smoothing pulls a node toward the center of
@@ -48,27 +51,26 @@ edge.
 <li>\b Centroidal smoothing pulls a node toward the
 element-area-weighted centroid of the surrounding elements. </li>
 
-Typically, the  Laplacian method will produce the mesh with the least element
-distortion. It is also the fastest method. Centroidal smoothing usually
-produces  a mesh with more uniform element sizes. Both methods
-produce good results with "free" meshes.</li>
+Laplacian method will produce the mesh with the least element
+edge length. It is also the fastest method. Centroidal smoothing
+produces a mesh with more uniform element sizes.</li>
 </ul>
 
 \image html image83.gif
 
 </li>
-<li>specify the <b>Iteration limit</b>. Both smoothing methods
-iterate through a number of steps to produce the resulting smoothed
-mesh. At each new step the smoothing is reevaluated with the updated nodal locations. This
-process continues till the limit of iterations has been
-exceeded, or till the aspect ratio of all element is less than or equal to the
-specified one.</li>
-<li>specify the  <b>Max. aspect ratio</b> - the target mesh quality at which the
-smoothing algorithm should stop the iterations.</li>
-<li>activate <b>in parametric space</b> checkbox if it is necessary to
-to improve the shape of faces in the parametric space
-of geometrical surfaces on which they are generated, else the shape of
-faces in the 3D space is improved. </li>   
+<li>specify the <b>Iteration limit</b>. Both smoothing methods iterate
+  through a number of steps to produce the resulting smoothed mesh. At
+  each new step the smoothing is reevaluated with the updated nodal
+  locations. This process continues till the limit of iterations has
+  been exceeded, or till the aspect ratio of all element is less than
+  or equal to the specified one.</li>
+<li>specify the  <b>Max. aspect ratio</b> - the target mesh quality at
+  which the smoothing algorithm should stop the iterations.</li>
+<li>activate <b>in parametric space</b> check-box if it is necessary to
+  improve the shape of faces in the parametric space of geometrical
+  surfaces on which they are generated, else the shape of faces in the
+  3D space is improved that is suitable for <b>planar meshes only</b>. </li>
 </ul>
 </li>
 <li>Click \b Apply or <b> Apply and Close</b> button to confirm the operation.</li>
index 143c34628a8b14fc8cb713ef200542ba03d5d966..da3ed83f65984bc275a3878fc26b5fe795c1966a 100644 (file)
@@ -3,11 +3,10 @@
 \page taper_page Taper
 
 \n \b Taper mesh quality criterion represents the ratio of the areas
-of two triangles separated by a diagonal. So it can be calculated only
-for elements consisting of 4 nodes.
+of two triangles separated by a diagonal within a quadrilateral face.
 
-  <b><center>JA=0.25 * (A1 + A2 + A3 + A4)
-  <br> TAPER= MAX(|A1/JA - 1|, |A2/JA - 1|, |A3/JA - 1|, |A4/JA - 1|)</center></b>
+  <b><center>JA = 0.25 * (A1 + A2 + A3 + A4)
+  <br> TAPER = MAX(|A1/JA - 1|, |A2/JA - 1|, |A3/JA - 1|, |A4/JA - 1|)</center></b>
 
 <br><em>To apply the Taper quality criterion to your mesh:</em>