src/SMESH/SMESH_subMesh.hxx

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