Update SMESH documentation

diff --git a/doc/salome/gui/SMESH/images/rotation2.png b/doc/salome/gui/SMESH/images/rotation2.png
new file mode 100755 (executable)
index 0000000..366771a
Binary files /dev/null and b/doc/salome/gui/SMESH/images/rotation2.png differ

diff --git a/doc/salome/gui/SMESH/input/about_quality_controls.doc b/doc/salome/gui/SMESH/input/about_quality_controls.doc
index 9872b6c9f3dce44a2511bb22f055073b994567aa..0d7ab61b0b05f5bbd7c39214228b1cf3e488c61c 100644 (file)
--- a/doc/salome/gui/SMESH/input/about_quality_controls.doc
+++ b/doc/salome/gui/SMESH/input/about_quality_controls.doc
@@ -17,7 +17,7 @@ There are 0D, 1D, 2D and 3D quality controls.
 
 0D mesh quality controls:
 <ul>
 
 0D mesh quality controls:
 <ul>

-<li>\subpage free_nodes_page "Free nodes"</li>
+<li>\ref free_nodes_page "Free nodes"</li>

 </ul>
 
 1D mesh quality controls:
 </ul>
 
 1D mesh quality controls:


@@ -29,6 +29,7 @@ There are 0D, 1D, 2D and 3D quality controls.
 
 2D mesh quality controls:
 <ul>
 
 2D mesh quality controls:
 <ul>

+<li>\subpage free_nodes_page "Free nodes"</li>

 <li>\subpage free_edges_page "Free edges"</li>
 <li>\subpage length_2d_page "Length 2D"</li>
 <li>\subpage borders_at_multi_connection_2d_page "Borders at multi-connection 2D"</li>
 <li>\subpage free_edges_page "Free edges"</li>
 <li>\subpage length_2d_page "Length 2D"</li>
 <li>\subpage borders_at_multi_connection_2d_page "Borders at multi-connection 2D"</li>

diff --git a/doc/salome/gui/SMESH/input/adding_nodes_and_elements.doc b/doc/salome/gui/SMESH/input/adding_nodes_and_elements.doc
index 179e7885ab69ba13dff0a32d41ca683237758b1a..fc727701b3ae3fb4812bbbef907a4477c9391bce 100644 (file)
--- a/doc/salome/gui/SMESH/input/adding_nodes_and_elements.doc
+++ b/doc/salome/gui/SMESH/input/adding_nodes_and_elements.doc
@@ -43,11 +43,6 @@ created:
 
 \image html add_node.png
 
 
 \image html add_node.png
 

-\note You can also use variables defined in the SALOME \b NoteBook
-to specify coordinates of the node:
-
-\image html addnode_notebook.png
-

 <br>
 \anchor adding_edges_anchor
 <h2>Adding edges</h2>
 <br>
 \anchor adding_edges_anchor
 <h2>Adding edges</h2>

diff --git a/doc/salome/gui/SMESH/input/constructing_meshes.doc b/doc/salome/gui/SMESH/input/constructing_meshes.doc
index d62feac7cc5102ef33d3a00a1ae361877ac6e11f..efbd97403cd83793192ee8192d1a698a785bba35 100644 (file)
--- a/doc/salome/gui/SMESH/input/constructing_meshes.doc
+++ b/doc/salome/gui/SMESH/input/constructing_meshes.doc
@@ -73,7 +73,37 @@ 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>
 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. 
 
 Browser</b>. From the \b Mesh menu select \b Compute or click "Compute" button of the
 toolbar. 
 

diff --git a/doc/salome/gui/SMESH/input/extrusion.doc b/doc/salome/gui/SMESH/input/extrusion.doc
index ea25158f1eff42bdb57cc0b6c082fb091ad16bbb..1a91dbcb43e8c1ff33013b8e000fee0b79ac8f95 100644 (file)
--- a/doc/salome/gui/SMESH/input/extrusion.doc
+++ b/doc/salome/gui/SMESH/input/extrusion.doc
@@ -16,38 +16,36 @@ and Hexahedron solids respectively.
 \image html image91.png
 <center><em>"Extrusion" button</em></center>
 
 \image html image91.png
 <center><em>"Extrusion" button</em></center>
 

-The following dialog box will appear:
+The following dialog common for line and planar elements will appear:

 
 \image html extrusionalongaline1.png
 
 
 \image html extrusionalongaline1.png
 

-\image html extrusionalongaline2.png

 </li>
 
 </li>
 

-<li>In this dialog box you should select:
+<li>In this dialog:

 <ul>
 <ul>

-<li>the type of elements which will be extruded (1D or 2D),</li>
-<li>specify the IDs of the elements which will be extruded by
-selecting them in the 3D viewer or select the whole mesh or
-submesh,
+<li>select the type of elements which will be extruded (1D or 2D),</li>
+<li>specify the IDs of the elements which will be extruded:

 <ul>
 <ul>

