This class provides an interface to the suite of preconditioners available from PETSc. More...

#include <petsc_preconditioner.h>

Inheritance diagram for libMesh::PetscPreconditioner< T >:

Public Member Functions
	PetscPreconditioner (const libMesh::Parallel::Communicator &comm_in)
	Constructor. More...

virtual	~PetscPreconditioner ()=default

virtual void	apply (const NumericVector< T > &x, NumericVector< T > &y) override
	Computes the preconditioned vector `y` based on input vector `x`. More...

virtual void	clear () override
	Release all memory and clear data structures. More...

virtual void	init () override
	Initialize data structures if not done so already. More...

PC	pc ()

bool	initialized () const

virtual void	setup ()
	This is called every time the "operator might have changed". More...

void	set_matrix (SparseMatrix< Number > &mat)
	Sets the matrix to be preconditioned. More...

PreconditionerType	type () const

void	set_type (const PreconditionerType pct)
	Sets the type of preconditioner to use. More...

const Parallel::Communicator &	comm () const

processor_id_type	n_processors () const

processor_id_type	processor_id () const

Static Public Member Functions
static void	set_petsc_preconditioner_type (const PreconditionerType &preconditioner_type, PC &pc)
	Tells PETSc to use the user-specified preconditioner. More...

static std::unique_ptr< Preconditioner< T > >	build_preconditioner (const libMesh::Parallel::Communicator &comm, const SolverPackage solver_package=libMesh::default_solver_package())
	Builds a `Preconditioner` using the linear solver package specified by `solver_package`, returning the result wrapped in a std::unique_ptr for safety. More...

static std::string	get_info ()
	Gets a string containing the reference information. More...

static void	print_info (std::ostream &out_stream=libMesh::out)
	Prints the reference information, by default to `libMesh::out`. More...

static unsigned int	n_objects ()
	Prints the number of outstanding (created, but not yet destroyed) objects. More...

static void	enable_print_counter_info ()
	Methods to enable/disable the reference counter output from print_info() More...

static void	disable_print_counter_info ()

Protected Types
typedef std::map< std::string, std::pair< unsigned int, unsigned int > >	Counts
	Data structure to log the information. More...

Protected Member Functions
void	increment_constructor_count (const std::string &name) noexcept
	Increments the construction counter. More...

void	increment_destructor_count (const std::string &name) noexcept
	Increments the destruction counter. More...

Protected Attributes
WrappedPetsc< PC >	_pc
	Preconditioner context. More...

Mat	_mat
	PETSc Mat pulled out of the _matrix object during init(). More...

SparseMatrix< T > *	_matrix
	The matrix P... More...

PreconditionerType	_preconditioner_type
	Enum stating with type of preconditioner to use. More...

bool	_is_initialized
	Flag indicating if the data structures have been initialized. More...

const Parallel::Communicator &	_communicator

Static Protected Attributes
static Counts	_counts
	Actually holds the data. More...

static Threads::atomic< unsigned int >	_n_objects
	The number of objects. More...

static Threads::spin_mutex	_mutex
	Mutual exclusion object to enable thread-safe reference counting. More...

static bool	_enable_print_counter = true
	Flag to control whether reference count information is printed when print_info is called. More...

Static Private Member Functions
static void	set_petsc_subpreconditioner_type (const PCType type, PC &pc)
	Some PETSc preconditioners (ILU, LU) don't work in parallel. More...

Detailed Description

template<typename T>
class libMesh::PetscPreconditioner< T >

This class provides an interface to the suite of preconditioners available from PETSc.

All overridden virtual functions are documented in preconditioner.h.

Author: Derek Gaston

Date: 2009

Definition at line 56 of file petsc_preconditioner.h.

Member Typedef Documentation

◆ Counts

typedef std::map<std::string, std::pair<unsigned int, unsigned int> > libMesh::ReferenceCounter::Counts

protectedinherited

Data structure to log the information.

The log is identified by the class name.

Definition at line 119 of file reference_counter.h.

Constructor & Destructor Documentation

◆ PetscPreconditioner()

template<typename T >

libMesh::PetscPreconditioner< T >::PetscPreconditioner ( const libMesh::Parallel::Communicator & comm_in )

