SMESH_subMesh.hxx

Go to the documentation of this file.

// Copyright (C) 2007-2026  CEA, EDF, OPEN CASCADE
//
// Copyright (C) 2003-2007  OPEN CASCADE, EADS/CCR, LIP6, CEA/DEN,
// CEDRAT, EDF R&D, LEG, PRINCIPIA R&D, BUREAU VERITAS
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) any later version.
//
// This library is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307 USA
//
// See http://www.salome-platform.org/ or email : webmaster.salome@opencascade.com
//
 
//  File   : SMESH_subMesh.hxx
//  Author : Paul RASCLE, EDF
//  Module : SMESH
//
#ifndef _SMESH_SUBMESH_HXX_
#define _SMESH_SUBMESH_HXX_
 
#include "SMESH_SMESH.hxx"
 
#include "SMDS_Iterator.hxx"
#include "SMESH_ComputeError.hxx"
#include "SMESH_Algo.hxx"
 
#include "Utils_SALOME_Exception.hxx"
 
#include <TopoDS_Shape.hxx>
#include <TopTools_IndexedMapOfShape.hxx>
 
#include <list>
#include <map>
 
class SMESHDS_Mesh;
class SMESHDS_SubMesh;
class SMESH_Algo;
class SMESH_Gen;
class SMESH_Hypothesis;
class SMESH_Mesh;
class SMESH_subMesh;
class SMESH_subMeshEventListener;
struct SMESH_subMeshEventListenerData;
 
typedef SMESH_subMeshEventListener     EventListener;
typedef SMESH_subMeshEventListenerData EventListenerData;
 
typedef boost::shared_ptr< SMDS_Iterator<SMESH_subMesh*> > SMESH_subMeshIteratorPtr;
 
 
class SMESH_EXPORT SMESH_subMesh
{
 public:
  SMESH_subMesh(int                  Id,
                SMESH_Mesh *         father,
                SMESHDS_Mesh *       meshDS,
                const TopoDS_Shape & aSubShape);
  virtual ~ SMESH_subMesh();
 
  int GetId() const; // == meshDS->ShapeToIndex( aSubShape )
 
  SMESH_Mesh* GetFather() { return _father; }
 
  SMESHDS_SubMesh *       GetSubMeshDS();
  const SMESHDS_SubMesh * GetSubMeshDS() const;
 
  SMESHDS_SubMesh* CreateSubMeshDS();
  // Explicit SMESHDS_SubMesh creation method, required for persistence mechanism
 
  SMESH_subMesh *GetFirstToCompute();
 
  SMESH_Algo* GetAlgo() const;
  SMESH_Algo* CopyAlgo() const;
 
  const std::map < int, SMESH_subMesh * >& DependsOn();
  bool DependsOn( const SMESH_subMesh* other ) const;
  bool DependsOn( const int shapeID ) const;
  SMESH_subMeshIteratorPtr getDependsOnIterator(const bool includeSelf,
                                                const bool complexShapeFirst=false) const;
 
  const std::vector< SMESH_subMesh * > & GetAncestors() const;
  void ClearAncestors();
 
  const TopoDS_Shape & GetSubShape() const;
 
  enum compute_state
  {
    NOT_READY, READY_TO_COMPUTE, COMPUTE_OK, FAILED_TO_COMPUTE
  };
  enum algo_state
  {
    NO_ALGO, MISSING_HYP, HYP_OK
  };
  enum algo_event
  {
    ADD_HYP          , ADD_ALGO,
    REMOVE_HYP       , REMOVE_ALGO,
    ADD_FATHER_HYP   , ADD_FATHER_ALGO,
    REMOVE_FATHER_HYP, REMOVE_FATHER_ALGO,
    MODIF_HYP
  };
  enum compute_event
  {
    MODIF_ALGO_STATE, COMPUTE, COMPUTE_SUBMESH, COMPUTE_NOGEOM, COMPUTE_CANCELED,
    CLEAN, SUBMESH_COMPUTED, SUBMESH_RESTORED, SUBMESH_LOADED,
    MESH_ENTITY_REMOVED, CHECK_COMPUTE_STATE
  };
  enum event_type
  {
    ALGO_EVENT, COMPUTE_EVENT
  };
 
  // ==================================================================
  // Members to track non hierarchical dependencies between sub-meshes
  // ==================================================================
 
  void SetEventListener(EventListener*     listener,
                        EventListenerData* data,
                        SMESH_subMesh*     where);
 
  void AddOwnListener(EventListener* listener);
 
  EventListenerData* GetEventListenerData(EventListener* listener,
                                          const bool     myOwn=false) const;
 
  EventListenerData* GetEventListenerData(const std::string& listenerName,
                                          const bool         myOwn=false) const;
 
  void DeleteEventListener(EventListener* listener);
 
protected:
 
  std::map< EventListener*, EventListenerData* > _eventListeners;
 
  struct OwnListenerData {
    SMESH_subMesh* mySubMesh;
    int            myMeshID; // id of mySubMesh->GetFather()
    int            mySubMeshID;
    EventListener* myListener;
    OwnListenerData( SMESH_subMesh* sm=0, EventListener* el=0);
  };
  std::list< OwnListenerData >                    _ownListeners;
 
