SimpleLinearEllipticSolver.hpp

00001 /*
00002 
00003 Copyright (C) University of Oxford, 2005-2011
00004 
00005 University of Oxford means the Chancellor, Masters and Scholars of the
00006 University of Oxford, having an administrative office at Wellington
00007 Square, Oxford OX1 2JD, UK.
00008 
00009 This file is part of Chaste.
00010 
00011 Chaste is free software: you can redistribute it and/or modify it
00012 under the terms of the GNU Lesser General Public License as published
00013 by the Free Software Foundation, either version 2.1 of the License, or
00014 (at your option) any later version.
00015 
00016 Chaste is distributed in the hope that it will be useful, but WITHOUT
00017 ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or
00018 FITNESS FOR A PARTICULAR PURPOSE.  See the GNU Lesser General Public
00019 License for more details. The offer of Chaste under the terms of the
00020 License is subject to the License being interpreted in accordance with
00021 English Law and subject to any action against the University of Oxford
00022 being under the jurisdiction of the English Courts.
00023 
00024 You should have received a copy of the GNU Lesser General Public License
00025 along with Chaste. If not, see <http://www.gnu.org/licenses/>.
00026 
00027 */
00028 
00029 #ifndef SIMPLELINEARELLIPTICSOLVER_HPP_
00030 #define SIMPLELINEARELLIPTICSOLVER_HPP_
00031 
00032 #include "AbstractAssemblerSolverHybrid.hpp"
00033 #include "AbstractStaticLinearPdeSolver.hpp"
00034 #include "AbstractLinearEllipticPde.hpp"
00035 
00041 template<unsigned ELEMENT_DIM, unsigned SPACE_DIM>
00042 class SimpleLinearEllipticSolver
00043     : public AbstractAssemblerSolverHybrid<ELEMENT_DIM, SPACE_DIM, 1, NORMAL>,
00044       public AbstractStaticLinearPdeSolver<ELEMENT_DIM, SPACE_DIM, 1>
00045 {
00046 protected:
00047 
00049     AbstractLinearEllipticPde<ELEMENT_DIM,SPACE_DIM>* mpEllipticPde;
00050 
00063     virtual c_matrix<double, 1*(ELEMENT_DIM+1), 1*(ELEMENT_DIM+1)> ComputeMatrixTerm(
00064         c_vector<double, ELEMENT_DIM+1>& rPhi,
00065         c_matrix<double, SPACE_DIM, ELEMENT_DIM+1>& rGradPhi,
00066         ChastePoint<SPACE_DIM>& rX,
00067         c_vector<double,1>& rU,
00068         c_matrix<double,1,SPACE_DIM>& rGradU,
00069         Element<ELEMENT_DIM,SPACE_DIM>* pElement);
00070 
00082     virtual c_vector<double,1*(ELEMENT_DIM+1)> ComputeVectorTerm(
00083         c_vector<double, ELEMENT_DIM+1>& rPhi,
00084         c_matrix<double, SPACE_DIM, ELEMENT_DIM+1>& rGradPhi,
00085         ChastePoint<SPACE_DIM>& rX,
00086         c_vector<double,1>& rU,
00087         c_matrix<double,1,SPACE_DIM>& rGradU,
00088         Element<ELEMENT_DIM,SPACE_DIM>* pElement);
00089 
00090 
00091     // Note: does not have to provide a ComputeVectorSurfaceTerm for surface integrals,
00092     // the parent AbstractAssemblerSolverHybrid assumes natural Neumann BCs and uses a
00093     // NaturalNeumannSurfaceTermAssembler for assembling this part of the vector.
00094 
00095 
00096 
00105     void SetupLinearSystem(Vec currentSolution, bool computeMatrix)
00106     {
00107         SetupGivenLinearSystem(currentSolution, computeMatrix, this->mpLinearSystem);
00108     }
00109 
00110 public:
00111 
00120     SimpleLinearEllipticSolver(AbstractTetrahedralMesh<ELEMENT_DIM,SPACE_DIM>* pMesh,
00121                                AbstractLinearEllipticPde<ELEMENT_DIM,SPACE_DIM>* pPde,
00122                                BoundaryConditionsContainer<ELEMENT_DIM,SPACE_DIM,1>* pBoundaryConditions,
00123                                unsigned numQuadPoints = 2);
00124 
00131     void InitialiseForSolve(Vec initialSolution = NULL);
00132 };
00133 
00134 #endif /*SIMPLELINEARELLIPTICSOLVER_HPP_*/