Constructor.

Initializes PetscPreconditioner data structures

Definition at line 34 of file petsc_preconditioner.C.

                                                                                         :
   Preconditioner<T>(comm_in)
 {}

◆ ~PetscPreconditioner()

template<typename T >

virtual libMesh::PetscPreconditioner< T >::~PetscPreconditioner ( )

virtualdefault

Member Function Documentation

◆ apply()

template<typename T >

void libMesh::PetscPreconditioner< T >::apply	(	const NumericVector< T > &	x,
		NumericVector< T > &	y
	)

overridevirtual

Computes the preconditioned vector y based on input vector x.

This is usually done by solving \( Py=x \) to get the action of \( P^-1 x \).

Implements libMesh::Preconditioner< T >.

Definition at line 41 of file petsc_preconditioner.C.

References libMesh::ierr, and libMesh::PetscVector< T >::vec().

 {
   PetscVector<T> & x_pvec = cast_ref<PetscVector<T> &>(const_cast<NumericVector<T> &>(x));
   PetscVector<T> & y_pvec = cast_ref<PetscVector<T> &>(const_cast<NumericVector<T> &>(y));
 
   Vec x_vec = x_pvec.vec();
   Vec y_vec = y_pvec.vec();
 
   PetscErrorCode ierr = PCApply(_pc, x_vec, y_vec);
   LIBMESH_CHKERR(ierr);
 }

◆ build_preconditioner()

template<typename T >

std::unique_ptr< Preconditioner< T > > libMesh::Preconditioner< T >::build_preconditioner	(	const libMesh::Parallel::Communicator &	comm,
		const SolverPackage	solver_package = `libMesh::default_solver_package()`
	)

staticinherited

Builds a Preconditioner using the linear solver package specified by solver_package, returning the result wrapped in a std::unique_ptr for safety.

Definition at line 50 of file preconditioner.C.

 {
   // Avoid unused parameter warnings when no solver packages are enabled.
   libmesh_ignore(comm);
 
   // Build and return the appropriate Preconditioner object.
   switch (solver_package)
     {
 
 #ifdef LIBMESH_HAVE_PETSC
     case PETSC_SOLVERS:
       {
         return std::make_unique<PetscPreconditioner<T>>(comm);
       }
 #endif
 
 #ifdef LIBMESH_TRILINOS_HAVE_EPETRA
     case TRILINOS_SOLVERS:
       return std::make_unique<TrilinosPreconditioner<T>>(comm);
 #endif
 
 #ifdef LIBMESH_HAVE_EIGEN
     case EIGEN_SOLVERS:
       return std::make_unique<EigenPreconditioner<T>>(comm);
 #endif
 
     default:
       libmesh_error_msg("ERROR:  Unrecognized solver package: " << solver_package);
     }
 }

◆ clear()

template<typename T >

void libMesh::PetscPreconditioner< T >::clear ( )

overridevirtual

Release all memory and clear data structures.

Reimplemented from libMesh::Preconditioner< T >.

Definition at line 93 of file petsc_preconditioner.C.

 {
   // Calls custom deleter
   _pc.destroy();
 }

◆ comm()

const Parallel::Communicator& libMesh::ParallelObject::comm ( ) const

inlineinherited

Returns: A reference to the Parallel::Communicator object used by this mesh.

Definition at line 97 of file parallel_object.h.

References libMesh::ParallelObject::_communicator.

98 { return _communicator; }

libMesh::ParallelObject::_communicator

const Parallel::Communicator & _communicator

Definition: parallel_object.h:120

◆ disable_print_counter_info()

void libMesh::ReferenceCounter::disable_print_counter_info ( )

staticinherited

Definition at line 100 of file reference_counter.C.

References libMesh::ReferenceCounter::_enable_print_counter.

 {
   _enable_print_counter = false;
   return;
 }

◆ enable_print_counter_info()

void libMesh::ReferenceCounter::enable_print_counter_info ( )

staticinherited

Methods to enable/disable the reference counter output from print_info()

Definition at line 94 of file reference_counter.C.

References libMesh::ReferenceCounter::_enable_print_counter.

 {
   _enable_print_counter = true;
   return;
 }

◆ get_info()