  void setEventListener(EventListener* listener, EventListenerData* data);
 
  void notifyListenersOnEvent( const int         event,
                               const event_type  eventType,
                               SMESH_Hypothesis* hyp = 0);
 
  void deleteOwnListeners();
 
  void loadDependentMeshes();
 
  // END: Members to track non hierarchical dependencies between submeshes
  // =====================================================================
 
public:
 
  SMESH_Hypothesis::Hypothesis_Status
    AlgoStateEngine(algo_event event, SMESH_Hypothesis * anHyp);
 
  SMESH_Hypothesis::Hypothesis_Status
    SubMeshesAlgoStateEngine(algo_event event, SMESH_Hypothesis * anHyp, bool exitOnFatal=false);
 
  algo_state             GetAlgoState() const    { return _algoState; }
  compute_state          GetComputeState() const { return _computeState; }
  SMESH_ComputeErrorPtr& GetComputeError()       { return _computeError; }
 
  void DumpAlgoState(bool isMain);
 
  bool ComputeStateEngine(compute_event event);
  void ComputeSubMeshStateEngine(compute_event event, const bool includeSelf=false);
 
  bool Evaluate(MapShapeNbElems& aResMap);
 
  bool IsConform(const SMESH_Algo* theAlgo);
  // check if a conform mesh will be produced by the Algo
 
  bool CanAddHypothesis(const SMESH_Hypothesis* theHypothesis) const;
  // return true if theHypothesis can be attached to me:
  // its dimension is checked
 
  static bool IsApplicableHypothesis(const SMESH_Hypothesis* theHypothesis,
                                    const TopAbs_ShapeEnum  theShapeType);
 
  bool IsApplicableHypothesis(const SMESH_Hypothesis* theHypothesis) const;
  // return true if theHypothesis can be used to mesh me:
  // its shape type is checked
 
  SMESH_Hypothesis::Hypothesis_Status CheckConcurrentHypothesis (SMESH_Hypothesis* theHypothesis);
  // check if there are several applicable hypothesis on fathers
 
  bool IsEmpty() const;
 
  bool IsMeshComputed() const;
  // check if _subMeshDS contains mesh elements unless _alwaysComputed==true
 
  bool IsComputedPartially() const;
  // check if any upper level sub-shape is not computed
 
  void SetAllowedSubShapes( const TopTools_IndexedMapOfShape* subShapes )
  { _allowedSubShapes = subShapes; }
 
  void SetIsAlwaysComputed(bool isAlCo);
  bool IsAlwaysComputed() const { return _alwaysComputed; }
 
  bool SubMeshesComputed(bool * isFailedToCompute=0) const;
 
  int GetComputeCost() const;
  // how costly is to compute this sub-mesh
 
  bool FindIntersection( const SMESH_subMesh *           theOther,
                         std::set<const SMESH_subMesh*>& theSetOfCommon ) const;
 
protected:
  // ==================================================================
  void insertDependence(const TopoDS_Shape aShape,
                        TopAbs_ShapeEnum   aSubType,
                        TopAbs_ShapeEnum   avoidType=TopAbs_SHAPE);
 
  void removeSubMeshElementsAndNodes();
  void updateDependantsState(const compute_event theEvent);
  void updateSubMeshState(const compute_state theState);
  void cleanDependants();
  void cleanDependsOn( SMESH_Algo* algoRequiringCleaning=0 );
  void setAlgoState(algo_state state);
 
  TopoDS_Shape getCollection(SMESH_Gen * theGen,
                             SMESH_Algo* theAlgo,
                             bool &      theSubComputed,
                             bool &      theSubFailed,
                             std::vector<SMESH_subMesh*>& theSubs);
  bool checkComputeError(SMESH_Algo*         theAlgo,
                         const bool          theComputeOK,
                         const TopoDS_Shape& theShape=TopoDS_Shape());
 
  const SMESH_Hypothesis* getSimilarAttached(const TopoDS_Shape&      theShape,
                                             const SMESH_Hypothesis * theHyp,
                                             const int                theHypType = 0);
  //
  int computeCost() const;
 
protected:
 
  TopoDS_Shape          _subShape;
  SMESHDS_SubMesh *     _subMeshDS;
  SMESH_Mesh *          _father;
  int                   _Id;
 
  std::map < int, SMESH_subMesh * >_mapDepend;
  bool                             _dependenceAnalysed;
  std::vector< SMESH_subMesh * >   _ancestors;
 
  SMESH_Algo *          _algo; // the algorithm found by last *StateEngine() call
  TopoDS_Shape          _algoShape; // shape the algorithm is assigned to
  algo_state            _algoState;
  compute_state         _computeState;
  SMESH_ComputeErrorPtr _computeError;
  int                   _computeCost;     // how costly is to compute this sub-mesh
  int                   _realComputeCost; // _computeCost depending on presence of needed hypotheses
 
  // allow algo->Compute() if a sub-shape of lower dim is meshed but
  // none mesh entity is bound to it. Eg StdMeshers_CompositeSegment_1D can
  // mesh several edges as a whole and leave some of them  without mesh entities
  bool                  _alwaysComputed;
 
  const TopTools_IndexedMapOfShape* _allowedSubShapes; // allowed to be returned by getCollection()
 
};
 
#endif