-<li>Check on <b>Select the whole mesh, submesh or group</b> option
-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on an element in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the elements. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</li>
+<li><b>Select the whole mesh, submesh or group</b> activating this
+checkbox; 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>

 </ul>
 </li>
 <li>specify the distance at which the elements will be extruded,</li>
 <li>specify the vector along which the elements will be extruded,</li>
 </ul>
 </li>
 <li>specify the distance at which the elements will be extruded,</li>
 <li>specify the vector along which the elements will be extruded,</li>

-<li>number of steps.</li>
-</ul>
-<li> <b>Generate Groups</b> checkbox allows copying the groups of
+<li>specify the number of steps;</li>
+<li>activate  <b>Generate Groups</b> checkbox if it is necessary to copy the groups of

 elements of the source mesh to the newly created one. </li>
 </li>
 elements of the source mesh to the newly created one. </li>
 </li>

+</ul>

 
 

-<li>Click the \b Apply or \b OK button.</li>
+<li>Click \b Apply or <b> Apply and Close</b>  button to confirm the operation.</li>

 </ol>
 
 \image html image77.jpg "The mesh with an edge selected for extrusion"
 </ol>
 
 \image html image77.jpg "The mesh with an edge selected for extrusion"

diff --git a/doc/salome/gui/SMESH/input/extrusion_along_path.doc b/doc/salome/gui/SMESH/input/extrusion_along_path.doc
index d35d233151c133404d8cf5e6e7a1f677d719d4a5..31174dde2b7de7cd5ce8eb49dc47ca0bd6dcb5a7 100644 (file)
--- a/doc/salome/gui/SMESH/input/extrusion_along_path.doc
+++ b/doc/salome/gui/SMESH/input/extrusion_along_path.doc
@@ -88,26 +88,27 @@ path</b> item or click <em>"Extrusion along a path"</em> button in the toolbar.
 \image html image101.png
 <center><em>"Extrusion along a path" button</em></center>
 
 \image html image101.png
 <center><em>"Extrusion along a path" button</em></center>
 

-The following dialog box will appear:
+The following dialog common for line and planar elements will appear:

 
 \image html extrusion1.png
 
 \image html extrusion1.png

-
-\image html extrusion2.png

 </li>
 
 </li>
 

-<li>In the dialog box you should:
+<li>In this dialog:

 <ul>
 <li>select the type of elements which will be extruded (1D or 2D),</li>
 <li>specify the <b>IDs of the elements</b> which will be extruded
 <ul>
 <li>select the type of elements which will be extruded (1D or 2D),</li>
 <li>specify the <b>IDs of the elements</b> which will be extruded

+

 <ul>
 <ul>

-<li>Check on <b>Select the whole mesh, submesh or group</b> option
-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on an element in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the elements. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</li>
+<li><b>Select the whole mesh, submesh or group</b> activating this
+checkbox; 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>

 </ul>
 </ul>

+

 </li>
 <li>define the Path along which the elements will be extruded,
 \n Path definition consists of several elements:
 </li>
 <li>define the Path along which the elements will be extruded,
 \n Path definition consists of several elements:


@@ -117,7 +118,7 @@ about filters on the
 <li><b>Start node</b> - the first or the last node on the edge. It is used to define the direction of extrusion </li>
 </ul>
 </li>
 <li><b>Start node</b> - the first or the last node on the edge. It is used to define the direction of extrusion </li>
 </ul>
 </li>

-<li> <b>Generate Groups</b> checkbox allows copying the groups of
+<li>activate  <b>Generate Groups</b> checkbox if it is necessary to  copy the groups of

 elements of the source mesh to the newly created one. </li>
 </ul>
 </li>
 elements of the source mesh to the newly created one. </li>
 </ul>
 </li>


@@ -149,7 +150,9 @@ At each step the shape will be rotated by angle/nb. of steps.
 </ul>
 </li>
 
 </ul>
 </li>
 

-<li>Click the \b Apply or \b OK button. Mesh edges will be extruded into
+
+<li>Click \b Apply or <b> Apply and Close</b>  button to confirm the operation.
+Mesh edges will be extruded into

 faces, faces into volumes. The external surface of the resulting 3d
 mesh (if faces have been extruded) is covered with faces, and corners
 with edges. If the path is closed, the resulting mesh can contain
 faces, faces into volumes. The external surface of the resulting 3d
 mesh (if faces have been extruded) is covered with faces, and corners
 with edges. If the path is closed, the resulting mesh can contain

diff --git a/doc/salome/gui/SMESH/input/free_faces.doc b/doc/salome/gui/SMESH/input/free_faces.doc
index 4a87b992ac739a982c9b5d542bced727059b159e..68a986efd814d4344fda9ac9ee0a0201758a4113 100644 (file)
--- a/doc/salome/gui/SMESH/input/free_faces.doc
+++ b/doc/salome/gui/SMESH/input/free_faces.doc
@@ -2,14 +2,14 @@
 
 \page free_faces_page Free faces
 
 
 \page free_faces_page Free faces
 

