Reference documentation for deal.II version 9.4.0

#include <deal.II/multigrid/mg_base.h>
Public Member Functions  
virtual  ~MGTransferBase () override=default 
virtual void  prolongate (const unsigned int to_level, VectorType &dst, const VectorType &src) const =0 
virtual void  prolongate_and_add (const unsigned int to_level, VectorType &dst, const VectorType &src) const 
virtual void  restrict_and_add (const unsigned int from_level, VectorType &dst, const VectorType &src) const =0 
Subscriptor functionality  
Classes derived from Subscriptor provide a facility to subscribe to this object. This is mostly used by the SmartPointer class.  
void  subscribe (std::atomic< bool > *const validity, const std::string &identifier="") const 
void  unsubscribe (std::atomic< bool > *const validity, const std::string &identifier="") const 
unsigned int  n_subscriptions () const 
template<typename StreamType >  
void  list_subscribers (StreamType &stream) const 
void  list_subscribers () const 
template<class Archive >  
void  serialize (Archive &ar, const unsigned int version) 
using  map_value_type = decltype(counter_map)::value_type 
using  map_iterator = decltype(counter_map)::iterator 
std::atomic< unsigned int >  counter 
std::map< std::string, unsigned int >  counter_map 
std::vector< std::atomic< bool > * >  validity_pointers 
const std::type_info *  object_info 
static std::mutex  mutex 
static ::ExceptionBase &  ExcInUse (int arg1, std::string arg2, std::string arg3) 
static ::ExceptionBase &  ExcNoSubscriber (std::string arg1, std::string arg2) 
void  check_no_subscribers () const noexcept 
Base class used to declare the operations needed by a concrete class implementing prolongation and restriction of vectors in the multigrid context. This class is abstract and has no implementation of these operations.
There are several derived classes, reflecting the fact that vector types and numbering of the finegrid discretization and of the multilevel implementation are independent.
If you use multigrid for a single PDE or for your complete system of equations, you will use MGTransferPrebuilt together with Multigrid. The vector types used on the fine grid as well as for the multilevel operations may be Vector or BlockVector. In both cases, MGTransferPrebuilt will operate on all components of the solution.
For mixed systems, it may be required to do multigrid only for a single component or for some components. The classes MGTransferSelect and MGTransferBlock handle these cases.
MGTransferSelect is used if you use multigrid (on Vector objects) for a single component, possibly grouped using mg_target_component
.
The class MGTransferBlock handles the case where your multigrid method operates on BlockVector objects. These can contain all or a consecutive set of the blocks of the complete system. Since most smoothers cannot operate on block structures, it is not clear whether this case is really useful. Therefore, a tested implementation of this case will be supplied when needed.

overridevirtualdefault 
Destructor. Does nothing here, but needs to be declared virtual anyway.

pure virtual 
Prolongate a vector from level to_level1
to level to_level
. The previous content of dst
is overwritten.
Implemented in MGTransferBlock< number >, MGTransferBlockMatrixFreeBase< dim, Number, TransferType >, MGTransferBlockMatrixFreeBase< dim, Number, MGTransferMatrixFree< dim, Number > >, MGTransferBlockMatrixFreeBase< dim, VectorType::value_type, MGTransferGlobalCoarsening< dim, VectorType > >, MGTransferMatrixFree< dim, Number >, MGTransferBlockSelect< number >, MGTransferSelect< number >, MGTransferPrebuilt< VectorType >, and MGTransferGlobalCoarsening< dim, VectorType >.

virtual 
Prolongate a vector from level to_level1
to level to_level
, summing into the previous content of dst
.
Reimplemented in MGTransferBlockMatrixFreeBase< dim, Number, TransferType >, MGTransferBlockMatrixFreeBase< dim, Number, MGTransferMatrixFree< dim, Number > >, MGTransferBlockMatrixFreeBase< dim, VectorType::value_type, MGTransferGlobalCoarsening< dim, VectorType > >, and MGTransferGlobalCoarsening< dim, VectorType >.
Definition at line 47 of file mg_base.cc.

pure virtual 
Restrict a vector from level from_level
to level from_level1
and add this restriction to dst
. If the region covered by cells on level from_level
is smaller than that of level from_level1
(local refinement), then some degrees of freedom in dst
are active and will not be altered. For the other degrees of freedom, the result of the restriction is added.
Implemented in MGTransferBlock< number >, MGTransferBlockMatrixFreeBase< dim, Number, TransferType >, MGTransferBlockMatrixFreeBase< dim, Number, MGTransferMatrixFree< dim, Number > >, MGTransferBlockMatrixFreeBase< dim, VectorType::value_type, MGTransferGlobalCoarsening< dim, VectorType > >, MGTransferMatrixFree< dim, Number >, MGTransferBlockSelect< number >, MGTransferSelect< number >, MGTransferPrebuilt< VectorType >, and MGTransferGlobalCoarsening< dim, VectorType >.