#include <simple_block_preconditioners.h>

Inheritance diagram for oomph::SimpleBlockDiagonalPreconditioner< MATRIX >:

Public Member Functions
	SimpleBlockDiagonalPreconditioner ()
	Constructor for SimpleBlockDiagonalPreconditioner. More...

	~SimpleBlockDiagonalPreconditioner ()
	Destructor - delete the diagonal solvers. More...

	SimpleBlockDiagonalPreconditioner (const SimpleBlockDiagonalPreconditioner &)
	Broken copy constructor. More...

void	operator= (const SimpleBlockDiagonalPreconditioner &)
	Broken assignment operator. More...

void	preconditioner_solve (const DoubleVector &r, DoubleVector &z)
	Apply preconditioner to r. More...

virtual void	setup ()
	Setup the preconditioner. More...

void	add_mesh (const Mesh *const mesh_pt)
	Add a mesh. More...

Public Member Functions inherited from oomph::BlockPreconditioner< MATRIX >
	BlockPreconditioner ()
	Constructor. More...

virtual	~BlockPreconditioner ()
	Destructor. More...

	BlockPreconditioner (const BlockPreconditioner &)=delete
	Broken copy constructor. More...

void	operator= (const BlockPreconditioner &)=delete
	Broken assignment operator. More...

MATRIX *	matrix_pt () const

void	turn_on_recursive_debug_flag ()

void	turn_off_recursive_debug_flag ()

void	turn_on_debug_flag ()
	Toggles on the debug flag. More...

void	turn_off_debug_flag ()
	Toggles off the debug flag. More...

void	turn_into_subsidiary_block_preconditioner (BlockPreconditioner< MATRIX > *master_block_prec_pt, const Vector< unsigned > &doftype_in_master_preconditioner_coarse)

void	turn_into_subsidiary_block_preconditioner (BlockPreconditioner< MATRIX > *master_block_prec_pt, const Vector< unsigned > &doftype_in_master_preconditioner_coarse, const Vector< Vector< unsigned >> &doftype_coarsen_map_coarse)

virtual void	block_setup ()

void	block_setup (const Vector< unsigned > &dof_to_block_map)

void	get_block (const unsigned &i, const unsigned &j, MATRIX &output_matrix, const bool &ignore_replacement_block=false) const

MATRIX	get_block (const unsigned &i, const unsigned &j, const bool &ignore_replacement_block=false) const

void	set_master_matrix_pt (MATRIX *in_matrix_pt)
	Set the matrix_pt in the upper-most master preconditioner. More...

void	get_block_other_matrix (const unsigned &i, const unsigned &j, MATRIX *in_matrix_pt, MATRIX &output_matrix)

void	get_blocks (DenseMatrix< bool > &required_blocks, DenseMatrix< MATRIX * > &block_matrix_pt) const

void	get_dof_level_block (const unsigned &i, const unsigned &j, MATRIX &output_block, const bool &ignore_replacement_block=false) const

MATRIX	get_concatenated_block (const VectorMatrix< BlockSelector > &selected_block)

void	get_concatenated_block_vector (const Vector< unsigned > &block_vec_number, const DoubleVector &v, DoubleVector &b)

void	return_concatenated_block_vector (const Vector< unsigned > &block_vec_number, const DoubleVector &b, DoubleVector &v) const
	Takes concatenated block ordered vector, b, and copies its. More...

void	get_block_vectors (const Vector< unsigned > &block_vec_number, const DoubleVector &v, Vector< DoubleVector > &s) const

void	get_block_vectors (const DoubleVector &v, Vector< DoubleVector > &s) const

void	return_block_vectors (const Vector< unsigned > &block_vec_number, const Vector< DoubleVector > &s, DoubleVector &v) const

void	return_block_vectors (const Vector< DoubleVector > &s, DoubleVector &v) const

void	get_block_vector (const unsigned &n, const DoubleVector &v, DoubleVector &b) const

void	return_block_vector (const unsigned &n, const DoubleVector &b, DoubleVector &v) const

void	get_block_ordered_preconditioner_vector (const DoubleVector &v, DoubleVector &w)

void	return_block_ordered_preconditioner_vector (const DoubleVector &w, DoubleVector &v) const

unsigned	nblock_types () const
	Return the number of block types. More...

unsigned	ndof_types () const
	Return the total number of DOF types. More...