-\n This mesh quality control highlights faces which are connected
-less than to two mesh volume elements. Free faces are shown with a color differs from
-the color of shared faces.
+\n This mesh quality control highlights the faces connected
+less than to two mesh volume elements. The free faces are shown with a
+color different from the color of shared faces.

 
 \image html free_faces.png
 
 \image html free_faces.png

-<center>In this picture some volume mesh element are removed as
-a result some faces become connected only to one
-volume. i.e. become free.
+<center>In this picture some volume mesh elements have been, as
+a result some faces became connected only to one
+volume. i.e. became free.

 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_free_faces "Free Faces quality control" operation.  
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_free_faces "Free Faces quality control" operation.  

diff --git a/doc/salome/gui/SMESH/input/free_nodes.doc b/doc/salome/gui/SMESH/input/free_nodes.doc
index 13f31430994306e64f949fa205e9448420004ec1..1caaf9e4ba50aff976e4a0546a37538abe063dfb 100644 (file)
--- a/doc/salome/gui/SMESH/input/free_nodes.doc
+++ b/doc/salome/gui/SMESH/input/free_nodes.doc
@@ -2,13 +2,12 @@
 
 \page free_nodes_page Free nodes
 
 
 \page free_nodes_page Free nodes
 

-\n This mesh quality control highlights nodes which are not connected
-to any  mesh element. Free nodes are shown with a color differs from
-the color of nodes.
+\n This mesh quality control highlights the nodes which are not connected
+to any  mesh element. 

 
 \image html free_nodes.png
 
 \image html free_nodes.png

-<center>In this picture some nodes don't connected to a mesh element as
-a result of deleting elements and adding several isolated nodes.
+<center>In this picture some nodes are not connected to any mesh
+element after deleting some elements and adding several isolated nodes.

 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_free_nodes "Free Nodes quality control" operation.  
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_free_nodes "Free Nodes quality control" operation.  

diff --git a/doc/salome/gui/SMESH/input/modifying_meshes.doc b/doc/salome/gui/SMESH/input/modifying_meshes.doc
index d3149b7301eaa0d5a11623772abcfabe9c2dc2e6..f7a882524d15d3fb60613471d0e450dc7898a8cb 100644 (file)
--- a/doc/salome/gui/SMESH/input/modifying_meshes.doc
+++ b/doc/salome/gui/SMESH/input/modifying_meshes.doc
@@ -47,4 +47,7 @@ of the selected node or edge.</li>
 or vice versa.</li>
 </ul>
 
 or vice versa.</li>
 </ul>
 

+\note It is possible to use the variables defined in the SALOME \b NoteBook
+ to specify the numerical parameters used for modification of any object.
+

 */
\ No newline at end of file
 */
\ No newline at end of file

diff --git a/doc/salome/gui/SMESH/input/preview_meshes.doc b/doc/salome/gui/SMESH/input/preview_meshes.doc
deleted file mode 100644 (file)
index 92a4cca..0000000
--- a/doc/salome/gui/SMESH/input/preview_meshes.doc
+++ /dev/null
@@ -1,36 +0,0 @@
-/*!
-
-\page preview_meshes_page Preview and Compute meshes
-
-Before whole mesh computation it is allowed to see the mesh preview.
-When mesh object is already created and all hypotheses assigned,
-select your mesh in the <b>Object Browser</b>. From the
-\b Mesh menu select \b Preview or click "Preview" button of the
-toolbar or activate "Preview" item from pop-up menu.
-
-\image html mesh_precompute.png
-<center><em>"Preview" button</em></center>
-
-The Mesh Preview dialog box appears. In this dialog box you can select
-preview mode <b>1D mesh</b> or <b>2D mesh</b> depending on assigned
-hypotheses to mesh. 
-
-The 1D mesh preview shows as nodes computed on geometry edges
-
-\image html preview_mesh_1D.png
-
-The 2D mesh preview shows edge mesh elements, computed on geometry faces
-
-\image html preview_mesh_2D.png
-
-Pressing <b>Compute</b> button leads to whole mesh computation
-process.
-During exit from Preview dialog box, the question about storage temporary
-created mesh elements appers:
-
-\image html preview_tmp_data.png
-
-Note, that computed temporary mesh elements can be reused during next
-mesh computation process.
-
-*/

diff --git a/doc/salome/gui/SMESH/input/removing_nodes_and_elements.doc b/doc/salome/gui/SMESH/input/removing_nodes_and_elements.doc
index 6e0f7f804eb404a9360221e45737b5d6f31ccd97..6cd89157302553b8021384a5022ca7837bd47ae1 100644 (file)
--- a/doc/salome/gui/SMESH/input/removing_nodes_and_elements.doc
+++ b/doc/salome/gui/SMESH/input/removing_nodes_and_elements.doc
@@ -29,15 +29,17 @@ The following dialog box will appear:
 
 \image html removenodes.png
 
 
 \image html removenodes.png
 

-In this dialog box you can specify one or several nodes
+In this dialog box you can specify one or several nodes:

 <ul>
 <ul>

-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on a node in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the nodes. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</li>
+<li>choose mesh nodes with the mouse in the 3D Viewer. It is
+possible to select a whole area with a mouse frame; or</li> 
+<li>input the node IDs directly in <b>ID Elements</b> field. The selected nodes 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 nodes. See more
+about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>

 </ul>
 </ul>