std::string libMesh::ReferenceCounter::get_info ( )

staticinherited

Gets a string containing the reference information.

Definition at line 47 of file reference_counter.C.

References libMesh::ReferenceCounter::_counts, and libMesh::Quality::name().

Referenced by libMesh::ReferenceCounter::print_info().

 {
 #if defined(LIBMESH_ENABLE_REFERENCE_COUNTING) && defined(DEBUG)
 
   std::ostringstream oss;
 
   oss << '\n'
       << " ---------------------------------------------------------------------------- \n"
       << "| Reference count information                                                |\n"
       << " ---------------------------------------------------------------------------- \n";
 
   for (const auto & [name, cd] : _counts)
     oss << "| " << name << " reference count information:\n"
         << "|  Creations:    " << cd.first    << '\n'
         << "|  Destructions: " << cd.second << '\n';
 
   oss << " ---------------------------------------------------------------------------- \n";
 
   return oss.str();
 
 #else
 
   return "";
 
 #endif
 }

◆ increment_constructor_count()

void libMesh::ReferenceCounter::increment_constructor_count ( const std::string & name )

inlineprotectednoexceptinherited

Increments the construction counter.

Should be called in the constructor of any derived class that will be reference counted.

Definition at line 183 of file reference_counter.h.

References libMesh::err, libMesh::BasicOStreamProxy< charT, traits >::get(), libMesh::Quality::name(), and libMesh::Threads::spin_mtx.

Referenced by libMesh::ReferenceCountedObject< RBParametrized >::ReferenceCountedObject().

 {
   libmesh_try
   {
     Threads::spin_mutex::scoped_lock lock(Threads::spin_mtx);
     std::pair<unsigned int, unsigned int> & p = _counts[name];
     p.first++;
   }
   libmesh_catch (...)
   {
     auto stream = libMesh::err.get();
     stream->exceptions(stream->goodbit); // stream must not throw
     libMesh::err << "Encountered unrecoverable error while calling "
                  << "ReferenceCounter::increment_constructor_count() "
                  << "for a(n) " << name << " object." << std::endl;
     std::terminate();
   }
 }

◆ increment_destructor_count()

void libMesh::ReferenceCounter::increment_destructor_count ( const std::string & name )

inlineprotectednoexceptinherited

Increments the destruction counter.

Should be called in the destructor of any derived class that will be reference counted.

Definition at line 207 of file reference_counter.h.

References libMesh::err, libMesh::BasicOStreamProxy< charT, traits >::get(), libMesh::Quality::name(), and libMesh::Threads::spin_mtx.

Referenced by libMesh::ReferenceCountedObject< RBParametrized >::~ReferenceCountedObject().

 {
   libmesh_try
   {
     Threads::spin_mutex::scoped_lock lock(Threads::spin_mtx);
     std::pair<unsigned int, unsigned int> & p = _counts[name];
     p.second++;
   }
   libmesh_catch (...)
   {
     auto stream = libMesh::err.get();
     stream->exceptions(stream->goodbit); // stream must not throw
     libMesh::err << "Encountered unrecoverable error while calling "
                  << "ReferenceCounter::increment_destructor_count() "
                  << "for a(n) " << name << " object." << std::endl;
     std::terminate();
   }
 }

◆ init()

template<typename T >

void libMesh::PetscPreconditioner< T >::init ( )

overridevirtual

Initialize data structures if not done so already.

Note: This MUST be called before the preconditioning object is used.

Reimplemented from libMesh::Preconditioner< T >.

Definition at line 57 of file petsc_preconditioner.C.