const Mesh *	mesh_pt (const unsigned &i) const

unsigned	nmesh () const

int	block_number (const unsigned &i_dof) const
	Return the block number corresponding to a global index i_dof. More...

int	index_in_block (const unsigned &i_dof) const

const LinearAlgebraDistribution *	block_distribution_pt (const unsigned &b) const
	Access function to the block distributions (const version). More...

LinearAlgebraDistribution *	block_distribution_pt (const unsigned b)
	Access function to the block distributions (non-const version). More...

LinearAlgebraDistribution *	dof_block_distribution_pt (const unsigned &b)
	Access function to the dof-level block distributions. More...

const LinearAlgebraDistribution *	master_distribution_pt () const

unsigned	ndof_types_in_mesh (const unsigned &i) const

bool	is_subsidiary_block_preconditioner () const

bool	is_master_block_preconditioner () const

void	set_block_output_to_files (const std::string &basefilename)

void	disable_block_output_to_files ()
	Turn off output of blocks (by clearing the basefilename string). More...

bool	block_output_on () const
	Test if output of blocks is on or not. More...

void	output_blocks_to_files (const std::string &basefilename, const unsigned &precision=8) const

void	post_block_matrix_assembly_partial_clear ()

BlockPreconditioner< MATRIX > *	master_block_preconditioner_pt () const
	Access function to the master block preconditioner pt. More...

void	clear_block_preconditioner_base ()

void	document ()

Vector< Vector< unsigned > >	doftype_coarsen_map_fine () const

Vector< unsigned >	get_fine_grain_dof_types_in (const unsigned &i) const

unsigned	nfine_grain_dof_types_in (const unsigned &i) const

MapMatrix< unsigned, CRDoubleMatrix * >	replacement_dof_block_pt () const
	Access function to the replaced dof-level blocks. More...

void	setup_matrix_vector_product (MatrixVectorProduct matvec_prod_pt, CRDoubleMatrix block_pt, const Vector< unsigned > &block_col_indices)

void	setup_matrix_vector_product (MatrixVectorProduct matvec_prod_pt, CRDoubleMatrix block_pt, const unsigned &block_col_index)

void	internal_get_block_ordered_preconditioner_vector (const DoubleVector &v, DoubleVector &w) const

void	internal_return_block_ordered_preconditioner_vector (const DoubleVector &w, DoubleVector &v) const

unsigned	internal_nblock_types () const

unsigned	internal_ndof_types () const

void	internal_return_block_vector (const unsigned &n, const DoubleVector &b, DoubleVector &v) const

void	internal_get_block_vector (const unsigned &n, const DoubleVector &v, DoubleVector &b) const

void	internal_get_block_vectors (const Vector< unsigned > &block_vec_number, const DoubleVector &v, Vector< DoubleVector > &s) const

void	internal_get_block_vectors (const DoubleVector &v, Vector< DoubleVector > &s) const

void	internal_return_block_vectors (const Vector< unsigned > &block_vec_number, const Vector< DoubleVector > &s, DoubleVector &v) const

void	internal_return_block_vectors (const Vector< DoubleVector > &s, DoubleVector &v) const

void	internal_get_block (const unsigned &i, const unsigned &j, MATRIX &output_block) const

int	internal_block_number (const unsigned &i_dof) const

int	internal_index_in_block (const unsigned &i_dof) const

const LinearAlgebraDistribution *	internal_block_distribution_pt (const unsigned &b) const
	Access function to the internal block distributions. More...

void	insert_auxiliary_block_distribution (const Vector< unsigned > &block_vec_number, LinearAlgebraDistribution *dist_pt)

void	block_matrix_test (const unsigned &i, const unsigned &j, const MATRIX *block_matrix_pt) const

template<typename myType >
int	get_index_of_value (const Vector< myType > &vec, const myType val, const bool sorted=false) const

void	internal_get_block (const unsigned &block_i, const unsigned &block_j, CRDoubleMatrix &output_block) const

void	get_dof_level_block (const unsigned &block_i, const unsigned &block_j, CRDoubleMatrix &output_block, const bool &ignore_replacement_block) const

Public Member Functions inherited from oomph::Preconditioner
	Preconditioner ()
	Constructor. More...

	Preconditioner (const Preconditioner &)=delete
	Broken copy constructor. More...