+
+

 </li>
 </ol>
 
 </li>
 </ol>
 


@@ -65,13 +67,14 @@ The following dialog box will appear:
 
 In this dialog box you can specify one or several elements
 <ul>
 
 In this dialog box you can specify one or several elements
 <ul>

-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on an element in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the elements. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</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>

 </ul>
 </ul>

+

 </li>
 <li>Click \b Apply or <b>Apply and Close</b> to confirm deletion of the specified elements.</li>
 </ol>
 </li>
 <li>Click \b Apply or <b>Apply and Close</b> to confirm deletion of the specified elements.</li>
 </ol>

diff --git a/doc/salome/gui/SMESH/input/revolution.doc b/doc/salome/gui/SMESH/input/revolution.doc
index 67dfdb374cdb1aea48c01967dbd00b1b7b3715cf..503799d4e0da34777267d0f0ce53ee9ab291104c 100644 (file)
--- a/doc/salome/gui/SMESH/input/revolution.doc
+++ b/doc/salome/gui/SMESH/input/revolution.doc
@@ -16,31 +16,40 @@ on the revolution axis).
 \image html image92.png
 <center><em>"Revolution" button</em></center>
 
 \image html image92.png
 <center><em>"Revolution" button</em></center>
 

-The following dialog box shall appear:
+The following dialog common for line and planar elements will appear:

 
 \image html revolution1.png
 
 
 \image html revolution1.png
 

-\image html revolution2.png

 </li>
 
 <li>
 </li>
 
 <li>

-In this dialog box you should specify:
+In this dialog you should specify:

 <ul>
 <li>the type of elements which will be extruded (1D or 2D),</li>
 <ul>
 <li>the type of elements which will be extruded (1D or 2D),</li>

-<li>specify the IDs of the elements which will be revolved
+<li>specify the IDs of the elements which will be revolved:
+
+
+<ul>
+<li><b>Select the whole mesh, submesh or group</b> activating this
+checkbox; 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>
+</ul>
+</li>
+
+<li>specify the axis of revolution:

 <ul>
 <ul>

-<li>Check on <b>Select the whole mesh, submesh or group</b> option
-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on an element in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the elements. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</li>
+<li>specify the cooordinates of the start \b Point of the vector of revolution;</li>
+<li>specify the \b Vector of revolution through the coordinates of its
+end point with respect to the coordinates of the start point;</li>

 </ul>
 </li>
 </ul>
 </li>

-<li>specify the axis (point and vector) around which the elements will
-be revolved,</li>
-<li>angle of rotation and number of steps,</li>
+
+<li>specify the angle of revolution and the number of revolution steps,</li>

 <ul> <li> Angle by Step - the elements are extruded by the specified angle at each step (i.e. for Angle=30 and Number of Steps=2, the elements will be extruded 
  by 30 degrees twice for a total of 30*2=60)</li>
 
 <ul> <li> Angle by Step - the elements are extruded by the specified angle at each step (i.e. for Angle=30 and Number of Steps=2, the elements will be extruded 
  by 30 degrees twice for a total of 30*2=60)</li>
 


@@ -52,15 +61,17 @@ be revolved,</li>
 \image html revolutionsn1.png "Example of Revolution with Total Angle"
 
 </ul>
 \image html revolutionsn1.png "Example of Revolution with Total Angle"
 
 </ul>

-<li>tolerance of rotation</li>
-</ul>
+</li>
+
+<li>specify the tolerance for the operation</li>

 
 

-<li> <b>Preview</b> checkbox allows showing the results of parameter-setting in the viewer </li>
-<li> <b>Generate Groups</b> checkbox allows copying the groups of
+<li>activate  <b>Preview</b> checkbox to show the  parameter-setting in the viewer </li>
+<li>activate  <b>Generate Groups</b> checkbox to copy the groups of

 elements of the source mesh to the newly created one. </li>
 </li>
 
 elements of the source mesh to the newly created one. </li>
 </li>
 

-<li>Click the \b Apply or \b OK button.</li>
+<li>Click \b Apply or <b> Apply and Close</b> button to confirm the
+operation.</li>

 </ol>
 
 
 </ol>
 
 

diff --git a/doc/salome/gui/SMESH/input/rotation.doc b/doc/salome/gui/SMESH/input/rotation.doc
index e643572764b847143884c85c6aa92c334c2af3b9..79d27d7c1b30dd4b26e37c8498d2f27f8a75e22b 100644 (file)
--- a/doc/salome/gui/SMESH/input/rotation.doc
+++ b/doc/salome/gui/SMESH/input/rotation.doc
@@ -2,41 +2,69 @@
 
 \page rotation_page Rotation
 
 
 \page rotation_page Rotation
 

-\n This operation allows to rotate in space your mesh or
+\n This operation allows to rotate in space the mesh or

 some of its elements.
 
 some of its elements.
 

