00001 /* @HEADER@ */ 00002 // ************************************************************************ 00003 // 00004 // Sundance 00005 // Copyright (2005) Sandia Corporation 00006 // 00007 // Copyright (year first published) Sandia Corporation. Under the terms 00008 // of Contract DE-AC04-94AL85000 with Sandia Corporation, the U.S. Government 00009 // retains certain rights in this software. 00010 // 00011 // This library is free software; you can redistribute it and/or modify 00012 // it under the terms of the GNU Lesser General Public License as 00013 // published by the Free Software Foundation; either version 2.1 of the 00014 // License, or (at your option) any later version. 00015 // 00016 // This library is distributed in the hope that it will be useful, but 00017 // WITHOUT ANY WARRANTY; without even the implied warranty of 00018 // MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU 00019 // Lesser General Public License for more details. 00020 // 00021 // You should have received a copy of the GNU Lesser General Public 00022 // License along with this library; if not, write to the Free Software 00023 // Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 00024 // USA 00025 // Questions? Contact Kevin Long (krlong@sandia.gov), 00026 // Sandia National Laboratories, Livermore, California, USA 00027 // 00028 // ************************************************************************ 00029 /* @HEADER@ */ 00030 00031 #ifndef SUNDANCE_INCREMENTALLYCREATABLEMESH_H 00032 #define SUNDANCE_INCREMENTALLYCREATABLEMESH_H 00033 00034 00035 00036 #include "SundanceDefs.hpp" 00037 #include "SundanceMeshBase.hpp" 00038 #include "Teuchos_Array.hpp" 00039 00040 namespace Sundance 00041 { 00042 /** 00043 * IncrementallyCreatableMesh is an interface for the creation of meshes 00044 * by adding vertices, then elements. 00045 */ 00046 class IncrementallyCreatableMesh : public MeshBase 00047 { 00048 public: 00049 /** Construct an empty mesh of the given dimension, distributed over 00050 * processors in the MPI communicator*/ 00051 IncrementallyCreatableMesh(int dim, const MPIComm& comm, 00052 const MeshEntityOrder& meshOrder) 00053 : MeshBase(dim, comm, meshOrder) {;} 00054 00055 /** virtual dtor */ 00056 virtual ~IncrementallyCreatableMesh(){;} 00057 00058 /** Optional preallocation of space for an estimated number of vertices */ 00059 virtual void estimateNumVertices(int nPts) {;} 00060 00061 /** Optional preallocation of space for an estimated number of elements */ 00062 virtual void estimateNumElements(int nElems) {;} 00063 00064 00065 00066 /** 00067 * Add new new vertex to the mesh. 00068 * \param globalIndex the GID of the new vertex 00069 * \param x the spatial position of the new vertex 00070 * \param ownerProcID the processor that "owns" this vertex 00071 * \param label a label for this vertex (optionally used in setting loads, boundary 00072 * conditions, etc) 00073 * \return the LID of the vertex. 00074 */ 00075 virtual int addVertex(int globalIndex, const Point& x, 00076 int ownerProcID, int label) = 0 ; 00077 00078 /** 00079 * Add a new element to the mesh. 00080 * \param globalIndex the GID of the new element 00081 * \param vertexGIDs tuple of GIDs for the vertices defining this element. 00082 * \param ownerProcID the processor that "owns" this element 00083 * \param label a label for this element (optionally used in setting loads, 00084 * material properties, etc) 00085 * \return the LID of the element 00086 */ 00087 virtual int addElement(int globalIndex, const Array<int>& vertexGIDs, 00088 int ownerProcID, int label) = 0 ; 00089 00090 00091 /** 00092 * 00093 */ 00094 virtual void freezeTopology() {} 00095 }; 00096 00097 } 00098 00099 00100 00101 #endif