3 \page ghs3dprl_hypo_page GHS3DPRL Parameters hypothesis
5 \n GHS3DPRL Parameters hypothesis works only with <b>Tetrahedron (Tepal with TetMesh-GHS3D)</b> algorithm.
7 \n This algorithm is a commercial software, its use requires a licence (http://www.distene.com/fr/build/offer.html).
8 \n The advantage of Tepal is the possibility to generate (for example) a <em>partitioned</em>
9 200 million tetrahedra mesh on a not-so-big memory computer (2Go RAM)
10 ...in something like 50 hours of <em>one</em> CPU (Xeon, 2008).
11 This is an alternative to Pluging GHS3D where you should need something like a not-so-common CPU with 64Go RAM
12 <em>to try</em> to do a one-partitionned 200 million tetrahedra mesh ...in a much less time indeed.
15 \n This Plugin <em>doesn't</em> load in Memory the supposed plentiful big resulting meshes.
16 It's user choice: (in GUI Mesh mode) menu File-Import-MED Files.
17 \n Beware, to load one 5 millions tetrahedra MED file, GUI Salome needs 2Go RAM.
18 \n A new true parallel faster version of Tepal, using MPI, is expected in 2009.
20 \image html ghs3dprl_parameters_basic.png
24 <b>Name</b> - allows to define the name of the hypothesis (GHS3DPRL Parameters by default).
27 <b>MED_Name</b> - allows to define the path and the basename of the
28 generated resulted MED files ("DOMAIN" by default).
29 Undefined path means environment variable $SALOME_TMP_DIR (or $TMP by default).
32 <b>Nb_Part</b> - allows to define the number of MED files generated,
33 the initial skin (triangles) will be meshed (tetrahedra) and partitioned
34 in Nb_Part by the <i>elementary</i> algorithm implemented in Tepal.<br>
35 Beware, the (expected) number of total tetrahedra versus this parameter
36 involves the maximum tepal RAM use.
39 <b>Keep_Files</b> - if this box is checked, input files of Tepal
40 (GHS3DPRL.points and GHS3DPRL.faces) are deleted after use (...if no backgrounding).
43 <b>Tepal_in_Background</b> - if this box is checked, for big meshes,
44 launch Tepal execution and MED file generation in background,
45 allows user exiting of Salome. In this case, beware of the
46 job Tepal is "killSalome.py" <i>independent</i>, sometimes on other host.
49 <b>To_Mesh_Holes</b> - if this box is checked, force parameter component
50 of tetmesh-ghs3d to mesh holes.
53 <h1>Modifying GHS3DPRL Advanced Parameters</h1><br>
54 GHS3DPRL Plugin launches standalone binary executable tepal2med which launches binary executable tepal.<br>
55 tepal2med launches tepal, wait for the end of computation, and converts resulting output tepal files in expected MED files.<br>
56 Some advanced optional parameters are accessibles as arguments.<br>
57 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>
59 <b>Advanced tepal2med Parameters</b> - type "tepal2med --help" in a Terminal. <p>
62 myname@myhost > /export/home/myname/salome_5/GHS3DPRLPLUGIN_5/bin/salome/tepal2med --help
64 --help : produces this help message
65 --casename : path and name of input tepal2med files which are
66 - output files of tepal .msg .noboite .faces .points .glo
67 - output file of GHS3DPRL_Plugin casename_skin.med (optional)
68 with initial skin and its initial groups
69 --number : number of partitions
70 --medname : path and name of output MED files
71 --limitswap : max size of working cpu memory (Mo) (before swapping on .temp files)
72 --verbose : trace of execution (0->6)
73 --test : more tests about joints, before generation of output files
74 --menu : a GUI menu for option number
75 --launchtepal : also launch tepal on files casename.faces and casename.points and option number
76 --meshholes : force parameter component of tetmesh-ghs3d to mesh holes
77 --background : force background mode from launch tepal and generation of final MED files (big meshes)
78 --deletegroups : regular expression (see QRegExp) which matches unwanted groups in final MED files
79 (try --deletegroups="(\bAll_Nodes|\bAll_Faces)"
80 (try --deletegroups="((\bAll_|\bNew_)(N|F|T))"
82 tepal2med --casename=/tmp/GHS3DPRL --number=2 --medname=DOMAIN --limitswap=1000
83 --verbose=0 --test=yes --menu=no --launchtepal=no
90 <b>Advanced tepal Parameters</b> - type "tepal" in a Terminal. <p>
94 =====================================
95 GHS3D-TEPAL 1.4.2 (Dec, 2006) 10-Dec-2008 AT 12:59:48
96 =====================================
101 91680 Bruyeres le Chatel
103 Phone: +33(0)1-69-26-62-10 Fax: +33(0)1-69-26-90-33
104 EMail: support@distene.com
106 COPYRIGHT (C)2006 DISTENE ALL RIGHTS RESERVED
109 USAGE : tepal options
112 --filename name (-f name) :
113 Basename of the input case (MANDATORY)
116 Number of subdomains to make (MANDATORY)
118 --ghs3d ghs3d options (-g ghs3d options) :
119 Run temesh ghs3d on a previously generated subdomain. (ghs3d options must be "quoted")
122 Max amount of memory (megabytes) allowed for ghs in the cutting process. (default is 0 : unlimited)
125 Only (re)mesh all subdomains and update communications messages
127 --mesh_call command (-c command) :
128 Call the user specified command for meshing all the subomains after their skin was generated
131 Only compute and show some statistics on subdomains
134 Merge final subdomains skins
136 --rebuild_tetra (-R ) :
137 Merge final subdomains skins and tetraedra
139 --rebuild_iface (-i ) :
140 Include interfaces in final subdomains merge
142 --rebuild_retag (-t ) :
143 Tag vertices, faces (and tetra if selected) with their subdomain number in final subdomains merge (keeps the lowest tag for shared elements)
145 --rebuild_ensight_parts (-e ) :
146 Build ensight geom file with parts
148 --tetmesh_args str (-G str) :
149 Arguments to pass to Tetmesh during cutting process
151 ==============================================================================
152 GHS3D-TEPAL SOFTWARE 1.4.2 (Dec, 2006)
154 COPYRIGHT (C)2006 DISTENE ALL RIGHTS RESERVED
155 ==============================================================================
157 Phone: +33(0)1-69-26-62-10 Fax: +33(0)1-69-26-90-33
158 EMail: support@distene.com )
165 <b>Advanced ghs3d Parameters (through tepal's --tetmesh_args)</b> - type "ghs3d -h" in a Terminal. <p>
168 myname@myhost > ghs3d -h
171 /export/home/myname/ghs3d-4.0/DISTENE/Tools/TetMesh-GHS3D4.0/bin/Linux/ghs3dV4.0
172 [-u] [-m memory>] [-M MEMORY] [-f prefix] [-v verbose]
173 [-c component] [-p0] [-C] [-E count] [-t] [-o level]
174 [-I filetype] [-a/-b] [-O n m]
178 -u (-h) : prints this message.
180 -m memory : launches the software with memory Megabytes of work space.
181 The default value of this parameter is 64 Megabytes and its
182 minimum value is 10 Megabytes.
183 It is also possible to set this parameter with the
184 environment variable GHS3D_MEMORY by means of an operation
186 setenv GHS3D_MEMORY memory,
187 the value specified in the command line has the priority on
188 the environment variable.
190 -M MEMORY : uses the automatic memory adjustment feature.
191 If MEMORY is zero, the size of the work space is initially
192 guessed from the input. If MEMORY is not zero, the
193 software starts with MEMORY Megabytes of work space.
194 The software then reallocates more and more memory as
196 The starting value when MEMORY equals 0 is 64 Megabytes,
197 the maximum is given with memory of the -m option if used
198 and the actual memory available.
200 -f prefix : defines the generic prefix of the files.
202 -v verbose : sets the output level parameter (the verbose parameter
203 must be in the range 0 to 10).
205 -c component : chooses the meshed component. If component is
206 0, all components to be meshed
207 1, only the main (outermost) component to be meshed
209 -p0 : disables creation of internal points.
211 -C : uses alternate boundary recovery version. To be used only
212 when the boundary recovery of the standard version fails.
214 -E count : sets the extended output for error messages. If -E is used,
215 the error messages found will be printed, up to a maximum
216 count of errors between 1 and 100.
218 -t : generates an error file prefix.Log
220 -o level : sets the desired optimisation level.
221 Valid optimisation levels are:
222 none, light, medium or standard, strong,
223 in increasing order of "quality vs speed" ratio.
225 -I filetype : defines the input mesh format as follows:
226 -IP input files are ascii files, named prefix.points
227 and prefix.faces - this is the default
228 -IPb input files are binary files, named prefix.pointsb
230 -IM input file is ascii file, named prefix.mesh
231 where prefix is given with the -f option
233 -a/-b : selects the output file type:
234 -a for ascii (the default) and
237 -On : saves a NOPO file in addition. NOPO is the mesh data
238 structure of the Simail and Modulef software packages.
239 -Om : saves a mesh file in addition.
240 -Omn : saves both NOPO and mesh files.
242 ==============================================================================
243 TETMESH-GHS3D SOFTWARE 4.0-3 (December, 2006)
245 COPYRIGHT (C)1989-2006 INRIA ALL RIGHTS RESERVED
246 ==============================================================================
248 Phone: +33(0)1-69-26-62-10 Fax: +33(0)1-69-26-90-33
249 EMail: support@distene.com )
254 <h1>Saving user's preferred GHS3DPRL Advanced Parameters</h1><br>
255 GHS3DPRL Plugin launches standalone binary executable tepal2med.<br>
256 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>
258 <b>Advanced tepal2med Parameters</b> - overriding parameter deletegroups<p>
262 #script tepal2med overriding parameter deletegroups
263 #we have renamed binary executable tepal2med as tepal2med.exe
264 #echo tepal2med initial parameters are $1 $2 $3 $4 ... or $*
267 tepal2med.exe $* --deletegroups="(\bAll_Nodes|\bAll_Faces)"
274 <b>Advanced tepal Parameters</b> - overriding parameter component of ghs3d (to mesh holes). <p>
278 #script tepal overriding parameter component of tetmesh-ghs3d
279 #we have renamed binary executable tepal as tepal.exe
281 #optionnaly we could set licence only for us
282 DISTENE_LICENSE_FILE="Use global envvar: DLIM8VAR"
283 DLIM8VAR="dlim8 1:1:29030@is142356/0016175ef08c::a1ba1...etc...e19"
284 SIMULOGD_LICENSE_FILE=29029@is142356
286 tepal.exe $* --tetmesh_args "-c 0"
293 <b>Advanced tepal Parameters</b> - overriding launching tepal on other host. <p>
297 #script tepal overriding launching tepal on other host (tepal run 64 bits only)
298 #we have renamed binary executable tepal as tepal.exe
299 #common file system (same path) otherwise scp... on input or result files
300 #ssh -keygen -t rsa done and files id_rsa et id-rsa.pub move in ~/.ssh
302 #example of typical command
303 #tepal -f /home/myname/tmp/GHS3DPRL -n 4 > /home/myname/tmp/tepal.log
304 #echo parameters $1 $2 $3 $4 ... or $*
306 #tepal licence ought to be known on otherhost
307 ssh otherhost "tepal.exe $* > /home/myname/tmp/tepal.log"
310 #ssh otherhost "tepal.exe $* --tetmesh_args \"-c 0\"" > /home/myname/tmp/tepal.log
316 <h1>TUI use.</h1><br>
320 <b>example ex30_tepal.py.</b><p>
341 base = geompy.MakeVertex(0, 0, 0)
342 direction = geompy.MakeVectorDXDYDZ(0, 0, 1)
344 cylinder = geompy.MakeCylinder(base, direction, radius, height)
346 geompy.addToStudy(cylinder, "Cylinder")
348 # Define a mesh on a geometry
349 # ---------------------------
351 m = smesh.Mesh(cylinder)
353 # 2D mesh with BLSURF
354 # -------------------
356 algo2d = m.Triangle(smesh.BLSURF)
358 algo2d.SetPhysicalMesh(1)
361 algo2d.SetGeometricMesh(0)
366 algo3d = m.Tetrahedron(smesh.GHS3DPRL)
368 algo3d.SetMEDName(results)
370 algo3d.SetBackground(False)
371 algo3d.SetKeepFiles(False)
372 algo3d.SetToMeshHoles(True)
382 if os.access(results+".xml", os.F_OK):