+<em>To rotate the mesh:</em>
+
+<ol>
+<li>From the \b Modification menu choose \b Transformation -> \b Rotation item  or click
+<em>"Rotation"</em> button in the toolbar.
+ 

 \image html rotation_ico.png "Rotation button"
 
 \image html rotation_ico.png "Rotation button"
 

-<em>To rotate your mesh:</em>
-\par
-From the \b Modification choose \b Transformation and  from its sub-menu
-select the \b Rotation item. The following dialog box shall appear:
+The following dialog will appear:

 
 \image html rotation.png
 
 \image html rotation.png

-\par 
-In this dialog box you can specify the elements which should be
-rotated
+
+</li>
+
+<li>
+In this dialog:
+<ul>
+<li>specify the IDs of the elements which will be rotated:
+

 <ul>
 <ul>

-<li>Check on <b>Select the whole mesh, submesh or group</b> option
-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on an element in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the elements. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</li>
+<li><b>Select the whole mesh, submesh or group</b> activating this
+checkbox; 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>

 </ul>
 </ul>

- and the rotation parameters:
+</li>
+
+<li>specify the axis of rotation:

 <ul>
 <ul>

-<li>\b Axis: point and vector</li>
-<li>\b Angle of rotation</li>
+<li>specify the cooordinates of the start \b Point of the vector of rotation;</li>
+<li>specify the \b Vector of rotation through the coordinates of its
+end point with respect to the coordinates of the start point;</li>

 </ul>
 </ul>

+</li>
+<li>specify the \b Angle of rotation </li>
+
+<li>specify the conditions of rotation:
+<ul>
+<li>activate <b>Move elements</b> radio button to create  the source
+mesh (or elements) at the new location and erase it from the previous location;</li>
+<li>activate <b>Copy elements</b> radio button to create the source
+mesh (or elements) at the new location, but leave it at the previous
+location, the source mesh will be considered one and single mesh with the result of the rotation;</li>
+<li>activate <b>Create as new mesh</b> radio button to leave the
+source mesh (or elements) at its previous location and create a new
+mesh at the new location, the new mesh appears in the Object Browser
+with the default name MeshName_rotated (it is possible to change this
+name in the adjacent box);</li>
+<li>activate <b> Copy groups </b> checkbox to copy the groups of elements of the source mesh to the newly created mesh.</li>
+</ul>
+</li>
+
+<li>Click \b Apply or <b> Apply and Close</b> button to confirm the
+operation.</li>

 
 

-\n Toggle the corresponding checkbox to <b> Select whole mesh, submesh or group.</b>  
-\n When <b>Move elements</b> radio button is selected, the source mesh (or elements) is created at the new location and erased from its previous location
-\n When <b>Copy elements</b> radio button is selected,the source mesh (or elements) is created at the new location, but it also remains at its previous location and is considered one and single mesh with the result of the rotation.
-\n When <b>Create as new mesh</b> radio button is selected, the source mesh (or elements) remains at its previous location and a new mesh is created at the new location and appears in the Object Browser with the default name MeshName_rotated (you can change this name in the adjacent box).
-\n <b> Copy groups </b> checkbox allows copying the groups of elements of the source mesh to the newly created one.
-\par
+</ol>

 
 
 \image html rotation1.png "The initial mesh"
 
 
 \image html rotation1.png "The initial mesh"

diff --git a/doc/salome/gui/SMESH/input/selection_filter_library.doc b/doc/salome/gui/SMESH/input/selection_filter_library.doc
index da38dfd76aa309a6a29253d493bdd4a93e22abe3..94dd3844c4b6f3f87537a738b5d61abf0edd3665 100644 (file)
--- a/doc/salome/gui/SMESH/input/selection_filter_library.doc
+++ b/doc/salome/gui/SMESH/input/selection_filter_library.doc
@@ -66,20 +66,19 @@ shape, the algorithm works slower.
 IDs. 
 <b>Threshold Value</b> can be, for example: "1,2,3,50-60,63,67,70-78"
 </li><li>
 IDs. 
 <b>Threshold Value</b> can be, for example: "1,2,3,50-60,63,67,70-78"
 </li><li>

-<b>Color of Group</b> allows selection of entities belonging to Group with
-specified color defined by the <b>Threshold Value</b>.
+<b>Color of Group</b> allows selection of entities belonging to the Group with
+the color defined by the <b>Threshold Value</b>.

 </li>
 </ul>
 
 </li>
 </ul>
 

-Some criteria are applicable to all <b>Entity types</b>: except for
+Some criteria are applicable to all <b>Entity types</b>, except for

 <b>Nodes</b>
 <ul><li>
 <b>Nodes</b>
 <ul><li>

-<b>Linear</b> allows selection of Linear or Quadratic (in case of
-Unary set to "Not" state)
+<b>Linear</b> allows selection of Linear or Quadratic elements (if Unary is set to "Not")

 </li><li>
 <b>Geometry type</b> allows selection of elements by their geometric type
 defined by the <b>Threshold Value</b>. The list of available geometric
 </li><li>
 <b>Geometry type</b> allows selection of elements by their geometric type
 defined by the <b>Threshold Value</b>. The list of available geometric

