.. _blockmethod:
-===============================
-Principle: the method by blocks
-===============================
-
-Principle
-=========
-
-The principle of the method by block is to decompose the geometry to
-be meshed into a set of hexahedra related per face. The initial
-geometry is divided into a new geometry which has the property to be a
-set solids. All these solids are hexahedra with shared faces. Once
-cutting is complete, the mesh is easy to obtain.
-
-The method by blocks consists in:
+=======================
+Build a model of blocks
+=======================
-- finding a compound of blocks,
-- this compound of blocks has to be equivalent to the initial geometry to mesh.
+What is a model of blocks ?
+===========================
+A block (or a hexahedron) is a volume defined by:
+ - 8 vertices
+ - 12 edges
+ - 6 quadrangular faces
-A block is a volume defined by:
+A model of blocks is a set of blocks.
-- 8 vertices
-- 12 edges
- - *straight line*, *curve*
-- 6 quadrangular faces
- - *planar face*, *3D face*
-
-A compound of blocks is a volume that for each face is:
-
-- either a free face (in one block)
-- or a face shared between 2 blocks
+And for each quadrangle of a model of blocks, this quadrangle is:
+ - or a free face
+ - or a face shared between 2 blocks
+How to find a model of blocks ?
+===============================
+In this version of HEXABLOCK component, the user must find himself the model of blocks that is adapted for his geometry.
+
.. _modelbloc:
-Create a model of blocks
-========================
+How to create a model of blocks ?
+=================================
+
+When the user find the model of blocks necessary for his geometry to be meshed with hexahedra,
+HEXABLOCK component has a lot of tool to build this model of blocks:
-A model of block is a compound of blocks based on a topological
-definition. The model of blocks construction can be build by using the
-two following methods:
+- basic functions:
+ - create one hexahedron
+ - create a hexahedra with 2, 3, 4 or 5 quadrangles
+ - remove hexahedra
-1. Construct and associate blocks (hexahedra)
- - the main operations for creating blocks are:
- - Basics: create, remove,transform
- - construct hexahedra grids: cartesian, cylindrical, spherical
+- grid building:
+ - cartesian grid
+ - cylindrical grid
+ - spherical grid
- - blocks association operations:
- - merge, cut, disconnect hexahedra
- - prism, join quadrangles
- - merge two quadrangles of two blocks
- - merge two edges
- - merge two vertices
- - disconnect two vertices
- - create hexahedra between two existing quadrangles
-
-2. Construct hexahedra via predefined models:
- - cylinder
- - pipe
- - two intersected cylinders
- - two intersected pipes
+- predefined model of blocks:
+ - for cylinder
+ - for pipe
+ - for two intersected cylinders
+ - for two intersected pipes
+ - for hemisphere
+ - for ring
+
+- powerfull functions:
+ - prism quadrangles
+ - join quadrangles
+ - make hexahedra by revolution of quadrangles
+ - cut an edge to slice hexahedra
+ - replace an hexadron by a pattern
+
+- by transformation:
+ - translation
+ - rotation
+ - scale
+
+- by symetry:
+ - with a point
+ - with a line
+ - with a plane
+
+- by merging:
+ - of two vertices
+ - of two edges
+ - of two quadrangles
+
+- by disconnection:
+ - of two vertices
+ - of two edges
+ - of two quadrangles
Example of simple model of blocks
=================================
-.. image:: _static/ex1.PNG
+.. image:: _static/ex1.png
:align: center
.. centered::
- 2 blocks linked by 1 face
+ An exemple of a model with 12 blocks