void	operator= (const Preconditioner &)=delete
	Broken assignment operator. More...

virtual	~Preconditioner ()
	Destructor (empty) More...

virtual void	preconditioner_solve_transpose (const DoubleVector &r, DoubleVector &z)

void	setup (DoubleMatrixBase *matrix_pt)

void	setup (const Problem problem_pt, DoubleMatrixBase matrix_pt)

void	enable_silent_preconditioner_setup ()
	Set up the block preconditioner quietly! More...

void	disable_silent_preconditioner_setup ()
	Be verbose in the block preconditioner setup. More...

virtual void	clean_up_memory ()
	Clean up memory (empty). Generic interface function. More...

virtual void	set_matrix_pt (DoubleMatrixBase *matrix_pt)
	Set the matrix pointer. More...

virtual const OomphCommunicator *	comm_pt () const
	Get function for comm pointer. More...

virtual void	set_comm_pt (const OomphCommunicator *const comm_pt)
	Set the communicator pointer. More...

double	setup_time () const
	Returns the time to setup the preconditioner. More...

virtual void	turn_into_subsidiary_block_preconditioner (BlockPreconditioner< CRDoubleMatrix > *master_block_prec_pt, const Vector< unsigned > &doftype_in_master_preconditioner_coarse)

virtual void	turn_into_subsidiary_block_preconditioner (BlockPreconditioner< CRDoubleMatrix > *master_block_prec_pt, const Vector< unsigned > &doftype_in_master_preconditioner_coarse, const Vector< Vector< unsigned >> &doftype_coarsen_map_coarse)

Public Member Functions inherited from oomph::DistributableLinearAlgebraObject
	DistributableLinearAlgebraObject ()
	Default constructor - create a distribution. More...

	DistributableLinearAlgebraObject (const DistributableLinearAlgebraObject &matrix)=delete
	Broken copy constructor. More...

void	operator= (const DistributableLinearAlgebraObject &)=delete
	Broken assignment operator. More...

virtual	~DistributableLinearAlgebraObject ()
	Destructor. More...

LinearAlgebraDistribution *	distribution_pt () const
	access to the LinearAlgebraDistribution More...

unsigned	nrow () const
	access function to the number of global rows. More...

unsigned	nrow_local () const
	access function for the num of local rows on this processor. More...

unsigned	nrow_local (const unsigned &p) const
	access function for the num of local rows on this processor. More...

unsigned	first_row () const
	access function for the first row on this processor More...

unsigned	first_row (const unsigned &p) const
	access function for the first row on this processor More...

bool	distributed () const
	distribution is serial or distributed More...

bool	distribution_built () const

void	build_distribution (const LinearAlgebraDistribution *const dist_pt)

void	build_distribution (const LinearAlgebraDistribution &dist)

Private Attributes
Vector< Preconditioner * >	Diagonal_block_preconditioner_pt

Vector< const Mesh * >	My_mesh_pt

Additional Inherited Members
Protected Member Functions inherited from oomph::BlockPreconditioner< MATRIX >
void	set_nmesh (const unsigned &n)

void	set_mesh (const unsigned &i, const Mesh *const mesh_pt, const bool &allow_multiple_element_type_in_mesh=false)

void	set_replacement_dof_block (const unsigned &block_i, const unsigned &block_j, CRDoubleMatrix *replacement_dof_block_pt)

bool	any_mesh_distributed () const

int	internal_dof_number (const unsigned &i_dof) const

unsigned	internal_index_in_dof (const unsigned &i_dof) const

unsigned	internal_block_dimension (const unsigned &b) const

unsigned	internal_dof_block_dimension (const unsigned &i) const

unsigned	master_nrow () const

unsigned	internal_master_dof_number (const unsigned &b) const

const LinearAlgebraDistribution *	internal_preconditioner_matrix_distribution_pt () const

const LinearAlgebraDistribution *	preconditioner_matrix_distribution_pt () const

Protected Member Functions inherited from oomph::DistributableLinearAlgebraObject
void	clear_distribution ()

Protected Attributes inherited from oomph::BlockPreconditioner< MATRIX >
MapMatrix< unsigned, CRDoubleMatrix * >	Replacement_dof_block_pt
	The replacement dof-level blocks. More...

Vector< LinearAlgebraDistribution * >	Block_distribution_pt
	The distribution for the blocks. More...

