src/SMDS/SMDS_Mesh.hxx

   1 //  SMESH SMDS : implementaion of Salome mesh data structure
   2 //
   3 //  Copyright (C) 2003  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.opencascade.org/SALOME/ or email : webmaster.salome@opencascade.org
  21 //
  22 //
  23 //
  24 //  File   : SMDS_Mesh.hxx
  25 //  Module : SMESH
  26
  27 #ifndef _SMDS_Mesh_HeaderFile
  28 #define _SMDS_Mesh_HeaderFile
  29
  30 #include "SMDS_MeshNode.hxx"
  31 #include "SMDS_MeshEdge.hxx"
  32 #include "SMDS_MeshFace.hxx"
  33 #include "SMDS_MeshVolume.hxx"
  34 #include "SMDS_MeshElementIDFactory.hxx"
  35 #include "SMDS_ElemIterator.hxx"
  36 #include <NCollection_Map.hxx>
  37
  38 #include <boost/shared_ptr.hpp>
  39 #include <set>
  40 #include <list>
  41
  42 typedef SMDS_Iterator<const SMDS_MeshNode *> SMDS_NodeIterator;
  43 typedef boost::shared_ptr<SMDS_Iterator<const SMDS_MeshNode *> > SMDS_NodeIteratorPtr;
  44 typedef SMDS_Iterator<const SMDS_MeshEdge *> SMDS_EdgeIterator;
  45 typedef boost::shared_ptr<SMDS_Iterator<const SMDS_MeshEdge *> > SMDS_EdgeIteratorPtr;
  46 typedef SMDS_Iterator<const SMDS_MeshFace *> SMDS_FaceIterator;
  47 typedef boost::shared_ptr<SMDS_Iterator<const SMDS_MeshFace *> > SMDS_FaceIteratorPtr;
  48 typedef SMDS_Iterator<const SMDS_MeshVolume *> SMDS_VolumeIterator;
  49 typedef boost::shared_ptr<SMDS_Iterator<const SMDS_MeshVolume *> > SMDS_VolumeIteratorPtr;
  50
  51 class SMDS_Mesh:public SMDS_MeshObject{
  52 public:
  53
  54   SMDS_Mesh();
  55
  56   SMDS_NodeIteratorPtr nodesIterator() const;
  57   SMDS_EdgeIteratorPtr edgesIterator() const;
  58   SMDS_FaceIteratorPtr facesIterator() const;
  59   SMDS_VolumeIteratorPtr volumesIterator() const;
  60   SMDS_ElemIteratorPtr elementsIterator() const;
  61
  62   SMDS_Mesh *AddSubMesh();
  63
  64   virtual SMDS_MeshNode* AddNodeWithID(double x, double y, double z, int ID);
  65   virtual SMDS_MeshNode* AddNode(double x, double y, double z);
  66
  67   virtual SMDS_MeshEdge* AddEdgeWithID(int n1, int n2, int ID);
  68   virtual SMDS_MeshEdge* AddEdgeWithID(const SMDS_MeshNode * n1,
  69                                        const SMDS_MeshNode * n2,
  70                                        int ID);
  71   virtual SMDS_MeshEdge* AddEdge(const SMDS_MeshNode * n1,
  72                                  const SMDS_MeshNode * n2);
  73
  74   virtual SMDS_MeshFace* AddFaceWithID(int n1, int n2, int n3, int ID);
  75   virtual SMDS_MeshFace* AddFaceWithID(const SMDS_MeshNode * n1,
  76                                        const SMDS_MeshNode * n2,
  77                                        const SMDS_MeshNode * n3,
  78                                        int ID);
  79   virtual SMDS_MeshFace* AddFace(const SMDS_MeshNode * n1,
  80                                  const SMDS_MeshNode * n2,
  81                                  const SMDS_MeshNode * n3);
  82
  83   virtual SMDS_MeshFace* AddFaceWithID(int n1, int n2, int n3, int n4, int ID);
  84   virtual SMDS_MeshFace* AddFaceWithID(const SMDS_MeshNode * n1,
  85                                        const SMDS_MeshNode * n2,
  86                                        const SMDS_MeshNode * n3,
  87                                        const SMDS_MeshNode * n4,
  88                                        int ID);
  89   virtual SMDS_MeshFace* AddFace(const SMDS_MeshNode * n1,
  90                                  const SMDS_MeshNode * n2,
  91                                  const SMDS_MeshNode * n3,
  92                                  const SMDS_MeshNode * n4);
  93
  94   virtual SMDS_MeshFace* AddFaceWithID(const SMDS_MeshEdge * e1,
  95                                        const SMDS_MeshEdge * e2,
  96                                        const SMDS_MeshEdge * e3, int ID);
  97   virtual SMDS_MeshFace* AddFace(const SMDS_MeshEdge * e1,
  98                                  const SMDS_MeshEdge * e2,
  99                                  const SMDS_MeshEdge * e3);
 100
 101   virtual SMDS_MeshFace* AddFaceWithID(const SMDS_MeshEdge * e1,
 102                                        const SMDS_MeshEdge * e2,
 103                                        const SMDS_MeshEdge * e3,
 104                                        const SMDS_MeshEdge * e4, int ID);
 105   virtual SMDS_MeshFace* AddFace(const SMDS_MeshEdge * e1,
 106                                  const SMDS_MeshEdge * e2,
 107                                  const SMDS_MeshEdge * e3,
 108                                  const SMDS_MeshEdge * e4);
 109
 110   virtual SMDS_MeshVolume* AddVolumeWithID(int n1, int n2, int n3, int n4, int ID);
 111   virtual SMDS_MeshVolume* AddVolumeWithID(const SMDS_MeshNode * n1,
 112                                            const SMDS_MeshNode * n2,
 113                                            const SMDS_MeshNode * n3,
 114                                            const SMDS_MeshNode * n4,
 115                                            int ID);
 116   virtual SMDS_MeshVolume* AddVolume(const SMDS_MeshNode * n1,
 117                                      const SMDS_MeshNode * n2,
 118                                      const SMDS_MeshNode * n3,
 119                                      const SMDS_MeshNode * n4);
 120
 121   virtual SMDS_MeshVolume* AddVolumeWithID(int n1, int n2, int n3, int n4,
 122                                            int n5, int ID);
 123   virtual SMDS_MeshVolume* AddVolumeWithID(const SMDS_MeshNode * n1,
 124                                            const SMDS_MeshNode * n2,
 125                                            const SMDS_MeshNode * n3,
 126                                            const SMDS_MeshNode * n4,
 127                                            const SMDS_MeshNode * n5,
 128                                            int ID);
 129   virtual SMDS_MeshVolume* AddVolume(const SMDS_MeshNode * n1,
 130                                      const SMDS_MeshNode * n2,
 131                                      const SMDS_MeshNode * n3,
 132                                      const SMDS_MeshNode * n4,
 133                                      const SMDS_MeshNode * n5);
 134
 135   virtual SMDS_MeshVolume* AddVolumeWithID(int n1, int n2, int n3, int n4,
 136                                            int n5, int n6, int ID);
 137   virtual SMDS_MeshVolume* AddVolumeWithID(const SMDS_MeshNode * n1,
 138                                            const SMDS_MeshNode * n2,
 139                                            const SMDS_MeshNode * n3,
 140                                            const SMDS_MeshNode * n4,
 141                                            const SMDS_MeshNode * n5,
 142                                            const SMDS_MeshNode * n6,
 143                                            int ID);
 144   virtual SMDS_MeshVolume* AddVolume(const SMDS_MeshNode * n1,
 145                                      const SMDS_MeshNode * n2,
 146                                      const SMDS_MeshNode * n3,
 147                                      const SMDS_MeshNode * n4,
 148                                      const SMDS_MeshNode * n5,
 149                                      const SMDS_MeshNode * n6);
 150
 151   virtual SMDS_MeshVolume* AddVolumeWithID(int n1, int n2, int n3, int n4,
 152                                            int n5, int n6, int n7, int n8, int ID);
 153   virtual SMDS_MeshVolume* AddVolumeWithID(const SMDS_MeshNode * n1,
 154                                            const SMDS_MeshNode * n2,
 155                                            const SMDS_MeshNode * n3,
 156                                            const SMDS_MeshNode * n4,
 157                                            const SMDS_MeshNode * n5,
 158                                            const SMDS_MeshNode * n6,
 159                                            const SMDS_MeshNode * n7,
 160                                            const SMDS_MeshNode * n8,
 161                                            int ID);
 162   virtual SMDS_MeshVolume* AddVolume(const SMDS_MeshNode * n1,
 163                                      const SMDS_MeshNode * n2,
 164                                      const SMDS_MeshNode * n3,
 165                                      const SMDS_MeshNode * n4,
 166                                      const SMDS_MeshNode * n5,
 167                                      const SMDS_MeshNode * n6,
 168                                      const SMDS_MeshNode * n7,
 169                                      const SMDS_MeshNode * n8);
 170
 171   virtual SMDS_MeshVolume* AddVolumeWithID(const SMDS_MeshFace * f1,
 172                                            const SMDS_MeshFace * f2,
 173                                            const SMDS_MeshFace * f3,
 174                                            const SMDS_MeshFace * f4, int ID);
 175   virtual SMDS_MeshVolume* AddVolume(const SMDS_MeshFace * f1,
 176                                      const SMDS_MeshFace * f2,
 177                                      const SMDS_MeshFace * f3,
 178                                      const SMDS_MeshFace * f4);
 179
 180   virtual SMDS_MeshVolume* AddVolumeWithID(const SMDS_MeshFace * f1,
 181                                            const SMDS_MeshFace * f2,
 182                                            const SMDS_MeshFace * f3,
 183                                            const SMDS_MeshFace * f4,
 184                                            const SMDS_MeshFace * f5, int ID);
 185   virtual SMDS_MeshVolume* AddVolume(const SMDS_MeshFace * f1,
 186                                      const SMDS_MeshFace * f2,
 187                                      const SMDS_MeshFace * f3,
 188                                      const SMDS_MeshFace * f4,
 189                                      const SMDS_MeshFace * f5);
 190
 191   virtual SMDS_MeshVolume* AddVolumeWithID(const SMDS_MeshFace * f1,
 192                                            const SMDS_MeshFace * f2,
 193                                            const SMDS_MeshFace * f3,
 194                                            const SMDS_MeshFace * f4,
 195                                            const SMDS_MeshFace * f5,
 196                                            const SMDS_MeshFace * f6, int ID);
 197   virtual SMDS_MeshVolume* AddVolume(const SMDS_MeshFace * f1,
 198                                      const SMDS_MeshFace * f2,
 199                                      const SMDS_MeshFace * f3,
 200                                      const SMDS_MeshFace * f4,
 201                                      const SMDS_MeshFace * f5,
 202                                      const SMDS_MeshFace * f6);
 203
 204   virtual void RemoveElement(const SMDS_MeshElement *        elem,
 205                              std::list<const SMDS_MeshElement *>& removedElems,
 206                              std::list<const SMDS_MeshElement *>& removedNodes,
 207                              const bool                      removenodes = false);
 208   virtual void RemoveElement(const SMDS_MeshElement * elem, bool removenodes = false);
 209   virtual void RemoveNode(const SMDS_MeshNode * node);
 210   virtual void RemoveEdge(const SMDS_MeshEdge * edge);
 211   virtual void RemoveFace(const SMDS_MeshFace * face);
 212   virtual void RemoveVolume(const SMDS_MeshVolume * volume);
 213
 214   virtual bool RemoveFromParent();
 215   virtual bool RemoveSubMesh(const SMDS_Mesh * aMesh);
 216
 217   static bool ChangeElementNodes(const SMDS_MeshElement * elem,
 218                                  const SMDS_MeshNode    * nodes[],
 219                                  const int                nbnodes);
 220
 221   virtual void Renumber (const bool isNodes, const int startID = 1, const int deltaID = 1);
 222   // Renumber all nodes or elements.
 223
 224   const SMDS_MeshNode *FindNode(int idnode) const;
 225   const SMDS_MeshEdge *FindEdge(int idnode1, int idnode2) const;
 226   const SMDS_MeshFace *FindFace(int idnode1, int idnode2, int idnode3) const;
 227   const SMDS_MeshFace *FindFace(int idnode1, int idnode2, int idnode3, int idnode4) const;
 228   const SMDS_MeshElement *FindElement(int IDelem) const;
 229   static const SMDS_MeshEdge* FindEdge(const SMDS_MeshNode * n1,
 230                                        const SMDS_MeshNode * n2);
 231   static const SMDS_MeshFace* FindFace(const SMDS_MeshNode *n1,
 232                                        const SMDS_MeshNode *n2,
 233                                        const SMDS_MeshNode *n3);
 234   static const SMDS_MeshFace* FindFace(const SMDS_MeshNode *n1,
 235                                        const SMDS_MeshNode *n2,
 236                                        const SMDS_MeshNode *n3,
 237                                        const SMDS_MeshNode *n4);
 238   int MaxNodeID() const;
 239   int MinNodeID() const;
 240   int MaxElementID() const;
 241   int MinElementID() const;
 242
 243
 244   int NbNodes() const;
 245   int NbEdges() const;
 246   int NbFaces() const;
 247   int NbVolumes() const;
 248   int NbSubMesh() const;
 249   void DumpNodes() const;
 250   void DumpEdges() const;
 251   void DumpFaces() const;
 252   void DumpVolumes() const;
 253   void DebugStats() const;
 254   SMDS_Mesh *boundaryFaces();
 255   SMDS_Mesh *boundaryEdges();
 256   virtual ~SMDS_Mesh();
 257   bool hasConstructionEdges();
 258   bool hasConstructionFaces();
 259   bool hasInverseElements();
 260   void setConstructionEdges(bool);
 261   void setConstructionFaces(bool);
 262   void setInverseElements(bool);
 263
 264   /*!
 265    * Checks if the element is present in mesh.
 266    * Useful to determine dead pointers.
 267    * Use this function for debug purpose only! Do not check in the code
 268    * using it even in _DEBUG_ mode
 269    */
 270   bool Contains (const SMDS_MeshElement* elem) const;
 271
 272   typedef NCollection_Map<SMDS_MeshNode *> SetOfNodes;
 273   typedef NCollection_Map<SMDS_MeshEdge *> SetOfEdges;
 274   typedef NCollection_Map<SMDS_MeshFace *> SetOfFaces;
 275   typedef NCollection_Map<SMDS_MeshVolume *> SetOfVolumes;
 276
 277 private:
 278   SMDS_Mesh(SMDS_Mesh * parent);
 279
 280   SMDS_MeshFace * createTriangle(const SMDS_MeshNode * node1,
 281                                  const SMDS_MeshNode * node2,
 282                                  const SMDS_MeshNode * node3);
 283   SMDS_MeshFace * createQuadrangle(const SMDS_MeshNode * node1,
 284                                    const SMDS_MeshNode * node2,
 285                                    const SMDS_MeshNode * node3,
 286                                    const SMDS_MeshNode * node4);
 287   SMDS_MeshEdge* FindEdgeOrCreate(const SMDS_MeshNode * n1,
 288                                   const SMDS_MeshNode * n2);
 289   SMDS_MeshFace* FindFaceOrCreate(const SMDS_MeshNode *n1,
 290                                   const SMDS_MeshNode *n2,
 291                                   const SMDS_MeshNode *n3);
 292   SMDS_MeshFace* FindFaceOrCreate(const SMDS_MeshNode *n1,
 293                                   const SMDS_MeshNode *n2,
 294                                   const SMDS_MeshNode *n3,
 295                                   const SMDS_MeshNode *n4);
 296
 297   bool registerElement(int ID, SMDS_MeshElement * element);
 298
 299   void addChildrenWithNodes(std::set<const SMDS_MeshElement*>& setOfChildren,
 300                             const SMDS_MeshElement * element,
 301                             std::set<const SMDS_MeshElement*>& nodes);
 302
 303   // Fields PRIVATE
 304
 305   SetOfNodes myNodes;
 306   SetOfEdges myEdges;
 307   SetOfFaces myFaces;
 308   SetOfVolumes myVolumes;
 309   SMDS_Mesh *myParent;
 310   std::list<SMDS_Mesh *> myChildren;
 311   SMDS_MeshElementIDFactory *myNodeIDFactory;
 312   SMDS_MeshElementIDFactory *myElementIDFactory;
 313
 314   bool myHasConstructionEdges;
 315   bool myHasConstructionFaces;
 316   bool myHasInverseElements;
 317 };
 318
 319
 320 #endif