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

   1 /*!
   2
   3 \page ghs3d_hypo_page GHS3D Parameters hypothesis
   4
   5 \n GHS3D Parameters hypothesis works only with <b>Tetrahedron (GHS3D)</b>
   6 algorithm. This algorithm is a commercial software.
   7 \n To get a licence, visit http://www.distene.com/corp/eval-distene.html
   8
   9 <h1>General parameters</h1>
  10
  11 \image html ghs3d_parameters_basic.png
  12
  13 <ul>
  14 <li><b>Name</b> - allows to define the name of the hypothesis (GHS3D
  15 Parameters by default).</li>
  16
  17 <li><b>To mesh holes</b> - if checked, the algorithm will
  18 create mesh in the holes inside a solid shape, else only the outermost
  19 shape will be meshed. Volumic elements created within holes are bound
  20 to the solid.</li>
  21
  22 <li><b>Optimization level</b> - allows choosing the required
  23 optimization level: none, light, medium or strong. Higher level of
  24 optimisation provides better mesh, but can be time-consuming.
  25 </li>
  26
  27 <h1>Advanced parameters</h1>
  28
  29 \image html ghs3d_parameters_advanced.png
  30
  31 <li><b>Maximum memory size</b> - launches ghs3d software with
  32 work space limited to the specified amount of RAM, in Mbytes. If this option is
  33 checked off, the software will be launched with 7O% of the total RAM space. </li>
  34
  35 <li><b>Initial memory size</b> - starts ghs3d software with
  36 the specified amount of work space, in Mbytes. If this option is checked off, the
  37 software will be started with 100 Megabytes of working space. </li>
  38
  39 <li><b>Working directory</b> - allows defining the folder for input and output
  40 files of ghs3d software, which are the files starting with "GHS3D_" prefix. </li>
  41
  42 <li><b>Keep working files</b> - allows checking input and output files
  43 of ghs3d software, while usually these files are removed after the
  44 launch of the mesher.</li>
  45
  46 <li><b>Verbose level</b> - to choose verbosity level in the range from
  47 0 to 10.
  48 <ul> <li>0, no standard output,
  49 </li><li>2, prints the data, quality statistics of the skin and final
  50 meshes and indicates when the final mesh is being saved. In addition
  51 the software gives indication regarding the CPU time.
  52 </li><li>10, same as 2 plus the main steps in the computation, quality
  53 statistics histogram of the skin mesh, quality statistics histogram
  54 together with the characteristics of the final mesh.
  55 </li></ul></li>
  56
  57 <li><b>To create new nodes</b> - if this option is checked off, ghs3d
  58 tries to create tetrahedrons using only the nodes of the 2D mesh.</li>
  59
  60 <li><b>To remove the initial central point</b> TetMesh-GHS3D adds an internal point
  61 at the gravity centre of the bounding box to speed up and to simplify
  62 the meshing process. However, it is possible to refrain from creating
  63 this point by using the command line option -no initial central point. This can be
  64 particularly useful to generate a volume mesh without internal points at all and in some rare cases
  65 at the boundary regeneration phase when it is impossible to proceed
  66 with the standard options
  67 (for example, when one dimension of the domain is more than 20 times greater than the other two).
  68 Use this option if the boundary regeneration has failed with the standard parameters and before using
  69 the recovery version (command line option -C).
  70 Note: when using this option, the speed of the meshing process may
  71 decrease, and the quality may change.
  72 Note: the boundary regeneration may fail with this option, in some rare cases.</li>
  73
  74 <li><b>To use boundary recovery version</b> - enables using a
  75 boundary recovery module which tries to
  76 create volume meshes starting from very poor quality surface meshes
  77 (almost flat triangles on the surface, high density propagation,
  78 extreme aspect ratios, etc.) which fails with the standard version. The
  79 resulting volume mesh will however most likely have a very poor
  80 quality (poor aspect ratio of elements, tetrahedra with a very small
  81 positive volume).</li>
  82
  83 <li><b>To use FEM correction</b> - Applies finite-element correction by
  84 replacing overconstrained elements where it is possible. At first the process
  85 slices the overconstrained edges and at second the overconstrained
  86 facets. This ensures that there are no edges with two boundary
  87 vertices and that there are no facets with three boundary vertices. TetMesh-GHS3D gives the initial
  88 and final overconstrained edges and facets. It also gives the facets
  89 which have three edges on the boundary.
  90 Note: when using this option, the speed of the meshing process may
  91 decrease, quality may change, and the smallest volume may be smaller.
  92 By default, the FEM correction is not used.</li>
  93
  94 <li><b>Option as text</b> - allows to input in the command line any text
  95 for ghs3d, for example, advanced options. </li>
  96
  97 </ul>
  98
  99
 100 <h1>Enforced vertices</h1>
 101
 102 \image html ghs3d_enforced_vertices.png
 103
 104 GHS3D algorithm can locally make the mesh finer. It is possible to define enforced vertices in the volume where the mesh will be detailed.
 105
 106 A node will be created at the enforced vertex coordinates. There is no need to create a vertex in CAD.
 107
 108 An enforced vertex is defined by:
 109 <ul>
 110 <li>The (x,y,z) cartesian coordinates</li>
 111 <li>A constant physical size</li>
 112 </ul>
 113
 114 <br><b>See Also</b> a sample TUI Script of the \ref tui_ghs3d "creation of a Ghs3D hypothesis", including enforced vertices.
 115
 116
 117 */