Vector< Vector< unsigned > >	Block_to_dof_map_coarse

Vector< Vector< unsigned > >	Block_to_dof_map_fine
	Mapping for the block types to the most fine grain dof types. More...

Vector< Vector< unsigned > >	Doftype_coarsen_map_coarse

Vector< Vector< unsigned > >	Doftype_coarsen_map_fine

Vector< LinearAlgebraDistribution * >	Internal_block_distribution_pt
	Storage for the default distribution for each internal block. More...

Vector< LinearAlgebraDistribution * >	Dof_block_distribution_pt

Vector< unsigned >	Allow_multiple_element_type_in_mesh

Vector< const Mesh * >	Mesh_pt

Vector< unsigned >	Ndof_types_in_mesh

unsigned	Internal_nblock_types

unsigned	Internal_ndof_types

Protected Attributes inherited from oomph::Preconditioner
bool	Silent_preconditioner_setup
	Boolean to indicate whether or not the build should be done silently. More...

std::ostream *	Stream_pt
	Pointer to the output stream – defaults to std::cout. More...

Detailed Description

template<typename MATRIX>
class oomph::SimpleBlockDiagonalPreconditioner< MATRIX >

Simple proof-of-concept block diagonal preconditioner for demo purposes. There's a much better version in src/generic!

Constructor & Destructor Documentation

◆ SimpleBlockDiagonalPreconditioner() [1/2]

template<typename MATRIX >

oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::SimpleBlockDiagonalPreconditioner ( )

inline

Constructor for SimpleBlockDiagonalPreconditioner.

                                        : BlockPreconditioner<MATRIX>()
    {
    } // end_of_constructor

◆ ~SimpleBlockDiagonalPreconditioner()

template<typename MATRIX >

oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::~SimpleBlockDiagonalPreconditioner ( )

inline

Destructor - delete the diagonal solvers.

    {
     // Delete diagonal preconditioners (approximate solvers)
     unsigned n_block = Diagonal_block_preconditioner_pt.size();
     for (unsigned i = 0 ; i < n_block; i++)
      {
       delete Diagonal_block_preconditioner_pt[i];
       Diagonal_block_preconditioner_pt[i] = 0;
      }
    }

References oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::Diagonal_block_preconditioner_pt, and i.

◆ SimpleBlockDiagonalPreconditioner() [2/2]

template<typename MATRIX >

oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::SimpleBlockDiagonalPreconditioner ( const SimpleBlockDiagonalPreconditioner< MATRIX > & )

inline

Broken copy constructor.

   { 
    BrokenCopy::broken_copy("SimpleBlockDiagonalPreconditioner");
   } 

References oomph::BrokenCopy::broken_copy().

Member Function Documentation

◆ add_mesh()

template<typename MATRIX >

void oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::add_mesh ( const Mesh *const mesh_pt )

inline

Add a mesh.

   {
 #ifdef PARANOID
     // Check that the mesh pointer is not null.
     if(mesh_pt == 0)
     {
       std::ostringstream err_msg;
       err_msg << "The mesh_pt is null, please point it to a mesh.\n";
       throw OomphLibError(err_msg.str(),
                           OOMPH_CURRENT_FUNCTION,
                           OOMPH_EXCEPTION_LOCATION);
     }
 #endif
  
     // Push back the mesh.
     My_mesh_pt.push_back(mesh_pt);
   } 

References oomph::BlockPreconditioner< MATRIX >::mesh_pt(), oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::My_mesh_pt, OOMPH_CURRENT_FUNCTION, and OOMPH_EXCEPTION_LOCATION.

◆ operator=()

template<typename MATRIX >

void oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::operator= ( const SimpleBlockDiagonalPreconditioner< MATRIX > & )

inline

Broken assignment operator.

   {
    BrokenCopy::broken_assign("SimpleBlockDiagonalPreconditioner");
   }

References oomph::BrokenCopy::broken_assign().

◆ preconditioner_solve()

template<typename MATRIX >

void oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::preconditioner_solve	(	const DoubleVector &	r,
		DoubleVector &	z
	)

virtual

Apply preconditioner to r.

Preconditioner solve for the block diagonal preconditioner.

