]> SALOME platform Git repositories - modules/geom.git/blob - src/GEOM_SWIG/AdvancedGEOMBuilder.py
Salome HOME
Start potring to the VTK OpenGL2 backend.
[modules/geom.git] / src / GEOM_SWIG / AdvancedGEOMBuilder.py
1 #  -*- coding: iso-8859-1 -*-
2 # Copyright (C) 2007-2016  CEA/DEN, EDF R&D, OPEN CASCADE
3 #
4 # This library is free software; you can redistribute it and/or
5 # modify it under the terms of the GNU Lesser General Public
6 # License as published by the Free Software Foundation; either
7 # version 2.1 of the License, or (at your option) any later version.
8 #
9 # This library is distributed in the hope that it will be useful,
10 # but WITHOUT ANY WARRANTY; without even the implied warranty of
11 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12 # Lesser General Public License for more details.
13 #
14 # You should have received a copy of the GNU Lesser General Public
15 # License along with this library; if not, write to the Free Software
16 # Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
17 #
18 # See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
19 #
20 from GEOM import IAdvancedOperations
21
22 # Engine Library Name
23 __libraryName__ = "AdvancedEngine"
24
25 def GetAdvancedOperations(self):
26     anOp = self.GetPluginOperations(self.myStudyId, __libraryName__)
27     return anOp._narrow(IAdvancedOperations)
28
29 ## Create a T-shape object with specified caracteristics for the main
30 #  and the incident pipes (radius, width, half-length).
31 #  The extremities of the main pipe are located on junctions points P1 and P2.
32 #  The extremity of the incident pipe is located on junction point P3.
33 #  If P1, P2 and P3 are not given, the center of the shape is (0,0,0) and
34 #  the main plane of the T-shape is XOY.
35 #
36 #  @param theR1 Internal radius of main pipe
37 #  @param theW1 Width of main pipe
38 #  @param theL1 Half-length of main pipe
39 #  @param theR2 Internal radius of incident pipe (R2 < R1)
40 #  @param theW2 Width of incident pipe (R2+W2 < R1+W1)
41 #  @param theL2 Half-length of incident pipe
42 #
43 #  @param theHexMesh Boolean indicating if shape is prepared for hex mesh (default=True)
44 #  @param theP1 1st junction point of main pipe
45 #  @param theP2 2nd junction point of main pipe
46 #  @param theP3 Junction point of incident pipe
47 #
48 #  @param theRL Internal radius of left thickness reduction
49 #  @param theWL Width of left thickness reduction
50 #  @param theLtransL Length of left transition part
51 #  @param theLthinL Length of left thin part
52 #
53 #  @param theRR Internal radius of right thickness reduction
54 #  @param theWR Width of right thickness reduction
55 #  @param theLtransR Length of right transition part
56 #  @param theLthinR Length of right thin part
57 #
58 #  @param theRI Internal radius of incident thickness reduction
59 #  @param theWI Width of incident thickness reduction
60 #  @param theLtransI Length of incident transition part
61 #  @param theLthinI Length of incident thin part
62 #
63 #  @param theName Object name; when specified, this parameter is used
64 # for result publication in the study. Otherwise, if automatic
65 # publication is switched on, default value is used for result name.
66 #
67 #  @return List of GEOM.GEOM_Object, containing the created shape and propagation groups.
68 #
69 #  @ref tui_creation_pipetshape "Example"
70 #  @ingroup l4_advanced
71 def MakePipeTShape (self, theR1, theW1, theL1, theR2, theW2, theL2,
72     theHexMesh=True, theP1=None, theP2=None, theP3=None,
73     theRL=0, theWL=0, theLtransL=0, theLthinL=0,
74     theRR=0, theWR=0, theLtransR=0, theLthinR=0,
75     theRI=0, theWI=0, theLtransI=0, theLthinI=0,
76     theName=None):
77     """
78     Create a T-shape object with specified caracteristics for the main
79     and the incident pipes (radius, width, half-length).
80     The extremities of the main pipe are located on junctions points P1 and P2.
81     The extremity of the incident pipe is located on junction point P3.
82     If P1, P2 and P3 are not given, the center of the shape is (0,0,0) and
83     the main plane of the T-shape is XOY.
84
85     Parameters:
86         theR1 Internal radius of main pipe
87         theW1 Width of main pipe
88         theL1 Half-length of main pipe
89         theR2 Internal radius of incident pipe (R2 < R1)
90         theW2 Width of incident pipe (R2+W2 < R1+W1)
91         theL2 Half-length of incident pipe
92         theHexMesh Boolean indicating if shape is prepared for hex mesh (default=True)
93         theP1 1st junction point of main pipe
94         theP2 2nd junction point of main pipe
95         theP3 Junction point of incident pipe
96         
97         theRL Internal radius of left thickness reduction
98         theWL Width of left thickness reduction
99         theLtransL Length of left transition part
100         theLthinL Length of left thin part
101         
102         theRR Internal radius of right thickness reduction
103         theWR Width of right thickness reduction
104         theLtransR Length of right transition part
105         theLthinR Length of right thin part
106         
107         theRI Internal radius of incident thickness reduction
108         theWI Width of incident thickness reduction
109         theLtransI Length of incident transition part
110         theLthinI Length of incident thin part
111         
112         theName Object name; when specified, this parameter is used
113         for result publication in the study. Otherwise, if automatic
114         publication is switched on, default value is used for result name.
115     
116     Returns:
117     List of GEOM_Object, containing the created shape and propagation groups.
118     
119     Example of usage:
120     # create PipeTShape object
121     pipetshape = geompy.MakePipeTShape(80.0, 20.0, 200.0, 50.0, 20.0, 200.0)
122     # create PipeTShape object with position
123     pipetshape_position = geompy.MakePipeTShape(80.0, 20.0, 200.0, 50.0, 20.0, 200.0, True, P1, P2, P3)
124     # create PipeTShape object with left thickness reduction
125     pipetshape_thr = geompy.MakePipeTShape(80.0, 20.0, 200.0, 50.0, 20.0, 200.0, theRL=60, theWL=20, theLtransL=40, theLthinL=20)
126     """
127     from salome.geom.geomBuilder import ParseParameters, RaiseIfFailed, _toListOfNames
128     theR1, theW1, theL1, theR2, theW2, theL2, theRL, theWL, theLtransL, theLthinL, theRR, theWR, theLtransR, theLthinR, theRI, theWI, theLtransI, theLthinI, Parameters = ParseParameters(theR1, theW1, theL1, theR2, theW2, theL2, theRL, theWL, theLtransL, theLthinL, theRR, theWR, theLtransR, theLthinR, theRI, theWI, theLtransI, theLthinI)
129     anOp = GetAdvancedOperations(self)
130     if (theP1 and theP2 and theP3):
131         anObj = anOp.MakePipeTShapeTRWithPosition(theR1, theW1, theL1, theR2, theW2, theL2,
132                                                   theRL, theWL, theLtransL, theLthinL,
133                                                   theRR, theWR, theLtransR, theLthinR,
134                                                   theRI, theWI, theLtransI, theLthinI,
135                                                   theHexMesh, theP1, theP2, theP3)
136     else:
137         anObj = anOp.MakePipeTShapeTR(theR1, theW1, theL1, theR2, theW2, theL2,
138                                       theRL, theWL, theLtransL, theLthinL,
139                                       theRR, theWR, theLtransR, theLthinR,
140                                       theRI, theWI, theLtransI, theLthinI,
141                                       theHexMesh)
142         pass
143     RaiseIfFailed("MakePipeTShape", anOp)
144     if Parameters: anObj[0].SetParameters(Parameters)
145     self.def_names = [ "pipeTShape" ] + [ "pipeTShape_grp_%d" % i for i in range(1, len(anObj)) ]
146     self._autoPublish(anObj, _toListOfNames(theName, len(anObj)), self.def_names)
147     anOp.UnRegister()
148     return anObj
149
150 ## Create a T-shape object with chamfer and with specified caracteristics for the main
151 #  and the incident pipes (radius, width, half-length). The chamfer is
152 #  created on the junction of the pipes.
153 #  The extremities of the main pipe are located on junctions points P1 and P2.
154 #  The extremity of the incident pipe is located on junction point P3.
155 #  If P1, P2 and P3 are not given, the center of the shape is (0,0,0) and
156 #  the main plane of the T-shape is XOY.
157 #  @param theR1 Internal radius of main pipe
158 #  @param theW1 Width of main pipe
159 #  @param theL1 Half-length of main pipe
160 #  @param theR2 Internal radius of incident pipe (R2 < R1)
161 #  @param theW2 Width of incident pipe (R2+W2 < R1+W1)
162 #  @param theL2 Half-length of incident pipe
163 #  @param theH Height of the chamfer.
164 #  @param theW Width of the chamfer.
165 #  @param theHexMesh Boolean indicating if shape is prepared for hex mesh (default=True)
166 #  @param theP1 1st junction point of main pipe
167 #  @param theP2 2nd junction point of main pipe
168 #  @param theP3 Junction point of incident pipe
169 #
170 #  @param theRL Internal radius of left thickness reduction
171 #  @param theWL Width of left thickness reduction
172 #  @param theLtransL Length of left transition part
173 #  @param theLthinL Length of left thin part
174 #
175 #  @param theRR Internal radius of right thickness reduction
176 #  @param theWR Width of right thickness reduction
177 #  @param theLtransR Length of right transition part
178 #  @param theLthinR Length of right thin part
179 #
180 #  @param theRI Internal radius of incident thickness reduction
181 #  @param theWI Width of incident thickness reduction
182 #  @param theLtransI Length of incident transition part
183 #  @param theLthinI Length of incident thin part
184 #
185 #  @param theName Object name; when specified, this parameter is used
186 #         for result publication in the study. Otherwise, if automatic
187 #         publication is switched on, default value is used for result name.
188 #
189 #  @return List of GEOM.GEOM_Object, containing the created shape and propagation groups.
190 #
191 #  @ref tui_creation_pipetshape "Example"
192 #  @ingroup l4_advanced
193 def MakePipeTShapeChamfer (self, theR1, theW1, theL1, theR2, theW2, theL2,
194                            theH, theW, theHexMesh=True, theP1=None, theP2=None, theP3=None,
195                            theRL=0, theWL=0, theLtransL=0, theLthinL=0,
196                            theRR=0, theWR=0, theLtransR=0, theLthinR=0,
197                            theRI=0, theWI=0, theLtransI=0, theLthinI=0,
198                            theName=None):
199     """
200     Create a T-shape object with chamfer and with specified caracteristics for the main
201     and the incident pipes (radius, width, half-length). The chamfer is
202     created on the junction of the pipes.
203     The extremities of the main pipe are located on junctions points P1 and P2.
204     The extremity of the incident pipe is located on junction point P3.
205     If P1, P2 and P3 are not given, the center of the shape is (0,0,0) and
206     the main plane of the T-shape is XOY.
207     
208     Parameters:
209         theR1 Internal radius of main pipe
210         theW1 Width of main pipe
211         theL1 Half-length of main pipe
212         theR2 Internal radius of incident pipe (R2 < R1)
213         theW2 Width of incident pipe (R2+W2 < R1+W1)
214         theL2 Half-length of incident pipe
215         theH Height of the chamfer.
216         theW Width of the chamfer.
217         theHexMesh Boolean indicating if shape is prepared for hex mesh (default=True)
218         theP1 1st junction point of main pipe
219         theP2 2nd junction point of main pipe
220         theP3 Junction point of incident pipe
221         
222         theRL Internal radius of left thickness reduction
223         theWL Width of left thickness reduction
224         theLtransL Length of left transition part
225         theLthinL Length of left thin part
226         
227         theRR Internal radius of right thickness reduction
228         theWR Width of right thickness reduction
229         theLtransR Length of right transition part
230         theLthinR Length of right thin part
231         
232         theRI Internal radius of incident thickness reduction
233         theWI Width of incident thickness reduction
234         theLtransI Length of incident transition part
235         theLthinI Length of incident thin part
236         
237         theName Object name; when specified, this parameter is used
238         for result publication in the study. Otherwise, if automatic
239         publication is switched on, default value is used for result name.
240         
241         Returns:
242             List of GEOM_Object, containing the created shape and propagation groups.
243
244         Example of usage:
245             # create PipeTShape with chamfer object
246             pipetshapechamfer = geompy.MakePipeTShapeChamfer(80.0, 20.0, 200.0, 50.0, 20.0, 200.0, 20.0, 20.0)
247             # create PipeTShape with chamfer object with position
248             pipetshapechamfer_position = geompy.MakePipeTShapeChamfer(80.0, 20.0, 200.0, 50.0, 20.0, 200.0, 20.0, 20.0, True, P1, P2, P3)
249             # create PipeTShape with chamfer object with left thickness reduction
250             pipetshapechamfer_thr = geompy.MakePipeTShapeChamfer(80.0, 20.0, 200.0, 50.0, 20.0, 200.0, 20.0, 20.0, theRL=60, theWL=20, theLtransL=40, theLthinL=20)
251     """
252     from salome.geom.geomBuilder import ParseParameters, RaiseIfFailed, _toListOfNames
253     theR1, theW1, theL1, theR2, theW2, theL2, theH, theW, theRL, theWL, theLtransL, theLthinL, theRR, theWR, theLtransR, theLthinR, theRI, theWI, theLtransI, theLthinI, Parameters = ParseParameters(theR1, theW1, theL1, theR2, theW2, theL2, theH, theW, theRL, theWL, theLtransL, theLthinL, theRR, theWR, theLtransR, theLthinR, theRI, theWI, theLtransI, theLthinI)
254     anOp = GetAdvancedOperations(self)
255     if (theP1 and theP2 and theP3):
256         anObj = anOp.MakePipeTShapeTRChamferWithPosition(theR1, theW1, theL1, theR2, theW2, theL2,
257                                                          theRL, theWL, theLtransL, theLthinL,
258                                                          theRR, theWR, theLtransR, theLthinR,
259                                                          theRI, theWI, theLtransI, theLthinI,
260                                                          theH, theW, theHexMesh, theP1, theP2, theP3)
261     else:
262         anObj = anOp.MakePipeTShapeTRChamfer(theR1, theW1, theL1, theR2, theW2, theL2,
263                                              theRL, theWL, theLtransL, theLthinL,
264                                              theRR, theWR, theLtransR, theLthinR,
265                                              theRI, theWI, theLtransI, theLthinI,
266                                              theH, theW, theHexMesh)
267     pass
268
269     RaiseIfFailed("MakePipeTShapeChamfer", anOp)
270     if Parameters: anObj[0].SetParameters(Parameters)
271     self.def_names = [ "pipeTShape" ] + [ "pipeTShape_grp_%d" % i for i in range(1, len(anObj)) ]
272     self._autoPublish(anObj, _toListOfNames(theName, len(anObj)), self.def_names)
273     anOp.UnRegister()
274     return anObj
275
276 ## Create a T-shape object with fillet and with specified caracteristics for the main
277 #  and the incident pipes (radius, width, half-length). The fillet is
278 #  created on the junction of the pipes.
279 #  The extremities of the main pipe are located on junctions points P1 and P2.
280 #  The extremity of the incident pipe is located on junction point P3.
281 #  If P1, P2 and P3 are not given, the center of the shape is (0,0,0) and
282 #  the main plane of the T-shape is XOY.
283 #  @param theR1 Internal radius of main pipe
284 #  @param theW1 Width of main pipe
285 #  @param theL1 Half-length of main pipe
286 #  @param theR2 Internal radius of incident pipe (R2 < R1)
287 #  @param theW2 Width of incident pipe (R2+W2 < R1+W1)
288 #  @param theL2 Half-length of incident pipe
289 #  @param theRF Radius of curvature of fillet.
290 #  @param theHexMesh Boolean indicating if shape is prepared for hex mesh (default=True)
291 #  @param theP1 1st junction point of main pipe
292 #  @param theP2 2nd junction point of main pipe
293 #  @param theP3 Junction point of incident pipe
294 #
295 #  @param theRL Internal radius of left thickness reduction
296 #  @param theWL Width of left thickness reduction
297 #  @param theLtransL Length of left transition part
298 #  @param theLthinL Length of left thin part
299 #
300 #  @param theRR Internal radius of right thickness reduction
301 #  @param theWR Width of right thickness reduction
302 #  @param theLtransR Length of right transition part
303 #  @param theLthinR Length of right thin part
304 #
305 #  @param theRI Internal radius of incident thickness reduction
306 #  @param theWI Width of incident thickness reduction
307 #  @param theLtransI Length of incident transition part
308 #  @param theLthinI Length of incident thin part
309 #
310 #  @param theName Object name; when specified, this parameter is used
311 #         for result publication in the study. Otherwise, if automatic
312 #         publication is switched on, default value is used for result name.
313 #
314 #  @return List of GEOM.GEOM_Object, containing the created shape and propagation groups.
315 #
316 #  @ref tui_creation_pipetshape "Example"
317 #  @ingroup l4_advanced
318 def MakePipeTShapeFillet (self, theR1, theW1, theL1, theR2, theW2, theL2,
319                           theRF, theHexMesh=True, theP1=None, theP2=None, theP3=None,
320                           theRL=0, theWL=0, theLtransL=0, theLthinL=0,
321                           theRR=0, theWR=0, theLtransR=0, theLthinR=0,
322                           theRI=0, theWI=0, theLtransI=0, theLthinI=0,
323                           theName=None):
324     """
325     Create a T-shape object with fillet and with specified caracteristics for the main
326     and the incident pipes (radius, width, half-length). The fillet is
327     created on the junction of the pipes.
328     The extremities of the main pipe are located on junctions points P1 and P2.
329     The extremity of the incident pipe is located on junction point P3.
330     
331     Parameters:
332         If P1, P2 and P3 are not given, the center of the shape is (0,0,0) and
333         the main plane of the T-shape is XOY.
334         theR1 Internal radius of main pipe
335         theW1 Width of main pipe
336         heL1 Half-length of main pipe
337         theR2 Internal radius of incident pipe (R2 < R1)
338         theW2 Width of incident pipe (R2+W2 < R1+W1)
339         theL2 Half-length of incident pipe
340         theRF Radius of curvature of fillet.
341         theHexMesh Boolean indicating if shape is prepared for hex mesh (default=True)
342         theP1 1st junction point of main pipe
343         theP2 2nd junction point of main pipe
344         theP3 Junction point of incident pipe
345         
346         theRL Internal radius of left thickness reduction
347         theWL Width of left thickness reduction
348         theLtransL Length of left transition part
349         theLthinL Length of left thin part
350         
351         theRR Internal radius of right thickness reduction
352         theWR Width of right thickness reduction
353         theLtransR Length of right transition part
354         theLthinR Length of right thin part
355         
356         theRI Internal radius of incident thickness reduction
357         theWI Width of incident thickness reduction
358         theLtransI Length of incident transition part
359         theLthinI Length of incident thin part
360         
361         theName Object name; when specified, this parameter is used
362         for result publication in the study. Otherwise, if automatic
363         publication is switched on, default value is used for result name.
364                 
365         Returns:
366             List of GEOM_Object, containing the created shape and propagation groups.
367                 
368         Example of usage:
369             # create PipeTShape with fillet object
370             pipetshapefillet = geompy.MakePipeTShapeFillet(80.0, 20.0, 200.0, 50.0, 20.0, 200.0, 5.0)
371             # create PipeTShape with fillet object with position
372             pipetshapefillet_position = geompy.MakePipeTShapeFillet(80.0, 20.0, 200.0, 50.0, 20.0, 200.0, 5.0, True, P1, P2, P3)
373             # create PipeTShape with fillet object with left thickness reduction
374             pipetshapefillet_thr = geompy.MakePipeTShapeFillet(80.0, 20.0, 200.0, 50.0, 20.0, 200.0, 5.0, theRL=60, theWL=20, theLtransL=40, theLthinL=20)
375     """
376     from salome.geom.geomBuilder import ParseParameters, RaiseIfFailed, _toListOfNames
377     theR1, theW1, theL1, theR2, theW2, theL2, theRF, theRL, theWL, theLtransL, theLthinL, theRR, theWR, theLtransR, theLthinR, theRI, theWI, theLtransI, theLthinI, Parameters = ParseParameters(theR1, theW1, theL1, theR2, theW2, theL2, theRF, theRL, theWL, theLtransL, theLthinL, theRR, theWR, theLtransR, theLthinR, theRI, theWI, theLtransI, theLthinI)
378     anOp = GetAdvancedOperations(self)    
379     if (theP1 and theP2 and theP3):
380         anObj = anOp.MakePipeTShapeTRFilletWithPosition(theR1, theW1, theL1, theR2, theW2, theL2,
381                                                         theRL, theWL, theLtransL, theLthinL,
382                                                         theRR, theWR, theLtransR, theLthinR,
383                                                         theRI, theWI, theLtransI, theLthinI,
384                                                         theRF, theHexMesh, theP1, theP2, theP3)
385     else:
386         anObj = anOp.MakePipeTShapeTRFillet(theR1, theW1, theL1, theR2, theW2, theL2,
387                                                   theRL, theWL, theLtransL, theLthinL,
388                                                   theRR, theWR, theLtransR, theLthinR,
389                                                   theRI, theWI, theLtransI, theLthinI,
390                                                   theRF, theHexMesh)
391         pass
392     RaiseIfFailed("MakePipeTShapeFillet", anOp)
393     if Parameters: anObj[0].SetParameters(Parameters)
394     self.def_names = [ "pipeTShape" ] + [ "pipeTShape_grp_%d" % i for i in range(1, len(anObj)) ]
395     self._autoPublish(anObj, _toListOfNames(theName, len(anObj)), self.def_names)
396     anOp.UnRegister()
397     return anObj
398
399 ## This function allows creating a disk already divided into blocks. It
400 #  can be used to create divided pipes for later meshing in hexaedra.
401 #  @param theR Radius of the disk
402 #  @param theOrientation Orientation of the plane on which the disk will be built
403 #         1 = XOY, 2 = OYZ, 3 = OZX
404 #  @param thePattern Division pattern. It can be GEOM.SQUARE or GEOM.HEXAGON
405 #  @param theName Object name; when specified, this parameter is used
406 #         for result publication in the study. Otherwise, if automatic
407 #         publication is switched on, default value is used for result name.
408 #
409 #  @return New GEOM_Object, containing the created shape.
410 #
411 #  @ref tui_creation_divideddisk "Example"
412 #  @ingroup l4_advanced
413 def MakeDividedDisk(self, theR, theOrientation, thePattern, theName=None):
414     """
415     Creates a disk, divided into blocks. It can be used to create divided pipes
416     for later meshing in hexaedra.
417     
418     Parameters:
419         theR Radius of the disk
420         theOrientation Orientation of the plane on which the disk will be built:
421         1 = XOY, 2 = OYZ, 3 = OZX
422         thePattern Division pattern. It can be GEOM.SQUARE or GEOM.HEXAGON
423         theName Object name; when specified, this parameter is used
424         for result publication in the study. Otherwise, if automatic
425         publication is switched on, default value is used for result name.
426         
427         Returns:
428             New GEOM_Object, containing the created shape.
429     """
430     from salome.geom.geomBuilder import ParseParameters, RaiseIfFailed, _toListOfNames
431     theR, Parameters = ParseParameters(theR)
432     anOp = GetAdvancedOperations(self)
433     anObj = anOp.MakeDividedDisk(theR, 67.0, theOrientation, thePattern)
434     RaiseIfFailed("MakeDividedDisk", anOp)
435     if Parameters: anObj.SetParameters(Parameters)
436     self._autoPublish(anObj, theName, "dividedDisk")
437     anOp.UnRegister()
438     return anObj
439             
440 ## This function allows creating a disk already divided into blocks. It
441 #  can be used to create divided pipes for later meshing in hexaedra.
442 #  @param theCenter Center of the disk
443 #  @param theVector Normal vector to the plane of the created disk
444 #  @param theRadius Radius of the disk
445 #  @param thePattern Division pattern. It can be GEOM.SQUARE or GEOM.HEXAGON
446 #  @param theName Object name; when specified, this parameter is used
447 #         for result publication in the study. Otherwise, if automatic
448 #         publication is switched on, default value is used for result name.
449 #
450 #  @return New GEOM_Object, containing the created shape.
451 #
452 #  @ref tui_creation_divideddisk "Example"
453 #  @ingroup l4_advanced
454 def MakeDividedDiskPntVecR(self, theCenter, theVector, theRadius, thePattern, theName=None):
455     """
456     Creates a disk already divided into blocks. It can be used to create divided pipes
457     for later meshing in hexaedra.
458     
459     Parameters:
460         theCenter Center of the disk
461         theVector Normal vector to the plane of the created disk
462         theRadius Radius of the disk
463         thePattern Division pattern. It can be GEOM.SQUARE or GEOM.HEXAGON
464         theName Object name; when specified, this parameter is used
465         for result publication in the study. Otherwise, if automatic
466         publication is switched on, default value is used for result name.
467
468     Returns:
469         New GEOM_Object, containing the created shape.
470     """
471     from salome.geom.geomBuilder import ParseParameters, RaiseIfFailed, _toListOfNames
472     theRadius, Parameters = ParseParameters(theRadius)
473     anOp = GetAdvancedOperations(self)
474     anObj = anOp.MakeDividedDiskPntVecR(theCenter, theVector, theRadius, 67.0, thePattern)
475     RaiseIfFailed("MakeDividedDiskPntVecR", anOp)
476     if Parameters: anObj.SetParameters(Parameters)
477     self._autoPublish(anObj, theName, "dividedDisk")
478     anOp.UnRegister()
479     return anObj
480
481 ## Builds a cylinder prepared for hexa meshes
482 #  @param theR Radius of the cylinder
483 #  @param theH Height of the cylinder
484 #  @param thePattern Division pattern. It can be GEOM.SQUARE or GEOM.HEXAGON
485 #  @param theName Object name; when specified, this parameter is used
486 #         for result publication in the study. Otherwise, if automatic
487 #         publication is switched on, default value is used for result name.
488 #
489 #  @return New GEOM_Object, containing the created shape.
490 #
491 #  @ref tui_creation_dividedcylinder "Example"
492 #  @ingroup l4_advanced
493 def MakeDividedCylinder(self, theR, theH, thePattern, theName=None):
494     """
495     Builds a cylinder prepared for hexa meshes
496     
497     Parameters:
498         theR Radius of the cylinder
499         theH Height of the cylinder
500         thePattern Division pattern. It can be GEOM.SQUARE or GEOM.HEXAGON
501         theName Object name; when specified, this parameter is used
502         for result publication in the study. Otherwise, if automatic
503         publication is switched on, default value is used for result name.
504         
505         Returns:
506         New GEOM_Object, containing the created shape.
507     """
508     from salome.geom.geomBuilder import ParseParameters, RaiseIfFailed, _toListOfNames
509     theR, theH, Parameters = ParseParameters(theR, theH)
510     anOp = GetAdvancedOperations(self)
511     anObj = anOp.MakeDividedCylinder(theR, theH, thePattern)
512     RaiseIfFailed("MakeDividedCylinder", anOp)
513     if Parameters: anObj.SetParameters(Parameters)
514     self._autoPublish(anObj, theName, "dividedCylinder")
515     anOp.UnRegister()
516     return anObj
517
518 ## Create a surface from a cloud of points
519 #  @param thelPoints list of points. Compounds of points are
520 #         accepted as well.
521 #  @param theNbMax maximum number of Bezier pieces in the resulting
522 #         surface.
523 #  @param theDegMax maximum degree of the resulting BSpline surface.
524 #  @param theDMax 3D tolerance of initial approximation.
525 #  @param theName Object name; when specified, this parameter is used
526 #         for result publication in the study. Otherwise, if automatic
527 #         publication is switched on, default value is used for result name.
528 #  @return New GEOM_Object, containing the created shape.
529 #  @note 3D tolerance of initial approximation represents a tolerance of
530 #        initial plate surface approximation. If this parameter is equal
531 #        to 0 (default value) it is computed. In this case an error of
532 #        initial plate surface computation is used as the approximation
533 #        tolerance. This error represents a maximal distance between
534 #        computed plate surface and given points.
535 #
536 #  @ref tui_creation_smoothingsurface "Example"
537 #  @ingroup l4_advanced
538 def MakeSmoothingSurface(self, thelPoints, theNbMax=2, theDegMax=8,
539                          theDMax=0.0, theName=None):
540     """
541     Create a surface from a cloud of points
542     
543     Parameters:
544         thelPoints list of points. Compounds of points are
545                    accepted as well.
546         theNbMax maximum number of Bezier pieces in the resulting
547                  surface.
548         theDegMax maximum degree of the resulting BSpline surface.
549         theDMax 3D tolerance of initial approximation.
550         theName Object name; when specified, this parameter is used
551                 for result publication in the study. Otherwise, if automatic
552                 publication is switched on, default value is used for result name.
553
554     Returns:
555         New GEOM_Object, containing the created shape.
556
557     Note:
558         3D tolerance of initial approximation represents a tolerance of
559         initial plate surface approximation. If this parameter is equal
560         to 0 (default value) it is computed. In this case an error of
561         initial plate surface computation is used as the approximation
562         tolerance. This error represents a maximal distance between
563         computed plate surface and given points.
564     """
565     from salome.geom.geomBuilder import RaiseIfFailed
566     anOp = GetAdvancedOperations(self)
567     anObj = anOp.MakeSmoothingSurface(thelPoints, theNbMax,
568                                       theDegMax, theDMax)
569     RaiseIfFailed("MakeSmoothingSurface", anOp)
570     self._autoPublish(anObj, theName, "smoothing")
571     anOp.UnRegister()
572     return anObj