-types depends on element entity type defined by the <b>Threshold Value</b>.
+types depends on the element entity type defined by the <b>Threshold Value</b>.

 </li>
 </ul>
 
 </li>
 </ul>
 


@@ -97,14 +96,6 @@ specified arbitrary surface within a given <b>Tolerance</b>.
 </li>
 </ul>
 
 </li>
 </ul>
 

-Additional criteria to select mesh <b>Nodes</b> are the following:
-<ul><li>
-<b>Free Nodes</b> selects free mesh nodes, i.e. nodes not belonging to 
-mesh elements. See also a
-\ref free_nodes_page "Free Nodes quality control".
-</li>
-</ul>
-

 Additional criteria to select mesh <b>Edges</b> are the following:
 <ul><li>
 <b>Free Borders</b> selects free 1D mesh elements, i.e. edges belonging to 
 Additional criteria to select mesh <b>Edges</b> are the following:
 <ul><li>
 <b>Free Borders</b> selects free 1D mesh elements, i.e. edges belonging to 


@@ -153,8 +144,7 @@ Additional criteria to select mesh <b>Faces</b> are the following:
 one element of mesh only. See also a
 \ref free_edges_page "Free Edges quality control".
 </li><li>
 one element of mesh only. See also a
 \ref free_edges_page "Free Edges quality control".
 </li><li>

-<b>Free faces</b> selects 3D mesh elements wich belong less than to
-two volumes.
+<b>Free faces</b> selects 3D mesh elements wich belong to less than two volumes.

 </li><li>
 <b>Borders at Multi-Connections 2D</b> selects cells consisting of edges belonging to
 several elements of mesh. The number of mesh elements should be more, less or equal
 </li><li>
 <b>Borders at Multi-Connections 2D</b> selects cells consisting of edges belonging to
 several elements of mesh. The number of mesh elements should be more, less or equal

diff --git a/doc/salome/gui/SMESH/input/smoothing.doc b/doc/salome/gui/SMESH/input/smoothing.doc
index 77a59f880e8b57e9f5d148ff6dfc9fced588d06f..dc15270a8e460109cfb6310c3f97df9fc8ad15b5 100644 (file)
--- a/doc/salome/gui/SMESH/input/smoothing.doc
+++ b/doc/salome/gui/SMESH/input/smoothing.doc
@@ -7,38 +7,40 @@
 
 <em>To apply smoothing to the elements of your mesh:</em>
 <ol>
 
 <em>To apply smoothing to the elements of your mesh:</em>
 <ol>

-<li>Display a mesh or a submesh in the 3D viewer.</li>
+

 <li>In the \b Modification menu select the \b Smoothing item or click
 <em>"Smoothing"</em> button in the toolbar.
 
 \image html image84.png
 <center><em>"Smoothing" button</em></center>
 
 <li>In the \b Modification menu select the \b Smoothing item or click
 <em>"Smoothing"</em> button in the toolbar.
 
 \image html image84.png
 <center><em>"Smoothing" button</em></center>
 

-The dialog box contains the following fields which should be
-specified:
+The following dialog will appear:

 
 \image html smoothing.png
 
 \image html smoothing.png

+</li>
+<li>In this dialog:

 
 <ul>
 
 <ul>

-<li><b>Id Elements</b> field allows to specify the elements which
-should be smoothed
+<li>specify the IDs of the elements which will be smoothed:

 <ul>
 <ul>

-<li>Check on <b>Select the whole mesh, submesh or group</b> option
-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on an element in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the elements. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</li>
+<li><b>Select the whole mesh, submesh or group</b> activating this
+checkbox; 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>

 </ul>
 </li>
 </ul>
 </li>

-<b>Fixed nodes ids:</b> some nodes keep their location during
-smoothing. If a mesh is built on a geometry shape, the nodes built on
-geometrical edges are always fixed. If smoothing is applied to a part
-of a mesh then the boundary nodes of an elements set are also
-fixed. Any other nodes may be additionally fixed. Fixed nodes can be
-selected manually or by filters too.</li>
-<li><b>Smoothing Method:</b>
+
+<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>choose the <b>Smoothing Method:</b>

 <ul>
 <li>\b Laplacian smoothing pulls a node toward the center of
 surrounding nodes directly connected to that node along an element
 <ul>
 <li>\b Laplacian smoothing pulls a node toward the center of
 surrounding nodes directly connected to that node along an element


@@ -47,32 +49,29 @@ edge.
 element-area-weighted centroid of the surrounding elements. </li>
 
 Typically, the  Laplacian method will produce the mesh with the least element
 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 faster method.Centroidal smoothing usually
-produces  a mesh that has more uniform element sizes. Both methods
+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>
 </ul>
 
 \image html image83.gif
 
 </li>
 produce good results with "free" meshes.</li>
 </ul>
 
 \image html image83.gif
 
 </li>

