doc/salome/gui/SMESH/input/ghs3d_hypo.doc

   1 /*!
   2
   3 \page ghs3d_hypo_page GHS3D Parameters hypothesis
   4
   5 \anchor ghs3d_top
   6 \n GHS3D Parameters hypothesis works only with <b>Tetrahedron (GHS3D)</b>
   7 algorithm. This algorithm is a commercial software.
   8 \n To get a licence, visit http://www.distene.com/corp/eval-distene.html
   9
  10 <ol>
  11 <li>\ref ghs3d_general_parameters "General parameters"</li>
  12 <li>\ref ghs3d_advanced_parameters "Advanced parameters"</li>
  13 <li>\ref ghs3d_enforced_vertices "Enforced vertices"</li>
  14 <li>\ref ghs3d_enforced_meshes "Enforced meshes"</li>
  15 </ol>
  16
  17 \anchor ghs3d_general_parameters
  18 <h1>General parameters</h1>
  19
  20 \image html ghs3d_parameters_basic.png
  21
  22 <ul>
  23 <li><b>Name</b> - allows to define the name of the hypothesis (GHS3D
  24 Parameters by default).</li>
  25
  26 <li><b>To mesh holes</b> - if checked, the algorithm will
  27 create mesh in the holes inside a solid shape, else only the outermost
  28 shape will be meshed. Volumic elements created within holes are bound
  29 to the solid.</li>
  30
  31 <li><b>Optimization level</b> - allows choosing the required
  32 optimization level:
  33 <ul>
  34 <li>none,</li>
  35 <li>light,</li>
  36 <li>medium (standard),</li>
  37 <li>standard+,</li>
  38 <li>strong.</li>
  39 </ul>
  40 Higher level of
  41 optimisation provides better mesh, but can be time-consuming.
  42 </li>
  43 </ul>
  44
  45 \ref ghs3d_top "Back to top"
  46
  47 \anchor ghs3d_advanced_parameters
  48 <h1>Advanced parameters</h1>
  49
  50 \image html ghs3d_parameters_advanced.png
  51
  52 <li><b>Maximum memory size</b> - launches ghs3d software with
  53 work space limited to the specified amount of RAM, in Mbytes. If this option is
  54 checked off, the software will be launched with 7O% of the total RAM space. </li>
  55
  56 <li><b>Initial memory size</b> - starts ghs3d software with
  57 the specified amount of work space, in Mbytes. If this option is checked off, the
  58 software will be started with 100 Megabytes of working space. </li>
  59
  60 <li><b>Working directory</b> - allows defining the folder for input and output
  61 files of ghs3d software, which are the files starting with "GHS3D_" prefix. </li>
  62
  63 <li><b>Keep working files</b> - allows checking input and output files
  64 of ghs3d software, while usually these files are removed after the
  65 launch of the mesher.</li>
  66
  67 <li><b>Verbose level</b> - to choose verbosity level in the range from
  68 0 to 10.
  69 <ul> <li>0, no standard output,
  70 </li><li>2, prints the data, quality statistics of the skin and final
  71 meshes and indicates when the final mesh is being saved. In addition
  72 the software gives indication regarding the CPU time.
  73 </li><li>10, same as 2 plus the main steps in the computation, quality
  74 statistics histogram of the skin mesh, quality statistics histogram
  75 together with the characteristics of the final mesh.
  76 </li></ul></li>
  77
  78 <li><b>To create new nodes</b> - if this option is checked off, ghs3d
  79 tries to create tetrahedrons using only the nodes of the 2D mesh.</li>
  80
  81 <li><b>To remove the initial central point</b> TetMesh-GHS3D adds an internal point
  82 at the gravity centre of the bounding box to speed up and to simplify
  83 the meshing process. However, it is possible to refrain from creating
  84 this point by using the command line option -no initial central point. This can be
  85 particularly useful to generate a volume mesh without internal points at all and in some rare cases
  86 at the boundary regeneration phase when it is impossible to proceed
  87 with the standard options
  88 (for example, when one dimension of the domain is more than 20 times greater than the other two).
  89 Use this option if the boundary regeneration has failed with the standard parameters and before using
  90 the recovery version (command line option -C).
  91 Note: when using this option, the speed of the meshing process may
  92 decrease, and the quality may change.
  93 Note: the boundary regeneration may fail with this option, in some rare cases.</li>
  94
  95 <li><b>To use boundary recovery version</b> - enables using a
  96 boundary recovery module which tries to
  97 create volume meshes starting from very poor quality surface meshes
  98 (almost flat triangles on the surface, high density propagation,
  99 extreme aspect ratios, etc.) which fails with the standard version. The
 100 resulting volume mesh will however most likely have a very poor
 101 quality (poor aspect ratio of elements, tetrahedra with a very small
 102 positive volume).</li>
 103
 104 <li><b>To use FEM correction</b> - Applies finite-element correction by
 105 replacing overconstrained elements where it is possible. At first the process
 106 slices the overconstrained edges and at second the overconstrained
 107 facets. This ensures that there are no edges with two boundary
 108 vertices and that there are no facets with three boundary vertices. TetMesh-GHS3D gives the initial
 109 and final overconstrained edges and facets. It also gives the facets
 110 which have three edges on the boundary.
 111 Note: when using this option, the speed of the meshing process may
 112 decrease, quality may change, and the smallest volume may be smaller.
 113 By default, the FEM correction is not used.</li>
 114
 115 <li><b>Option as text</b> - allows to input in the command line any text
 116 for ghs3d, for example, advanced options. </li>
 117
 118 </ul>
 119
 120 \ref ghs3d_top "Back to top"
 121
 122 \anchor ghs3d_enforced_vertices
 123 <h1>Enforced vertices</h1>
 124
 125 \note This feature is currently available only on meshes with no
 126 geometry attached. Such meshes can be obtained by
 127 <ul>
 128 <li>Copying an existing mesh</li>
 129 <li>Importing a mesh from file</li>
 130 <li>Applying a transformation to a mesh a get result in a new mesh</li>
 131 </ul>
 132
 133 \image html ghs3d_enforced_vertices.png
 134
 135 GHS3D algorithm can locally make the mesh finer. It is possible to
 136 define enforced vertices in the volume where the mesh will be detailed.
 137 A node will be created at the enforced vertex coordinates.
 138
 139 An enforced vertex is defined by:
 140 <ul>
 141 <li>A vertex</li>
 142 <ul>
 143 <li>from GEOM (Vertex, Compound)</li>
 144 <li>or from (x,y,z) cartesian coordinates</li>
 145 </ul>
 146 <li>A constant physical size</li>
 147 <li>If a group name is given, the created node will be added to the
 148 group. If the group does not exist, it is created.</li>
 149 </ul>
 150 \ref ghs3d_top "Back to top"
 151
 152 \anchor ghs3d_enforced_meshes
 153 <h1>Enforced Meshes</h1>
 154
 155 \note This feature is currently only available on meshes with no
 156 geometry attached. Such meshes can be obtained by
 157 <ul>
 158 <li>Copying an existing mesh</li>
 159 <li>Importing a mesh from file</li>
 160 <li>Applying a transformation to a mesh a get result in a new mesh</li>
 161 </ul>
 162
 163 \image html ghs3d_enforced_meshes.png
 164
 165 GHS3D algorithm can be forced by other meshes, sub-meshes or
 166 groups. The constraint elements should be contained
 167 entirely into the solid mesh.
 168 <ul>
 169 <li>The constraint element types are:
 170 <ul>
 171 <li>NODE</li>
 172 <li>EDGE</li>
 173 <li>FACE</li>
 174 </ul></li>
 175 <li>If a size is given, the mesh will be refined around the enforced
 176 elements given the size</li>
 177 <li>If a group name is given, the enforced elements will be added to
 178 the group. If the group does not exist, it is created.</li>
 179 </ul>
 180
 181 <br><b>See Also</b> a sample TUI Script of the \ref tui_ghs3d "creation of a Ghs3D hypothesis", including enforced vertices.
 182
 183 \ref ghs3d_top "Back to top"
 184
 185
 186 */