1 // Copyright (C) 2007-2016 CEA/DEN, EDF R&D, OPEN CASCADE
3 // Copyright (C) 2003-2007 OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
4 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
6 // This library is free software; you can redistribute it and/or
7 // modify it under the terms of the GNU Lesser General Public
8 // License as published by the Free Software Foundation; either
9 // version 2.1 of the License, or (at your option) any later version.
11 // This library is distributed in the hope that it will be useful,
12 // but WITHOUT ANY WARRANTY; without even the implied warranty of
13 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
14 // Lesser General Public License for more details.
16 // You should have received a copy of the GNU Lesser General Public
17 // License along with this library; if not, write to the Free Software
18 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
20 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
23 // SMESH SMESH_I : idl implementation based on 'SMESH' unit's classes
24 // File : SMESH_MeshEditor_i.hxx
25 // Author : Nicolas REJNERI
28 #ifndef _SMESH_MESHEDITOR_I_HXX_
29 #define _SMESH_MESHEDIOTR_I_HXX_
33 #include <SALOMEconfig.h>
34 #include CORBA_SERVER_HEADER(SMESH_MeshEditor)
36 #include "SMESH_Mesh.hxx"
37 #include "SMESH_PythonDump.hxx"
38 #include "SMESH_MeshEditor.hxx"
44 namespace MeshEditor_I {
46 struct ExtrusionParams;
49 class SMESH_I_EXPORT SMESH_MeshEditor_i: public POA_SMESH::SMESH_MeshEditor
52 SMESH_MeshEditor_i(SMESH_Mesh_i * theMesh, bool isPreview);
54 virtual ~ SMESH_MeshEditor_i();
56 * \brief Return edited mesh ID
57 * \retval int - mesh ID
59 int GetMeshId() const { return myMesh->GetId(); }
61 SMESH::SMESH_Mesh_ptr GetMesh();
66 * Return data of mesh edition preview
68 SMESH::MeshPreviewStruct* GetPreviewData() throw (SALOME::SALOME_Exception);
70 * If during last operation of MeshEditor some nodes were
71 * created this method returns list of their IDs, if new nodes
72 * not created - returns an empty list
74 SMESH::long_array* GetLastCreatedNodes() throw (SALOME::SALOME_Exception);
76 * If during last operation of MeshEditor some elements were
77 * created this method returns list of their IDs, if new elements
78 * not created - returns an empty list
80 SMESH::long_array* GetLastCreatedElems() throw (SALOME::SALOME_Exception);
82 * \brief Clears sequences of last created elements and nodes
84 void ClearLastCreated() throw (SALOME::SALOME_Exception);
86 * \brief Returns description of an error/warning occurred during the last operation
88 SMESH::ComputeError* GetLastError() throw (SALOME::SALOME_Exception);
91 * \brief Wrap a sequence of ids in a SMESH_IDSource
93 SMESH::SMESH_IDSource_ptr MakeIDSource(const SMESH::long_array& IDsOfElements,
94 SMESH::ElementType type);
95 static bool IsTemporaryIDSource( SMESH::SMESH_IDSource_ptr& idSource );
96 static CORBA::Long* GetTemporaryIDs( SMESH::SMESH_IDSource_ptr& idSource, int& nbIds );
98 CORBA::Boolean RemoveElements(const SMESH::long_array & IDsOfElements)
99 throw (SALOME::SALOME_Exception);
100 CORBA::Boolean RemoveNodes (const SMESH::long_array & IDsOfNodes)
101 throw (SALOME::SALOME_Exception);
102 CORBA::Long RemoveOrphanNodes()
103 throw (SALOME::SALOME_Exception);
106 * Methods for creation new elements.
107 * Returns ID of created element or 0 if element not created
109 CORBA::Long AddNode(CORBA::Double x, CORBA::Double y, CORBA::Double z)
110 throw (SALOME::SALOME_Exception);
111 CORBA::Long Add0DElement(CORBA::Long IDOfNode, CORBA::Boolean DuplicateElements)
112 throw (SALOME::SALOME_Exception);
113 CORBA::Long AddBall(CORBA::Long IDOfNodem, CORBA::Double diameter)
114 throw (SALOME::SALOME_Exception);
115 CORBA::Long AddEdge(const SMESH::long_array & IDsOfNodes)
116 throw (SALOME::SALOME_Exception);
117 CORBA::Long AddFace(const SMESH::long_array & IDsOfNodes)
118 throw (SALOME::SALOME_Exception);
119 CORBA::Long AddPolygonalFace(const SMESH::long_array & IDsOfNodes)
120 throw (SALOME::SALOME_Exception);
121 CORBA::Long AddQuadPolygonalFace(const SMESH::long_array & IDsOfNodes)
122 throw (SALOME::SALOME_Exception);
123 CORBA::Long AddVolume(const SMESH::long_array & IDsOfNodes)
124 throw (SALOME::SALOME_Exception);
125 CORBA::Long AddPolyhedralVolume(const SMESH::long_array & IDsOfNodes,
126 const SMESH::long_array & Quantities)
127 throw (SALOME::SALOME_Exception);
128 CORBA::Long AddPolyhedralVolumeByFaces(const SMESH::long_array & IdsOfFaces)
129 throw (SALOME::SALOME_Exception);
132 * \brief Create 0D elements on all nodes of the given object except those
133 * nodes on which a 0D element already exists.
134 * \param theObject object on whose nodes 0D elements will be created.
135 * \param theGroupName optional name of a group to add 0D elements created
136 * and/or found on nodes of \a theObject.
137 * \param theDuplicateElements to add one more 0D element to a node or not
138 * \return an object (a new group or a temporary SMESH_IDSource) holding
139 * ids of new and/or found 0D elements.
141 SMESH::SMESH_IDSource_ptr Create0DElementsOnAllNodes(SMESH::SMESH_IDSource_ptr theObject,
142 const char* theGroupName,
143 CORBA::Boolean theDuplicateElements)
144 throw (SALOME::SALOME_Exception);
147 * \brief Bind a node to a vertex
148 * \param NodeID - node ID
149 * \param VertexID - vertex ID available through GEOM_Object.GetSubShapeIndices()[0]
151 void SetNodeOnVertex(CORBA::Long NodeID, CORBA::Long VertexID)
152 throw (SALOME::SALOME_Exception);
154 * \brief Store node position on an edge
155 * \param NodeID - node ID
156 * \param EdgeID - edge ID available through GEOM_Object.GetSubShapeIndices()[0]
157 * \param paramOnEdge - parameter on edge where the node is located
159 void SetNodeOnEdge(CORBA::Long NodeID, CORBA::Long EdgeID,
160 CORBA::Double paramOnEdge)
161 throw (SALOME::SALOME_Exception);
163 * \brief Store node position on a face
164 * \param NodeID - node ID
165 * \param FaceID - face ID available through GEOM_Object.GetSubShapeIndices()[0]
166 * \param u - U parameter on face where the node is located
167 * \param v - V parameter on face where the node is located
169 void SetNodeOnFace(CORBA::Long NodeID, CORBA::Long FaceID,
170 CORBA::Double u, CORBA::Double v)
171 throw (SALOME::SALOME_Exception);
173 * \brief Bind a node to a solid
174 * \param NodeID - node ID
175 * \param SolidID - vertex ID available through GEOM_Object.GetSubShapeIndices()[0]
177 void SetNodeInVolume(CORBA::Long NodeID, CORBA::Long SolidID)
178 throw (SALOME::SALOME_Exception);
180 * \brief Bind an element to a shape
181 * \param ElementID - element ID
182 * \param ShapeID - shape ID available through GEOM_Object.GetSubShapeIndices()[0]
184 void SetMeshElementOnShape(CORBA::Long ElementID, CORBA::Long ShapeID)
185 throw (SALOME::SALOME_Exception);
188 CORBA::Boolean MoveNode(CORBA::Long NodeID,
189 CORBA::Double x, CORBA::Double y, CORBA::Double z)
190 throw (SALOME::SALOME_Exception);
192 CORBA::Boolean InverseDiag(CORBA::Long NodeID1, CORBA::Long NodeID2)
193 throw (SALOME::SALOME_Exception);
194 CORBA::Boolean DeleteDiag(CORBA::Long NodeID1, CORBA::Long NodeID2)
195 throw (SALOME::SALOME_Exception);
196 CORBA::Boolean Reorient(const SMESH::long_array & IDsOfElements)
197 throw (SALOME::SALOME_Exception);
198 CORBA::Boolean ReorientObject(SMESH::SMESH_IDSource_ptr theObject)
199 throw (SALOME::SALOME_Exception);
202 * \brief Reorient faces contained in \a the2Dgroup.
203 * \param the2Dgroup - the mesh or its part to reorient
204 * \param theDirection - desired direction of normal of \a theFace
205 * \param theFace - ID of face whose orientation is checked.
206 * It can be < 1 then \a thePoint is used to find a face.
207 * \param thePoint - is used to find a face if \a theFace < 1.
208 * \return number of reoriented elements.
210 CORBA::Long Reorient2D(SMESH::SMESH_IDSource_ptr the2Dgroup,
211 const SMESH::DirStruct& theDirection,
213 const SMESH::PointStruct& thePoint) throw (SALOME::SALOME_Exception);
215 * \brief Reorient faces basing on orientation of adjacent volumes.
216 * \param faces - a list of objects containing face to reorient
217 * \param volumes - an object containing volumes.
218 * \param outsideNormal - to orient faces to have their normal
219 * pointing either \a outside or \a inside the adjacent volumes.
220 * \return number of reoriented faces.
222 CORBA::Long Reorient2DBy3D(const SMESH::ListOfIDSources & faces,
223 SMESH::SMESH_IDSource_ptr volumes,
224 CORBA::Boolean outsideNormal)
225 throw (SALOME::SALOME_Exception);
228 CORBA::Boolean TriToQuad (const SMESH::long_array & IDsOfElements,
229 SMESH::NumericalFunctor_ptr Criterion,
230 CORBA::Double MaxAngle)
231 throw (SALOME::SALOME_Exception);
232 CORBA::Boolean TriToQuadObject (SMESH::SMESH_IDSource_ptr theObject,
233 SMESH::NumericalFunctor_ptr Criterion,
234 CORBA::Double MaxAngle)
235 throw (SALOME::SALOME_Exception);
236 CORBA::Boolean QuadToTri (const SMESH::long_array & IDsOfElements,
237 SMESH::NumericalFunctor_ptr Criterion)
238 throw (SALOME::SALOME_Exception);
239 CORBA::Boolean QuadToTriObject (SMESH::SMESH_IDSource_ptr theObject,
240 SMESH::NumericalFunctor_ptr Criterion)
241 throw (SALOME::SALOME_Exception);
242 void QuadTo4Tri (SMESH::SMESH_IDSource_ptr theObject)
243 throw (SALOME::SALOME_Exception);
244 CORBA::Boolean SplitQuad (const SMESH::long_array & IDsOfElements,
245 CORBA::Boolean Diag13)
246 throw (SALOME::SALOME_Exception);
247 CORBA::Boolean SplitQuadObject (SMESH::SMESH_IDSource_ptr theObject,
248 CORBA::Boolean Diag13)
249 throw (SALOME::SALOME_Exception);
250 CORBA::Long BestSplit (CORBA::Long IDOfQuad,
251 SMESH::NumericalFunctor_ptr Criterion)
252 throw (SALOME::SALOME_Exception);
253 void SplitVolumesIntoTetra(SMESH::SMESH_IDSource_ptr elems,
254 CORBA::Short methodFlags)
255 throw (SALOME::SALOME_Exception);
256 void SplitHexahedraIntoPrisms(SMESH::SMESH_IDSource_ptr elems,
257 const SMESH::PointStruct & startHexPoint,
258 const SMESH::DirStruct& facetToSplitNormal,
259 CORBA::Short methodFlags,
260 CORBA::Boolean allDomains)
261 throw (SALOME::SALOME_Exception);
262 void SplitBiQuadraticIntoLinear(const SMESH::ListOfIDSources& elems)
263 throw (SALOME::SALOME_Exception);
265 CORBA::Boolean Smooth(const SMESH::long_array & IDsOfElements,
266 const SMESH::long_array & IDsOfFixedNodes,
267 CORBA::Long MaxNbOfIterations,
268 CORBA::Double MaxAspectRatio,
269 SMESH::SMESH_MeshEditor::Smooth_Method Method)
270 throw (SALOME::SALOME_Exception);
271 CORBA::Boolean SmoothObject(SMESH::SMESH_IDSource_ptr theObject,
272 const SMESH::long_array & IDsOfFixedNodes,
273 CORBA::Long MaxNbOfIterations,
274 CORBA::Double MaxAspectRatio,
275 SMESH::SMESH_MeshEditor::Smooth_Method Method)
276 throw (SALOME::SALOME_Exception);
277 CORBA::Boolean SmoothParametric(const SMESH::long_array & IDsOfElements,
278 const SMESH::long_array & IDsOfFixedNodes,
279 CORBA::Long MaxNbOfIterations,
280 CORBA::Double MaxAspectRatio,
281 SMESH::SMESH_MeshEditor::Smooth_Method Method)
282 throw (SALOME::SALOME_Exception);
283 CORBA::Boolean SmoothParametricObject(SMESH::SMESH_IDSource_ptr theObject,
284 const SMESH::long_array & IDsOfFixedNodes,
285 CORBA::Long MaxNbOfIterations,
286 CORBA::Double MaxAspectRatio,
287 SMESH::SMESH_MeshEditor::Smooth_Method Method)
288 throw (SALOME::SALOME_Exception);
289 CORBA::Boolean smooth(const SMESH::long_array & IDsOfElements,
290 const SMESH::long_array & IDsOfFixedNodes,
291 CORBA::Long MaxNbOfIterations,
292 CORBA::Double MaxAspectRatio,
293 SMESH::SMESH_MeshEditor::Smooth_Method Method,
295 throw (SALOME::SALOME_Exception);
296 CORBA::Boolean smoothObject(SMESH::SMESH_IDSource_ptr theObject,
297 const SMESH::long_array & IDsOfFixedNodes,
298 CORBA::Long MaxNbOfIterations,
299 CORBA::Double MaxAspectRatio,
300 SMESH::SMESH_MeshEditor::Smooth_Method Method,
302 throw (SALOME::SALOME_Exception);
304 CORBA::Boolean ConvertFromQuadratic()
305 throw (SALOME::SALOME_Exception);
306 void ConvertFromQuadraticObject(SMESH::SMESH_IDSource_ptr theObject)
307 throw (SALOME::SALOME_Exception);
308 void ConvertToQuadratic(CORBA::Boolean Force3d)
309 throw (SALOME::SALOME_Exception);
310 void ConvertToQuadraticObject(CORBA::Boolean theForce3d,
311 SMESH::SMESH_IDSource_ptr theObject)
312 throw (SALOME::SALOME_Exception);
313 void ConvertToBiQuadratic(CORBA::Boolean theForce3d,
314 SMESH::SMESH_IDSource_ptr theObject)
315 throw (SALOME::SALOME_Exception);
317 void RenumberNodes() throw (SALOME::SALOME_Exception);
318 void RenumberElements() throw (SALOME::SALOME_Exception);
320 SMESH::ListOfGroups* RotationSweepObjects(const SMESH::ListOfIDSources & nodes,
321 const SMESH::ListOfIDSources & edges,
322 const SMESH::ListOfIDSources & faces,
323 const SMESH::AxisStruct & Axis,
324 CORBA::Double AngleInRadians,
325 CORBA::Long NbOfSteps,
326 CORBA::Double Tolerance,
327 CORBA::Boolean toMakeGroups)
328 throw (SALOME::SALOME_Exception);
330 SMESH::ListOfGroups* ExtrusionSweepObjects(const SMESH::ListOfIDSources & nodes,
331 const SMESH::ListOfIDSources & edges,
332 const SMESH::ListOfIDSources & faces,
333 const SMESH::DirStruct & stepVector,
334 CORBA::Long nbOfSteps,
335 const SMESH::double_array & theScaleFactors,
336 CORBA::Boolean theLinearVariation,
337 const SMESH::double_array & theBasePoint,
338 CORBA::Boolean toMakeGroups)
339 throw (SALOME::SALOME_Exception);
341 SMESH::ListOfGroups* ExtrusionByNormal(const SMESH::ListOfIDSources& objects,
342 CORBA::Double stepSize,
343 CORBA::Long nbOfSteps,
344 CORBA::Boolean byAverageNormal,
345 CORBA::Boolean useInputElemsOnly,
346 CORBA::Boolean makeGroups,
348 throw (SALOME::SALOME_Exception);
349 SMESH::ListOfGroups* AdvancedExtrusion(const SMESH::long_array & theIDsOfElements,
350 const SMESH::DirStruct & theStepVector,
351 CORBA::Long theNbOfSteps,
352 CORBA::Long theExtrFlags,
353 CORBA::Double theSewTolerance,
354 CORBA::Boolean theMakeGroups)
355 throw (SALOME::SALOME_Exception);
358 ExtrusionAlongPathObjects(const SMESH::ListOfIDSources & nodes,
359 const SMESH::ListOfIDSources & edges,
360 const SMESH::ListOfIDSources & faces,
361 SMESH::SMESH_IDSource_ptr PathMesh,
362 GEOM::GEOM_Object_ptr PathShape,
363 CORBA::Long NodeStart,
364 CORBA::Boolean HasAngles,
365 const SMESH::double_array & Angles,
366 CORBA::Boolean LinearVariation,
367 CORBA::Boolean HasRefPoint,
368 const SMESH::PointStruct & RefPoint,
370 SMESH::SMESH_MeshEditor::Extrusion_Error& Error)
371 throw (SALOME::SALOME_Exception);
373 SMESH::double_array* LinearAnglesVariation(SMESH::SMESH_Mesh_ptr PathMesh,
374 GEOM::GEOM_Object_ptr PathShape,
375 const SMESH::double_array & Angles);
377 void Mirror(const SMESH::long_array & IDsOfElements,
378 const SMESH::AxisStruct & Axis,
379 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
381 throw (SALOME::SALOME_Exception);
382 void MirrorObject(SMESH::SMESH_IDSource_ptr theObject,
383 const SMESH::AxisStruct & Axis,
384 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
386 throw (SALOME::SALOME_Exception);
387 void Translate(const SMESH::long_array & IDsOfElements,
388 const SMESH::DirStruct & Vector,
390 throw (SALOME::SALOME_Exception);
391 void TranslateObject(SMESH::SMESH_IDSource_ptr theObject,
392 const SMESH::DirStruct & Vector,
394 throw (SALOME::SALOME_Exception);
395 void Rotate(const SMESH::long_array & IDsOfElements,
396 const SMESH::AxisStruct & Axis,
399 throw (SALOME::SALOME_Exception);
400 void RotateObject(SMESH::SMESH_IDSource_ptr theObject,
401 const SMESH::AxisStruct & Axis,
404 throw (SALOME::SALOME_Exception);
406 SMESH::ListOfGroups* MirrorMakeGroups(const SMESH::long_array& IDsOfElements,
407 const SMESH::AxisStruct& Mirror,
408 SMESH::SMESH_MeshEditor::MirrorType MirrorType)
409 throw (SALOME::SALOME_Exception);
410 SMESH::ListOfGroups* MirrorObjectMakeGroups(SMESH::SMESH_IDSource_ptr Object,
411 const SMESH::AxisStruct& Mirror,
412 SMESH::SMESH_MeshEditor::MirrorType MirrorType)
413 throw (SALOME::SALOME_Exception);
414 SMESH::ListOfGroups* TranslateMakeGroups(const SMESH::long_array& IDsOfElements,
415 const SMESH::DirStruct& Vector)
416 throw (SALOME::SALOME_Exception);
417 SMESH::ListOfGroups* TranslateObjectMakeGroups(SMESH::SMESH_IDSource_ptr Object,
418 const SMESH::DirStruct& Vector)
419 throw (SALOME::SALOME_Exception);
420 SMESH::ListOfGroups* RotateMakeGroups(const SMESH::long_array& IDsOfElements,
421 const SMESH::AxisStruct& Axis,
422 CORBA::Double AngleInRadians)
423 throw (SALOME::SALOME_Exception);
424 SMESH::ListOfGroups* RotateObjectMakeGroups(SMESH::SMESH_IDSource_ptr Object,
425 const SMESH::AxisStruct& Axis,
426 CORBA::Double AngleInRadians)
427 throw (SALOME::SALOME_Exception);
429 SMESH::SMESH_Mesh_ptr MirrorMakeMesh(const SMESH::long_array& IDsOfElements,
430 const SMESH::AxisStruct& Mirror,
431 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
432 CORBA::Boolean CopyGroups,
433 const char* MeshName)
434 throw (SALOME::SALOME_Exception);
435 SMESH::SMESH_Mesh_ptr MirrorObjectMakeMesh(SMESH::SMESH_IDSource_ptr Object,
436 const SMESH::AxisStruct& Mirror,
437 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
438 CORBA::Boolean CopyGroups,
439 const char* MeshName)
440 throw (SALOME::SALOME_Exception);
441 SMESH::SMESH_Mesh_ptr TranslateMakeMesh(const SMESH::long_array& IDsOfElements,
442 const SMESH::DirStruct& Vector,
443 CORBA::Boolean CopyGroups,
444 const char* MeshName)
445 throw (SALOME::SALOME_Exception);
446 SMESH::SMESH_Mesh_ptr TranslateObjectMakeMesh(SMESH::SMESH_IDSource_ptr Object,
447 const SMESH::DirStruct& Vector,
448 CORBA::Boolean CopyGroups,
449 const char* MeshName)
450 throw (SALOME::SALOME_Exception);
451 SMESH::SMESH_Mesh_ptr RotateMakeMesh(const SMESH::long_array& IDsOfElements,
452 const SMESH::AxisStruct& Axis,
453 CORBA::Double AngleInRadians,
454 CORBA::Boolean CopyGroups,
455 const char* MeshName)
456 throw (SALOME::SALOME_Exception);
457 SMESH::SMESH_Mesh_ptr RotateObjectMakeMesh(SMESH::SMESH_IDSource_ptr Object,
458 const SMESH::AxisStruct& Axis,
459 CORBA::Double AngleInRadians,
460 CORBA::Boolean CopyGroups,
461 const char* MeshName)
462 throw (SALOME::SALOME_Exception);
464 void Scale(SMESH::SMESH_IDSource_ptr theObject,
465 const SMESH::PointStruct& thePoint,
466 const SMESH::double_array& theScaleFact,
467 CORBA::Boolean theCopy)
468 throw (SALOME::SALOME_Exception);
470 SMESH::ListOfGroups* ScaleMakeGroups(SMESH::SMESH_IDSource_ptr theObject,
471 const SMESH::PointStruct& thePoint,
472 const SMESH::double_array& theScaleFact)
473 throw (SALOME::SALOME_Exception);
475 SMESH::SMESH_Mesh_ptr ScaleMakeMesh(SMESH::SMESH_IDSource_ptr Object,
476 const SMESH::PointStruct& Point,
477 const SMESH::double_array& theScaleFact,
478 CORBA::Boolean CopyGroups,
479 const char* MeshName)
480 throw (SALOME::SALOME_Exception);
482 SMESH::SMESH_Mesh_ptr Offset( SMESH::SMESH_IDSource_ptr theObject,
484 CORBA::Boolean CopyGroups,
485 CORBA::Boolean CopyElements,
486 const char* MeshName,
487 SMESH::ListOfGroups_out Groups)
488 throw (SALOME::SALOME_Exception);
490 void FindCoincidentNodes (CORBA::Double Tolerance,
491 SMESH::array_of_long_array_out GroupsOfNodes,
492 CORBA::Boolean SeparateCornersAndMedium)
493 throw (SALOME::SALOME_Exception);
494 void FindCoincidentNodesOnPart(SMESH::SMESH_IDSource_ptr Object,
495 CORBA::Double Tolerance,
496 SMESH::array_of_long_array_out GroupsOfNodes,
497 CORBA::Boolean SeparateCornersAndMedium)
498 throw (SALOME::SALOME_Exception);
499 void FindCoincidentNodesOnPartBut(SMESH::SMESH_IDSource_ptr Object,
500 CORBA::Double Tolerance,
501 SMESH::array_of_long_array_out GroupsOfNodes,
502 const SMESH::ListOfIDSources& ExceptSubMeshOrGroups,
503 CORBA::Boolean SeparateCornersAndMedium)
504 throw (SALOME::SALOME_Exception);
505 void MergeNodes (const SMESH::array_of_long_array& GroupsOfNodes,
506 const SMESH::ListOfIDSources& NodesToKeep,
507 CORBA::Boolean AvoidMakingHoles )
508 throw (SALOME::SALOME_Exception);
509 void FindEqualElements(SMESH::SMESH_IDSource_ptr Object,
510 SMESH::array_of_long_array_out GroupsOfElementsID)
511 throw (SALOME::SALOME_Exception);
512 void MergeElements(const SMESH::array_of_long_array& GroupsOfElementsID)
513 throw (SALOME::SALOME_Exception);
514 void MergeEqualElements()
515 throw (SALOME::SALOME_Exception);
516 CORBA::Long MoveClosestNodeToPoint(CORBA::Double x,
520 throw (SALOME::SALOME_Exception);
522 * \brief Return ID of node closest to a given point
524 CORBA::Long FindNodeClosestTo(CORBA::Double x,
527 throw (SALOME::SALOME_Exception);
529 * Return elements of given type where the given point is IN or ON.
530 * 'ALL' type means elements of any type excluding nodes
532 SMESH::long_array* FindElementsByPoint(CORBA::Double x,
535 SMESH::ElementType type)
536 throw (SALOME::SALOME_Exception);
538 * Searching among the given elements, return elements of given type
539 * where the given point is IN or ON.
540 * 'ALL' type means elements of any type excluding nodes
542 SMESH::long_array* FindAmongElementsByPoint(SMESH::SMESH_IDSource_ptr elements,
546 SMESH::ElementType type)
547 throw (SALOME::SALOME_Exception);
550 * Return point state in a closed 2D mesh in terms of TopAbs_State enumeration.
551 * TopAbs_UNKNOWN state means that either mesh is wrong or the analysis fails.
553 CORBA::Short GetPointState(CORBA::Double x, CORBA::Double y, CORBA::Double z)
554 throw (SALOME::SALOME_Exception);
557 * Check if a 2D mesh is manifold
559 CORBA::Boolean IsManifold()
560 throw (SALOME::SALOME_Exception);
563 * Check if orientation of 2D elements is coherent
565 CORBA::Boolean IsCoherentOrientation2D()
566 throw (SALOME::SALOME_Exception);
569 * Returns all or only closed FreeBorder's.
571 SMESH::ListOfFreeBorders* FindFreeBorders(CORBA::Boolean closedOnly)
572 throw (SALOME::SALOME_Exception);
575 * Fill with 2D elements a hole defined by a FreeBorder.
576 * Optionally add new faces to a given group, which is returned
578 SMESH::SMESH_Group_ptr FillHole(const SMESH::FreeBorder& hole,
579 const char* groupName)
580 throw (SALOME::SALOME_Exception);
582 SMESH::CoincidentFreeBorders* FindCoincidentFreeBorders(CORBA::Double tolerance);
583 CORBA::Short SewCoincidentFreeBorders(const SMESH::CoincidentFreeBorders& freeBorders,
584 CORBA::Boolean createPolygons,
585 CORBA::Boolean createPolyedrs)
586 throw (SALOME::SALOME_Exception);
588 SMESH::SMESH_MeshEditor::Sew_Error
589 SewFreeBorders(CORBA::Long FirstNodeID1,
590 CORBA::Long SecondNodeID1,
591 CORBA::Long LastNodeID1,
592 CORBA::Long FirstNodeID2,
593 CORBA::Long SecondNodeID2,
594 CORBA::Long LastNodeID2,
595 CORBA::Boolean CreatePolygons,
596 CORBA::Boolean CreatePolyedrs) throw (SALOME::SALOME_Exception);
597 SMESH::SMESH_MeshEditor::Sew_Error
598 SewConformFreeBorders(CORBA::Long FirstNodeID1,
599 CORBA::Long SecondNodeID1,
600 CORBA::Long LastNodeID1,
601 CORBA::Long FirstNodeID2,
602 CORBA::Long SecondNodeID2) throw (SALOME::SALOME_Exception);
603 SMESH::SMESH_MeshEditor::Sew_Error
604 SewBorderToSide(CORBA::Long FirstNodeIDOnFreeBorder,
605 CORBA::Long SecondNodeIDOnFreeBorder,
606 CORBA::Long LastNodeIDOnFreeBorder,
607 CORBA::Long FirstNodeIDOnSide,
608 CORBA::Long LastNodeIDOnSide,
609 CORBA::Boolean CreatePolygons,
610 CORBA::Boolean CreatePolyedrs) throw (SALOME::SALOME_Exception);
611 SMESH::SMESH_MeshEditor::Sew_Error
612 SewSideElements(const SMESH::long_array& IDsOfSide1Elements,
613 const SMESH::long_array& IDsOfSide2Elements,
614 CORBA::Long NodeID1OfSide1ToMerge,
615 CORBA::Long NodeID1OfSide2ToMerge,
616 CORBA::Long NodeID2OfSide1ToMerge,
617 CORBA::Long NodeID2OfSide2ToMerge) throw (SALOME::SALOME_Exception);
620 * Set new nodes for given element.
621 * If number of nodes is not corresponded to type of
622 * element - returns false
624 CORBA::Boolean ChangeElemNodes(CORBA::Long ide, const SMESH::long_array& newIDs)
625 throw (SALOME::SALOME_Exception);
627 SMESH::SMESH_Group_ptr DoubleElements(SMESH::SMESH_IDSource_ptr theElements,
628 const char* theGroupName)
629 throw (SALOME::SALOME_Exception);
631 CORBA::Boolean DoubleNodes( const SMESH::long_array& theNodes,
632 const SMESH::long_array& theModifiedElems )
633 throw (SALOME::SALOME_Exception);
635 CORBA::Boolean DoubleNode( CORBA::Long theNodeId,
636 const SMESH::long_array& theModifiedElems )
637 throw (SALOME::SALOME_Exception);
639 CORBA::Boolean DoubleNodeGroup( SMESH::SMESH_GroupBase_ptr theNodes,
640 SMESH::SMESH_GroupBase_ptr theModifiedElems )
641 throw (SALOME::SALOME_Exception);
644 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements.
645 * Works as DoubleNodeGroup(), but returns a new group with newly created nodes.
646 * \param theNodes - group of nodes to be doubled.
647 * \param theModifiedElems - group of elements to be updated.
648 * \return a new group with newly created nodes
649 * \sa DoubleNodeGroup()
651 SMESH::SMESH_Group_ptr DoubleNodeGroupNew( SMESH::SMESH_GroupBase_ptr theNodes,
652 SMESH::SMESH_GroupBase_ptr theModifiedElems )
653 throw (SALOME::SALOME_Exception);
655 CORBA::Boolean DoubleNodeGroups( const SMESH::ListOfGroups& theNodes,
656 const SMESH::ListOfGroups& theModifiedElems )
657 throw (SALOME::SALOME_Exception);
659 SMESH::SMESH_Group_ptr DoubleNodeGroupsNew( const SMESH::ListOfGroups& theNodes,
660 const SMESH::ListOfGroups& theModifiedElems )
661 throw (SALOME::SALOME_Exception);
664 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
665 * \param theElems - the list of elements (edges or faces) to be replicated
666 * The nodes for duplication could be found from these elements
667 * \param theNodesNot - list of nodes to NOT replicate
668 * \param theAffectedElems - the list of elements (cells and edges) to which the
669 * replicated nodes should be associated to.
670 * \return TRUE if operation has been completed successfully, FALSE otherwise
671 * \sa DoubleNodeGroup(), DoubleNodeGroups()
673 CORBA::Boolean DoubleNodeElem( const SMESH::long_array& theElems,
674 const SMESH::long_array& theNodesNot,
675 const SMESH::long_array& theAffectedElems )
676 throw (SALOME::SALOME_Exception);
679 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
680 * \param theElems - the list of elements (edges or faces) to be replicated
681 * The nodes for duplication could be found from these elements
682 * \param theNodesNot - list of nodes to NOT replicate
683 * \param theShape - shape to detect affected elements (element which geometric center
684 * located on or inside shape).
685 * The replicated nodes should be associated to affected elements.
686 * \return TRUE if operation has been completed successfully, FALSE otherwise
687 * \sa DoubleNodeGroupInRegion(), DoubleNodeGroupsInRegion()
689 CORBA::Boolean DoubleNodeElemInRegion( const SMESH::long_array& theElems,
690 const SMESH::long_array& theNodesNot,
691 GEOM::GEOM_Object_ptr theShape )
692 throw (SALOME::SALOME_Exception);
695 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
696 * \param theElems - group of of elements (edges or faces) to be replicated
697 * \param theNodesNot - group of nodes not to replicated
698 * \param theAffectedElems - group of elements to which the replicated nodes
699 * should be associated to.
700 * \return TRUE if operation has been completed successfully, FALSE otherwise
701 * \sa DoubleNodes(), DoubleNodeGroups(), DoubleNodeElemGroupNew()
703 CORBA::Boolean DoubleNodeElemGroup( SMESH::SMESH_GroupBase_ptr theElems,
704 SMESH::SMESH_GroupBase_ptr theNodesNot,
705 SMESH::SMESH_GroupBase_ptr theAffectedElems )
706 throw (SALOME::SALOME_Exception);
709 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
710 * Works as DoubleNodeElemGroup(), but returns a new group with newly created elements.
711 * \param theElems - group of of elements (edges or faces) to be replicated
712 * \param theNodesNot - group of nodes not to replicated
713 * \param theAffectedElems - group of elements to which the replicated nodes
714 * should be associated to.
715 * \return a new group with newly created elements
716 * \sa DoubleNodeElemGroup()
718 SMESH::SMESH_Group_ptr DoubleNodeElemGroupNew( SMESH::SMESH_GroupBase_ptr theElems,
719 SMESH::SMESH_GroupBase_ptr theNodesNot,
720 SMESH::SMESH_GroupBase_ptr theAffectedElems )
721 throw (SALOME::SALOME_Exception);
723 SMESH::ListOfGroups* DoubleNodeElemGroup2New(SMESH::SMESH_GroupBase_ptr theElems,
724 SMESH::SMESH_GroupBase_ptr theNodesNot,
725 SMESH::SMESH_GroupBase_ptr theAffectedElems,
726 CORBA::Boolean theElemGroupNeeded,
727 CORBA::Boolean theNodeGroupNeeded)
728 throw (SALOME::SALOME_Exception);
731 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
732 * \param theElems - group of of elements (edges or faces) to be replicated
733 * \param theNodesNot - group of nodes not to replicated
734 * \param theShape - shape to detect affected elements (element which geometric center
735 * located on or inside shape).
736 * The replicated nodes should be associated to affected elements.
737 * \return TRUE if operation has been completed successfully, FALSE otherwise
738 * \sa DoubleNodesInRegion(), DoubleNodeGroupsInRegion()
740 CORBA::Boolean DoubleNodeElemGroupInRegion( SMESH::SMESH_GroupBase_ptr theElems,
741 SMESH::SMESH_GroupBase_ptr theNodesNot,
742 GEOM::GEOM_Object_ptr theShape )
743 throw (SALOME::SALOME_Exception);
746 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
747 * This method provided for convenience works as DoubleNodes() described above.
748 * \param theElems - list of groups of elements (edges or faces) to be replicated
749 * \param theNodesNot - list of groups of nodes not to replicated
750 * \param theAffectedElems - group of elements to which the replicated nodes
751 * should be associated to.
752 * \return TRUE if operation has been completed successfully, FALSE otherwise
753 * \sa DoubleNodeGroup(), DoubleNodes(), DoubleNodeElemGroupsNew()
755 CORBA::Boolean DoubleNodeElemGroups( const SMESH::ListOfGroups& theElems,
756 const SMESH::ListOfGroups& theNodesNot,
757 const SMESH::ListOfGroups& theAffectedElems )
758 throw (SALOME::SALOME_Exception);
761 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
762 * Works as DoubleNodeElemGroups(), but returns a new group with newly created elements.
763 * \param theElems - list of groups of elements (edges or faces) to be replicated
764 * \param theNodesNot - list of groups of nodes not to replicated
765 * \param theAffectedElems - group of elements to which the replicated nodes
766 * should be associated to.
767 * \return a new group with newly created elements
768 * \sa DoubleNodeElemGroups()
770 SMESH::SMESH_Group_ptr DoubleNodeElemGroupsNew( const SMESH::ListOfGroups& theElems,
771 const SMESH::ListOfGroups& theNodesNot,
772 const SMESH::ListOfGroups& theAffectedElems )
773 throw (SALOME::SALOME_Exception);
775 SMESH::ListOfGroups* DoubleNodeElemGroups2New(const SMESH::ListOfGroups& theElems,
776 const SMESH::ListOfGroups& theNodesNot,
777 const SMESH::ListOfGroups& theAffectedElems,
778 CORBA::Boolean theElemGroupNeeded,
779 CORBA::Boolean theNodeGroupNeeded)
780 throw (SALOME::SALOME_Exception);
783 * \brief Creates a hole in a mesh by doubling the nodes of some particular elements
784 * This method provided for convenience works as DoubleNodes() described above.
785 * \param theElems - list of groups of elements (edges or faces) to be replicated
786 * \param theNodesNot - list of groups of nodes not to replicated
787 * \param theShape - shape to detect affected elements (element which geometric center
788 * located on or inside shape).
789 * The replicated nodes should be associated to affected elements.
790 * \return TRUE if operation has been completed successfully, FALSE otherwise
791 * \sa DoubleNodeGroupInRegion(), DoubleNodesInRegion()
793 CORBA::Boolean DoubleNodeElemGroupsInRegion( const SMESH::ListOfGroups& theElems,
794 const SMESH::ListOfGroups& theNodesNot,
795 GEOM::GEOM_Object_ptr theShape )
796 throw (SALOME::SALOME_Exception);
799 * \brief Identify the elements that will be affected by node duplication (actual duplication is not performed.
800 * This method is the first step of DoubleNodeElemGroupsInRegion.
801 * \param theElems - list of groups of elements (edges or faces) to be replicated
802 * \param theNodesNot - list of groups of nodes not to replicated
803 * \param theShape - shape to detect affected elements (element which geometric center
804 * located on or inside shape).
805 * The replicated nodes should be associated to affected elements.
806 * \return groups of affected elements
807 * \sa DoubleNodeElemGroupsInRegion()
809 SMESH::ListOfGroups* AffectedElemGroupsInRegion( const SMESH::ListOfGroups& theElems,
810 const SMESH::ListOfGroups& theNodesNot,
811 GEOM::GEOM_Object_ptr theShape )
812 throw (SALOME::SALOME_Exception);
815 * \brief Double nodes on shared faces between groups of volumes and create flat elements on demand.
816 * The list of groups must describe a partition of the mesh volumes.
817 * The nodes of the internal faces at the boundaries of the groups are doubled.
818 * In option, the internal faces are replaced by flat elements.
819 * Triangles are transformed in prisms, and quadrangles in hexahedrons.
820 * \param theDomains - list of groups of volumes
821 * \param createJointElems - if TRUE, create the elements
822 * \param onAllBoundaries - if TRUE, the nodes and elements are also create on
823 * the boundary between \a theDomains and the rest mesh
824 * \return TRUE if operation has been completed successfully, FALSE otherwise
826 CORBA::Boolean DoubleNodesOnGroupBoundaries( const SMESH::ListOfGroups& theDomains,
827 CORBA::Boolean createJointElems,
828 CORBA::Boolean onAllBoundaries )
829 throw (SALOME::SALOME_Exception);
831 * \brief Double nodes on some external faces and create flat elements.
832 * Flat elements are mainly used by some types of mechanic calculations.
834 * Each group of the list must be constituted of faces.
835 * Triangles are transformed in prisms, and quadrangles in hexahedrons.
836 * @param theGroupsOfFaces - list of groups of faces
837 * @return TRUE if operation has been completed successfully, FALSE otherwise
839 CORBA::Boolean CreateFlatElementsOnFacesGroups( const SMESH::ListOfGroups& theGroupsOfFaces )
840 throw (SALOME::SALOME_Exception);
843 * \brief identify all the elements around a geom shape, get the faces delimiting the hole
844 * Build groups of volume to remove, groups of faces to replace on the skin of the object,
845 * groups of faces to remove insidethe object, (idem edges).
846 * Build ordered list of nodes at the border of each group of faces to replace (to be used to build a geom subshape)
848 void CreateHoleSkin(CORBA::Double radius,
849 GEOM::GEOM_Object_ptr theShape,
850 const char* groupName,
851 const SMESH::double_array& theNodesCoords,
852 SMESH::array_of_long_array_out GroupsOfNodes)
853 throw (SALOME::SALOME_Exception);
856 * \brief Generated skin mesh (containing 2D cells) from 3D mesh
857 * The created 2D mesh elements based on nodes of free faces of boundary volumes
858 * \return TRUE if operation has been completed successfully, FALSE otherwise
860 CORBA::Boolean Make2DMeshFrom3D()
861 throw (SALOME::SALOME_Exception);
863 SMESH::SMESH_Mesh_ptr MakeBoundaryMesh(SMESH::SMESH_IDSource_ptr elements,
864 SMESH::Bnd_Dimension dimension,
865 const char* groupName,
866 const char* meshName,
867 CORBA::Boolean toCopyElements,
868 CORBA::Boolean toCopyMissingBondary,
869 SMESH::SMESH_Group_out group)
870 throw (SALOME::SALOME_Exception);
872 CORBA::Long MakeBoundaryElements(SMESH::Bnd_Dimension dimension,
873 const char* groupName,
874 const char* meshName,
875 CORBA::Boolean toCopyAll,
876 const SMESH::ListOfIDSources& groups,
877 SMESH::SMESH_Mesh_out mesh,
878 SMESH::SMESH_Group_out group)
879 throw (SALOME::SALOME_Exception);
882 * \brief Create a polyline consisting of 1D mesh elements each lying on a 2D element of
883 * the initial mesh. Positions of new nodes are found by cutting the mesh by the
884 * plane passing through pairs of points specified by each PolySegment structure.
885 * If there are several paths connecting a pair of points, the shortest path is
886 * selected by the module. Position of the cutting plane is defined by the two
887 * points and an optional vector lying on the plane specified by a PolySegment.
888 * By default the vector is defined by Mesh module as following. A middle point
889 * of the two given points is computed. The middle point is projected to the mesh.
890 * The vector goes from the middle point to the projection point. In case of planar
891 * mesh, the vector is normal to the mesh.
892 * \param [inout] segments - PolySegment's defining positions of cutting planes.
893 * Return the used vector and position of the middle point.
894 * \param [in] groupName - optional name of a group where created mesh segments will
897 void MakePolyLine(SMESH::ListOfPolySegments& segments,
898 const char* groupName)
899 throw (SALOME::SALOME_Exception);
902 private: //!< private methods
904 ::SMESH_MeshEditor& getEditor();
906 SMESHDS_Mesh * getMeshDS() { return myMesh->GetMeshDS(); }
908 MeshEditor_I::TPreviewMesh * getPreviewMesh( SMDSAbs_ElementType previewType = SMDSAbs_All );
910 void declareMeshModified( bool isReComputeSafe );
913 * \brief Clear myLastCreated* or myPreviewData
915 void initData(bool deleteSearchers=true);
918 * \brief Return groups by their IDs
920 SMESH::ListOfGroups* getGroups(const std::list<int>* groupIDs)
921 throw (SALOME::SALOME_Exception);
923 SMESH::ListOfGroups* mirror(TIDSortedElemSet & IDsOfElements,
924 const SMESH::AxisStruct & Axis,
925 SMESH::SMESH_MeshEditor::MirrorType MirrorType,
928 ::SMESH_Mesh* TargetMesh=0)
929 throw (SALOME::SALOME_Exception);
930 SMESH::ListOfGroups* translate(TIDSortedElemSet & IDsOfElements,
931 const SMESH::DirStruct & Vector,
934 ::SMESH_Mesh* TargetMesh=0)
935 throw (SALOME::SALOME_Exception);
936 SMESH::ListOfGroups* rotate(TIDSortedElemSet & IDsOfElements,
937 const SMESH::AxisStruct & Axis,
941 ::SMESH_Mesh* TargetMesh=0)
942 throw (SALOME::SALOME_Exception);
944 SMESH::ListOfGroups* scale(SMESH::SMESH_IDSource_ptr theObject,
945 const SMESH::PointStruct& thePoint,
946 const SMESH::double_array& theScaleFact,
947 CORBA::Boolean theCopy,
949 ::SMESH_Mesh* theTargetMesh=0)
950 throw (SALOME::SALOME_Exception);
952 void convertToQuadratic(CORBA::Boolean theForce3d,
953 CORBA::Boolean theToBiQuad,
954 SMESH::SMESH_IDSource_ptr theObject = SMESH::SMESH_IDSource::_nil())
955 throw (SALOME::SALOME_Exception);
957 SMESH::SMESH_Mesh_ptr makeMesh(const char* theMeshName);
959 void dumpGroupsList(SMESH::TPythonDump & theDumpPython,
960 const SMESH::ListOfGroups * theGroupList);
962 std::string generateGroupName(const std::string& thePrefix);
964 void prepareIdSource(SMESH::SMESH_IDSource_ptr theObject);
967 enum IDSource_Error { IDSource_OK, IDSource_INVALID, IDSource_EMPTY };
969 bool idSourceToSet(SMESH::SMESH_IDSource_ptr theIDSource,
970 const SMESHDS_Mesh* theMeshDS,
971 TIDSortedElemSet& theElemSet,
972 const SMDSAbs_ElementType theType,
973 const bool emptyIfIsMesh = false,
974 IDSource_Error* error = 0);
976 void findCoincidentNodes( TIDSortedNodeSet & Nodes,
977 CORBA::Double Tolerance,
978 SMESH::array_of_long_array_out GroupsOfNodes,
979 CORBA::Boolean SeparateCornersAndMedium);
985 SMESH_Mesh_i* myMesh_i;
987 ::SMESH_MeshEditor myEditor;
989 bool myIsPreviewMode;
990 MeshEditor_I::TPreviewMesh * myPreviewMesh;
991 ::SMESH_MeshEditor * myPreviewEditor;
992 SMESH::MeshPreviewStruct_var myPreviewData;
994 // temporary IDSources