Salome HOME
Merge from V6_main 11/02/2013
[modules/smesh.git] / doc / salome / gui / SMESH / input / prism_3d_algo.doc
1 /*!
2
3 \page prism_3d_algo_page 3D extrusion meshing algorithm
4
5 3D extrusion algorithm can be used for meshing prisms, i.e. 3D shapes
6 defined by two opposing faces having the same number of vertices and
7 edges. These two faces should be connected by quadrangle "side" faces.
8
9 The prism is allowed to have sides composed of several faces. (A prism
10 side is a row of faces (or one face) connecting corresponding edges of
11 the top and base faces). But there is a limitation that a prism 
12 side is allowed to be split only vertically as indicated in the
13 picture below. 
14
15 \image html prism_ok_ko.png
16 In this picture, the left prism is suitable for meshing with 3D
17 extrusion algorithm; it has six sides two of which are split
18 vertically. And the right prism can't be meshed with this
19 algorithm because one of the prism sides is split horizontally (a
20 splitting edge is highlighted).
21
22 The algorithm can propagate 2D mesh not only between horizontal
23 (i.e. base and top) faces of one prism but also between faces of prisms
24 organized in a stack and between stacks sharing prism sides.
25
26 \image html prism_stack.png
27 In this picture, four neighboring prism stacks, each comprising two prisms,
28 are shown. The shown sub-mesh is used by the algorithm to mesh
29 all the eight prisms in the stacks.
30
31 To use <em>3D extrusion</em> algorithm you need to assign algorithms
32 and hypotheses of lower dimension as follows.
33 (A sample picture below shows algorithms and hypotheses used to
34 mesh a cylinder with prismatic volumes).
35
36 \image html prism_needs_hyps.png
37
38 \b Global algorithms and hypotheses to be chosen at 
39 \ref create_mesh_anchor "Creation of a mesh object" are:
40 <ul>
41 <li> 1D algorithm and hypothesis that will be applied for meshing
42   (logically) vertical edges of the prism (these edges connect the top and
43   base faces of prism). In the sample picture above these are
44   "Regular_1D" algorithm and "Nb. Segments_1" hypothesis.</li>
45 </ul>
46
47 \b Local algorithms and hypotheses to be chosen at 
48 \ref constructing_submeshes_page "Constructing sub-meshes" are:
49 <ul>
50   <li> 1D and 2D algorithms and hypotheses that will be applied for
51     meshing the top and base prism faces. These faces can be meshed
52     with any type of 2D elements: quadrangles, triangles, polygons or
53     their mix. It's enough to define a sub-mesh on either top or base
54     face. In the sample picture above, "BLSURF" algorithm meshes
55     "Face_1" base surface with triangles. (1D algorithm is not
56     assigned as "BLSURF" does not require divided edges to create 2D mesh.)
57   </li>
58   <li> Optionally you can define an 1D sub-mesh on some vertical edges
59     of stacked prisms, which will override the global 1D hypothesis mentioned
60     above. In the picture above the picture of Object Browser, the
61     vertical division is not equidistant on all the length because of
62     a "Number Of Segments" hypothesis with Scale Factor=3 assigned to
63     the highlighted edge. 
64 </li></ul>
65
66 \image html image157.gif 
67
68 Prism with 3D extrusion meshing. "Vertical" division is different on
69 neighbor edges due to local 1D hypotheses assigned.
70
71 \sa a sample TUI Script of
72 \ref tui_prism_3d_algo "Use 3D extrusion meshing algorithm".
73
74 */