References libMesh::libMeshPrivateData::_is_initialized, and libMesh::ierr.

 {
   libmesh_error_msg_if(!this->_matrix, "ERROR: No matrix set for PetscPreconditioner, but init() called");
 
   // Clear the preconditioner in case it has been created in the past
   if (!this->_is_initialized)
     {
       // Should probably use PCReset(), but it's not working at the moment so we'll destroy instead
       if (_pc)
         _pc.destroy();
 
       PetscErrorCode ierr = PCCreate(this->comm().get(), _pc.get());
       LIBMESH_CHKERR(ierr);
 
       auto pmatrix = cast_ptr<PetscMatrix<T> *>(this->_matrix);
       _mat = pmatrix->mat();
     }
 
   PetscErrorCode ierr = PCSetOperators(_pc, _mat, _mat);
   LIBMESH_CHKERR(ierr);
 
   // Set the PCType.  Note: this used to be done *before* the call to
   // PCSetOperators(), and only when !_is_initialized, but
   // 1.) Some preconditioners (those employing sub-preconditioners,
   // for example) have to call PCSetUp(), and can only do this after
   // the operators have been set.
   // 2.) It should be safe to call set_petsc_preconditioner_type()
   // multiple times.
   set_petsc_preconditioner_type(this->_preconditioner_type, *_pc);
 
   this->_is_initialized = true;
 }

◆ initialized()

template<typename T>

bool libMesh::Preconditioner< T >::initialized ( ) const

inlineinherited

Returns: true if the data structures are initialized, false otherwise.

Definition at line 84 of file preconditioner.h.

Referenced by libMesh::libmesh_petsc_preconditioner_setup().

84 { return _is_initialized; }

libMesh::Preconditioner::_is_initialized

bool _is_initialized

Flag indicating if the data structures have been initialized.

Definition: preconditioner.h:143

◆ n_objects()

static unsigned int libMesh::ReferenceCounter::n_objects ( )

inlinestaticinherited

Prints the number of outstanding (created, but not yet destroyed) objects.

Definition at line 85 of file reference_counter.h.

References libMesh::ReferenceCounter::_n_objects.

Referenced by libMesh::LibMeshInit::~LibMeshInit().

86 { return _n_objects; }

libMesh::ReferenceCounter::_n_objects

static Threads::atomic< unsigned int > _n_objects

The number of objects.

Definition: reference_counter.h:132

◆ n_processors()

processor_id_type libMesh::ParallelObject::n_processors ( ) const

inlineinherited

Returns: The number of processors in the group.

Definition at line 103 of file parallel_object.h.

References libMesh::ParallelObject::_communicator, libMesh::libmesh_assert(), and TIMPI::Communicator::size().

   {
     processor_id_type returnval =
       cast_int<processor_id_type>(_communicator.size());
     libmesh_assert(returnval); // We never have an empty comm
     return returnval;
   }

◆ pc()

template<typename T >

PC libMesh::PetscPreconditioner< T >::pc ( )

Returns: The PETSc PC object. Can be useful for implementing more advanced algorithms.

Definition at line 102 of file petsc_preconditioner.C.

 {
   return _pc;
 }

◆ print_info()

void libMesh::ReferenceCounter::print_info ( std::ostream & out_stream = libMesh::out )

staticinherited

Prints the reference information, by default to libMesh::out.

Definition at line 81 of file reference_counter.C.

References libMesh::ReferenceCounter::_enable_print_counter, and libMesh::ReferenceCounter::get_info().

Referenced by libMesh::LibMeshInit::~LibMeshInit().

 {
   if (_enable_print_counter)
     out_stream << ReferenceCounter::get_info();
 }

◆ processor_id()

processor_id_type libMesh::ParallelObject::processor_id ( ) const

inlineinherited

Returns: The rank of this processor in the group.

Definition at line 114 of file parallel_object.h.

References libMesh::ParallelObject::_communicator, and TIMPI::Communicator::rank().

115 { return cast_int<processor_id_type>(_communicator.rank()); }

TIMPI::Communicator::rank

processor_id_type rank() const

libMesh::ParallelObject::_communicator

const Parallel::Communicator & _communicator

Definition: parallel_object.h:120

◆ set_matrix()

template<typename T >

void libMesh::Preconditioner< T >::set_matrix ( SparseMatrix< Number > & mat )

inherited

Sets the matrix to be preconditioned.

Definition at line 159 of file preconditioner.h.

 {
   //If the matrix is changing then we (probably) need to reinitialize.
   _is_initialized = false;
   _matrix = &mat;
 }

◆ set_petsc_preconditioner_type()

template<typename T >

void libMesh::PetscPreconditioner< T >::set_petsc_preconditioner_type	(	const PreconditionerType &	preconditioner_type,
		PC &	pc
	)

static

Tells PETSc to use the user-specified preconditioner.

