X-Git-Url: http://git.salome-platform.org/gitweb/?a=blobdiff_plain;f=doc%2Fsalome%2Fgui%2FSMESH%2Finput%2Fghs3d_hypo.doc;h=dfd0041f591b71097e86475d52061ada968e4af8;hb=da4fe2a060153eadccd50faeec22f80b0613fd80;hp=230929ce7a0cd500824e8bf2cdf20dcfec481849;hpb=9c4ebc1257fc4efffe0cf3af158878af996d4f6c;p=modules%2Fsmesh.git
diff --git a/doc/salome/gui/SMESH/input/ghs3d_hypo.doc b/doc/salome/gui/SMESH/input/ghs3d_hypo.doc
index 230929ce7..dfd0041f5 100644
--- a/doc/salome/gui/SMESH/input/ghs3d_hypo.doc
+++ b/doc/salome/gui/SMESH/input/ghs3d_hypo.doc
@@ -2,9 +2,19 @@
\page ghs3d_hypo_page GHS3D Parameters hypothesis
+\anchor ghs3d_top
\n GHS3D Parameters hypothesis works only with Tetrahedron (GHS3D)
algorithm. This algorithm is a commercial software.
+\n To get a licence, visit http://www.distene.com/corp/eval-distene.html
+
+- \ref ghs3d_general_parameters "General parameters"
+- \ref ghs3d_advanced_parameters "Advanced parameters"
+- \ref ghs3d_enforced_vertices "Enforced vertices"
+- \ref ghs3d_enforced_meshes "Enforced meshes"
+
+
+\anchor ghs3d_general_parameters
General parameters
\image html ghs3d_parameters_basic.png
@@ -19,10 +29,22 @@ shape will be meshed. Volumic elements created within holes are bound
to the solid.
Optimization level - allows choosing the required
-optimization level: none, light, medium or strong. Higher level of
+optimization level:
+
+- none,
+- light,
+- medium (standard),
+- standard+,
+- strong.
+
+Higher level of
optimisation provides better mesh, but can be time-consuming.
+
+
+\ref ghs3d_top "Back to top"
+\anchor ghs3d_advanced_parameters
Advanced parameters
\image html ghs3d_parameters_advanced.png
@@ -56,16 +78,18 @@ together with the characteristics of the final mesh.
To create new nodes - if this option is checked off, ghs3d
tries to create tetrahedrons using only the nodes of the 2D mesh.
-To remove initial central point - TetMesh-GHS3D adds an internal point
-at the centre of gravity of the bounding box in order to speed up and to simplify
-the meshing process. It is however possible for TetMesh-GHS3D to refrain from creating
+To remove the initial central point TetMesh-GHS3D adds an internal point
+at the gravity centre of the bounding box to speed up and to simplify
+the meshing process. However, it is possible to refrain from creating
this point by using the command line option -no initial central point. This can be
-particularly useful to generate a volume mesh without internal points at all, and in some rare cases,
-to help the boundary regeneration phase when it failed with the standard options (for example when
-one dimension of the domain is large compared to the other two, with a ratio of 20 or more).
-Use this option when the boundary regeneration failed with the standard parameters and before using
+particularly useful to generate a volume mesh without internal points at all and in some rare cases
+at the boundary regeneration phase when it is impossible to proceed
+with the standard options
+(for example, when one dimension of the domain is more than 20 times greater than the other two).
+Use this option if the boundary regeneration has failed with the standard parameters and before using
the recovery version (command line option -C).
-Note: when using this option, the speed of the meshing process may decrease, and quality may change.
+Note: when using this option, the speed of the meshing process may
+decrease, and the quality may change.
Note: the boundary regeneration may fail with this option, in some rare cases.
To use boundary recovery version - enables using a
@@ -78,37 +102,85 @@ quality (poor aspect ratio of elements, tetrahedra with a very small
positive volume).
To use FEM correction - Applies finite-element correction by
-replacing overconstrained elements where it is possible. The process is
-first slicing the overconstrained edges and second the overconstrained
-facets. This ensures that no edges have two boundary vertices and that
-no facets have three boundary vertices. TetMesh-GHS3D gives the initial
+replacing overconstrained elements where it is possible. At first the process
+slices the overconstrained edges and at second the overconstrained
+facets. This ensures that there are no edges with two boundary
+vertices and that there are no facets with three boundary vertices. TetMesh-GHS3D gives the initial
and final overconstrained edges and facets. It also gives the facets
which have three edges on the boundary.
Note: when using this option, the speed of the meshing process may
decrease, quality may change, and the smallest volume may be smaller.
-The default is no correction.
+By default, the FEM correction is not used.
-Option as text - allows input of any text as command line
-for ghs3d. This allows the input of advanced options in a free from.
+Option as text - allows to input in the command line any text
+for ghs3d, for example, advanced options.
+\ref ghs3d_top "Back to top"
+\anchor ghs3d_enforced_vertices
Enforced vertices
-\image html ghs3d_enforced_vertices.png
+\note This feature is currently available only on meshes with no
+geometry attached. Such meshes can be obtained by
+
+- Copying an existing mesh
+- Importing a mesh from file
+- Applying a transformation to a mesh a get result in a new mesh
+
-GHS3D algorithm can locally raffine the mesh. It is possible to define enforced vertices in the volume where the mesh will be raffined.
+\image html ghs3d_enforced_vertices.png
-A node will be created at the enforced vertex coordinates. There is no need to create a vertex in the CAD.
+GHS3D algorithm can locally make the mesh finer. It is possible to
+define enforced vertices in the volume where the mesh will be detailed.
+A node will be created at the enforced vertex coordinates.
An enforced vertex is defined by:
-- The (x,y,z) cartesian coordinates
+- A vertex
+
+- from GEOM (Vertex, Compound)
+- or from (x,y,z) cartesian coordinates
+
- A constant physical size
+- If a group name is given, the created node will be added to the
+group. If the group does not exist, it is created.
+
+\ref ghs3d_top "Back to top"
+
+\anchor ghs3d_enforced_meshes
+Enforced Meshes
+
+\note This feature is currently only available on meshes with no
+geometry attached. Such meshes can be obtained by
+
+- Copying an existing mesh
+- Importing a mesh from file
+- Applying a transformation to a mesh a get result in a new mesh
+
+
+\image html ghs3d_enforced_meshes.png
+
+GHS3D algorithm can be forced by other meshes, sub-meshes or
+groups. The constraint elements should be contained
+entirely into the solid mesh.
+
+- The constraint element types are:
+
+- If a size is given, the mesh will be refined around the enforced
+elements given the size
+- If a group name is given, the enforced elements will be added to
+the group. If the group does not exist, it is created.
See Also a sample TUI Script of the \ref tui_ghs3d "creation of a Ghs3D hypothesis", including enforced vertices.
+\ref ghs3d_top "Back to top"
+
-*/
\ No newline at end of file
+*/