doc/creategrids.rst

   1 :tocdepth: 3
   2
   3 .. _creategrids:
   4
   5 ============
   6 Create grids
   7 ============
   8
   9 To create a **Grid** in the **Main Menu** select **Model -> Make Grid**.
  10
  11 Three kinds of grid can be created:
  12
  13 - cartesian grid (see :ref:`guicartgrid`),
  14 - cylindrical grid (see :ref:`guicylgrid`),
  15 - spherical grid (see :ref:`guisphergrid`).
  16
  17 .. _guicartgrid:
  18
  19 Cartesian grid
  20 ==============
  21
  22 To create a cartesian grid, select radio button **Cartesian**:
  23
  24 .. image:: _static/gui_make_cart_grid.png
  25    :align: center
  26
  27 .. centered::
  28       Dialogue Box for a Cartesian grid
  29
  30
  31 The following data are required:
  32
  33 - the vertex of the initial hexahedron,
  34 - the vector corresponding to the diametrically opposite vertex to the initial vertex,
  35 - the number of repetition of this hexahedra along the three axes
  36   (n(x), n(y) and n(z)).
  37
  38
  39 The result of this action is:
  40
  41 .. image:: _static/cartgrid3.png
  42    :align: center
  43
  44 .. centered::
  45    Result Cartesian Grid
  46
  47 TUI command: :ref:`tuicartgrid`
  48
  49
  50 .. _guicylgrid:
  51
  52 Cylindrical grid
  53 ================
  54
  55 To create a cylindrical grid, select radio button **Cylindrical**:
  56
  57 .. image:: _static/gui_make_cyl_grid.png
  58    :align: center
  59
  60 .. centered::
  61    Dialogue Box for a Cylindrical grid (regular size)
  62
  63
  64 The following data are required:
  65
  66 - Cylinder
  67     - center: coordinates of the cylinder base center (select a vertex).
  68     - base: base vector of the cylinder (select a vector).
  69     - height: vertical vector of the cylinder (select a vector).
  70
  71 - Grid
  72     - radius: size and number of elements from the center.
  73     - angle: size and number of elements around the center.
  74     - height: size and number of elements on height.
  75     - fill: choose this option to fill the central part of the hexhahedra.
  76
  77
  78 Elements size of the grid can be irregular (differents sizes). Select the adequate radio button:
  79
  80 .. image:: _static/gui_make_cyl_grid_irregular.png
  81    :align: center
  82
  83 .. centered::
  84    Dialogue Box for a Cylindrical grid (irregular size)
  85
  86
  87 The result is an array of hexahedra which are arranged along the
  88 radial axis first, then the angular axis, then according to the layers
  89 and then possibly hexahedra filling the central part.
  90
  91 The filling of the central part of the cylinder is made according to the two following cases:
  92
  93 .. image:: _static/cyl_grid2.PNG
  94    :align: center
  95
  96 .. centered::
  97    Filling of the central part of the cylinder in the case the number of angular elements is odd na = 5.
  98
  99 .. image:: _static/cyl_grid1.PNG
 100    :align: center
 101
 102 .. centered::
 103    Filling of the central part of the cylinder in the case the number of angular elements is even na = 4.
 104
 105
 106 The result:
 107
 108 .. image:: _static/cylgrid1.png
 109    :align: center
 110
 111 .. image:: _static/cylgrid2.png
 112    :align: center
 113
 114 .. image:: _static/cylgrid3.png
 115    :align: center
 116
 117 .. image:: _static/cylgrid4.png
 118    :align: center
 119
 120 .. image:: _static/cylgrid5.png
 121    :align: center
 122
 123 .. image:: _static/cylgrid6.png
 124    :align: center
 125
 126
 127 .. centered::
 128    Cylindrical grids with different filling cases
 129
 130 TUI command: :ref:`tuicylgrid`
 131
 132 .. _guisphergrid:
 133
 134 Spherical grid
 135 ===============
 136
 137 To create a spherical grid, select radio button **Spherical**:
 138
 139 .. image:: _static/gui_make_spher_grid.png
 140    :align: center
 141
 142 .. centered::
 143    Dialogue Box for a Spherical grid
 144
 145
 146 The following data are required:
 147
 148 - the center (vertex) of the central hexahedron,
 149 - the vector corresponding to the diametrically opposite vertex to the initial vertex,
 150 - the number of embedded hexahedra (nb),
 151 - the coefficient of growth (k).
 152
 153
 154 The result is an array of hexahedra starting with the central and
 155 other hexahedral are arranged layer by layer from the center. Each
 156 layer contains six hexahedral always in the following order: two along
 157 the X axis, then two for the Y axis and two for the Z axis.
 158
 159 The result of this action is:
 160
 161 .. image:: _static/sph_grid.png
 162    :align: center
 163
 164 .. centered::
 165    Resulting Spherical grid
 166
 167 TUI command: :ref:`tuisphergrid`