Definition at line 110 of file petsc_preconditioner.C.

References libMesh::AMG_PRECOND, libMesh::ASM_PRECOND, libMesh::BLOCK_JACOBI_PRECOND, libMesh::CHOLESKY_PRECOND, communicator, libMesh::EISENSTAT_PRECOND, libMesh::err, libMesh::ICC_PRECOND, libMesh::IDENTITY_PRECOND, libMesh::ierr, libMesh::ILU_PRECOND, libMesh::JACOBI_PRECOND, libMesh::LU_PRECOND, libMesh::SHELL_PRECOND, libMesh::SOR_PRECOND, libMesh::SVD_PRECOND, and libMesh::USER_PRECOND.

 {
   PetscErrorCode ierr = 0;
 
   // get the communicator from the PETSc object
   Parallel::communicator comm;
   PetscObjectGetComm((PetscObject)pc, & comm);
   Parallel::Communicator communicator(comm);
 
   switch (preconditioner_type)
     {
     case IDENTITY_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCNONE));
       CHKERRABORT(comm,ierr);
       break;
 
     case CHOLESKY_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCCHOLESKY));
       CHKERRABORT(comm,ierr);
       break;
 
     case ICC_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCICC));
       CHKERRABORT(comm,ierr);
       break;
 
     case ILU_PRECOND:
       {
         // In serial, just set the ILU preconditioner type
         if (communicator.size())
           {
             ierr = PCSetType (pc, const_cast<KSPType>(PCILU));
             CHKERRABORT(comm,ierr);
           }
         else
           {
             // But PETSc has no truly parallel ILU, instead you have to set
             // an actual parallel preconditioner (e.g. block Jacobi) and then
             // assign ILU sub-preconditioners.
             ierr = PCSetType (pc, const_cast<KSPType>(PCBJACOBI));
             CHKERRABORT(comm,ierr);
 
             // Set ILU as the sub preconditioner type
             set_petsc_subpreconditioner_type(PCILU, pc);
           }
         break;
       }
 
     case LU_PRECOND:
       {
         // In serial, just set the LU preconditioner type
         if (communicator.size())
           {
             ierr = PCSetType (pc, const_cast<KSPType>(PCLU));
             CHKERRABORT(comm,ierr);
           }
         else
           {
             // But PETSc has no truly parallel LU, instead you have to set
             // an actual parallel preconditioner (e.g. block Jacobi) and then
             // assign LU sub-preconditioners.
             ierr = PCSetType (pc, const_cast<KSPType>(PCBJACOBI));
             CHKERRABORT(comm,ierr);
 
             // Set ILU as the sub preconditioner type
             set_petsc_subpreconditioner_type(PCLU, pc);
           }
         break;
       }
 
     case ASM_PRECOND:
       {
         // In parallel, I think ASM uses ILU by default as the sub-preconditioner...
         // I tried setting a different sub-preconditioner here, but apparently the matrix
         // is not in the correct state (at this point) to call PCSetUp().
         ierr = PCSetType (pc, const_cast<KSPType>(PCASM));
         CHKERRABORT(comm,ierr);
         break;
       }
 
     case JACOBI_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCJACOBI));
       CHKERRABORT(comm,ierr);
       break;
 
     case BLOCK_JACOBI_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCBJACOBI));
       CHKERRABORT(comm,ierr);
       break;
 
     case SOR_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCSOR));
       CHKERRABORT(comm,ierr);
       break;
 
     case EISENSTAT_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCEISENSTAT));
       CHKERRABORT(comm,ierr);
       break;
 
     case AMG_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCHYPRE));
       CHKERRABORT(comm,ierr);
       break;
 
     case SVD_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCSVD));
       CHKERRABORT(comm,ierr);
       break;
 
     case USER_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCMAT));
       CHKERRABORT(comm,ierr);
       break;
 
     case SHELL_PRECOND:
       ierr = PCSetType (pc, const_cast<KSPType>(PCSHELL));
       CHKERRABORT(comm,ierr);
       break;
 
     default:
       libMesh::err << "ERROR:  Unsupported PETSC Preconditioner: "
                    << preconditioner_type       << std::endl
                    << "Continuing with PETSC defaults" << std::endl;
     }
 
   // Set additional options if we are doing AMG and
   // HYPRE is available
 #ifdef LIBMESH_HAVE_PETSC_HYPRE
   if (preconditioner_type == AMG_PRECOND)
     {
       ierr = PCHYPRESetType(pc, "boomeramg");
       CHKERRABORT(comm,ierr);
     }
 #endif
 
   // Let the commandline override stuff
   ierr = PCSetFromOptions(pc);
   CHKERRABORT(comm,ierr);
 }

