mirror of
https://git.salome-platform.org/gitpub/modules/smesh.git
synced 2024-09-24 11:42:51 +05:00
393 lines
14 KiB
Plaintext
393 lines
14 KiB
Plaintext
/*!
|
|
|
|
\page ghs3dprl_hypo_page GHS3DPRL Parameters hypothesis
|
|
|
|
\n GHS3DPRL Parameters hypothesis works only with <b>Tetrahedron (Tepal with TetMesh-GHS3D)</b> algorithm.
|
|
\n
|
|
\n This algorithm is a commercial software, its use requires a licence (http://www.distene.com/fr/build/offer.html).
|
|
\n The advantage of Tepal is the possibility to generate (for example) a <em>partitioned</em>
|
|
200 million tetrahedra mesh on a not-so-big memory computer (2Go RAM)
|
|
...in something like 50 hours of <em>one</em> CPU (Xeon, 2008).
|
|
This is an alternative to Pluging GHS3D where you should need something like a not-so-common CPU with 64Go RAM
|
|
<em>to try</em> to do a one-partitionned 200 million tetrahedra mesh ...in a much less time indeed.
|
|
\n
|
|
\n Notes:
|
|
\n This Plugin <em>doesn't</em> load in Memory the supposed plentiful big resulting meshes.
|
|
It's user choice: (in GUI Mesh mode) menu File-Import-MED Files.
|
|
\n Beware, to load one 5 millions tetrahedra MED file, GUI Salome needs 2Go RAM.
|
|
\n A new true parallel faster version of Tepal, using MPI, is expected in 2009.
|
|
|
|
\image html ghs3dprl_parameters_basic.png
|
|
|
|
<ul>
|
|
<li>
|
|
<b>Name</b> - allows to define the name of the hypothesis (GHS3DPRL Parameters by default).
|
|
</li>
|
|
<li>
|
|
<b>MED_Name</b> - allows to define the path and the basename of the
|
|
generated resulted MED files ("DOMAIN" by default).
|
|
Undefined path means environment variable $SALOME_TMP_DIR (or $TMP by default).
|
|
</li>
|
|
<li>
|
|
<b>Nb_Part</b> - allows to define the number of MED files generated,
|
|
the initial skin (triangles) will be meshed (tetrahedra) and partitioned
|
|
in Nb_Part by the <i>elementary</i> algorithm implemented in Tepal.<br>
|
|
Beware, the (expected) number of total tetrahedra versus this parameter
|
|
involves the maximum tepal RAM use.
|
|
</li>
|
|
<li>
|
|
<b>Keep_Files</b> - if this box is checked, input files of Tepal
|
|
(GHS3DPRL.points and GHS3DPRL.faces) are deleted after use (...if no backgrounding).
|
|
</li>
|
|
<li>
|
|
<b>Tepal_in_Background</b> - if this box is checked, for big meshes,
|
|
launch Tepal execution and MED file generation in background,
|
|
allows user exiting of Salome. In this case, beware of the
|
|
job Tepal is "killSalome.py" <i>independent</i>, sometimes on other host.
|
|
</li>
|
|
<li>
|
|
<b>To_Mesh_Holes</b> - if this box is checked, force parameter component
|
|
of tetmesh-ghs3d to mesh holes.
|
|
</li>
|
|
|
|
<h1>Modifying GHS3DPRL Advanced Parameters</h1><br>
|
|
GHS3DPRL Plugin launches standalone binary executable tepal2med which launches binary executable tepal.<br>
|
|
tepal2med launches tepal, wait for the end of computation, and converts resulting output tepal files in expected MED files.<br>
|
|
Some advanced optional parameters are accessibles as arguments.<br>
|
|
If keep_files checked you a posteriori can always re-launch tepal2med in a Terminal as a command with yours parameters.<br>Idem for tepal.<br><br>
|
|
<li>
|
|
<b>Advanced tepal2med Parameters</b> - type "tepal2med --help" in a Terminal. <p>
|
|
|
|
\verbatim
|
|
myname@myhost > /export/home/myname/salome_5/GHS3DPRLPLUGIN_5/bin/salome/tepal2med --help
|
|
Available options:
|
|
--help : produces this help message
|
|
--casename : path and name of input tepal2med files which are
|
|
- output files of tepal .msg .noboite .faces .points .glo
|
|
- output file of GHS3DPRL_Plugin casename_skin.med (optional)
|
|
with initial skin and its initial groups
|
|
--number : number of partitions
|
|
--medname : path and name of output MED files
|
|
--limitswap : max size of working cpu memory (Mo) (before swapping on .temp files)
|
|
--verbose : trace of execution (0->6)
|
|
--test : more tests about joints, before generation of output files
|
|
--menu : a GUI menu for option number
|
|
--launchtepal : also launch tepal on files casename.faces and casename.points and option number
|
|
--meshholes : force parameter component of tetmesh-ghs3d to mesh holes
|
|
--background : force background mode from launch tepal and generation of final MED files (big meshes)
|
|
--deletegroups : regular expression (see QRegExp) which matches unwanted groups in final MED files
|
|
(try --deletegroups="(\bAll_Nodes|\bAll_Faces)"
|
|
(try --deletegroups="((\bAll_|\bNew_)(N|F|T))"
|
|
example:
|
|
tepal2med --casename=/tmp/GHS3DPRL --number=2 --medname=DOMAIN --limitswap=1000
|
|
--verbose=0 --test=yes --menu=no --launchtepal=no
|
|
|
|
\endverbatim
|
|
|
|
</li>
|
|
<li>
|
|
<p>
|
|
<b>Advanced tepal Parameters</b> - type "tepal" in a Terminal. <p>
|
|
|
|
\verbatim
|
|
myname@myhost > tepal
|
|
=====================================
|
|
GHS3D-TEPAL 1.4.2 (Dec, 2006) 10-Dec-2008 AT 12:59:48
|
|
=====================================
|
|
|
|
Distene SAS
|
|
Pole Teratec - BARD-1
|
|
Domaine du Grand Rue
|
|
91680 Bruyeres le Chatel
|
|
FRANCE
|
|
Phone: +33(0)1-69-26-62-10 Fax: +33(0)1-69-26-90-33
|
|
EMail: support@distene.com
|
|
|
|
COPYRIGHT (C)2006 DISTENE ALL RIGHTS RESERVED
|
|
|
|
|
|
USAGE : tepal options
|
|
|
|
With options in :
|
|
--filename name (-f name) :
|
|
Basename of the input case (MANDATORY)
|
|
|
|
--ndom n (-n n) :
|
|
Number of subdomains to make (MANDATORY)
|
|
|
|
--ghs3d ghs3d options (-g ghs3d options) :
|
|
Run temesh ghs3d on a previously generated subdomain. (ghs3d options must be "quoted")
|
|
|
|
--memory m (-m m) :
|
|
Max amount of memory (megabytes) allowed for ghs in the cutting process. (default is 0 : unlimited)
|
|
|
|
--mesh_only (-Z ) :
|
|
Only (re)mesh all subdomains and update communications messages
|
|
|
|
--mesh_call command (-c command) :
|
|
Call the user specified command for meshing all the subomains after their skin was generated
|
|
|
|
--stats_only (-S ) :
|
|
Only compute and show some statistics on subdomains
|
|
|
|
--rebuild (-r ) :
|
|
Merge final subdomains skins
|
|
|
|
--rebuild_tetra (-R ) :
|
|
Merge final subdomains skins and tetraedra
|
|
|
|
--rebuild_iface (-i ) :
|
|
Include interfaces in final subdomains merge
|
|
|
|
--rebuild_retag (-t ) :
|
|
Tag vertices, faces (and tetra if selected) with their subdomain number in final subdomains merge (keeps the lowest tag for shared elements)
|
|
|
|
--rebuild_ensight_parts (-e ) :
|
|
Build ensight geom file with parts
|
|
|
|
--tetmesh_args str (-G str) :
|
|
Arguments to pass to Tetmesh during cutting process
|
|
|
|
==============================================================================
|
|
GHS3D-TEPAL SOFTWARE 1.4.2 (Dec, 2006)
|
|
END OF SESSION
|
|
COPYRIGHT (C)2006 DISTENE ALL RIGHTS RESERVED
|
|
==============================================================================
|
|
( Distene SAS
|
|
Phone: +33(0)1-69-26-62-10 Fax: +33(0)1-69-26-90-33
|
|
EMail: support@distene.com )
|
|
|
|
\endverbatim
|
|
|
|
</li>
|
|
<li>
|
|
<p>
|
|
<b>Advanced ghs3d Parameters (through tepal's --tetmesh_args)</b> - type "ghs3d -h" in a Terminal. <p>
|
|
|
|
\verbatim
|
|
myname@myhost > ghs3d -h
|
|
|
|
USE
|
|
/export/home/myname/ghs3d-4.0/DISTENE/Tools/TetMesh-GHS3D4.0/bin/Linux/ghs3dV4.0
|
|
[-u] [-m memory>] [-M MEMORY] [-f prefix] [-v verbose]
|
|
[-c component] [-p0] [-C] [-E count] [-t] [-o level]
|
|
[-I filetype] [-a/-b] [-O n m]
|
|
|
|
DESCRIPTION
|
|
|
|
-u (-h) : prints this message.
|
|
|
|
-m memory : launches the software with memory Megabytes of work space.
|
|
The default value of this parameter is 64 Megabytes and its
|
|
minimum value is 10 Megabytes.
|
|
It is also possible to set this parameter with the
|
|
environment variable GHS3D_MEMORY by means of an operation
|
|
equivalent to:
|
|
setenv GHS3D_MEMORY memory,
|
|
the value specified in the command line has the priority on
|
|
the environment variable.
|
|
|
|
-M MEMORY : uses the automatic memory adjustment feature.
|
|
If MEMORY is zero, the size of the work space is initially
|
|
guessed from the input. If MEMORY is not zero, the
|
|
software starts with MEMORY Megabytes of work space.
|
|
The software then reallocates more and more memory as
|
|
needed.
|
|
The starting value when MEMORY equals 0 is 64 Megabytes,
|
|
the maximum is given with memory of the -m option if used
|
|
and the actual memory available.
|
|
|
|
-f prefix : defines the generic prefix of the files.
|
|
|
|
-v verbose : sets the output level parameter (the verbose parameter
|
|
must be in the range 0 to 10).
|
|
|
|
-c component : chooses the meshed component. If component is
|
|
0, all components to be meshed
|
|
1, only the main (outermost) component to be meshed
|
|
|
|
-p0 : disables creation of internal points.
|
|
|
|
-C : uses alternate boundary recovery version. To be used only
|
|
when the boundary recovery of the standard version fails.
|
|
|
|
-E count : sets the extended output for error messages. If -E is used,
|
|
the error messages found will be printed, up to a maximum
|
|
count of errors between 1 and 100.
|
|
|
|
-t : generates an error file prefix.Log
|
|
|
|
-o level : sets the desired optimisation level.
|
|
Valid optimisation levels are:
|
|
none, light, medium or standard, strong,
|
|
in increasing order of "quality vs speed" ratio.
|
|
|
|
-I filetype : defines the input mesh format as follows:
|
|
-IP input files are ascii files, named prefix.points
|
|
and prefix.faces - this is the default
|
|
-IPb input files are binary files, named prefix.pointsb
|
|
and prefix.facesb
|
|
-IM input file is ascii file, named prefix.mesh
|
|
where prefix is given with the -f option
|
|
|
|
-a/-b : selects the output file type:
|
|
-a for ascii (the default) and
|
|
-b for binary.
|
|
|
|
-On : saves a NOPO file in addition. NOPO is the mesh data
|
|
structure of the Simail and Modulef software packages.
|
|
-Om : saves a mesh file in addition.
|
|
-Omn : saves both NOPO and mesh files.
|
|
|
|
==============================================================================
|
|
TETMESH-GHS3D SOFTWARE 4.0-3 (December, 2006)
|
|
END OF SESSION
|
|
COPYRIGHT (C)1989-2006 INRIA ALL RIGHTS RESERVED
|
|
==============================================================================
|
|
( Distene SAS
|
|
Phone: +33(0)1-69-26-62-10 Fax: +33(0)1-69-26-90-33
|
|
EMail: support@distene.com )
|
|
|
|
\endverbatim
|
|
|
|
</li>
|
|
<h1>Saving user's preferred GHS3DPRL Advanced Parameters</h1><br>
|
|
GHS3DPRL Plugin launches standalone binary executable tepal2med.<br>
|
|
you may rename tepal2med as tepal2med.exe for example, and replace tepal2med by a shell script at your convenience to overriding parameters.<br>... or else $PATH modification... .<br>Idem for tepal.<br><br>
|
|
<li>
|
|
<b>Advanced tepal2med Parameters</b> - overriding parameter deletegroups<p>
|
|
|
|
\code
|
|
#!/bin/bash
|
|
#script tepal2med overriding parameter deletegroups
|
|
#we have renamed binary executable tepal2med as tepal2med.exe
|
|
#echo tepal2med initial parameters are $1 $2 $3 $4 ... or $*
|
|
#$0 is ignored
|
|
|
|
tepal2med.exe $* --deletegroups="(\bAll_Nodes|\bAll_Faces)"
|
|
|
|
\endcode
|
|
|
|
</li>
|
|
<li>
|
|
<p>
|
|
<b>Advanced tepal Parameters</b> - overriding parameter component of ghs3d (to mesh holes). <p>
|
|
|
|
\code
|
|
#!/bin/bash
|
|
#script tepal overriding parameter component of tetmesh-ghs3d
|
|
#we have renamed binary executable tepal as tepal.exe
|
|
|
|
#optionnaly we could set licence only for us
|
|
DISTENE_LICENSE_FILE="Use global envvar: DLIM8VAR"
|
|
DLIM8VAR="dlim8 1:1:29030@is142356/0016175ef08c::a1ba1...etc...e19"
|
|
SIMULOGD_LICENSE_FILE=29029@is142356
|
|
|
|
tepal.exe $* --tetmesh_args "-c 0"
|
|
|
|
\endcode
|
|
|
|
</li>
|
|
<li>
|
|
<p>
|
|
<b>Advanced tepal Parameters</b> - overriding launching tepal on other host. <p>
|
|
|
|
\code
|
|
#!/bin/bash
|
|
#script tepal overriding launching tepal on other host (tepal run 64 bits only)
|
|
#we have renamed binary executable tepal as tepal.exe
|
|
#common file system (same path) otherwise scp... on input or result files
|
|
#ssh -keygen -t rsa done and files id_rsa et id-rsa.pub move in ~/.ssh
|
|
|
|
#example of typical command
|
|
#tepal -f /home/myname/tmp/GHS3DPRL -n 4 > /home/myname/tmp/tepal.log
|
|
#echo parameters $1 $2 $3 $4 ... or $*
|
|
|
|
#tepal licence ought to be known on otherhost
|
|
ssh otherhost "tepal.exe $* > /home/myname/tmp/tepal.log"
|
|
|
|
#or more and more
|
|
#ssh otherhost "tepal.exe $* --tetmesh_args \"-c 0\"" > /home/myname/tmp/tepal.log
|
|
|
|
\endcode
|
|
|
|
</li>
|
|
|
|
<h1>TUI use.</h1><br>
|
|
|
|
<li>
|
|
<p>
|
|
<b>example ex30_tepal.py.</b><p>
|
|
|
|
\code
|
|
|
|
#!/bin/python
|
|
import os
|
|
|
|
import geompy
|
|
import smesh
|
|
|
|
# Parameters
|
|
# ----------
|
|
|
|
results = "/tmp/ZZ"
|
|
|
|
radius = 50
|
|
height = 200
|
|
|
|
# Build a cylinder
|
|
# ----------------
|
|
|
|
base = geompy.MakeVertex(0, 0, 0)
|
|
direction = geompy.MakeVectorDXDYDZ(0, 0, 1)
|
|
|
|
cylinder = geompy.MakeCylinder(base, direction, radius, height)
|
|
|
|
geompy.addToStudy(cylinder, "Cylinder")
|
|
|
|
# Define a mesh on a geometry
|
|
# ---------------------------
|
|
|
|
m = smesh.Mesh(cylinder)
|
|
|
|
# 2D mesh with BLSURF
|
|
# -------------------
|
|
|
|
algo2d = m.Triangle(smesh.BLSURF)
|
|
|
|
algo2d.SetPhysicalMesh(1)
|
|
algo2d.SetPhySize(5)
|
|
|
|
algo2d.SetGeometricMesh(0)
|
|
|
|
# 3D mesh with tepal
|
|
# ------------------
|
|
|
|
algo3d = m.Tetrahedron(smesh.GHS3DPRL)
|
|
|
|
algo3d.SetMEDName(results)
|
|
algo3d.SetNbPart(4)
|
|
algo3d.SetBackground(False)
|
|
algo3d.SetKeepFiles(False)
|
|
algo3d.SetToMeshHoles(True)
|
|
|
|
# Launch meshers
|
|
# --------------
|
|
|
|
status = m.Compute()
|
|
|
|
# Test if ok
|
|
# ----------
|
|
|
|
if os.access(results+".xml", os.F_OK):
|
|
print "Ok: tepal"
|
|
else:
|
|
print "KO: tepal"
|
|
\endcode
|
|
|
|
</li>
|
|
</ul>
|
|
|
|
|
|
*/
|