src/SMESH/SMESH_subMesh.hxx

   1 //  Copyright (C) 2007-2010  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
  23 //  SMESH SMESH : implementaion of SMESH idl descriptions
  24 //  File   : SMESH_subMesh.hxx
  25 //  Author : Paul RASCLE, EDF
  26 //  Module : SMESH
  27 //
  28 #ifndef _SMESH_SUBMESH_HXX_
  29 #define _SMESH_SUBMESH_HXX_
  30
  31 #include "SMESH_SMESH.hxx"
  32
  33 #include "SMESHDS_Mesh.hxx"
  34 #include "SMESHDS_SubMesh.hxx"
  35 #include "SMESH_Hypothesis.hxx"
  36 #include "SMESH_ComputeError.hxx"
  37 #include "SMESH_Algo.hxx"
  38
  39 #include "Utils_SALOME_Exception.hxx"
  40
  41 #include <TopoDS_Shape.hxx>
  42
  43 #include <list>
  44 #include <map>
  45
  46 class SMESH_Mesh;
  47 class SMESH_Hypothesis;
  48 class SMESH_Algo;
  49 class SMESH_Gen;
  50 class SMESH_subMeshEventListener;
  51 class SMESH_subMeshEventListenerData;
  52 class SMESH_subMesh;
  53
  54 typedef SMESH_subMeshEventListener     EventListener;
  55 typedef SMESH_subMeshEventListenerData EventListenerData;
  56
  57 typedef boost::shared_ptr< SMDS_Iterator<SMESH_subMesh*> > SMESH_subMeshIteratorPtr;
  58
  59
  60 class SMESH_EXPORT SMESH_subMesh
  61 {
  62  public:
  63   SMESH_subMesh(int Id, SMESH_Mesh * father, SMESHDS_Mesh * meshDS,
  64                 const TopoDS_Shape & aSubShape);
  65   virtual ~ SMESH_subMesh();
  66
  67   int GetId() const;
  68
  69   SMESH_Mesh* GetFather() { return _father; }
  70
  71   SMESHDS_SubMesh * GetSubMeshDS();
  72
  73   SMESHDS_SubMesh* CreateSubMeshDS();
  74   // Explicit SMESHDS_SubMesh creation method, required for persistence mechanism
  75
  76   SMESH_subMesh *GetFirstToCompute();
  77
  78   const std::map < int, SMESH_subMesh * >& DependsOn();
  79   //const map < int, SMESH_subMesh * >&Dependants();
  80   /*!
  81    * \brief Return iterator on the submeshes this one depends on
  82    */
  83   SMESH_subMeshIteratorPtr getDependsOnIterator(const bool includeSelf,
  84                                                 const bool complexShapeFirst);
  85
  86   const TopoDS_Shape & GetSubShape() const;
  87
  88   enum compute_state
  89   {
  90     NOT_READY, READY_TO_COMPUTE,
  91     COMPUTE_OK, FAILED_TO_COMPUTE
  92     };
  93   enum algo_state
  94   {
  95     NO_ALGO, MISSING_HYP, HYP_OK
  96     };
  97   enum algo_event
  98   {
  99     ADD_HYP          , ADD_ALGO,
 100     REMOVE_HYP       , REMOVE_ALGO,
 101     ADD_FATHER_HYP   , ADD_FATHER_ALGO,
 102     REMOVE_FATHER_HYP, REMOVE_FATHER_ALGO,
 103     MODIF_HYP
 104     };
 105   enum compute_event
 106   {
 107     MODIF_ALGO_STATE, COMPUTE,
 108     CLEAN, SUBMESH_COMPUTED, SUBMESH_RESTORED,
 109     MESH_ENTITY_REMOVED, CHECK_COMPUTE_STATE
 110     };
 111   enum event_type
 112   {
 113     ALGO_EVENT, COMPUTE_EVENT
 114   };
 115
 116   // ==================================================================
 117   // Members to track non hierarchical dependencies between submeshes
 118   // ==================================================================
 119
 120   /*!
 121    * \brief Sets an event listener and its data to a submesh
 122     * \param listener - the listener to store
 123     * \param data - the listener data to store
 124     * \param where - the submesh to store the listener and it's data
 125    *
 126    * The method remembers the submesh \awhere it puts the listener in order to delete
 127    * them when HYP_OK algo_state is lost
 128    * After being set, event listener is notified on each event of \awhere submesh.
 129    */
 130   void SetEventListener(EventListener*     listener,
 131                         EventListenerData* data,
 132                         SMESH_subMesh*     where);
 133
 134   /*!
 135    * \brief Return an event listener data
 136     * \param listener - the listener whose data is
 137     * \retval EventListenerData* - found data, maybe NULL
 138    */
 139   EventListenerData* GetEventListenerData(EventListener* listener) const;
 140
 141   /*!
 142    * \brief Unregister the listener and delete it and it's data
 143     * \param listener - the event listener to delete
 144    */
 145   void DeleteEventListener(EventListener* listener);
 146
 147 protected:
 148
 149   //!< event listeners to notify
 150   std::map< EventListener*, EventListenerData* >           myEventListeners;
 151   //!< event listeners to delete when HYP_OK algo_state is lost
 152   std::list< std::pair< SMESH_subMesh*, EventListener* > > myOwnListeners;
 153
 154   /*!
 155    * \brief Sets an event listener and its data to a submesh
 156     * \param listener - the listener to store
 157     * \param data - the listener data to store
 158    *
 159    * After being set, event listener is notified on each event of a submesh.
 160    */
 161   void SetEventListener(EventListener* listener, EventListenerData* data);
 162
 163   /*!
 164    * \brief Notify stored event listeners on the occured event
 165    * \param event - algo_event or compute_event itself
 166    * \param eventType - algo_event or compute_event
 167    * \param hyp - hypothesis, if eventType is algo_event
 168    */
 169   void NotifyListenersOnEvent( const int         event,
 170                                const event_type  eventType,
 171                                SMESH_Hypothesis* hyp = 0);
 172
 173   /*!
 174    * \brief Delete event listeners depending on algo of this submesh
 175    */
 176   void DeleteOwnListeners();
 177
 178   // ==================================================================
 179
 180 public:
 181
 182   SMESH_Hypothesis::Hypothesis_Status
 183     AlgoStateEngine(int event, SMESH_Hypothesis * anHyp);
 184
 185   SMESH_Hypothesis::Hypothesis_Status
 186     SubMeshesAlgoStateEngine(int event, SMESH_Hypothesis * anHyp);
 187
 188   int GetAlgoState() const { return _algoState; }
 189   int GetComputeState() const { return _computeState; };
 190   SMESH_ComputeErrorPtr& GetComputeError() { return _computeError; }
 191
 192   void DumpAlgoState(bool isMain);
 193
 194   bool ComputeStateEngine(int event);
 195   void ComputeSubMeshStateEngine(int event);
 196
 197   bool Evaluate(MapShapeNbElems& aResMap);
 198
 199   bool IsConform(const SMESH_Algo* theAlgo);
 200   // check if a conform mesh will be produced by the Algo
 201
 202   bool CanAddHypothesis(const SMESH_Hypothesis* theHypothesis) const;
 203   // return true if theHypothesis can be attached to me:
 204   // its dimention is checked
 205
 206   static bool IsApplicableHypotesis(const SMESH_Hypothesis* theHypothesis,
 207                                     const TopAbs_ShapeEnum  theShapeType);
 208
 209   bool IsApplicableHypotesis(const SMESH_Hypothesis* theHypothesis) const
 210   { return IsApplicableHypotesis( theHypothesis, _subShape.ShapeType() ); }
 211   // return true if theHypothesis can be used to mesh me:
 212   // its shape type is checked
 213
 214   SMESH_Hypothesis::Hypothesis_Status CheckConcurentHypothesis (const int theHypType);
 215   // check if there are several applicable hypothesis on fathers
 216
 217   /*!
 218    * \brief Return true if no mesh entities is bound to the submesh
 219    */
 220   bool IsEmpty() const;
 221
 222   bool IsMeshComputed() const;
 223   // check if _subMeshDS contains mesh elements
 224
 225   /*!
 226    * \brief Allow algo->Compute() if a subshape of lower dim is meshed but
 227    *        none mesh entity is bound to it
 228    */
 229   void SetIsAlwaysComputed(bool isAlCo);
 230   bool IsAlwaysComputed() { return _alwaysComputed; }
 231
 232
 233   /*!
 234    * \brief  Find common submeshes (based on shared subshapes with other
 235    * \param theOther submesh to check
 236    * \param theCommonIds set of common submesh IDs
 237    * NOTE: this method does not cleat set before collect common IDs
 238    */
 239   bool FindIntersection( const SMESH_subMesh *           theOther,
 240                          std::set<const SMESH_subMesh*>& theSetOfCommon ) const;
 241
 242 protected:
 243   // ==================================================================
 244   void InsertDependence(const TopoDS_Shape aSubShape);
 245
 246   bool SubMeshesComputed();
 247
 248   bool SubMeshesReady();
 249
 250   void RemoveSubMeshElementsAndNodes();
 251   void UpdateDependantsState(const compute_event theEvent);
 252   void UpdateSubMeshState(const compute_state theState);
 253   void CleanDependants();
 254   void CleanDependsOn();
 255   void SetAlgoState(int state);
 256
 257   /*!
 258    * \brief Return a shape containing all sub-shapes of the MainShape that can be
 259    * meshed at once along with _subShape
 260    */
 261   TopoDS_Shape GetCollection(SMESH_Gen * theGen,
 262                              SMESH_Algo* theAlgo,
 263                              bool &      theSubComputed);
 264
 265   /*!
 266    * \brief Apply theAlgo to all subshapes in theCollection
 267    */
 268   bool ApplyToCollection (SMESH_Algo*         theAlgo,
 269                           const TopoDS_Shape& theCollection);
 270
 271   /*!
 272    * \brief Update compute_state by _computeError
 273     * \retval bool - false if there are errors
 274    */
 275   bool CheckComputeError(SMESH_Algo* theAlgo, const TopoDS_Shape& theShape=TopoDS_Shape());
 276
 277   /*!
 278    * \brief Return a hypothesis attached to theShape.
 279    *
 280    * If theHyp is provided, similar but not same hypotheses
 281    * is returned; else an applicable ones having theHypType
 282    * is returned
 283    */
 284   const SMESH_Hypothesis* GetSimilarAttached(const TopoDS_Shape&      theShape,
 285                                              const SMESH_Hypothesis * theHyp,
 286                                              const int                theHypType = 0);
 287   //
 288
 289 protected:
 290
 291   TopoDS_Shape          _subShape;
 292   SMESHDS_SubMesh *     _subMeshDS;
 293   SMESH_Mesh *          _father;
 294   int                   _Id;
 295
 296   std::map < int, SMESH_subMesh * >_mapDepend;
 297   bool                  _dependenceAnalysed;
 298
 299   int                   _algoState;
 300   int                   _computeState;
 301   SMESH_ComputeErrorPtr _computeError;
 302
 303   // allow algo->Compute() if a subshape of lower dim is meshed but
 304   // none mesh entity is bound to it. Eg StdMeshers_CompositeSegment_1D can
 305   // mesh several edges as a whole and leave some of them  without mesh entities
 306   bool                  _alwaysComputed;
 307
 308 };
 309
 310 #endif