X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fsplit_to_tetra.doc;h=b6ee36e935a981d21f70a30335ca87c53bc62f16;hb=3c33b141570dd9eee180f7149b5f97a0a30884db;hp=325c30c116209cfc4187a1ab5f5aa7c4d0e60e7f;hpb=bd4e115a78b52e3fbc016e5e30bb0e19b2a9e7d6;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/split_to_tetra.doc b/doc/salome/gui/SMESH/input/split_to_tetra.doc
index 325c30c11..b6ee36e93 100644
--- a/doc/salome/gui/SMESH/input/split_to_tetra.doc
+++ b/doc/salome/gui/SMESH/input/split_to_tetra.doc
@@ -1,55 +1,68 @@
/*!
-\page split_to_tetra_page Splitting volumes into tetrahedra
+\page split_to_tetra_page Splitting volumes
-\n This operation allows to split volumic elements into tetrahedra.
-2D mesh is modified accordingly.
+\n This operation allows to split either any volumic elements into
+tetrahedra or hexahedra into prisms. 2D mesh is modified accordingly.
To split volumes:
-- Display a mesh or a submesh in the 3D viewer.
-- In the \b Modification menu select the Split into Tetrahedra item or
-click "Split into Tetrahedra" button in the toolbar.
+
- Select a mesh, a sub-mesh or a group.
+- In the \b Modification menu select the Split Volumes item or
+click "Split Volumes" button in the toolbar.
\image html split_into_tetra_icon.png
-"Split into Tetrahedra" button
+"Split Volumes" button
The following dialog box will appear:
\image html split_into_tetra.png
-\par
-
-- The main list contains the list of volumes. You can click on
-a volume in the 3D viewer and it will be highlighted (lock Shift
-keyboard button to select several volumes). Click \b Add button and
-the ID of this volume will be added to the list. To remove the
-selected element or elements from the list click \b Remove button. Sort
-list button allows to sort the list of IDs. \b Filter button allows to
-apply a definite filter to the selection of volumes.
-
Note: If you split not all adjacent non-tetrahedral volumes, your mesh becomes
-non-conform.
-- Apply to all radio button allows to split all
-volumes of the currently displayed mesh or submesh.
-
+
+First it is possible to select the type of operation:
+- If \b Tetrahedron button is checked, the operation will split volumes of any type into tetrahedra.
+- If \b Prism button is checked, the operation will split hexahedra into prisms.
-- \b Split hexahedron
+
- The main list contains the list of volumes to split. You can click on
+ a volume in the 3D viewer and it will be highlighted (lock Shift
+ keyboard button to select several volumes). Click \b Add button and
+ the ID of this volume will be added to the list. To remove the
+ selected element or elements from the list click \b Remove button. Sort
+ list button allows to sort the list of IDs. \b Filter button allows applying a filter to the selection of volumes.
+
Note: If you split not all adjacent non-tetrahedral
+ volumes, your mesh becomes non-conform.
+
+- Apply to all radio button allows splitting all
+ volumes of the currently selected mesh.
+
+- If \b Tetrahedron element type is selected, Split hexahedron group allows specifying the number of tetrahedra a hexahedron will be split into. If the chosen method does not allow to get a conform mesh, a generic solution is applied: an additional node is created at the gravity center of a hexahedron, serving an apex of tetrahedra, all quadrangle sides of the hexahedron are split into two triangles each serving a base of a new tetrahedron.
+
+- If \b Prism element type is selected, the Split hexahedron group looks as follows:
+
+\image html split_into_prisms.png
-- Into 5 tetrahedra, Into 6 tetrahedra and Into 24 tetrahedra allows to
-specify the number of tetrahedra a hexahedron will be split into. If the specified method does
-not allow to get a conform mesh, a generic solution is applied: an additional node
-is created at the gravity center of a hexahedron, serving an apex of tetrahedra, all quadrangle sides of the hexahedron are split into two triangles each serving a base of a new tetrahedron.
+- Into 2 (or 4) prisms allows to specify the number of prisms a hexahedron will be split into.
+- Facet to split group allows to specify the side (facet) of the hexahedron, which is split into triangles. This facet is defined by a point and a direction. The algorithm finds a hexahedron closest to the specified point and splits a facet whose normal is closest to the specified direction. Then the splitting is propagated from that hexahedron to all adjacent hexahedra.
+The point and the direction by which the first split hexahedron is found can be specified:
+
+ - by input of coordinates in Hexa location and Facet normal fields, or
+ - by clicking Selection button and selecting in the viewer the element whose barycenter will be used as the start point and whose direction will be used as a normal to facet to split into triangles. Switch this button
+off to return to selection of volumes to split.
-
+
+ - If All domains option is off, the operation stops when all
+ hehexedra adjacent to the start hexahedron are split into
+ prisms. Else the operation tries to continue splitting starting from
+ another hexahedron closest to the Hexa location.
+
- - Select from a set of fields allows to choose a submesh or an
-existing group whose elements will be automatically added to the
-list.
+- Select from set of fields allows choosing a sub-mesh or an
+ existing group whose elements will be added to the list as you click \b Add button.
-- Click the \b Apply or Apply and Close button to confirm the operation.
+- Click \b Apply or Apply and Close button to confirm the operation.
*/