X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;ds=sidebyside;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fextrusion_along_path.doc;h=ca782049a01817646cd9d922ec8c12df74ccd0d6;hb=1a88a8f6658e4663f7bacfd6be57b7a3cbaa7248;hp=e391111d80f48271bdaa8c6c958780dcc9b9b9bb;hpb=bd4e115a78b52e3fbc016e5e30bb0e19b2a9e7d6;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/extrusion_along_path.doc b/doc/salome/gui/SMESH/input/extrusion_along_path.doc
index e391111d8..ca782049a 100644
--- a/doc/salome/gui/SMESH/input/extrusion_along_path.doc
+++ b/doc/salome/gui/SMESH/input/extrusion_along_path.doc
@@ -1,10 +1,11 @@
/*!
-\page extrusion_along_path_page Extrusion along a path
+\page extrusion_along_path_page Extrusion along Path
-\n In principle, Extrusion along a path works in the same way
-as \b Extrusion, the main difference is that we define not a vector,
-but a path of extrusion which must be a 1D mesh or 1D sub-mesh.
+\n In principle, Extrusion along Path works in the same way
+as \ref extrusion_page "Extrusion", the main difference is that we
+define not a vector, but a path of extrusion which must be an 1D mesh
+or 1D sub-mesh.
To get an idea of how this algorithm works, examine several examples,
starting from the most simple case of extrusion along a straight edge.
In the examples the sample mesh will be extruded along different
@@ -66,10 +67,10 @@ six coincident nodes and two coincident faces in the resulting
mesh.
\image html circle_angles_after.png
-
The same, but using angles {45, -45, 45, -45, 45, -45, 45,
--45}
+The same, but using angles {45, -45, 45, -45, 45, -45, 45, -45}
+
-
To use Extrusion along a path:
+
To use Extrusion along Path:
- From the \b Modification menu choose the Extrusion along a
path item or click "Extrusion along a path" button in the toolbar.
@@ -77,74 +78,95 @@ path item or click "Extrusion along a path" button in the toolbar.
\image html image101.png
"Extrusion along a path" button
-The following dialog common for line and planar elements will appear:
+The following dialog will appear:
-\image html extrusion1.png
+\image html extrusion_along_path_dlg.png
- In this dialog:
-- select the type of elements which will be extruded (1D or 2D),
-- specify the IDs of the elements which will be extruded
-
-
-- Select the whole mesh, submesh or group activating this
-checkbox; or
-- choose mesh elements with the mouse in the 3D Viewer. It is
-possible to select a whole area with a mouse frame; or
-- input the element IDs directly in ID Elements field. The selected elements will be highlighted in the
-viewer; or
-- apply Filters. Set filter 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.
-
-
-
-- define the Path along which the elements will be extruded,
-\n Path definition consists of several elements:
-
-- Mesh or submesh - 1D mesh or sub-mesh, along which proceeds the extrusion
-- Start node - the start node. It is used to define the direction of extrusion
-
-
-- activate Generate Groups checkbox if it is necessary to copy the groups of
-elements of the source mesh to the newly created one.
+ - Use \a Selection button to specify what you are going to
+ select at a given moment, \b Nodes, \b Edges or \b Faces.
+\image html image120.png
+"Selection" button
+
+ - Specify \b Nodes, \b Edges and \b Faces, which will be extruded, by one
+ of following means:
+
+ - Select the whole mesh, sub-mesh or group activating this
+ check-box.
+ - Choose mesh elements with the mouse in the 3D Viewer. It is
+ possible to select a whole area with a mouse frame.
+ - Input the element IDs directly in Node IDs, Edge
+ IDs and Face IDs fields. The selected elements will
+ be highlighted in the viewer, if the mesh is shown there.
+ - Apply Filters. Set filter button allows to apply a
+ filter to the selection of elements. See more about filters in
+ the \ref filtering_elements "Selection filters" page.
+
+
+ - Define the \b Path along which the elements will be extruded.
+ Path definition consists of several elements:
+
+ - Mesh or sub-mesh - 1D mesh or sub-mesh, along which
+ proceeds the extrusion.
+ - Start node - the start node of the Path. It is used
+ to define the direction of extrusion.
+
+
+ - If you activate Generate Groups check-box, the result elements
+ created from selected elements contained in groups will be
+ included into new groups named by pattern "_extruded" and "_top". For example if a
+ selected quadrangle is included in \a g_Faces group (see figures
+ below) then result hexahedra will be included in \a
+ g_Faces_extruded group and a quadrangle created at the "top" of
+ extruded mesh will be included in \a g_Faces_top group.
+\image html extrusion_groups.png
+\image html extrusion_groups_res.png
+ This check-box is active only if there are some groups in the mesh.
+
- There are two optional parameters, which can be very useful:
- If the path of extrusion is curvilinear, at each iteration the
-extruded shape is rotated to keep its initial angularity to the
-curve. By default, the Base Point around which the shape is rotated is
-the mass center of the shape, however, you can specify any point as
-the Base Point and the shape will be rotated with respect to this
-point.
-
-- The shape can also be rotated around the path to get the resulting
-mesh in a helical fashion. You can set the values of angles at the
-right, add them to the list of angles at the left by pressing the "Add"
-button and remove them from the list by pressing the "Remove" button.
-
+ extruded elements are rotated to keep its initial angularity to the
+ curve. By default, the Base Point around which the elements
+ are rotated is the mass center of the elements (note that it can
+ differ from the gravity center computed by \a Geometry module for the
+ underlying shape), however, you can specify any point as the Base
+ Point and the elements will be rotated with respect to this
+ point.
+ Note that only the displacement of the Base Point exactly
+ equals to the path, and all other extruded elements simply keep
+ their position relatively to the Base Point at each
+ iteration.
+- The elements can also be rotated around the path to get the
+ resulting mesh in a helical fashion. You can set the values of
+ angles at the right, add them to the list of angles at the left by
+ pressing the "Add" button and remove them from the list by
+ pressing the "Remove" button.
\image html add.png
"Add" button
-
\image html remove.png
"Remove" button
-Linear variation of the angles option allows defining the angle of gradual rotation for the whole path.
-At each step the shape will be rotated by angle/nb. of steps.
-
+Linear variation of the angles option allows defining the angle
+of gradual rotation for the whole path. At each step the elements will
+be rotated by
( angle / nb. of steps )
.
-- Click \b Apply or Apply and Close 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
-duplicated nodes and faces, because no sewing is done.
+
- Click \b Apply or Apply and Close 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
+ duplicated nodes and faces, because no sewing is done.