Salome HOME
Merge from V6_main_20120808 08Aug12
[modules/hexablock.git] / doc / general.rst
1 :tocdepth: 3
2
3 .. _generale:
4
5 #########################
6 Introduction to HEXABLOCK 
7 #########################
8
9 .. Within the SALOME framework, a CAD module (GEOM) and a meshing
10    module (SMESH) are developed. This tools enable the construction
11    of hexahedrical meshes by means of a CAD cutting in blocks (the
12    method of blocks) topologically equivalent to hexahedra. Once this
13    cutting performed, the mesh construction is easy, but the method of
14    blocks can be touchy if the piece to mesh is complex.
15
16 Goals
17 =====
18
19 The HexaBlock module is designed to help users to build hexahedrical meshes
20 via the method by blocks. The two fundamental choices are:
21
22 - To execute the method by blocks where the user has to determine the needed blocks.
23 - To simplify all other tasks to obtain the mesh (in particular by
24   using directly the geometry to mesh).
25
26 Solution
27 ========
28
29 Finding a compound of blocks is in charge of users.
30  
31 HexaBlock enables to define a mesh with hexahedra in five stages:
32
33 - Load and create a geometry without constraint.
34 - Search a compound of blocks (mental working).
35 - Create a model of blocks:
36
37   - Logic realization of this division with operations on blocks.
38   - Regardless of the geometry to be meshed in terms of shape and placement.
39
40 - Associate this model of blocks to the geometry:
41
42   - Associate all the vertices of the model to the geometry.
43   - If necessary, associate edges of the model to the geometry.
44   - If necessary, associate quads of the model to the geometry.
45
46 - Generate the mesh:
47
48   - Create discretization laws.
49   - Discretize the edges.
50   - Define mesh groups.
51   - Setting the mesh generation.
52
53 Two ways of working are possible:
54
55 - *Graphic User Interface*
56 - *Python Scripting*
57
58
59 Presentation of the stages
60 ==========================
61
62 - The construction of the real CAD (see :ref:`cad`).
63
64 - The creation of a model of blocks (see :ref:`blockmethod`).
65
66 - The association of this model of blocks to the geometry (see :ref:`assomodelgeo`).
67
68 - The mesh generation (see :ref:`generatemesh`).
69
70
71
72 .. toctree::
73    :maxdepth: 3
74
75    cad.rst
76    block_method.rst
77    intro_association.rst
78    intro_groups.rst
79    intro_mesh.rst
80    intro_python.rst
81    annexe.rst
82