Reference documentation for deal.II version GIT e22cb6a53e 20230921 14:00:02+00:00

#include <deal.II/lac/petsc_solver.h>
Classes  
struct  AdditionalData 
Public Member Functions  
SolverTCQMR (SolverControl &cn, const AdditionalData &data=AdditionalData())  
SolverTCQMR (SolverControl &cn, const MPI_Comm mpi_communicator, const AdditionalData &data=AdditionalData())  
void  solve (const MatrixBase &A, VectorBase &x, const VectorBase &b, const PreconditionBase &preconditioner) 
virtual void  reset () 
void  set_prefix (const std::string &prefix) 
SolverControl &  control () const 
void  initialize (const PreconditionBase &preconditioner) 
KSP  petsc_ksp () 
operator KSP () const  
Protected Member Functions  
virtual void  set_solver_type (KSP &ksp) const override 
void  initialize_ksp_with_comm (const MPI_Comm comm) 
void  perhaps_set_convergence_test () const 
Protected Attributes  
const AdditionalData  additional_data 
KSP  ksp 
SmartPointer< SolverControl, SolverBase >  solver_control 
std::string  prefix_name 
Static Private Member Functions  
static PetscErrorCode  convergence_test (KSP ksp, const PetscInt iteration, const PetscReal residual_norm, KSPConvergedReason *reason, void *solver_control) 
An implementation of the solver interface using the PETSc TFQMR2 solver (called TCQMR in PETSc). Note that this solver had a serious bug in versions up to and including PETSc 2.1.6, in that it did not check convergence and always returned an error code. Thus, this class will abort with an error indicating failure to converge with PETSc 2.1.6 and prior. This should be fixed in later versions of PETSc, though.
Definition at line 679 of file petsc_solver.h.
PETScWrappers::SolverTCQMR::SolverTCQMR  (  SolverControl &  cn, 
const AdditionalData &  data = AdditionalData() 

) 
Constructor. In contrast to deal.II's own solvers, there is no need to give a vector memory object.
The last argument takes a structure with additional, solver dependent flags for tuning.
Definition at line 515 of file petsc_solver.cc.
PETScWrappers::SolverTCQMR::SolverTCQMR  (  SolverControl &  cn, 
const MPI_Comm  mpi_communicator,  
const AdditionalData &  data = AdditionalData() 

) 
Constructor. This constructor is deprecated and ignores the MPI communicator argument. Use the other constructor instead.
Definition at line 521 of file petsc_solver.cc.

overrideprotectedvirtual 
Function that takes a Krylov Subspace Solver context object, and sets the type of solver that is appropriate for this class.
Reimplemented from PETScWrappers::SolverBase.
Definition at line 529 of file petsc_solver.cc.

inherited 
Solve the linear system Ax=b
. Depending on the information provided by derived classes and the object passed as a preconditioner, one of the linear solvers and preconditioners of PETSc is chosen. Repeated calls to solve() do not reconstruct the preconditioner for performance reasons. See class Documentation.
Definition at line 84 of file petsc_solver.cc.

virtualinherited 
Resets the contained preconditioner and solver object. See class description for more details.
Definition at line 149 of file petsc_solver.cc.

inherited 
Sets a prefix name for the solver object. Useful when customizing the PETSc KSP object with commandline options.
Definition at line 142 of file petsc_solver.cc.

inherited 
Access to object that controls convergence.
Definition at line 156 of file petsc_solver.cc.

inherited 
initialize the solver with the preconditioner. This function is intended for use with SLEPc spectral transformation class.
Definition at line 232 of file petsc_solver.cc.

inherited 
Return the PETSc KSP object.
Definition at line 69 of file petsc_solver.cc.

inherited 
Conversion operator to gain access to the underlying PETSc type. If you do this, you cut this class off some information it may need, so this conversion operator should only be used if you know what you do.
Definition at line 76 of file petsc_solver.cc.

protectedinherited 
Utility to create the KSP object and attach convergence test.
Definition at line 207 of file petsc_solver.cc.

protectedinherited 
Utility to use deal.II convergence testing.
This call changes the convergence criterion when the instance of the class has a SolverControl object associated.
Definition at line 223 of file petsc_solver.cc.

staticprivateinherited 
A function that is used in PETSc as a callback to check on convergence. It takes the information provided from PETSc and checks it against deal.II's own SolverControl objects to see if convergence has been reached.
Definition at line 167 of file petsc_solver.cc.

protected 
Store a copy of the flags for this particular solver.
Definition at line 713 of file petsc_solver.h.

protectedinherited 
The PETSc KSP object.
Definition at line 168 of file petsc_solver.h.

protectedinherited 
Reference to the object that controls convergence of the iterative solver. In fact, for these PETSc wrappers, PETSc does so itself, but we copy the data from this object before starting the solution process, and copy the data back into it afterwards.
Definition at line 176 of file petsc_solver.h.

protectedinherited 
Solver prefix name to qualify options specific to the PETSc KSP object in the current context. Note: A hyphen () must NOT be given at the beginning of the prefix name. The first character of all runtime options is AUTOMATICALLY the hyphen.
Definition at line 206 of file petsc_solver.h.