Implements oomph::Preconditioner.

   {
    
    // Get number of blocks
    unsigned n_block = this->nblock_types();
    
    // Split up rhs vector into sub-vectors, re-arranged to match
    // the matrix blocks
    Vector<DoubleVector> block_r;
    this->get_block_vectors(r,block_r);
  
   // Solution of block solves
   Vector<DoubleVector> block_z(n_block);
   for (unsigned i = 0; i < n_block; i++)
    {
     Diagonal_block_preconditioner_pt[i]->preconditioner_solve(block_r[i],
                                                               block_z[i]);
    }
   
   // Copy solution in block vectors block_z back to z
   this->return_block_vectors(block_z,z);
   }

References i, and UniformPSDSelfTest::r.

◆ setup()

template<typename MATRIX >

void oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::setup

virtual

Setup the preconditioner.

The setup function.

Implements oomph::Preconditioner.

  {
  
   // Only set the mesh if this is a master block preconditioner.
   // Otherwise, the DOF ordering information is given by the
   // master block preconditioner.
   if(this->is_master_block_preconditioner())
   {
     const unsigned my_nmesh = My_mesh_pt.size();
  
 #ifdef PARANOID
     if(my_nmesh == 0)
     {
       std::ostringstream err_msg;
       err_msg << "There are no meshes set.\n"
               << "Please set at least one mesh with push_back_mesh(...)";
       throw OomphLibError(err_msg.str(),
                           OOMPH_CURRENT_FUNCTION,
                           OOMPH_EXCEPTION_LOCATION);
     }
 #endif
     // Set the nmesh in the BlockPreconditioner base class
     this->set_nmesh(my_nmesh);
  
     // Loop through all the meshes and set them.
     for (unsigned mesh_i = 0; mesh_i < my_nmesh; mesh_i++) 
     {
       this->set_mesh(mesh_i,My_mesh_pt[mesh_i]);
     }
   }
  
   // Set up the block look up scheme
   this->block_setup();
  
   // Number of blocks 
   unsigned nblock_types = this->nblock_types();
  
   // Resize the storage for the diagonal blocks
   Diagonal_block_preconditioner_pt.resize(nblock_types);
  
   // Create the subsidiary preconditioners
   for (unsigned i=0;i<nblock_types;i++)
    {
     Diagonal_block_preconditioner_pt[i] = new SuperLUPreconditioner;
    }
  
   // Get the diagonal matrix blocks
   Vector<CRDoubleMatrix*> block_diagonal_matrices(nblock_types);
   for (unsigned i=0;i<nblock_types;i++)
    {
     // Get block
     CRDoubleMatrix block;
     this->get_block(i,i,block);
     
     // Set up preconditioner (i.e. lu-decompose the block)
     Diagonal_block_preconditioner_pt[i]->setup(&block); 
     
     // Done with this block now, so can go out of scope; LU decomposition
     // is retained in superlu
    }
  }

References block(), i, OOMPH_CURRENT_FUNCTION, and OOMPH_EXCEPTION_LOCATION.

Member Data Documentation

◆ Diagonal_block_preconditioner_pt

template<typename MATRIX >

Vector<Preconditioner*> oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::Diagonal_block_preconditioner_pt

private

Vector of preconditioner pointers for storing the preconditioners for each diagonal block

Referenced by oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::~SimpleBlockDiagonalPreconditioner().

◆ My_mesh_pt

template<typename MATRIX >

Vector<const Mesh*> oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::My_mesh_pt

private

Vector of Mesh pointers. We store it here since this preconditioner is responsible for the DOF ordering, which is determined by calls to BlockPreconditioner::set_mesh(...).

Referenced by oomph::SimpleBlockDiagonalPreconditioner< MATRIX >::add_mesh().

The documentation for this class was generated from the following file:

simple_block_preconditioners.h

Public Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

template<typename MATRIX> class oomph::SimpleBlockDiagonalPreconditioner< MATRIX >

Constructor & Destructor Documentation

◆ SimpleBlockDiagonalPreconditioner() [1/2]

◆ ~SimpleBlockDiagonalPreconditioner()

◆ SimpleBlockDiagonalPreconditioner() [2/2]

Member Function Documentation

◆ add_mesh()

◆ operator=()

◆ preconditioner_solve()

◆ setup()

Member Data Documentation

◆ Diagonal_block_preconditioner_pt

◆ My_mesh_pt

template<typename MATRIX>
class oomph::SimpleBlockDiagonalPreconditioner< MATRIX >