ForkMaster/smesh
1
0
Fork 0
mirror of https://git.salome-platform.org/gitpub/modules/smesh.git synced 2024-12-25 17:00:34 +05:00
Code Issues Packages Projects Releases Wiki Activity

Update SMESH documentation

Browse Source
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
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

BIN
doc/salome/gui/SMESH/images/rotation2.png Executable file
View File

Binary file not shown.
Side by Side

After

Width:  |  Height:  |  Size: 25 KiB

3
doc/salome/gui/SMESH/input/about_quality_controls.doc
View File

@ -17,7 +17,7 @@ There are 0D, 1D, 2D and 3D quality controls.
0D mesh quality controls: 0D mesh quality controls:
<ul> <ul>
<li>\subpage free_nodes_page "Free nodes"</li> <li>\ref free_nodes_page "Free nodes"</li>
</ul> </ul>
1D mesh quality controls: 1D mesh quality controls:
@ -29,6 +29,7 @@ There are 0D, 1D, 2D and 3D quality controls.
2D mesh quality controls: 2D mesh quality controls:
<ul> <ul>
<li>\subpage free_nodes_page "Free nodes"</li>
<li>\subpage free_edges_page "Free edges"</li> <li>\subpage free_edges_page "Free edges"</li>
<li>\subpage length_2d_page "Length 2D"</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 borders_at_multi_connection_2d_page "Borders at multi-connection 2D"</li>

5
doc/salome/gui/SMESH/input/adding_nodes_and_elements.doc
View File

@ -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> <br>
\anchor adding_edges_anchor \anchor adding_edges_anchor
<h2>Adding edges</h2> <h2>Adding edges</h2>

32
doc/salome/gui/SMESH/input/constructing_meshes.doc
View File

@ -73,7 +73,37 @@ Automatic Tetrahedralization or Hexahedralization. The program will
automatically generate a 3D mesh with the most appropriate automatically generate a 3D mesh with the most appropriate
settings. In the same way you can apply this functionality for meshing settings. In the same way you can apply this functionality for meshing
2D objects, in which case 3D algorithms are not applied.</li> 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 Browser</b>. From the \b Mesh menu select \b Compute or click "Compute" button of the
toolbar. toolbar.

34
doc/salome/gui/SMESH/input/extrusion.doc
View File

@ -16,38 +16,36 @@ and Hexahedron solids respectively.
\image html image91.png \image html image91.png
<center><em>"Extrusion" button</em></center> <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>select the type of elements which will be extruded (1D or 2D),</li>
<li>specify the IDs of the elements which will be extruded by <li>specify the IDs of the elements which will be extruded:
selecting them in the 3D viewer or select the whole mesh or
submesh,
<ul> <ul>
<li>Check on <b>Select the whole mesh, submesh or group</b> option <li><b>Select the whole mesh, submesh or group</b> activating this
<li>Choosing them manually with the mouse in the 3D Viewer. You can checkbox; or</li>
click on an element in the 3D viewer and it will be highlighted</li> <li>choose mesh elements with the mouse in the 3D Viewer. It is
<li>Applying Filters. The <b>Set filter</b> button allows to apply a possible to select a whole area with a mouse frame; or</li>
definite filter to selection of the elements. See more <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
about filters on the viewer; or</li>
\ref selection_filter_library_page "Selection filter library" page.</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>
<li>specify the distance at which the elements will be extruded,</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>specify the vector along which the elements will be extruded,</li>
<li>number of steps.</li> <li>specify the number of steps;</li>
</ul> <li>activate <b>Generate Groups</b> checkbox if it is necessary to copy the groups of
<li> <b>Generate Groups</b> checkbox allows copying the groups of
elements of the source mesh to the newly created one. </li> elements of the source mesh to the newly created one. </li>
</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> </ol>
\image html image77.jpg "The mesh with an edge selected for extrusion" \image html image77.jpg "The mesh with an edge selected for extrusion"

