idl/SMESH_Gen.idl

   1 // Copyright (C) 2007-2012  CEA/DEN, EDF R&D, OPEN CASCADE
   2 //
   3 // Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
   4 // CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
   5 //
   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.
  10 //
  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.
  15 //
  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
  19 //
  20 // See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
  21 //
  22 //  File   : SMESH_Gen.idl
  23 //  Author : Paul RASCLE, EDF
  24
  25 #ifndef _SMESH_GEN_IDL_
  26 #define _SMESH_GEN_IDL_
  27
  28 #include "SALOME_Exception.idl"
  29 #include "SALOME_Component.idl"
  30 #include "SALOMEDS.idl"
  31
  32 #include "GEOM_Gen.idl"
  33
  34 #include "SMESH_Mesh.idl"
  35 #include "SMESH_Hypothesis.idl"
  36
  37 module SMESH
  38 {
  39   typedef sequence<GEOM::GEOM_Object> object_array;
  40   typedef sequence<SMESH_Mesh>        mesh_array;
  41
  42   interface FilterManager;
  43   interface SMESH_Pattern;
  44   interface Measurements;
  45
  46   /*!
  47    * Tags definition
  48    */
  49   // Top level
  50   const long Tag_HypothesisRoot = 1; // hypotheses root
  51   const long Tag_AlgorithmsRoot = 2; // algorithms root
  52   const long Tag_FirstMeshRoot  = 3; // first mesh root
  53   // Mesh/Submesh
  54   const long Tag_RefOnShape             = 1; // references to shape
  55   const long Tag_RefOnAppliedHypothesis = 2; // applied hypotheses root
  56   const long Tag_RefOnAppliedAlgorithms = 3; // applied algorithms root
  57   // Mesh only: sub-meshes roots by type
  58   const long Tag_FirstSubMesh           =  4;
  59   const long Tag_SubMeshOnVertex        =  4;
  60   const long Tag_SubMeshOnEdge          =  5;
  61   const long Tag_SubMeshOnWire          =  6;
  62   const long Tag_SubMeshOnFace          =  7;
  63   const long Tag_SubMeshOnShell         =  8;
  64   const long Tag_SubMeshOnSolid         =  9;
  65   const long Tag_SubMeshOnCompound      = 10;
  66   const long Tag_LastSubMesh            = 10;
  67   // Mesh only: group roots by type
  68   const long Tag_FirstGroup             = 11;
  69   const long Tag_NodeGroups             = 11;
  70   const long Tag_EdgeGroups             = 12;
  71   const long Tag_FaceGroups             = 13;
  72   const long Tag_VolumeGroups           = 14;
  73   const long Tag_0DElementsGroups       = 15;
  74   const long Tag_BallElementsGroups     = 16;
  75   const long Tag_LastGroup              = 16;
  76
  77   /*!
  78    * Hypothesis definintion error
  79    */
  80   struct AlgoStateError
  81   {
  82     Hypothesis_Status  state;
  83     string             algoName;
  84     long               algoDim;
  85     boolean            isGlobalAlgo;
  86   };
  87   typedef sequence<AlgoStateError> algo_error_array;
  88
  89   /*!
  90    * Mesh computation error
  91    */
  92   enum ComputeErrorName
  93   {
  94     COMPERR_OK            ,
  95     COMPERR_BAD_INPUT_MESH,  // wrong mesh on lower submesh
  96     COMPERR_STD_EXCEPTION ,  // some std exception raised
  97     COMPERR_OCC_EXCEPTION ,  // OCC exception raised
  98     COMPERR_SLM_EXCEPTION ,  // SALOME exception raised
  99     COMPERR_EXCEPTION     ,  // other exception raised
 100     COMPERR_MEMORY_PB     ,  // memory allocation problem
 101     COMPERR_ALGO_FAILED   ,  // computation failed
 102     COMPERR_BAD_SHAPE     ,  // bad geometry
 103     COMPERR_WARNING       ,  // algo reports error but sub-mesh is computed anyway
 104     COMPERR_CANCELED      ,  // compute canceled
 105     COMPERR_NO_MESH_ON_SHAPE // no mesh elements assigned to sub-mesh
 106   };
 107   struct ComputeError
 108   {
 109     short   code;       // ComputeErrorName or, if negative, algo specific code
 110     string  comment;    // textual problem description
 111     string  algoName;
 112     short   subShapeID; // id of sub-shape of a shape to mesh
 113     boolean hasBadMesh; // there are elements preventing computation available for visualization
 114   };
 115   typedef sequence<ComputeError> compute_error_array;
 116
 117
 118   interface SMESH_Gen : Engines::EngineComponent, SALOMEDS::Driver
 119   {
 120     //GEOM::GEOM_Gen SetGeomEngine( in string containerLoc );
 121     void SetGeomEngine( in GEOM::GEOM_Gen geomcompo );
 122
 123     FilterManager CreateFilterManager();
 124
 125     SMESH_Pattern GetPattern();
 126
 127     Measurements  CreateMeasurements();
 128
 129     /*!
 130       Set the current mode
 131      */
 132     void SetEmbeddedMode( in boolean theMode );
 133
 134     /*!
 135       Get the current mode
 136      */
 137     boolean IsEmbeddedMode();
 138
 139     /*!
 140       Set the current study
 141      */
 142     void SetCurrentStudy( in SALOMEDS::Study theStudy );
 143
 144     /*!
 145       Get the current study
 146      */
 147     SALOMEDS::Study GetCurrentStudy();
 148
 149     /*!
 150      * Create a hypothesis that can be shared by differents parts of the mesh.
 151      * An hypothesis is either:
 152      * - a method used to generate or modify a part of the mesh (algorithm).
 153      * - a parameter or a law used by an algorithm.
 154      * Algorithms are 1D, 2D or 3D.
 155      */
 156     SMESH_Hypothesis CreateHypothesis( in string theHypName,
 157                                        in string theLibName )
 158       raises ( SALOME::SALOME_Exception );
 159
 160     /*!
 161      * Return a hypothesis holding parameter values corresponding either to the mesh
 162      * existing on the given geometry or to size of the geometry.
 163      * The returned hypothesis may be the one existing in a study and used
 164      * to compute the mesh, or a temporary one created just to pass parameter
 165      * values.
 166      */
 167     SMESH_Hypothesis GetHypothesisParameterValues( in string            theHypName,
 168                                                    in string            theLibName,
 169                                                    in SMESH_Mesh        theMesh,
 170                                                    in GEOM::GEOM_Object theGeom,
 171                                                    in boolean           byMesh)
 172       raises ( SALOME::SALOME_Exception );
 173
 174     /*!
 175      * Sets number of segments per diagonal of boundary box of geometry by which
 176      * default segment length of appropriate 1D hypotheses is defined
 177      */
 178     void SetBoundaryBoxSegmentation( in long theNbSegments ) raises ( SALOME::SALOME_Exception );
 179     /*!
 180      * \brief Sets default number of segments per edge
 181      */
 182     void SetDefaultNbSegments( in long theNbSegments) raises ( SALOME::SALOME_Exception );
 183
 184     /*!
 185      * Set the object name
 186      */
 187     void SetName( in string theObjectIOR,
 188                   in string theObjectName )
 189       raises ( SALOME::SALOME_Exception );
 190
 191     /*!
 192      * Create a Mesh object, given a geometry shape.
 193      * Mesh is created empty (no points, no elements).
 194      * Shape is explored via GEOM_Client to create local copies.
 195      * of TopoDS_Shapes and bind CORBA references of shape & subshapes
 196      * with TopoDS_Shapes
 197      */
 198     SMESH_Mesh CreateMesh( in GEOM::GEOM_Object theObject )
 199       raises ( SALOME::SALOME_Exception );
 200
 201     /*!
 202      * Create an empty mesh object
 203      */
 204     SMESH_Mesh CreateEmptyMesh()
 205       raises ( SALOME::SALOME_Exception );
 206
 207     /*!
 208      * Create Mesh object importing data from given UNV file
 209      * (UNV supported version is I-DEAS 10)
 210      */
 211     SMESH_Mesh CreateMeshesFromUNV( in string theFileName )
 212       raises ( SALOME::SALOME_Exception );
 213
 214     /*!
 215      * Create Mesh object(s) importing data from given MED file
 216      */
 217      mesh_array CreateMeshesFromMED( in string theFileName,
 218                                      out SMESH::DriverMED_ReadStatus theStatus )
 219        raises ( SALOME::SALOME_Exception );
 220
 221     /*!
 222      * Create Mesh object(s) importing data from given MED file
 223      */
 224      mesh_array CreateMeshesFromSAUV( in string theFileName,
 225                                       out SMESH::DriverMED_ReadStatus theStatus )
 226        raises ( SALOME::SALOME_Exception );
 227
 228     /*!
 229      * Create Mesh object importing data from given STL file
 230      */
 231     SMESH_Mesh CreateMeshesFromSTL( in string theFileName )
 232       raises ( SALOME::SALOME_Exception );
 233
 234     /*!
 235      * Create Mesh object(s) importing data from given CGNS file
 236      */
 237     mesh_array CreateMeshesFromCGNS( in string theFileName,
 238                                      out SMESH::DriverMED_ReadStatus theStatus )
 239       raises ( SALOME::SALOME_Exception );
 240
 241     /*!
 242      * Create Mesh object importing data from given GMF file
 243      */
 244     SMESH_Mesh CreateMeshesFromGMF( in string               theFileName,
 245                                     out SMESH::ComputeError theError)
 246       raises ( SALOME::SALOME_Exception );
 247
 248     /*!
 249      * Create a mesh by copying a part of another mesh
 250      *  \param meshPart - a part of mesh to copy
 251      *  \param meshName - a name of the new mesh
 252      *  \param toCopyGroups - to create in the new mesh groups
 253      *                        the copied elements belongs to
 254      *  \param toKeepIDs - to preserve IDs of the copied elements or not
 255      */
 256     SMESH_Mesh CopyMesh(in SMESH_IDSource meshPart,
 257                         in string         meshName,
 258                         in boolean        toCopyGroups,
 259                         in boolean        toKeepIDs)
 260       raises ( SALOME::SALOME_Exception );
 261
 262     /*!
 263      * Concatenate the given meshes into one mesh.
 264      * Union groups with the same name and type if
 265      * theUniteIdenticalGroups flag is true.
 266      * Merge coincident nodes and elements if
 267      * theMergeNodesAndElements flag is true.
 268      */
 269     SMESH_Mesh Concatenate(in mesh_array theMeshesArray,
 270                            in boolean    theUniteIdenticalGroups,
 271                            in boolean    theMergeNodesAndElements,
 272                            in double     theMergeTolerance)
 273       raises ( SALOME::SALOME_Exception );
 274
 275     /*!
 276      * Concatenate the given meshes into one mesh.
 277      * Union groups with the same name and type if
 278      * theUniteIdenticalGroups flag is true.
 279      * Merge coincident nodes and elements if
 280      * theMergeNodesAndElements flag is true.
 281      * Create the groups of all elements from initial meshes.
 282      */
 283     SMESH_Mesh ConcatenateWithGroups(in mesh_array theMeshesArray,
 284                                      in boolean    theUniteIdenticalGroups,
 285                                      in boolean    theMergeNodesAndElements,
 286                                      in double     theMergeTolerance)
 287       raises ( SALOME::SALOME_Exception );
 288
 289     /*!
 290      * Mesh a subShape.
 291      * First, verify list of hypothesis associated with the Sub-shape,
 292      * return NOK if hypothesis are not sufficient
 293      */
 294     boolean Compute( in SMESH_Mesh        theMesh,
 295                      in GEOM::GEOM_Object theSubObject )
 296       raises ( SALOME::SALOME_Exception );
 297
 298     /*!
 299      * Cancel a computation.
 300      */
 301     void CancelCompute( in SMESH_Mesh        theMesh,
 302                         in GEOM::GEOM_Object theSubObject );
 303
 304     /*!
 305      * Return true if hypotheses are defined well
 306      */
 307     boolean IsReadyToCompute( in SMESH_Mesh        theMesh,
 308                               in GEOM::GEOM_Object theSubObject )
 309       raises ( SALOME::SALOME_Exception );
 310
 311     /*!
 312      * Evaluates size of prospective mesh on a shape
 313      */
 314     long_array  Evaluate(in SMESH_Mesh        theMesh,
 315                          in GEOM::GEOM_Object theSubObject)
 316       raises ( SALOME::SALOME_Exception );
 317
 318     /*!
 319      * Calculate Mesh as preview till indicated dimension
 320      * First, verify list of hypothesis associated with the Sub-shape.
 321      * Return mesh preview structure
 322      */
 323     MeshPreviewStruct Precompute( in SMESH_Mesh        theMesh,
 324                                   in GEOM::GEOM_Object theSubObject,
 325                                   in Dimension         theDimension,
 326                                   inout long_array    theShapesId )
 327       raises ( SALOME::SALOME_Exception );
 328
 329     /*!
 330      * Return errors of hypotheses definintion
 331      * algo_error_array is empty if everything is OK
 332      */
 333     algo_error_array GetAlgoState( in SMESH_Mesh        theMesh,
 334                                    in GEOM::GEOM_Object theSubObject )
 335       raises ( SALOME::SALOME_Exception );
 336
 337     /*!
 338      * Return errors of mesh computation
 339      * compute_error_array is empty if everything is OK
 340      */
 341     compute_error_array GetComputeErrors( in SMESH_Mesh        theMesh,
 342                                           in GEOM::GEOM_Object theSubObject )
 343       raises ( SALOME::SALOME_Exception );
 344
 345     /*!
 346      * Return mesh elements preventing computation of a sub-shape
 347      */
 348     MeshPreviewStruct GetBadInputElements( in SMESH_Mesh theMesh,
 349                                            in short      theSubShapeID )
 350       raises ( SALOME::SALOME_Exception );
 351
 352     /*!
 353      * Return indeces of faces, edges and vertices of given sub-shapes
 354      * within theMainObject
 355      */
 356     long_array GetSubShapesId( in GEOM::GEOM_Object theMainObject,
 357                                in object_array      theListOfSubObjects )
 358        raises ( SALOME::SALOME_Exception );
 359
 360     /*!
 361      * Return geometrical object the given element is built on.
 362      * The returned geometrical object, if not nil, is either found in the
 363      * study or is published by this method with the given name
 364      */
 365     GEOM::GEOM_Object GetGeometryByMeshElement( in SMESH_Mesh  theMesh,
 366                                                 in long        theElementID,
 367                                                 in string      theGeomName)
 368       raises ( SALOME::SALOME_Exception );
 369
 370     /*!
 371      * Return geometrical object the given element is built on.
 372      * The returned geometrical object not published in study by this method.
 373      */
 374     GEOM::GEOM_Object FindGeometryByMeshElement( in SMESH_Mesh  theMesh,
 375                                                  in long        theElementID)
 376       raises ( SALOME::SALOME_Exception );
 377
 378     /*!
 379      * \brief Return id of object, registered in current study context
 380      *
 381      * Can be used to check if the object was created in the same container, as this engine.
 382      */
 383     long GetObjectId(in Object theObject);
 384
 385     /*!
 386      * \brief Get MED version of the file by its name.
 387      */
 388     boolean GetMEDVersion(in string theFileName, out MED_VERSION theVersion);
 389
 390     /*!
 391      * \brief Get names of meshes defined in file with the specified name.
 392      */
 393     string_array GetMeshNames(in string theFileName);
 394   };
 395
 396 };
 397
 398 #endif