-<li><b>Iteration limit:</b> both of the smoothing methods use an
-iterative procedure to converge toward a smoothed mesh. All nodes are
-smoothed according to one of the techniques shown above. Then the
-smoothing is reevaluated with the updated nodal locations. This
-process continues until the maximum number of iterations has been
-exceeded, or all elements has aspect ratio less or equal than the
+<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>
 specified one.</li>

-<li><b>Max. aspect ratio</b> allows to define the quality at which the
-smoothing algorithm should stop the iterations as the target of the
-operation has been reached.</li>
-<li>When <b>in parametric space</b> radio button is checked, the
-algorithm tries to improve the shape of faces in the parametric space
+<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>   
 </ul>
 of geometrical surfaces on which they are generated, else the shape of
 faces in the 3D space is improved. </li>   
 </ul>

-

 </li>
 </li>

-<li>Click the \b Apply or \b OK button to confirm the operation.</li>
+<li>Click \b Apply or <b> Apply and Close</b> button to confirm the operation.</li>

 </ol>
 
 \image html smoothing1.png "The initial mesh"
 </ol>
 
 \image html smoothing1.png "The initial mesh"

diff --git a/doc/salome/gui/SMESH/input/symmetry.doc b/doc/salome/gui/SMESH/input/symmetry.doc
index 67068e98145524221c5d331a9c34c66998ac4326..ce0278c0cbc5625206bd701fc57461d92f0d57a0 100644 (file)
--- a/doc/salome/gui/SMESH/input/symmetry.doc
+++ b/doc/salome/gui/SMESH/input/symmetry.doc
@@ -5,48 +5,80 @@
 \n This geometrical operation allows to perform a symmetrical copy of
 your mesh or some of its elements.
 
 \n This geometrical operation allows to perform a symmetrical copy of
 your mesh or some of its elements.
 

+<em>To create a symmtrical copy of the mesh:</em>
+
+<ol>
+<li>From the \b Modification menu choose \b Transformation -> \b Symmetry item  or click
+<em>"Symmetry"</em> button in the toolbar.
+

 \image html symmetry.png "Symmetry button"
 
 \image html symmetry.png "Symmetry button"
 

-<em>To apply symmetry to your mesh:</em>
-\par
-From the \b Modification choose \b Transformation and  from its
-sub-menu select the \b Symmetry item. The following dialog box shall
-appear:
+One of the following dialogs will appear:

 
 

-\image html symmetry1.png
+It is possible to mirror a mesh or some of its elements through:
+\image html symmetry1.png "a point (defined by a point and a vector)"
+\image html symmetry2.png "an axis"
+\image html symmetry3.png "a plane (defined by a point and a normal to the plane)"

 
 

-\image html symmetry2.png
+</li>

 
 

-\image html symmetry3.png
+<li>
+In the dialog:
+<ul>
+<li>specify the IDs of the elements for the symmetry operation:

 
 

-\par
-This operation has three options, you can symmetrically copy your mesh
-or some of its elements specifying:

 <ul>
 <ul>

-<li>one point</li>
-<li>one axis (point and vector)</li>
-<li>one plane (point and normal)</li>
+<li><b>Select the whole mesh, submesh or group</b> activating this
+checkbox; 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>

 </ul>
 </ul>

+</li>

 
 

+<li>depending on the nature of the mirror object: 

 <ul>
 <ul>

-<li>Select elements for the symmetry operation
+<li>if the mesh is mirrored through a point, specify the coordinates
+of the point</li>
+<li>if the mesh is mirrored through an axis: 

 <ul>
 <ul>

-<li>Check on <b>Select the whole mesh, submesh or group</b> option
-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on an element in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the elements. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</li>
+<li>specify the cooordinates of the start \b Point of the axis vector;</li>
+<li>specify the axis \b Vector through the coordinates of its
+end point with respect to the coordinates of the start point;</li>

 </ul>
 </li>
 </ul>
 </li>

-<li>When <b>Move elements</b> radio button is selected, the source mesh (or elements) is created at the new location and erased from its previous location</li>
-<li>When <b>Copy elements</b> radio button is selected,the source mesh (or elements) is created at the new location, but it also remains at its previous location and is considered one and single mesh with the result of the translation.</li>
-<li>When <b>Create as new mesh</b> radio button is selected, the source mesh (or elements) remains at its previous location and a new mesh is created at the new location and appears in the Object Browser with the default name MeshName_mirrored (you can change this name in the adjacent box).</li>
-<li><b> Copy groups </b> checkbox allows copying the groups of elements of the source mesh to the newly created one.</li>
+
+<li>if the mesh is mirrored through a plane:
+<ul>
+<li>specify the cooordinates of the \b Point lying on the plane;</li>
+<li>specify the axis \b Vector through the coordinates of its
+end point with respect to the coordinates of the start point.</li>

 </ul>
 </ul>