29
doc/salome/gui/SMESH/input/extrusion_along_path.doc
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 \image html image101.png
<center><em>"Extrusion along a path" button</em></center> <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> <ul>
<li>select the type of elements which will be extruded (1D or 2D),</li> <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 <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><b>Select the whole mesh, submesh or group</b> activating this
<li>Choosing them manually with the mouse in the 3D Viewer. You can checkbox; or</li>
click on an element in the 3D viewer and it will be highlighted</li> <li>choose mesh elements with the mouse in the 3D Viewer. It is
<li>Applying Filters. The <b>Set filter</b> button allows to apply a possible to select a whole area with a mouse frame; or</li>
definite filter to selection of the elements. See more <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
about filters on the viewer; or</li>
\ref selection_filter_library_page "Selection filter library" page.</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>
<li>define the Path along which the elements will be extruded, <li>define the Path along which the elements will be extruded,
\n Path definition consists of several elements: \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> <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> </ul>
</li> </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> elements of the source mesh to the newly created one. </li>
</ul> </ul>
</li> </li>
@ -149,7 +150,9 @@ At each step the shape will be rotated by angle/nb. of steps.
</ul> </ul>
</li> </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 faces, faces into volumes. The external surface of the resulting 3d
mesh (if faces have been extruded) is covered with faces, and corners mesh (if faces have been extruded) is covered with faces, and corners
with edges. If the path is closed, the resulting mesh can contain with edges. If the path is closed, the resulting mesh can contain

12
doc/salome/gui/SMESH/input/free_faces.doc
View File

@ -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 \n This mesh quality control highlights the faces connected
less than to two mesh volume elements. Free faces are shown with a color differs from less than to two mesh volume elements. The free faces are shown with a
the color of shared faces. 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 <center>In this picture some volume mesh elements have been, as
a result some faces become connected only to one a result some faces became connected only to one
volume. i.e. become free. volume. i.e. became free.
<br><b>See Also</b> a sample TUI Script of a <br><b>See Also</b> a sample TUI Script of a
\ref tui_free_faces "Free Faces quality control" operation. \ref tui_free_faces "Free Faces quality control" operation.

9
doc/salome/gui/SMESH/input/free_nodes.doc
View File

@ -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 \n This mesh quality control highlights the nodes which are not connected
to any mesh element. Free nodes are shown with a color differs from to any mesh element.
the color of nodes.
\image html free_nodes.png \image html free_nodes.png
<center>In this picture some nodes don't connected to a mesh element as <center>In this picture some nodes are not connected to any mesh
a result of deleting elements and adding several isolated nodes. element after deleting some elements and adding several isolated nodes.
<br><b>See Also</b> a sample TUI Script of a <br><b>See Also</b> a sample TUI Script of a
\ref tui_free_nodes "Free Nodes quality control" operation. \ref tui_free_nodes "Free Nodes quality control" operation.

3
doc/salome/gui/SMESH/input/modifying_meshes.doc
View File

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

36
doc/salome/gui/SMESH/input/preview_meshes.doc
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.
*/

29
doc/salome/gui/SMESH/input/removing_nodes_and_elements.doc
View File

@ -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 <li>choose mesh nodes with the mouse in the 3D Viewer. It is
click on a node in the 3D viewer and it will be highlighted</li> possible to select a whole area with a mouse frame; or</li>
<li>Applying Filters. The <b>Set filter</b> button allows to apply a <li>input the node IDs directly in <b>ID Elements</b> field. The selected nodes will be highlighted in the
definite filter to selection of the nodes. See more viewer; or</li>
about filters on the <li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of nodes. See more
\ref selection_filter_library_page "Selection filter library" page.</li> about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
</ul> </ul>
</li> </li>
</ol> </ol>
@ -65,13 +67,14 @@ The following dialog box will appear:
In this dialog box you can specify one or several elements In this dialog box you can specify one or several elements
<ul> <ul>
<li>Choosing them manually with the mouse in the 3D Viewer. You can <li>choose mesh elements with the mouse in the 3D Viewer. It is
click on an element in the 3D viewer and it will be highlighted</li> possible to select a whole area with a mouse frame; or</li>
<li>Applying Filters. The <b>Set filter</b> button allows to apply a <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
definite filter to selection of the elements. See more viewer; or</li>
about filters on the <li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
\ref selection_filter_library_page "Selection filter library" page.</li> about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
</ul> </ul>
</li> </li>
<li>Click \b Apply or <b>Apply and Close</b> to confirm deletion of the specified elements.</li> <li>Click \b Apply or <b>Apply and Close</b> to confirm deletion of the specified elements.</li>
</ol> </ol>

