PetscSolverGlobalMatrix.h

// ============================================================================
// ==                                                                        ==
// == AMDiS - Adaptive multidimensional simulations                          ==
// ==                                                                        ==
// ==  http://www.amdis-fem.org                                              ==
// ==                                                                        ==
// ============================================================================
//
// Software License for AMDiS
//
// Copyright (c) 2010 Dresden University of Technology 
// All rights reserved.
// Authors: Simon Vey, Thomas Witkowski et al.
//
// This file is part of AMDiS
//
// See also license.opensource.txt in the distribution.



/** \file PetscSolverGlobalMatrix.h */

#ifndef AMDIS_PETSC_SOLVER_GLOBAL_MATRIX_H
#define AMDIS_PETSC_SOLVER_GLOBAL_MATRIX_H

#include <boost/tuple/tuple.hpp>
#include "AMDiS_fwd.h"
#include "parallel/MatrixNnzStructure.h"
#include "parallel/PetscSolver.h"

namespace AMDiS {

  using namespace std;

  /** 
   * PETSc solver which creates a globally distributed matrix. Supports also
   * coarse space assembling.
   */
  class PetscSolverGlobalMatrix : public PetscSolver
  {
  public:
    PetscSolverGlobalMatrix()
      : PetscSolver(),
	zeroStartVector(false),
	printMatInfo(false)
    {
      Parameters::get("parallel->use zero start vector", zeroStartVector);
      Parameters::get("parallel->print matrix info", printMatInfo);
    }

    void fillPetscMatrix(Matrix<DOFMatrix*> *mat);

    void fillPetscMatrixWithCoarseSpace(Matrix<DOFMatrix*> *mat);

    void fillPetscRhs(SystemVector *vec);

    void solvePetscMatrix(SystemVector &vec, AdaptInfo *adaptInfo);    

    void solveGlobal(Vec &rhs, Vec &sol);

    void destroyMatrixData();

    void destroyVectorData();

  protected:
    void removeDirichletRows(Matrix<DOFMatrix*> *seqMat, 
			     ParallelDofMapping &dofMap,
			     Mat mpiMat);

    void removeDirichletRows(SystemVector *seqVec, 
			     ParallelDofMapping &dofMap,
			     Vec mpiVec);

    /// Reads field split information and creats a splitting based on 
    /// component numbers.
    void createFieldSplit(PC pc);

    /** \brief 
     * Creates a new field split for a preconditioner object.
     *
     * \param[in] pc          PETSc preconditioner object, must be of
     *                        type PCFIELDSPLIT
     * \param[in] splitName   Name of the field split, can be used to set other
     *                        parameters of the PCFIELDSPLIT preconditioner on
     *                        the command line.
     * \param[in] components  System component numbers of the field split. At
     *                        the moment only continuous splits are allowed.
     */
    void createFieldSplit(PC pc, string splitName, vector<int> &components);

    virtual void initSolver(KSP &ksp);

    virtual void exitSolver(KSP ksp);

    virtual void initPreconditioner(PC pc);

    virtual void exitPreconditioner(PC pc);

    /// Takes a DOF matrix and sends the values to the global PETSc matrix.
    void setDofMatrix(DOFMatrix* mat, int nRowMat = 0, int nColMat = 0);

    /// Takes a DOF vector and sends its values to a given PETSc vector.
    void setDofVector(Vec vecInterior,
		      Vec vecCoarse,
		      DOFVector<double>* vec, 
		      int nRowVec, bool rankOnly = false);

    inline void setDofVector(Vec vecInterior,
			     DOFVector<double>* vec, 
			     int nRowVec, bool rankOnly = false)
    {
      setDofVector(vecInterior, PETSC_NULL, vec, nRowVec, rankOnly);
    }


  protected:
    bool zeroStartVector;

    /// If true, after parallel assembling, information about the matrix
    /// are printed.
    bool printMatInfo;
  };


}

#endif