X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fextrusion_along_path.doc;h=03717c77fb60f1ed6d72d70c02a03bc73f8f3b6f;hb=fd96feab4b58b9ebe8706e44b35006e0122d682e;hp=d35d233151c133404d8cf5e6e7a1f677d719d4a5;hpb=0635c9fc80f67d1e5dc0e94ec85f487286a92070;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 d35d23315..03717c77f 100644
--- a/doc/salome/gui/SMESH/input/extrusion_along_path.doc
+++ b/doc/salome/gui/SMESH/input/extrusion_along_path.doc
@@ -1,16 +1,18 @@
/*!
-\page extrusion_along_path_page Extrusion along a 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 meshed edge. 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 all examples
-the same mesh will be extruded along different paths and with
-different parameters. This sample 2D mesh has two quadrangle faces and
-seven edges. Look at the picture, where white digits are the node
-numbers and green are the element numbers:
+\page extrusion_along_path_page Extrusion along Path
+
+\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
+paths and with different parameters.
+This 2D mesh has two quadrangle faces and seven edges. Look
+at the picture, where white digits are the node numbers and green
+are the element numbers:
\image html mesh_for_extr_along_path.png
@@ -40,29 +42,17 @@ been selected as Start node.
\image html curvi_angles_after.png
The same, but using angles {45, 45, 45, 0, -45, -45, -45}
-
Extrusion along a sub-mesh
+
Extrusion of a 2D face along a mesh built on a wire
-In this example the path mesh has been built on a wire (polyline with
-six edges). The first edge of the wire was used as Shape (edge), node
-#1 as Start node. The angles have been defined as {10, 10, 10}. The
-middle edge (#4) of the initial mesh has been extruded.
+In this example the path mesh has been built on a wire containing 3
+edges. Node 1 is a start node. Linear angle variation by 180 degrees
+has also been applied.
-\image html edge_wire_before.png
+\image html extr_along_wire_before.png
+Meshed wire
-\image html edge_wire_after.png
-
-
Extrusion of 2d elements along a sub-mesh
-
-This extrusion bases on the same path mesh as in the previous example
-but the third edge of the wire was set as Shape (edge) and node
-#4 as Start node. Please note, that the extrusion has been done
-in direction from node #4 to node #3, i.e. against the wire
-direction. In this example both faces of the initial mesh have been
-extruded.
-
-\image html edge_wire_3d_before.png
-
-\image html edge_wire_3d_after.png
+\image html extr_along_wire_after.png
+The resulting extrusion
Extrusion of 2d elements along a closed path
@@ -77,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.
@@ -88,72 +78,93 @@ path item or click "Extrusion along a path" button in the toolbar.
\image html image101.png
"Extrusion along a path" button
-The following dialog box will appear:
+The following dialog will appear:
-\image html extrusion1.png
-
-\image html extrusion2.png
+\image html extrusion_along_path_dlg.png
-- In the dialog box you should:
-
-- select the type of elements which will be extruded (1D or 2D),
-- specify the IDs of the elements which will be extruded
-
-- Check on Select the whole mesh, submesh or group option
-
- 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
-- Applying Filters. The Set filter 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.
-
-
-- define the Path along which the elements will be extruded,
-\n Path definition consists of several elements:
+
- In this dialog:
-- \b Mesh - containing a 1D sub-mesh on the edge, along which proceeds the extrusion
-- Shape (edge) - as the mesh can be complex, the edge is used to define the sub-mesh for the path
-- Start node - the first or the last node on the edge. It is used to define the direction of extrusion
-
-
-- Generate Groups checkbox allows copying 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, 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 the \b Apply or \b OK button. 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.