◆ set_petsc_subpreconditioner_type()

template<typename T >

void libMesh::PetscPreconditioner< T >::set_petsc_subpreconditioner_type	(	const PCType	type,
		PC &	pc
	)

staticprivate

Some PETSc preconditioners (ILU, LU) don't work in parallel.

This function is called from set_petsc_preconditioner_type() to set additional options for those so-called sub-preconditioners. This method ends up being static so that it can be called from set_petsc_preconditioner_type(). Not sure why set_petsc_preconditioner_type() needs to be static though...

Definition at line 253 of file petsc_preconditioner.C.

References communicator, and libMesh::ierr.

 {
   // For catching PETSc error return codes
   PetscErrorCode ierr = 0;
 
   // get the communicator from the PETSc object
   Parallel::communicator comm;
   PetscObjectGetComm((PetscObject)pc, & comm);
   Parallel::Communicator communicator(comm);
 
   // All docs say must call KSPSetUp or PCSetUp before calling PCBJacobiGetSubKSP.
   // You must call PCSetUp after the preconditioner operators have been set, otherwise you get the:
   //
   // "Object is in wrong state!"
   // "Matrix must be set first."
   //
   // error messages...
   ierr = PCSetUp(pc);
   CHKERRABORT(comm,ierr);
 
   // To store array of local KSP contexts on this processor
   KSP * subksps;
 
   // the number of blocks on this processor
   PetscInt n_local;
 
   // The global number of the first block on this processor.
   // This is not used, so we just pass null instead.
   // int first_local;
 
   // Fill array of local KSP contexts
   ierr = PCBJacobiGetSubKSP(pc, &n_local, LIBMESH_PETSC_NULLPTR,
                             &subksps);
   CHKERRABORT(comm,ierr);
 
   // Loop over sub-ksp objects, set ILU preconditioner
   for (PetscInt i=0; i<n_local; ++i)
     {
       // Get pointer to sub KSP object's PC
       PC subpc;
       ierr = KSPGetPC(subksps[i], &subpc);
       CHKERRABORT(comm,ierr);
 
       // Set requested type on the sub PC
       ierr = PCSetType(subpc, type);
       CHKERRABORT(comm,ierr);
     }
 }

◆ set_type()

template<typename T >

void libMesh::Preconditioner< T >::set_type ( const PreconditionerType pct )

inherited

Sets the type of preconditioner to use.

Definition at line 168 of file preconditioner.h.

 {
   //If the preconditioner type changes we (probably) need to reinitialize.
   _is_initialized = false;
   _preconditioner_type = pct;
 }

◆ setup()

template<typename T>

virtual void libMesh::Preconditioner< T >::setup ( )

inlinevirtualinherited

This is called every time the "operator might have changed".

This is where you need to fill in your preconditioning matrix.

Definition at line 110 of file preconditioner.h.

Referenced by libMesh::libmesh_petsc_preconditioner_setup().

110 {}

◆ type()

template<typename T>

PreconditionerType libMesh::Preconditioner< T >::type ( ) const

inlineinherited

Returns: The type of preconditioner to use.

Definition at line 120 of file preconditioner.h.

120 { return _preconditioner_type; }

libMesh::Preconditioner::_preconditioner_type

PreconditionerType _preconditioner_type

Enum stating with type of preconditioner to use.

Definition: preconditioner.h:138

Member Data Documentation

◆ _communicator

const Parallel::Communicator& libMesh::ParallelObject::_communicator

protectedinherited

Definition at line 120 of file parallel_object.h.

Referenced by libMesh::EquationSystems::build_parallel_elemental_solution_vector(), libMesh::EquationSystems::build_parallel_solution_vector(), libMesh::ParallelObject::comm(), libMesh::ParallelObject::n_processors(), libMesh::ParallelObject::operator=(), libMesh::ParallelObject::processor_id(), and libMesh::BoundaryInfo::regenerate_id_sets().