49
doc/salome/gui/SMESH/input/revolution.doc
View File

@ -16,31 +16,40 @@ on the revolution axis).
\image html image92.png \image html image92.png
<center><em>"Revolution" button</em></center> <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> <ul>
<li>the type of elements which will be extruded (1D or 2D),</li> <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> <ul>
<li>Check on <b>Select the whole mesh, submesh or group</b> option <li><b>Select the whole mesh, submesh or group</b> activating this
<li>Choosing them manually with the mouse in the 3D Viewer. You can checkbox; or</li>
click on an element in the 3D viewer and it will be highlighted</li> <li>choose mesh elements with the mouse in the 3D Viewer. It is
<li>Applying Filters. The <b>Set filter</b> button allows to apply a possible to select a whole area with a mouse frame; or</li>
definite filter to selection of the elements. See more <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
about filters on the viewer; or</li>
\ref selection_filter_library_page "Selection filter library" page.</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>
<li>specify the axis (point and vector) around which the elements will
be revolved,</li> <li>specify the axis of revolution:
<li>angle of rotation and number of steps,</li> <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 <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> 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" \image html revolutionsn1.png "Example of Revolution with Total Angle"
</ul> </ul>
<li>tolerance of rotation</li> </li>
</ul>
<li> <b>Preview</b> checkbox allows showing the results of parameter-setting in the viewer </li> <li>specify the tolerance for the operation</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> elements of the source mesh to the newly created one. </li>
</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>

84
doc/salome/gui/SMESH/input/rotation.doc
View File

@ -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> The following dialog will appear:
\par
From the \b Modification choose \b Transformation and from its sub-menu
select the \b Rotation item. The following dialog box shall appear:
\image html rotation.png \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> </li>
\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. <li>
\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). In this dialog:
\n <b> Copy groups </b> checkbox allows copying the groups of elements of the source mesh to the newly created one. <ul>
\par <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" \image html rotation1.png "The initial mesh"

22
doc/salome/gui/SMESH/input/selection_filter_library.doc
View File

@ -66,20 +66,19 @@ shape, the algorithm works slower.
IDs. IDs.
<b>Threshold Value</b> can be, for example: "1,2,3,50-60,63,67,70-78" <b>Threshold Value</b> can be, for example: "1,2,3,50-60,63,67,70-78"
</li><li> </li><li>
<b>Color of Group</b> allows selection of entities belonging to Group with <b>Color of Group</b> allows selection of entities belonging to the Group with
specified color defined by the <b>Threshold Value</b>. the color defined by the <b>Threshold Value</b>.
</li> </li>
</ul> </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> <b>Nodes</b>
<ul><li> <ul><li>
<b>Linear</b> allows selection of Linear or Quadratic (in case of <b>Linear</b> allows selection of Linear or Quadratic elements (if Unary is set to "Not")
Unary set to "Not" state)
</li><li> </li><li>
<b>Geometry type</b> allows selection of elements by their geometric type <b>Geometry type</b> allows selection of elements by their geometric type
defined by the <b>Threshold Value</b>. The list of available geometric 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> </li>
</ul> </ul>
@ -97,14 +96,6 @@ specified arbitrary surface within a given <b>Tolerance</b>.
</li> </li>
</ul> </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: Additional criteria to select mesh <b>Edges</b> are the following:
<ul><li> <ul><li>
<b>Free Borders</b> selects free 1D mesh elements, i.e. edges belonging to <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 one element of mesh only. See also a
\ref free_edges_page "Free Edges quality control". \ref free_edges_page "Free Edges quality control".
</li><li> </li><li>
<b>Free faces</b> selects 3D mesh elements wich belong less than to <b>Free faces</b> selects 3D mesh elements wich belong to less than two volumes.
two volumes.
</li><li> </li><li>
<b>Borders at Multi-Connections 2D</b> selects cells consisting of edges belonging to <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 several elements of mesh. The number of mesh elements should be more, less or equal

