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:
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>
\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>
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.
\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 extrusionalongaline2.png
</li>
-<li>In this dialog box you should select:
+<li>In this dialog:
<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>
-<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>
-<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>
+</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"
\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 extrusion2.png
</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>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>define the Path along which the elements will be extruded,
\n Path definition consists of several elements:
<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>
</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
\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
-<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.
\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
-<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.
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
+++ /dev/null
-/*!
-
-\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.
-
-*/
\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>
-<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>
+
+
</li>
</ol>
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>
+
</li>
<li>Click \b Apply or <b>Apply and Close</b> to confirm deletion of the specified elements.</li>
</ol>
\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 revolution2.png
</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>
-<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>
-<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>
-<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>
\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>
-<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>
\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.
+<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"
-<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
-\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>
-<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>
- and the rotation parameters:
+</li>
+
+<li>specify the axis of rotation:
<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>
+</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"
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>
-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>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
-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>
-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
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
<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>
-The dialog box contains the following fields which should be
-specified:
+The following dialog will appear:
\image html smoothing.png
+</li>
+<li>In this dialog:
<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>
-<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>
-<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
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>
-<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>
-<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>
-
</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"
\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"
-<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>
-<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>
+</li>
+<li>depending on the nature of the mirror object:
<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>
-<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>
-<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>
+</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.
\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"
-<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>
-<li>two points (starting and ending)</li>
-<li>one vector</li>
-</ul>
+<li>specify the IDs of the translated elements:
<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>
-<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>
-<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>
+</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.
