Chaste Release::3.1
MutableElement.hpp
00001 /*
00002 
00003 Copyright (c) 2005-2012, University of Oxford.
00004 All rights reserved.
00005 
00006 University of Oxford means the Chancellor, Masters and Scholars of the
00007 University of Oxford, having an administrative office at Wellington
00008 Square, Oxford OX1 2JD, UK.
00009 
00010 This file is part of Chaste.
00011 
00012 Redistribution and use in source and binary forms, with or without
00013 modification, are permitted provided that the following conditions are met:
00014  * Redistributions of source code must retain the above copyright notice,
00015    this list of conditions and the following disclaimer.
00016  * Redistributions in binary form must reproduce the above copyright notice,
00017    this list of conditions and the following disclaimer in the documentation
00018    and/or other materials provided with the distribution.
00019  * Neither the name of the University of Oxford nor the names of its
00020    contributors may be used to endorse or promote products derived from this
00021    software without specific prior written permission.
00022 
00023 THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
00024 AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
00025 IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
00026 ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE
00027 LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
00028 CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
00029 GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
00030 HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
00031 LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
00032 OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
00033 
00034 */
00035 #ifndef MUTABLEELEMENT_HPP_
00036 #define MUTABLEELEMENT_HPP_
00037 
00038 #include "AbstractElement.hpp"
00039 
00040 #include "ChasteSerialization.hpp"
00041 #include <boost/serialization/base_object.hpp>
00042 #include <boost/serialization/vector.hpp>
00043 
00048 template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>
00049 class MutableElement : public AbstractElement<ELEMENT_DIM, SPACE_DIM>
00050 {
00051 private:
00052 
00053 
00055     friend class boost::serialization::access;
00067     template<class Archive>
00068     void serialize(Archive & archive, const unsigned int version)
00069     {
00070         archive & boost::serialization::base_object<AbstractElement<ELEMENT_DIM, SPACE_DIM> >(*this);
00071     }
00072 
00073 public:
00074 
00081     MutableElement(unsigned index);
00082 
00089     MutableElement(unsigned index,
00090                   const std::vector<Node<SPACE_DIM>*>& rNodes);
00091 
00092 
00096     ~MutableElement();
00097 
00103     void RegisterWithNodes();
00104 
00111     void MarkAsDeleted();
00112 
00118     void ResetIndex(unsigned index);
00119 
00126     void UpdateNode(const unsigned& rIndex, Node<SPACE_DIM>* pNode);
00127 
00133     void DeleteNode(const unsigned& rIndex);
00134 
00141     void AddNode(Node<SPACE_DIM>* pNode, const unsigned& rIndex);
00142 
00150     unsigned GetNodeLocalIndex(unsigned globalIndex) const;
00151 
00157     bool IsElementOnBoundary() const;
00158 
00159 };
00160 
00161 
00163 //                  Specialization for 1d elements                  //
00164 //                                                                  //
00165 //                 1d elements are just edges (lines)               //
00167 
00172 template<unsigned SPACE_DIM>
00173 class MutableElement<1, SPACE_DIM> : public AbstractElement<1,SPACE_DIM>
00174 {
00175 public:
00176 
00183     MutableElement(unsigned index, const std::vector<Node<SPACE_DIM>*>& rNodes);
00184 
00191     MutableElement(unsigned index);
00192 
00196     virtual ~MutableElement();
00197 
00204     void UpdateNode(const unsigned& rIndex, Node<SPACE_DIM>* pNode);
00205 
00211     void RegisterWithNodes();
00212 
00219     void MarkAsDeleted();
00220 
00226     void ResetIndex(unsigned index);
00227 
00233     void DeleteNode(const unsigned& rIndex);
00234 
00241     void AddNode(Node<SPACE_DIM>* pNode, const unsigned& rIndex);
00242 
00250     unsigned GetNodeLocalIndex(unsigned globalIndex) const;
00251 
00257     bool IsElementOnBoundary() const;
00258 };
00259 
00260 #endif /*MUTABLEELEMENT_HPP_*/