67
doc/salome/gui/SMESH/input/smoothing.doc
View File

@ -7,38 +7,40 @@
<em>To apply smoothing to the elements of your mesh:</em> <em>To apply smoothing to the elements of your mesh:</em>
<ol> <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 <li>In the \b Modification menu select the \b Smoothing item or click
<em>"Smoothing"</em> button in the toolbar. <em>"Smoothing"</em> button in the toolbar.
\image html image84.png \image html image84.png
<center><em>"Smoothing" button</em></center> <center><em>"Smoothing" button</em></center>
The dialog box contains the following fields which should be The following dialog will appear:
specified:
\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 <li>specify the IDs of the elements which will be smoothed:
should be smoothed
<ul> <ul>
<li>Check on <b>Select the whole mesh, submesh or group</b> option <li><b>Select the whole mesh, submesh or group</b> activating this
<li>Choosing them manually with the mouse in the 3D Viewer. You can checkbox; or</li>
click on an element in the 3D viewer and it will be highlighted</li> <li>choose mesh elements with the mouse in the 3D Viewer. It is
<li>Applying Filters. The <b>Set filter</b> button allows to apply a possible to select a whole area with a mouse frame; or</li>
definite filter to selection of the elements. See more <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
about filters on the viewer; or</li>
\ref selection_filter_library_page "Selection filter library" page.</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>
<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 <li>define the <b>Fixed nodes ids</b> that should remain at their location during
geometrical edges are always fixed. If smoothing is applied to a part smoothing. If a mesh is built on a shape, the nodes built on its
of a mesh then the boundary nodes of an elements set are also geometric edges are always fixed. If the smoothing is applied to a part
fixed. Any other nodes may be additionally fixed. Fixed nodes can be of the mesh, the nodes of boundary elements are also
selected manually or by filters too.</li> fixed. It is possible to additionally fix any other nodes. The fixed nodes can be
<li><b>Smoothing Method:</b> selected manually or by filters, just as the smoothed elements.</li>
<li>choose the <b>Smoothing Method:</b>
<ul> <ul>
<li>\b Laplacian smoothing pulls a node toward the center of <li>\b Laplacian smoothing pulls a node toward the center of
surrounding nodes directly connected to that node along an element surrounding nodes directly connected to that node along an element
@ -47,32 +49,29 @@ edge.
element-area-weighted centroid of the surrounding elements. </li> element-area-weighted centroid of the surrounding elements. </li>
Typically, the Laplacian method will produce the mesh with the least element Typically, the Laplacian method will produce the mesh with the least element
distortion. It is also the faster method.Centroidal smoothing usually distortion. It is also the fastest method. Centroidal smoothing usually
produces a mesh that has more uniform element sizes. Both methods produces a mesh with more uniform element sizes. Both methods
produce good results with "free" meshes.</li> produce good results with "free" meshes.</li>
</ul> </ul>
\image html image83.gif \image html image83.gif
</li> </li>
<li><b>Iteration limit:</b> both of the smoothing methods use an <li>specify the <b>Iteration limit</b>. Both smoothing methods
iterative procedure to converge toward a smoothed mesh. All nodes are iterate through a number of steps to produce the resulting smoothed
smoothed according to one of the techniques shown above. Then the mesh. At each new step the smoothing is reevaluated with the updated nodal locations. This
smoothing is reevaluated with the updated nodal locations. This process continues till the limit of iterations has been
process continues until the maximum number of iterations has been exceeded, or till the aspect ratio of all element is less than or equal to the
exceeded, or all elements has aspect ratio less or equal than the
specified one.</li> specified one.</li>
<li><b>Max. aspect ratio</b> allows to define the quality at which the <li>specify the <b>Max. aspect ratio</b> - the target mesh quality at which the
smoothing algorithm should stop the iterations as the target of the smoothing algorithm should stop the iterations.</li>
operation has been reached.</li> <li>activate <b>in parametric space</b> checkbox if it is necessary to
<li>When <b>in parametric space</b> radio button is checked, the to improve the shape of faces in the parametric space
algorithm tries to improve the shape of faces in the parametric space
of geometrical surfaces on which they are generated, else the shape of of geometrical surfaces on which they are generated, else the shape of
faces in the 3D space is improved. </li> faces in the 3D space is improved. </li>
</ul> </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> </ol>
\image html smoothing1.png "The initial mesh" \image html smoothing1.png "The initial mesh"

