1 // Copyright (C) 2007-2016 CEA/DEN, EDF R&D
3 // This library is free software; you can redistribute it and/or
4 // modify it under the terms of the GNU Lesser General Public
5 // License as published by the Free Software Foundation; either
6 // version 2.1 of the License, or (at your option) any later version.
8 // This library is distributed in the hope that it will be useful,
9 // but WITHOUT ANY WARRANTY; without even the implied warranty of
10 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
11 // Lesser General Public License for more details.
13 // You should have received a copy of the GNU Lesser General Public
14 // License along with this library; if not, write to the Free Software
15 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
17 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
21 // File : BLSURFPlugin_Algorithm.idl
22 // Authors : Francis KLOSS (OCC) & Patrick LAUG (INRIA) & Lioka RAZAFINDRAZAKA (CEA)
23 // Size maps developement: Nicolas GEIMER (OCC) & Gilles DAVID (EURIWARE)
26 #ifndef _SMESH_BLSURFALGORITHM_IDL_
27 #define _SMESH_BLSURFALGORITHM_IDL_
29 #include "SMESH_Hypothesis.idl"
30 #include "GEOM_Gen.idl"
31 #include "SALOME_Exception.idl"
34 * BLSURFPlugin: interfaces to BLSURF related hypotheses and algorithms
38 typedef sequence<string> string_array;
40 // Enforced vertex name
41 typedef string TEnfName;
43 typedef string TEntry;
44 typedef sequence<TEntry> TEntryList;
46 typedef string TEnfGroupName;
48 // Coordinates of enforced vertex
49 typedef sequence<double,3> TEnfVertexCoords;
51 typedef sequence<TEnfVertexCoords> TEnfVertexCoordsList;
57 TEnfVertexCoords coords;
58 TEnfGroupName grpName;
59 TEntryList faceEntries;
61 // List of enforced vertices
62 typedef sequence<TEnfVertex> TEnfVertexList;
64 // Map Face Entry / List of enforced vertices
65 struct TFaceEntryEnfVertexListMapElement {
67 TEnfVertexList enfVertexList;
69 typedef sequence<TFaceEntryEnfVertexListMapElement> TFaceEntryEnfVertexListMap;
71 // Map Face Entry / List of coords
72 struct TFaceEntryCoordsListMapElement {
74 TEnfVertexCoordsList coordsList;
76 typedef sequence<TFaceEntryCoordsListMapElement> TFaceEntryCoordsListMap;
78 // Map Face Entry / List of enf vertex entries
79 struct TFaceEntryEnfVertexEntryListMapElement {
81 TEntryList enfVertexEntryList;
83 typedef sequence<TFaceEntryEnfVertexEntryListMapElement> TFaceEntryEnfVertexEntryListMap;
85 // Map Coords / Enforced vertex
86 struct TCoordsEnfVertexElement {
87 TEnfVertexCoords coords;
90 typedef sequence<TCoordsEnfVertexElement> TCoordsEnfVertexMap;
92 // Map Enf Vertex Entry / Enforced vertex
93 struct TEnfVertexEntryEnfVertexElement {
94 TEntry enfVertexEntry;
97 typedef sequence<TEnfVertexEntryEnfVertexElement> TEnfVertexEntryEnfVertexMap;
99 // List of Face Entry with internal enforced vertices activated
100 typedef sequence<TEntry> TFaceEntryInternalVerticesList;
103 struct TAttractorParams {
111 typedef sequence<TAttractorParams> TAttParamsMap;
114 struct TPreCadPeriodicity {
117 TEntryList theSourceVerticesEntries;
118 TEntryList theTargetVerticesEntries;
121 typedef sequence<TPreCadPeriodicity> TPeriodicityList;
124 * BLSURFPlugin_BLSURF: interface of BLSURF algorithm
126 interface BLSURFPlugin_BLSURF : SMESH::SMESH_2D_Algo
131 * BLSURFPlugin_Hypothesis: interface of "BLSURF parameters" hypothesis
133 interface BLSURFPlugin_Hypothesis : SMESH::SMESH_Hypothesis
137 * Sets a way to define size of mesh elements to generate
138 * 0 - size is defined automatically
139 * 1 - size is set by SetPhySize() method
140 * 2 - size is set by SetPhySize() method. A sizemap is defined.
142 void SetPhysicalMesh(in long isCustom);
143 long GetPhysicalMesh();
146 * Sets a way to define maximum angular deflection of mesh from CAD model
147 * 0 - deflection is defined automatically
148 * 1 - deflection is set by SetAngleMesh() method
149 * 2 - deflection is set by SetAngleMesh() method. A sizemap is defined (TODO).
151 void SetGeometricMesh(in long isCustom);
152 long GetGeometricMesh();
155 * Sets size of mesh elements to generate
157 void SetPhySize(in double size);
158 void SetPhySizeRel(in double size);
160 boolean IsPhySizeRel();
163 * Sets lower boundary of mesh element size
165 void SetMinSize(in double theMinSize);
166 void SetMinSizeRel(in double theMinSize);
168 boolean IsMinSizeRel();
171 * Sets upper boundary of mesh element size
173 void SetMaxSize(in double theMaxSize);
174 void SetMaxSizeRel(in double theMaxSize);
176 boolean IsMaxSizeRel();
179 * Sets maximal allowed ratio between the lengths of two adjacent edges
181 void SetGradation(in double ratio);
182 double GetGradation();
185 * Sets to create quadrilateral elements or not
187 void SetQuadAllowed(in boolean allowed);
188 boolean GetQuadAllowed();
191 * Sets angular deflection (in degrees) of a mesh face and edge from CAD surface
193 void SetAngleMesh(in double angle);
194 double GetAngleMesh();
197 * Sets the maximum desired distance between a triangle and its supporting CAD surface
199 void SetChordalError(in double distance);
200 double GetChordalError();
203 * Determines whether the generated mesh will be isotropic or anisotropic
205 void SetAnisotropic(in boolean anisotropic);
206 boolean GetAnisotropic();
209 * Defines the maximum anisotropic ratio of the metric governing the anisotropic process.
210 * The default value of 0 means that the metric (and thus the generated elements)
211 * can be arbitrarily stretched.
213 void SetAnisotropicRatio(in double ratio);
214 double GetAnisotropicRatio();
217 * This patch-independent correction option can be activated to remove the tiny
218 * (nano) edges from the generated mesh, without taking into account the tags
219 * (attributes) specifications.
221 void SetRemoveTinyEdges(in boolean remove);
222 boolean GetRemoveTinyEdges();
225 * Defines the minimal length under which an edge is considered to be a tiny one
227 void SetTinyEdgeLength(in double length);
228 double GetTinyEdgeLength();
231 * This patch independent correction option can be activated to remove the bad
232 * elements (often called slivers) from the generated mesh, without taking into account
233 * the tags (attributes) specification.
235 void SetBadElementRemoval(in boolean remove);
236 boolean GetBadElementRemoval();
239 * This parameter defines the aspect ratio triggering the "bad element"
240 * classification for the force bad surface element removal option.
242 void SetBadElementAspectRatio(in double ratio);
243 double GetBadElementAspectRatio();
246 * If this option is activated, MeshGems-CADSurf will optimize the mesh in order to
247 * get better shaped elements, during a process which respects the patch independent options.
248 * This optimisation cannot be fully performed when correct_surface_intersections = 1.
250 void SetOptimizeMesh(in boolean optimize);
251 boolean GetOptimizeMesh();
254 * Determines the order of mesh elements to be generated (linear or quadratic)
256 void SetQuadraticMesh(in boolean quadratic);
257 boolean GetQuadraticMesh();
260 * Sets topology usage way defining how mesh conformity is assured
261 * value=0 - mesh conformity is assured by conformity of a shape
262 * value=1,2 - mesh conformity is assured by pre-processing a CAD model (OBSOLETE)
263 * value=3 - mesh conformity is assured by pre-processing a CAD model with Pre-CAD
265 void SetTopology(in long way);
269 * Sets verbosity level in the range 0 to 100.
271 void SetVerbosity(in short theVal) raises (SALOME::SALOME_Exception);
272 short GetVerbosity();
277 void SetPreCADMergeEdges(in boolean toMergeEdges);
278 boolean GetPreCADMergeEdges();
281 * To remove duplicate CAD faces.
283 void SetPreCADRemoveDuplicateCADFaces(in boolean toRemoveDuplicateCADFaces);
284 boolean GetPreCADRemoveDuplicateCADFaces();
287 * To process 3D topology.
289 void SetPreCADProcess3DTopology(in boolean toProcess);
290 boolean GetPreCADProcess3DTopology();
294 * To compute topology from scratch
296 void SetPreCADDiscardInput(in boolean toDiscardInput);
297 boolean GetPreCADDiscardInput();
300 * Sets advanced option value
302 void SetOptionValue(in string optionName,
303 in string optionValue) raises (SALOME::SALOME_Exception);
304 void SetPreCADOptionValue(in string optionName,
305 in string optionValue) raises (SALOME::SALOME_Exception);
306 string GetOptionValue(in string optionName) raises (SALOME::SALOME_Exception);
307 string GetPreCADOptionValue(in string optionName) raises (SALOME::SALOME_Exception);
309 * Unsets advanced option
311 void UnsetOption(in string optionName);
312 void UnsetPreCADOption(in string optionName);
315 * Adds custom advanced option and its value
317 void AddOption(in string optionName, in string optionValue);
318 void AddPreCADOption(in string optionName, in string optionValue);
319 string GetOption(in string optionName);
320 string GetPreCADOption(in string optionName);
323 * Return array of strings each of which is option name concatenated
324 * with option value devided by semicolon - "option_name:option_value:option_type".
325 * Option value is empty if an option is not set.
326 * Note: the method is mostly for interaction with GUI.
328 string_array GetOptionValues();
329 string_array GetPreCADOptionValues();
332 * Set option values each in the form "option_name[:option_value][:option_type]".
333 * Note: the method is mostly for interaction with GUI.
335 void SetOptionValues(in string_array options) raises (SALOME::SALOME_Exception);
336 void SetPreCADOptionValues(in string_array options) raises (SALOME::SALOME_Exception);
341 void SetSizeMapEntries(in string_array sizeMaps) raises (SALOME::SALOME_Exception);
342 void ClearSizeMaps();
344 void UnsetEntry(in string entry);
347 * Set/unset a SizeMap on geom object
349 void SetSizeMap(in GEOM::GEOM_Object GeomObj, in string sizeMap) raises (SALOME::SALOME_Exception);
350 void SetConstantSizeMap(in GEOM::GEOM_Object GeomObj, in double sizeMap);
351 void UnsetSizeMap(in GEOM::GEOM_Object GeomObj);
354 * Set a SizeMap on geom object given by entry
356 void SetSizeMapEntry(in string entry, in string sizeMap) raises (SALOME::SALOME_Exception);
357 void SetConstantSizeMapEntry(in string entry, in GEOM::shape_type shapeType, in double sizeMap) raises (SALOME::SALOME_Exception);
358 string GetSizeMapEntry(in string entry) raises (SALOME::SALOME_Exception);
359 string_array GetSizeMapEntries();
362 * Set/unset an attractor on geom object
364 void SetAttractor(in GEOM::GEOM_Object GeomObj, in string attractor);
365 void UnsetAttractor(in GEOM::GEOM_Object GeomObj);
368 * Set an attractor on geom object given by entry
370 void SetAttractorEntry(in string entry, in string attractor) raises (SALOME::SALOME_Exception);
371 string GetAttractorEntry(in string entry) raises (SALOME::SALOME_Exception);
372 string_array GetAttractorEntries();
375 * Set/unset an attractor given as geom object on another geom object
377 void SetAttractorGeom(in GEOM::GEOM_Object GeomObj, in GEOM::GEOM_Object AttractorShape, in double StartSize, in double EndSize, in double ActionRadius, in double ConstantRadius);
378 void UnsetAttractorGeom(in GEOM::GEOM_Object GeomObj, in GEOM::GEOM_Object AttractorShape);
379 void UnsetAttractorEntry(in string entry, in string attractor);
382 * Set an attractor given by entry on a geom object given by entry
384 void SetClassAttractorEntry(in string entry, in string att_entry, in double StartSize, in double EndSize, in double ActionRadius, in double ConstantRadius ) raises (SALOME::SALOME_Exception);
385 BLSURFPlugin::TAttParamsMap GetAttractorParams();
388 void SetCustomSizeMapEntry(in string entry, in string sizeMap);
389 string GetCustomSizeMapEntry(in string entry);
390 void SetCustomSizeMap(in GEOM::GEOM_Object GeomObj, in string sizeMap);
391 void UnsetCustomSizeMap(in GEOM::GEOM_Object GeomObj);
392 string_array GetCustomSizeMapEntries();
394 ///////////////////////
395 // ENFORCED VERTEXES //
396 ///////////////////////
398 TFaceEntryEnfVertexListMap GetAllEnforcedVerticesByFace();
399 TEnfVertexList GetAllEnforcedVertices();
401 TFaceEntryCoordsListMap GetAllCoordsByFace();
402 TCoordsEnfVertexMap GetAllEnforcedVerticesByCoords();
404 TFaceEntryEnfVertexEntryListMap GetAllEnfVertexEntriesByFace();
405 TEnfVertexEntryEnfVertexMap GetAllEnforcedVerticesByEnfVertexEntry();
407 void ClearAllEnforcedVertices();
410 * Set/get/unset an enforced vertex on geom face
412 boolean SetEnforcedVertex(in GEOM::GEOM_Object theFace, in double x, in double y, in double z) raises (SALOME::SALOME_Exception);
413 boolean SetEnforcedVertexNamed(in GEOM::GEOM_Object theFace, in double x, in double y, in double z, in TEnfName theVertexName) raises (SALOME::SALOME_Exception);
414 boolean SetEnforcedVertexGeom(in GEOM::GEOM_Object theFace, in GEOM::GEOM_Object theVertex) raises (SALOME::SALOME_Exception);
415 boolean SetEnforcedVertexWithGroup(in GEOM::GEOM_Object theFace, in double x, in double y, in double z, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
416 boolean SetEnforcedVertexNamedWithGroup(in GEOM::GEOM_Object theFace, in double x, in double y, in double z, in TEnfName theVertexName, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
417 boolean SetEnforcedVertexGeomWithGroup(in GEOM::GEOM_Object theFace, in GEOM::GEOM_Object theVertex, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
420 TEnfVertexList GetEnforcedVertices(in GEOM::GEOM_Object theFace) raises (SALOME::SALOME_Exception);
422 boolean UnsetEnforcedVertex(in GEOM::GEOM_Object theFace, in double x, in double y, in double z) raises (SALOME::SALOME_Exception);
423 boolean UnsetEnforcedVertexGeom(in GEOM::GEOM_Object theFace, in GEOM::GEOM_Object theVertex) raises (SALOME::SALOME_Exception);
424 boolean UnsetEnforcedVertices(in GEOM::GEOM_Object theFace) raises (SALOME::SALOME_Exception);
427 * Set/get/unset an enforced vertex on geom face given by entry
429 boolean SetEnforcedVertexEntry(in TEntry theFaceEntry, in double x, in double y, in double z,
430 in TEnfName theVertexName, in TEntry theVertexEntry, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
432 TEnfVertexList GetEnforcedVerticesEntry(in TEntry theFaceEntry) raises (SALOME::SALOME_Exception);
433 boolean UnsetEnforcedVertexEntry(in TEntry theFaceEntry, in double x, in double y, in double z, in TEntry theVertexEntry) raises (SALOME::SALOME_Exception);
434 // boolean UnsetEnforcedVertexEntryGeom(in TEntry theFaceEntry, in TEntry theVertexEntry) raises (SALOME::SALOME_Exception);
435 boolean UnsetEnforcedVerticesEntry(in TEntry theFaceEntry) raises (SALOME::SALOME_Exception);
438 * To get/set internal vertices as enforced vertices
440 void SetInternalEnforcedVertexAllFaces(in boolean toEnforceInternalVertices);
441 boolean GetInternalEnforcedVertexAllFaces();
442 void SetInternalEnforcedVertexAllFacesGroup(in TEnfGroupName groupName);
443 TEnfGroupName GetInternalEnforcedVertexAllFacesGroup();
445 // Enable internal enforced vertices on specific face if requested by user
446 // void SetInternalEnforcedVertex(in GEOM::GEOM_Object theFace,in boolean toEnforceInternalVertices) raises (SALOME::SALOME_Exception);
447 // void SetInternalEnforcedVertexWithGroup(in GEOM::GEOM_Object theFace, in boolean toEnforceInternalVertices, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
448 // void SetInternalEnforcedVertexEntry(in TEntry theFaceEntry, in boolean toEnforceInternalVertices, in TEnfGroupName groupName) raises (SALOME::SALOME_Exception);
449 // boolean GetInternalEnforcedVertex(in GEOM::GEOM_Object theFace) raises (SALOME::SALOME_Exception);
450 // boolean GetInternalEnforcedVertexEntry(in TEntry theFaceEntry) raises (SALOME::SALOME_Exception);
451 // TFaceEntryInternalVerticesList GetAllInternalEnforcedVerticesFaces();
452 ///////////////////////
455 ///////////////////////
457 ///////////////////////
459 void ClearPreCadPeriodicityVectors();
460 void AddPreCadFacesPeriodicity(in GEOM::GEOM_Object theFace1, in GEOM::GEOM_Object theFace2) raises (SALOME::SALOME_Exception);
461 void AddPreCadFacesPeriodicityWithVertices(in GEOM::GEOM_Object theFace1, in GEOM::GEOM_Object theFace2, in GEOM::ListOfGO theSourceVertices, in GEOM::ListOfGO theTargetVertices) raises (SALOME::SALOME_Exception);
462 void AddPreCadFacesPeriodicityEntry(in TEntry theFace1, in TEntry theFace2, in TEntryList theSourceVertices, in TEntryList theTargetVertices) raises (SALOME::SALOME_Exception);
463 void AddPreCadEdgesPeriodicity(in GEOM::GEOM_Object theEdge1, in GEOM::GEOM_Object theEdge2) raises (SALOME::SALOME_Exception);
464 void AddPreCadEdgesPeriodicityWithVertices(in GEOM::GEOM_Object theEdge1, in GEOM::GEOM_Object theEdge2, in GEOM::ListOfGO theSourceVertices, in GEOM::ListOfGO theTargetVertices) raises (SALOME::SALOME_Exception);
465 void AddPreCadEdgesPeriodicityEntry(in TEntry theEdge1, in TEntry theEdge2, in TEntryList theSourceVertices, in TEntryList theTargetVertices) raises (SALOME::SALOME_Exception);
466 TPeriodicityList GetPreCadFacesPeriodicityVector();
467 TPeriodicityList GetPreCadEdgesPeriodicityVector();
468 ///////////////////////
471 * Sets the file for export resulting mesh in GMF format
473 // void SetGMFFile(in string theFileName, in boolean isBinary);
474 void SetGMFFile(in string theFileName);
476 // boolean GetGMFFileMode();
479 // Obsolete methods - To be removed in V7
481 void SetPhyMin(in double theMinSize);
483 void SetPhyMax(in double theMaxSize);
485 void SetGeoMin(in double theMinSize);
487 void SetGeoMax(in double theMaxSize);
489 void SetAngleMeshS(in double angle);
490 double GetAngleMeshS();
491 void SetAngleMeshC(in double angle);
492 double GetAngleMeshC();
493 void SetDecimesh(in boolean toIgnoreEdges);
494 boolean GetDecimesh();
495 void SetPreCADRemoveNanoEdges(in boolean toRemoveNanoEdges);
496 boolean GetPreCADRemoveNanoEdges();
497 void SetPreCADEpsNano(in double epsNano);
498 double GetPreCADEpsNano();