Update SMESH documentation

This commit is contained in:
maintenance team 2009-02-20 14:12:39 +00:00
parent 315b4dcc1f
commit e7c421ee2a
17 changed files with 335 additions and 252 deletions

Binary file not shown.

After

Width:  |  Height:  |  Size: 25 KiB

View File

@ -17,7 +17,7 @@ There are 0D, 1D, 2D and 3D quality controls.
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:
@ -29,6 +29,7 @@ There are 0D, 1D, 2D and 3D 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>

View File

@ -43,11 +43,6 @@ created:
\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>

View File

@ -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>
<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.

View File

@ -16,38 +16,36 @@ and Hexahedron solids respectively.
\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"

View File

@ -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>
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:
@ -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>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>
@ -149,7 +150,9 @@ At each step the shape will be rotated by angle/nb. of steps.
</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

View File

@ -2,14 +2,14 @@
\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.

View File

@ -2,13 +2,12 @@
\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.

View File

@ -47,4 +47,7 @@ of the selected node or edge.</li>
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.
*/

View File

@ -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.
*/

View File

@ -29,15 +29,17 @@ The following dialog box will appear:
\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>
@ -65,13 +67,14 @@ The following dialog box will appear:
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>

View File

@ -16,31 +16,40 @@ on the revolution axis).
\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>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 axis (point and vector) around which the elements will
be revolved,</li>
<li>angle of rotation and number of steps,</li>
<li>specify the axis of revolution:
<ul>
<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 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>
@ -52,15 +61,17 @@ be revolved,</li>
\image html revolutionsn1.png "Example of Revolution with Total Angle"
</ul>
<li>tolerance of rotation</li>
</ul>
</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>specify the tolerance for the operation</li>
<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>

View File

@ -2,41 +2,69 @@
\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
<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>
</ul>
and the rotation parameters:
<ul>
<li>\b Axis: point and vector</li>
<li>\b Angle of rotation</li>
</ul>
\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
</li>
<li>
In this dialog:
<ul>
<li>specify the IDs of the elements which will be rotated:
<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 rotation:
<ul>
<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>
</ol>
\image html rotation1.png "The initial mesh"

View File

@ -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>
<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>
@ -97,14 +96,6 @@ specified arbitrary surface within a given <b>Tolerance</b>.
</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
@ -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>
<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

View File

@ -7,38 +7,40 @@
<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
@ -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
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"

View File

@ -5,48 +5,80 @@
\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
\par
This operation has three options, you can symmetrically copy your mesh
or some of its elements specifying:
<li>
In the dialog:
<ul>
<li>one point</li>
<li>one axis (point and vector)</li>
<li>one plane (point and normal)</li>
</ul>
<li>specify the IDs of the elements for the symmetry operation:
<ul>
<li>Select elements for the symmetry operation
<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>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>
</ul>
\par
<li>depending on the nature of the mirror object:
<ul>
<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>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>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>
</ol>
<br><b>See Also</b> a sample TUI Script of a
\ref tui_symmetry "Symmetry" operation.

View File

@ -5,43 +5,70 @@
\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"
\par
This operation has two options, you can translate in space your mesh
or some of its elements specifying:
</li>
<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
<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>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 vector of translation:
<ul>
<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>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.