94
doc/salome/gui/SMESH/input/symmetry.doc
View File

@ -5,48 +5,80 @@
\n This geometrical operation allows to perform a symmetrical copy of \n This geometrical operation allows to perform a symmetrical copy of
your mesh or some of its elements. 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> One of the following dialogs will appear:
\par
From the \b Modification choose \b Transformation and from its
sub-menu select the \b Symmetry item. The following dialog box shall
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:
\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>specify the IDs of the elements for the symmetry operation:
<li>one axis (point and vector)</li>
<li>one plane (point and normal)</li>
</ul>
<ul> <ul>
<li>Select elements for the symmetry operation <li><b>Select the whole mesh, submesh or group</b> activating this
<ul> checkbox; or</li>
<li>Check on <b>Select the whole mesh, submesh or group</b> option <li>choose mesh elements with the mouse in the 3D Viewer. It is
<li>Choosing them manually with the mouse in the 3D Viewer. You can possible to select a whole area with a mouse frame; or</li>
click on an element in the 3D viewer and it will be highlighted</li> <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
<li>Applying Filters. The <b>Set filter</b> button allows to apply a viewer; or</li>
definite filter to selection of the elements. See more <li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
about filters on the about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
\ref selection_filter_library_page "Selection filter library" page.</li>
</ul> </ul>
</li> </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 <br><b>See Also</b> a sample TUI Script of a
\ref tui_symmetry "Symmetry" operation. \ref tui_symmetry "Symmetry" operation.

79
doc/salome/gui/SMESH/input/translation.doc
View File

@ -5,43 +5,70 @@
\n This geometrical operation allows to translate in space your mesh \n This geometrical operation allows to translate in space your mesh
or some of its elements. 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> One of the following dialogs will appear:
\par
From the \b Modification choose \b Transformation and from its
sub-menu select the \b Translation item. The following dialog box
shall 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 </li>
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>specify the IDs of the translated elements:
<li>one vector</li>
</ul>
<ul> <ul>
<li>Select elements for the translation operation <li><b>Select the whole mesh, submesh or group</b> activating this
<ul> checkbox; or</li>
<li>Check on <b>Select the whole mesh, submesh or group</b> option <li>choose mesh elements with the mouse in the 3D Viewer. It is
<li>Choosing them manually with the mouse in the 3D Viewer. You can possible to select a whole area with a mouse frame; or</li>
click on an element in the 3D viewer and it will be highlighted</li> <li>input the element IDs directly in <b>ID Elements</b> field. The selected elements will be highlighted in the
<li>Applying Filters. The <b>Set filter</b> button allows to apply a viewer; or</li>
definite filter to selection of the elements. See more <li>apply Filters. <b>Set filter</b> button allows to apply a filter to the selection of elements. See more
about filters on the about filters in the \ref selection_filter_library_page "Selection filter library" page.</li>
\ref selection_filter_library_page "Selection filter library" page.</li>
</ul> </ul>
</li> </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>specify the vector of translation:
<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> <ul>
<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 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> </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 <br><b>See Also</b> a sample TUI Script of a
\ref tui_translation "Translation" operation. \ref tui_translation "Translation" operation.