◆ _counts

ReferenceCounter::Counts libMesh::ReferenceCounter::_counts

staticprotectedinherited

Actually holds the data.

Definition at line 124 of file reference_counter.h.

Referenced by libMesh::ReferenceCounter::get_info().

◆ _enable_print_counter

bool libMesh::ReferenceCounter::_enable_print_counter = true

staticprotectedinherited

Flag to control whether reference count information is printed when print_info is called.

Definition at line 143 of file reference_counter.h.

Referenced by libMesh::ReferenceCounter::disable_print_counter_info(), libMesh::ReferenceCounter::enable_print_counter_info(), and libMesh::ReferenceCounter::print_info().

◆ _is_initialized

template<typename T>

bool libMesh::Preconditioner< T >::_is_initialized

protectedinherited

Flag indicating if the data structures have been initialized.

Definition at line 143 of file preconditioner.h.

Referenced by libMesh::Preconditioner< Number >::initialized().

◆ _mat

template<typename T >

Mat libMesh::PetscPreconditioner< T >::_mat

protected

PETSc Mat pulled out of the _matrix object during init().

We aren't responsible for cleaning up this one.

Definition at line 95 of file petsc_preconditioner.h.

◆ _matrix

template<typename T>

SparseMatrix<T>* libMesh::Preconditioner< T >::_matrix

protectedinherited

The matrix P...

ie the matrix to be preconditioned. This is often the actual system matrix of a linear system.

Definition at line 133 of file preconditioner.h.

◆ _mutex

Threads::spin_mutex libMesh::ReferenceCounter::_mutex

staticprotectedinherited

Mutual exclusion object to enable thread-safe reference counting.

Definition at line 137 of file reference_counter.h.

◆ _n_objects

Threads::atomic< unsigned int > libMesh::ReferenceCounter::_n_objects

staticprotectedinherited

The number of objects.

Print the reference count information when the number returns to 0.

Definition at line 132 of file reference_counter.h.

Referenced by libMesh::ReferenceCounter::n_objects(), libMesh::ReferenceCounter::ReferenceCounter(), and libMesh::ReferenceCounter::~ReferenceCounter().

◆ _pc

template<typename T >

WrappedPetsc<PC> libMesh::PetscPreconditioner< T >::_pc

protected

Preconditioner context.

Definition at line 89 of file petsc_preconditioner.h.

◆ _preconditioner_type

template<typename T>

PreconditionerType libMesh::Preconditioner< T >::_preconditioner_type

protectedinherited

Enum stating with type of preconditioner to use.

Definition at line 138 of file preconditioner.h.

Referenced by libMesh::Preconditioner< Number >::type().

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

include/numerics/petsc_preconditioner.h
src/numerics/petsc_preconditioner.C

Public Member Functions

Static Public Member Functions

Protected Types

Protected Member Functions

Protected Attributes

Static Protected Attributes

Static Private Member Functions

Detailed Description

template<typename T> class libMesh::PetscPreconditioner< T >

Member Typedef Documentation

◆ Counts

Constructor & Destructor Documentation

◆ PetscPreconditioner()

◆ ~PetscPreconditioner()

Member Function Documentation

◆ apply()

◆ build_preconditioner()

◆ clear()

◆ comm()

◆ disable_print_counter_info()

◆ enable_print_counter_info()

◆ get_info()

◆ increment_constructor_count()

◆ increment_destructor_count()

◆ init()

◆ initialized()

◆ n_objects()

◆ n_processors()

◆ pc()

◆ print_info()

◆ processor_id()

◆ set_matrix()

◆ set_petsc_preconditioner_type()

◆ set_petsc_subpreconditioner_type()

◆ set_type()

◆ setup()

◆ type()

Member Data Documentation

◆ _communicator

◆ _counts

◆ _enable_print_counter

◆ _is_initialized

◆ _mat

◆ _matrix

◆ _mutex

◆ _n_objects

◆ _pc

◆ _preconditioner_type

template<typename T>
class libMesh::PetscPreconditioner< T >