+</li>
+
+<li>specify the conditions of symmetry operation:
+<ul>
+<li>activate <b>Move elements</b> radio button to create  the source
+mesh (or elements) at the new location and erase it from the previous location;</li>
+<li>activate <b>Copy elements</b> radio button to create the source
+mesh (or elements) at the new location, but leave it at the previous
+location, the source mesh will be considered one and single mesh with the result of the rotation;</li>
+<li>activate <b>Create as new mesh</b> radio button to leave the
+source mesh (or elements) at its previous location and create a new
+mesh at the new location, the new mesh appears in the Object Browser
+with the default name MeshName_rotated (it is possible to change this
+name in the adjacent box);</li>
+<li>activate <b> Copy groups </b> checkbox to copy the groups of elements of the source mesh to the newly created mesh.</li>
+</ul>
+</li>
+
+<li>Click \b Apply or <b> Apply and Close</b> button to confirm the
+operation.</li>

 
 

-\par
+</ol>

 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_symmetry "Symmetry" operation.  
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_symmetry "Symmetry" operation.  

diff --git a/doc/salome/gui/SMESH/input/translation.doc b/doc/salome/gui/SMESH/input/translation.doc
index 45565acaa6f8a29491df96acd3149893782d76ee..e4589b5a67e964bcc159b34fe0d91514837f1be1 100644 (file)
--- a/doc/salome/gui/SMESH/input/translation.doc
+++ b/doc/salome/gui/SMESH/input/translation.doc
@@ -5,43 +5,70 @@
 \n This geometrical operation allows to translate in space your mesh
 or some of its elements.
 
 \n This geometrical operation allows to translate in space your mesh
 or some of its elements.
 

+<em>To translate a mesh:</em>
+
+<ol>
+<li>From the \b Modification menu choose \b Transformation -> \b Translation item  or click
+<em>"Translation"</em> button in the toolbar.
+

 \image html translation.png "Translation button"
 
 \image html translation.png "Translation button"
 

-<em>To translate your mesh:</em>
-\par
-From the \b Modification choose \b Transformation and from its
-sub-menu select the \b Translation item. The following dialog box
-shall appear:
+One of the following dialogs will appear:

 
 

-\image html translation1.png
+It is possible to define the vector of thanslation:
+\image html translation1.png "by two points"

 
 

-\image html translation2.png
+\image html translation2.png "by the vector from the origin of coordinates" 
+
+</li>

 
 

-\par
-This operation has two options, you can translate in space your mesh
-or some of its elements specifying:
+<li>
+In the dialog:

 <ul>
 <ul>

-<li>two points (starting and ending)</li>
-<li>one vector</li>
-</ul>
+<li>specify the IDs of the translated elements:

 
 <ul>
 
 <ul>

-<li>Select elements for the translation operation
+<li><b>Select the whole mesh, submesh or group</b> activating this
+checkbox; 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>
+</ul>
+</li>
+
+<li>specify the vector of translation:

 <ul>
 <ul>

-<li>Check on <b>Select the whole mesh, submesh or group</b> option
-<li>Choosing them manually with the mouse in the 3D Viewer. You can
-click on an element in the 3D viewer and it will be highlighted</li>
-<li>Applying Filters. The <b>Set filter</b> button allows to apply a
-definite filter to selection of the elements. See more
-about filters on the
-\ref selection_filter_library_page "Selection filter library" page.</li>
+<li>specify the cooordinates of the start and end \b Points of the
+vector of translation; or</li>
+<li>specify the end point of the \b Vector of rotation starting at the
+origin of coordinates.</li>

 </ul>
 </li>
 </ul>
 </li>

-<li>When <b>Move elements</b> radio button is selected, the source mesh (or elements) is created at the new location and erased from its previous location</li>
-<li>When <b>Copy elements</b> radio button is selected,the source mesh (or elements) is created at the new location, but it also remains at its previous location and is considered one and single mesh with the result of the translation.</li>
-<li>When <b>Create as new mesh</b> radio button is selected, the source mesh (or elements) remains at its previous location and a new mesh is created at the new location and appears in the Object Browser with the default name MeshName_translated (you can change this name in the adjacent box).</li>
-<li><b> Copy groups </b> checkbox allows copying the groups of elements of the source mesh to the newly created one.</li>
+
+<li>specify the conditions of translation:
+<ul>
+<li>activate <b>Move elements</b> radio button to create  the source
+mesh (or elements) at the new location and erase it from the previous location;</li>
+<li>activate <b>Copy elements</b> radio button to create the source
+mesh (or elements) at the new location, but leave it at the previous
+location, the source mesh will be considered one and single mesh with the result of the rotation;</li>
+<li>activate <b>Create as new mesh</b> radio button to leave the
+source mesh (or elements) at its previous location and create a new
+mesh at the new location, the new mesh appears in the Object Browser
+with the default name MeshName_rotated (it is possible to change this
+name in the adjacent box);</li>
+<li>activate <b> Copy groups </b> checkbox to copy the groups of elements of the source mesh to the newly created mesh.</li>

 </ul>
 </ul>

+</li>
+
+<li>Click \b Apply or <b> Apply and Close</b> button to confirm the
+operation.</li>
+
+</ol>
+

 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_translation "Translation" operation.  
 
 <br><b>See Also</b> a sample TUI Script of a 
 \ref tui_translation "Translation" operation.