Class PoissonFACPreconditionerStrategy is an abstract FACPreconditionerStrategy implementing many of the operations required by smoothers for the Poisson equation and related problems. More...

#include <ibtk/PoissonFACPreconditionerStrategy.h>

Inheritance diagram for IBTK::PoissonFACPreconditionerStrategy:

[legend]

Public Member Functions
	PoissonFACPreconditionerStrategy (std::string object_name, SAMRAI::tbox::Pointer< SAMRAI::hier::Variable< NDIM > > scratch_var, int ghost_cell_width, SAMRAI::tbox::Pointer< SAMRAI::tbox::Database > input_db, const std::string &default_options_prefix)
	Constructor. More...

	~PoissonFACPreconditionerStrategy ()
	Destructor. More...

virtual void	setPoissonSpecifications (const SAMRAI::solv::PoissonSpecifications &poisson_spec)
	Set the SAMRAI::solv::PoissonSpecifications object used to specify the coefficients for the scalar-valued or vector-valued Laplace operator. More...

virtual void	setPhysicalBcCoef (SAMRAI::solv::RobinBcCoefStrategy< NDIM > *bc_coef)
	Set the SAMRAI::solv::RobinBcCoefStrategy object used to specify physical boundary conditions. More...

virtual void	setPhysicalBcCoefs (const std::vector< SAMRAI::solv::RobinBcCoefStrategy< NDIM > * > &bc_coefs)
	Set the SAMRAI::solv::RobinBcCoefStrategy objects used to specify physical boundary conditions. More...

const std::string &	getName () const
	Return the object name. More...

virtual bool	getIsInitialized () const
	Return whether the operator is initialized. More...

virtual void	setFACPreconditioner (SAMRAI::tbox::ConstPointer< FACPreconditioner > preconditioner)
	Method to allow the FACPreconditioner object to register itself with the concrete FACPreconditionerStrategy. More...

virtual void	setHomogeneousBc (bool homogeneous_bc)
	Set whether the solver should use homogeneous boundary conditions. More...

virtual bool	getHomogeneousBc () const
	Return whether the solver is using homogeneous boundary conditions. More...

virtual void	setSolutionTime (double solution_time)
	Set the time at which the solution is to be evaluated. More...

virtual double	getSolutionTime () const
	Get the time at which the solution is being evaluated. More...

virtual void	setTimeInterval (double current_time, double new_time)
	Set the current time interval. More...

virtual std::pair< double, double >	getTimeInterval () const
	Get the current time interval. More...

virtual double	getDt () const
	Get the current time step size. More...

virtual void	smoothError (SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &error, const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &residual, int level_num, int num_sweeps, bool performing_pre_sweeps, bool performing_post_sweeps)=0
	Smooth the error by the specified number of sweeps on the specified level of the patch hierarchy. More...

virtual bool	solveCoarsestLevel (SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &error, const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &residual, int coarsest_level_num)=0
	Solve the system of equations on the coarsest level of the patch hierarchy. More...

virtual void	computeResidual (SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &residual, const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &solution, const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &rhs, int coarsest_level_num, int finest_level_num)=0
	Compute the composite-grid residual on the specified range of levels of the patch hierarchy. More...

virtual void	allocateScratchData ()
	Allocate scratch data. More...

virtual void	deallocateScratchData ()
	Deallocate scratch data. More...

Logging functions.
SAMRAI::tbox::ConstPointer< IBTK::FACPreconditioner >	d_preconditioner

const std::string	d_object_name

bool	d_is_initialized = false

bool	d_homogeneous_bc

double	d_solution_time = std::numeric_limits<double>::quiet_NaN()

double	d_current_time = std::numeric_limits<double>::quiet_NaN()

double	d_new_time = std::numeric_limits<double>::quiet_NaN()

virtual void	printClassData (std::ostream &stream)
	Print class data to stream. More...

virtual SAMRAI::tbox::Pointer< SAMRAI::solv::SAMRAIVectorReal< NDIM, double > >	getLevelSAMRAIVectorReal (const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &vec, int level_num) const
	Return a SAMRAIVectorReal object that corresponds to the given object but restricted to a single level of the patch hierarchy. More...

Functions for configuring the solver.
void	setResetLevels (int coarsest_ln, int finest_ln)
	Specify the levels that need to be reset the next time the operator is re-initialized. More...

virtual void	setSmootherType (const std::string &smoother_type)=0
	Specify the smoother type. More...

virtual void	setCoarseSolverType (const std::string &coarse_solver_type)=0
	Specify the coarse level solver. More...

void	setCoarseSolverMaxIterations (int coarse_solver_max_iterations)
	Set the maximum number of iterations for the coarse level solve. More...

void	setCoarseSolverAbsoluteTolerance (double coarse_solver_abs_residual_tol)
	Set the absolute residual tolerance for convergence for coarse level solve. More...

void	setCoarseSolverRelativeTolerance (double coarse_solver_rel_residual_tol)
	Set the relative residual tolerance for convergence for coarse level solve. More...

void	setProlongationMethod (const std::string &prolongation_method)
	Set the name of the prolongation method. More...

void	setRestrictionMethod (const std::string &restriction_method)
	Set the name of the restriction method. More...

Partial implementation of FACPreconditionerStrategy interface.
void	setToZero (SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &vec, int level_num) override
	Zero the supplied vector. More...

void	restrictResidual (const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &src, SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &dst, int dst_ln) override
	Restrict the residual quantity to the specified level from the next finer level. More...

void	prolongError (const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &src, SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &dst, int dst_ln) override
	Prolong the error quantity to the specified level from the next coarser level. More...

void	prolongErrorAndCorrect (const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &src, SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &dst, int dst_ln) override
	Prolong the error quantity to the specified level from the next coarser level and apply the correction to the fine-level error. More...

void	initializeOperatorState (const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &solution, const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &rhs) override
	Compute hierarchy-dependent data. More...

void	deallocateOperatorState () override
	Remove all hierarchy-dependent data. More...

virtual void	initializeOperatorStateSpecialized (const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &solution, const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &rhs, int coarsest_reset_ln, int finest_reset_ln)=0
	Compute implementation-specific hierarchy-dependent data. More...

virtual void	deallocateOperatorStateSpecialized (int coarsest_reset_ln, int finest_reset_ln)=0
	Remove implementation-specific hierarchy-dependent data. More...

Methods for executing, caching, and resetting communication
schedules.
SAMRAI::solv::PoissonSpecifications	d_poisson_spec

std::unique_ptr< SAMRAI::solv::RobinBcCoefStrategy< NDIM > >	d_default_bc_coef

std::vector< SAMRAI::solv::RobinBcCoefStrategy< NDIM > * >	d_bc_coefs

SAMRAI::hier::IntVector< NDIM >	d_gcw

void	xeqScheduleProlongation (int dst_idx, int src_idx, int dst_ln)
	Execute a refinement schedule for prolonging data. More...

void	xeqScheduleRestriction (int dst_idx, int src_idx, int dst_ln)
	Execute schedule for restricting solution or residual to the specified level. More...

void	xeqScheduleGhostFillNoCoarse (int dst_idx, int dst_ln)
	Execute schedule for filling ghosts on the specified level. More...

void	xeqScheduleDataSynch (int dst_idx, int dst_ln)
	Execute schedule for synchronizing data on the specified level. More...

Various refine and coarsen objects.
SAMRAI::tbox::Pointer< RobinPhysBdryPatchStrategy >	d_bc_op

SAMRAI::tbox::Pointer< CoarseFineBoundaryRefinePatchStrategy >	d_cf_bdry_op

SAMRAI::tbox::Pointer< SAMRAI::xfer::VariableFillPattern< NDIM > >	d_op_stencil_fill_pattern

SAMRAI::tbox::Pointer< SAMRAI::xfer::VariableFillPattern< NDIM > >	d_synch_fill_pattern

SAMRAI::tbox::Pointer< SAMRAI::xfer::RefineOperator< NDIM > >	d_prolongation_refine_operator

SAMRAI::tbox::Pointer< SAMRAI::xfer::RefinePatchStrategy< NDIM > >	d_prolongation_refine_patch_strategy

SAMRAI::tbox::Pointer< SAMRAI::xfer::RefineAlgorithm< NDIM > >	d_prolongation_refine_algorithm

std::vector< SAMRAI::tbox::Pointer< SAMRAI::xfer::RefineSchedule< NDIM > > >	d_prolongation_refine_schedules

SAMRAI::tbox::Pointer< SAMRAI::xfer::CoarsenOperator< NDIM > >	d_restriction_coarsen_operator

SAMRAI::tbox::Pointer< SAMRAI::xfer::CoarsenAlgorithm< NDIM > >	d_restriction_coarsen_algorithm

std::vector< SAMRAI::tbox::Pointer< SAMRAI::xfer::CoarsenSchedule< NDIM > > >	d_restriction_coarsen_schedules

SAMRAI::tbox::Pointer< SAMRAI::xfer::RefineAlgorithm< NDIM > >	d_ghostfill_nocoarse_refine_algorithm

std::vector< SAMRAI::tbox::Pointer< SAMRAI::xfer::RefineSchedule< NDIM > > >	d_ghostfill_nocoarse_refine_schedules

SAMRAI::tbox::Pointer< SAMRAI::xfer::RefineAlgorithm< NDIM > >	d_synch_refine_algorithm

std::vector< SAMRAI::tbox::Pointer< SAMRAI::xfer::RefineSchedule< NDIM > > >	d_synch_refine_schedules

	PoissonFACPreconditionerStrategy ()=delete
	Default constructor. More...

	PoissonFACPreconditionerStrategy (const PoissonFACPreconditionerStrategy &from)=delete
	Copy constructor. More...

PoissonFACPreconditionerStrategy &	operator= (const PoissonFACPreconditionerStrategy &that)=delete
	Assignment operator. More...

Detailed Description

The parameter ghost_cell_width is the necessary ghost cell width for all operations required by this class and derived classes. Such operations includes restricting, prolongation, computing residuals, and smoothing error. The patch indices in the RHS vector must have ghost cell widths that are equal to this parameter.

Sample parameters for initialization from database (and their default values):

smoother_type = "DEFAULT"                    // see setSmootherType()
prolongation_method = "DEFAULT"              // see setProlongationMethod()
restriction_method = "DEFAULT"               // see setRestrictionMethod()
coarse_solver_type = "DEFAULT"               // see setCoarseSolverType()
coarse_solver_rel_residual_tol = 1.0e-5      // see setCoarseSolverRelativeTolerance()
coarse_solver_abs_residual_tol = 1.0e-50     // see setCoarseSolverAbsoluteTolerance()
coarse_solver_max_iterations = 10            // see setCoarseSolverMaxIterations()

Constructor & Destructor Documentation

◆ PoissonFACPreconditionerStrategy() [1/3]

IBTK::PoissonFACPreconditionerStrategy::PoissonFACPreconditionerStrategy	(	std::string	object_name,
		SAMRAI::tbox::Pointer< SAMRAI::hier::Variable< NDIM > >	scratch_var,
		int	ghost_cell_width,
		SAMRAI::tbox::Pointer< SAMRAI::tbox::Database >	input_db,
		const std::string &	default_options_prefix
	)

◆ ~PoissonFACPreconditionerStrategy()

IBTK::PoissonFACPreconditionerStrategy::~PoissonFACPreconditionerStrategy ( )

◆ PoissonFACPreconditionerStrategy() [2/3]

IBTK::PoissonFACPreconditionerStrategy::PoissonFACPreconditionerStrategy ( )

privatedelete

Note: This constructor is not implemented and should not be used.

◆ PoissonFACPreconditionerStrategy() [3/3]

IBTK::PoissonFACPreconditionerStrategy::PoissonFACPreconditionerStrategy ( const PoissonFACPreconditionerStrategy & from )

privatedelete

Note: This constructor is not implemented and should not be used.

Parameters

from	The value to copy to this object.

Member Function Documentation

◆ setPoissonSpecifications()

virtual void IBTK::PoissonFACPreconditionerStrategy::setPoissonSpecifications ( const SAMRAI::solv::PoissonSpecifications & poisson_spec )

virtual

◆ setPhysicalBcCoef()

virtual void IBTK::PoissonFACPreconditionerStrategy::setPhysicalBcCoef ( SAMRAI::solv::RobinBcCoefStrategy< NDIM > * bc_coef )

virtual

Note: bc_coef may be nullptr. In this case, default boundary conditions (as supplied to the class constructor) are employed.

Parameters

bc_coef Pointer to an object that can set the Robin boundary condition coefficients

◆ setPhysicalBcCoefs()

virtual void IBTK::PoissonFACPreconditionerStrategy::setPhysicalBcCoefs ( const std::vector< SAMRAI::solv::RobinBcCoefStrategy< NDIM > * > & bc_coefs )

virtual

Note: Any of the elements of bc_coefs may be nullptr. In this case, default boundary conditions (as supplied to the class constructor) are employed for that data depth.

Parameters

bc_coefs Vector of pointers to objects that can set the Robin boundary condition coefficients

◆ setResetLevels()

void IBTK::PoissonFACPreconditionerStrategy::setResetLevels	(	int	coarsest_ln,
		int	finest_ln
	)

When the operator is initialized, then only the specified range of levels are reset in the operator state the next time that the operator is initialized. If the operator is not initialized, this method has no effect.

To ensure the range of levels that is reset includes all levels in the patch hierarchy, use coarsest_ln = finest_ln = -1.

Note: This function is used to save some unnecessary computations when the hierarchy is regridded. The range of levels specified must include all levels which need to be reset by SAMRAI::mesh::StandardTagAndInitStrategy::resetHierarchyConfiguration(). Any data residing outside of this range of levels will not be reset. This is not what you want to have happen if, for instance, the Poisson specifications changes.

◆ setSmootherType()

virtual void IBTK::PoissonFACPreconditionerStrategy::setSmootherType ( const std::string & smoother_type )

pure virtual

Implemented in IBTK::CCPoissonBoxRelaxationFACOperator, IBTK::CCPoissonPointRelaxationFACOperator, IBTK::SCPoissonPointRelaxationFACOperator, and IBTK::CCPoissonLevelRelaxationFACOperator.

◆ setCoarseSolverType()

virtual void IBTK::PoissonFACPreconditionerStrategy::setCoarseSolverType ( const std::string & coarse_solver_type )

pure virtual

Implemented in IBTK::CCPoissonBoxRelaxationFACOperator, IBTK::CCPoissonPointRelaxationFACOperator, IBTK::CCPoissonLevelRelaxationFACOperator, and IBTK::SCPoissonPointRelaxationFACOperator.

◆ setCoarseSolverMaxIterations()

void IBTK::PoissonFACPreconditionerStrategy::setCoarseSolverMaxIterations ( int coarse_solver_max_iterations )

If the coarse level solver uses a maximum number of iterations parameter, the specified value is used. If the coarse level solver does not use such a stopping parameter, implementations are free to ignore this value.

◆ setCoarseSolverAbsoluteTolerance()

void IBTK::PoissonFACPreconditionerStrategy::setCoarseSolverAbsoluteTolerance ( double coarse_solver_abs_residual_tol )

If the coarse level solver uses a absolute convergence tolerance parameter, the specified value is used. If the coarse level solver does not use such a stopping parameter, implementations are free to ignore this value.

◆ setCoarseSolverRelativeTolerance()

void IBTK::PoissonFACPreconditionerStrategy::setCoarseSolverRelativeTolerance ( double coarse_solver_rel_residual_tol )

If the coarse level solver uses a relative convergence tolerance parameter, the specified value is used. If the coarse level solver does not use such a stopping parameter, implementations are free to ignore this value.

◆ setProlongationMethod()

void IBTK::PoissonFACPreconditionerStrategy::setProlongationMethod ( const std::string & prolongation_method )

◆ setRestrictionMethod()

void IBTK::PoissonFACPreconditionerStrategy::setRestrictionMethod ( const std::string & restriction_method )

◆ setToZero()

void IBTK::PoissonFACPreconditionerStrategy::setToZero	(	SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	vec,
		int	level_num
	)

overridevirtual

Implements IBTK::FACPreconditionerStrategy.

◆ restrictResidual()

void IBTK::PoissonFACPreconditionerStrategy::restrictResidual	(	const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	src,
		SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	dst,
		int	dst_ln
	)

overridevirtual

Parameters

src	source residual
dst	destination residual
dst_ln	destination level number

Implements IBTK::FACPreconditionerStrategy.

Reimplemented in IBTK::VCSCViscousOpPointRelaxationFACOperator.

◆ prolongError()

void IBTK::PoissonFACPreconditionerStrategy::prolongError	(	const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	src,
		SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	dst,
		int	dst_ln
	)

overridevirtual

Parameters

src	source error vector
dst	destination error vector
dst_ln	destination level number of data transfer

Implements IBTK::FACPreconditionerStrategy.

◆ prolongErrorAndCorrect()

void IBTK::PoissonFACPreconditionerStrategy::prolongErrorAndCorrect	(	const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	src,
		SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	dst,
		int	dst_ln
	)

overridevirtual

Parameters

src	source error vector
dst	destination error vector
dst_ln	destination level number of data transfer

Implements IBTK::FACPreconditionerStrategy.

◆ initializeOperatorState()

void IBTK::PoissonFACPreconditionerStrategy::initializeOperatorState	(	const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	solution,
		const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	rhs
	)

overridevirtual

Note that although the vector arguments given to other methods in this class may not necessarily be the same as those given to this method, there will be similarities, including:

hierarchy configuration (hierarchy pointer and level range)
number, type and alignment of vector component data
ghost cell width of data in the solution (or solution-like) vector

An unrecoverable error will occur if the rhs vector does not have consistent ghost cell width as that provided in the constructor.

Parameters

solution	solution vector u
rhs	right hand side vector f

Reimplemented from IBTK::FACPreconditionerStrategy.

◆ deallocateOperatorState()

void IBTK::PoissonFACPreconditionerStrategy::deallocateOperatorState ( )

overridevirtual

Remove all hierarchy-dependent data set by initializeOperatorState().

See also: initializeOperatorState

Reimplemented from IBTK::FACPreconditionerStrategy.

◆ initializeOperatorStateSpecialized()

virtual void IBTK::PoissonFACPreconditionerStrategy::initializeOperatorStateSpecialized	(	const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	solution,
		const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	rhs,
		int	coarsest_reset_ln,
		int	finest_reset_ln
	)

protectedpure virtual

Implemented in IBTK::CCPoissonBoxRelaxationFACOperator, IBTK::CCPoissonPointRelaxationFACOperator, IBTK::CCPoissonLevelRelaxationFACOperator, IBTK::SCPoissonPointRelaxationFACOperator, and IBTK::VCSCViscousOpPointRelaxationFACOperator.

◆ deallocateOperatorStateSpecialized()

virtual void IBTK::PoissonFACPreconditionerStrategy::deallocateOperatorStateSpecialized	(	int	coarsest_reset_ln,
		int	finest_reset_ln
	)

protectedpure virtual

Implemented in IBTK::CCPoissonBoxRelaxationFACOperator, IBTK::CCPoissonPointRelaxationFACOperator, IBTK::CCPoissonLevelRelaxationFACOperator, and IBTK::SCPoissonPointRelaxationFACOperator.

◆ xeqScheduleProlongation()

void IBTK::PoissonFACPreconditionerStrategy::xeqScheduleProlongation	(	int	dst_idx,
		int	src_idx,
		int	dst_ln
	)

protected

◆ xeqScheduleRestriction()

void IBTK::PoissonFACPreconditionerStrategy::xeqScheduleRestriction	(	int	dst_idx,
		int	src_idx,
		int	dst_ln
	)

protected

◆ xeqScheduleGhostFillNoCoarse()

void IBTK::PoissonFACPreconditionerStrategy::xeqScheduleGhostFillNoCoarse	(	int	dst_idx,
		int	dst_ln
	)

protected

◆ xeqScheduleDataSynch()

void IBTK::PoissonFACPreconditionerStrategy::xeqScheduleDataSynch	(	int	dst_idx,
		int	dst_ln
	)

protected

◆ operator=()

PoissonFACPreconditionerStrategy& IBTK::PoissonFACPreconditionerStrategy::operator= ( const PoissonFACPreconditionerStrategy & that )

privatedelete

Note: This operator is not implemented and should not be used.

Parameters

that	The value to assign to this object.

Returns: A reference to this object.

◆ getName()

const std::string& IBTK::FACPreconditionerStrategy::getName ( ) const

inherited

◆ getIsInitialized()

virtual bool IBTK::FACPreconditionerStrategy::getIsInitialized ( ) const

virtualinherited

◆ setFACPreconditioner()

virtual void IBTK::FACPreconditionerStrategy::setFACPreconditioner ( SAMRAI::tbox::ConstPointer< FACPreconditioner > preconditioner )

virtualinherited

◆ setHomogeneousBc()

virtual void IBTK::FACPreconditionerStrategy::setHomogeneousBc ( bool homogeneous_bc )

virtualinherited

◆ getHomogeneousBc()

virtual bool IBTK::FACPreconditionerStrategy::getHomogeneousBc ( ) const

virtualinherited

◆ setSolutionTime()

virtual void IBTK::FACPreconditionerStrategy::setSolutionTime ( double solution_time )

virtualinherited

◆ getSolutionTime()

virtual double IBTK::FACPreconditionerStrategy::getSolutionTime ( ) const

virtualinherited

◆ setTimeInterval()

virtual void IBTK::FACPreconditionerStrategy::setTimeInterval	(	double	current_time,
		double	new_time
	)

virtualinherited

◆ getTimeInterval()

virtual std::pair<double, double> IBTK::FACPreconditionerStrategy::getTimeInterval ( ) const

virtualinherited

◆ getDt()

virtual double IBTK::FACPreconditionerStrategy::getDt ( ) const

virtualinherited

◆ smoothError()

virtual void IBTK::FACPreconditionerStrategy::smoothError	(	SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	error,
		const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	residual,
		int	level_num,
		int	num_sweeps,
		bool	performing_pre_sweeps,
		bool	performing_post_sweeps
	)

pure virtualinherited

Implemented in IBAMR::StaggeredStokesIBLevelRelaxationFACOperator, IBTK::CCPoissonBoxRelaxationFACOperator, IBTK::CCPoissonPointRelaxationFACOperator, IBTK::CCPoissonLevelRelaxationFACOperator, IBTK::SCPoissonPointRelaxationFACOperator, IBAMR::StaggeredStokesLevelRelaxationFACOperator, IBTK::VCSCViscousOpPointRelaxationFACOperator, and IBAMR::StaggeredStokesBoxRelaxationFACOperator.

◆ solveCoarsestLevel()

virtual bool IBTK::FACPreconditionerStrategy::solveCoarsestLevel	(	SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	error,
		const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	residual,
		int	coarsest_level_num
	)

pure virtualinherited

Returns: true if the solver converged to specified tolerance, false otherwise

Implemented in IBAMR::StaggeredStokesFACPreconditionerStrategy, IBTK::CCPoissonBoxRelaxationFACOperator, IBTK::CCPoissonPointRelaxationFACOperator, IBTK::CCPoissonLevelRelaxationFACOperator, and IBTK::SCPoissonPointRelaxationFACOperator.

◆ computeResidual()

virtual void IBTK::FACPreconditionerStrategy::computeResidual	(	SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	residual,
		const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	solution,
		const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	rhs,
		int	coarsest_level_num,
		int	finest_level_num
	)

pure virtualinherited

Implemented in IBAMR::StaggeredStokesFACPreconditionerStrategy, IBAMR::StaggeredStokesIBLevelRelaxationFACOperator, IBTK::CCPoissonBoxRelaxationFACOperator, IBTK::CCPoissonPointRelaxationFACOperator, IBTK::CCPoissonLevelRelaxationFACOperator, IBTK::SCPoissonPointRelaxationFACOperator, and IBTK::VCSCViscousOpPointRelaxationFACOperator.

◆ allocateScratchData()

virtual void IBTK::FACPreconditionerStrategy::allocateScratchData ( )

virtualinherited

◆ deallocateScratchData()

virtual void IBTK::FACPreconditionerStrategy::deallocateScratchData ( )

virtualinherited

◆ printClassData()

virtual void IBTK::FACPreconditionerStrategy::printClassData ( std::ostream & stream )

virtualinherited

◆ getLevelSAMRAIVectorReal()

virtual SAMRAI::tbox::Pointer<SAMRAI::solv::SAMRAIVectorReal<NDIM, double> > IBTK::FACPreconditionerStrategy::getLevelSAMRAIVectorReal	(	const SAMRAI::solv::SAMRAIVectorReal< NDIM, double > &	vec,
		int	level_num
	)		const

protectedvirtualinherited

Member Data Documentation

◆ d_poisson_spec

SAMRAI::solv::PoissonSpecifications IBTK::PoissonFACPreconditionerStrategy::d_poisson_spec

protected

◆ d_default_bc_coef

std::unique_ptr<SAMRAI::solv::RobinBcCoefStrategy<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_default_bc_coef

protected

◆ d_bc_coefs

std::vector<SAMRAI::solv::RobinBcCoefStrategy<NDIM>*> IBTK::PoissonFACPreconditionerStrategy::d_bc_coefs

protected

◆ d_gcw

SAMRAI::hier::IntVector<NDIM> IBTK::PoissonFACPreconditionerStrategy::d_gcw

protected

◆ d_solution

SAMRAI::tbox::Pointer<SAMRAI::solv::SAMRAIVectorReal<NDIM, double> > IBTK::PoissonFACPreconditionerStrategy::d_solution

protected

◆ d_rhs

SAMRAI::tbox::Pointer<SAMRAI::solv::SAMRAIVectorReal<NDIM, double> > IBTK::PoissonFACPreconditionerStrategy::d_rhs

protected

◆ d_hierarchy

SAMRAI::tbox::Pointer<SAMRAI::hier::PatchHierarchy<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_hierarchy

protected

◆ d_coarsest_ln

int IBTK::PoissonFACPreconditionerStrategy::d_coarsest_ln = IBTK::invalid_level_number

protected

◆ d_finest_ln

int IBTK::PoissonFACPreconditionerStrategy::d_finest_ln = IBTK::invalid_level_number

protected

◆ d_level_data_ops

std::vector<SAMRAI::tbox::Pointer<SAMRAI::math::HierarchyDataOpsReal<NDIM, double> > > IBTK::PoissonFACPreconditionerStrategy::d_level_data_ops

protected

◆ d_level_bdry_fill_ops

std::vector<SAMRAI::tbox::Pointer<IBTK::HierarchyGhostCellInterpolation> > IBTK::PoissonFACPreconditionerStrategy::d_level_bdry_fill_ops

protected

◆ d_level_math_ops

std::vector<SAMRAI::tbox::Pointer<IBTK::HierarchyMathOps> > IBTK::PoissonFACPreconditionerStrategy::d_level_math_ops

protected

◆ d_in_initialize_operator_state

bool IBTK::PoissonFACPreconditionerStrategy::d_in_initialize_operator_state = false

protected

◆ d_coarsest_reset_ln

int IBTK::PoissonFACPreconditionerStrategy::d_coarsest_reset_ln = IBTK::invalid_level_number

protected

◆ d_finest_reset_ln

int IBTK::PoissonFACPreconditionerStrategy::d_finest_reset_ln = IBTK::invalid_level_number

protected

◆ d_smoother_type

std::string IBTK::PoissonFACPreconditionerStrategy::d_smoother_type = "DEFAULT"

protected

◆ d_prolongation_method

std::string IBTK::PoissonFACPreconditionerStrategy::d_prolongation_method = "DEFAULT"

protected

◆ d_restriction_method

std::string IBTK::PoissonFACPreconditionerStrategy::d_restriction_method = "DEFAULT"

protected

◆ d_coarse_solver_type

std::string IBTK::PoissonFACPreconditionerStrategy::d_coarse_solver_type = "DEFAULT"

protected

◆ d_coarse_solver_default_options_prefix

std::string IBTK::PoissonFACPreconditionerStrategy::d_coarse_solver_default_options_prefix

protected

◆ d_coarse_solver_rel_residual_tol

double IBTK::PoissonFACPreconditionerStrategy::d_coarse_solver_rel_residual_tol = 1.0e-5

protected

◆ d_coarse_solver_abs_residual_tol

double IBTK::PoissonFACPreconditionerStrategy::d_coarse_solver_abs_residual_tol = 1.0e-50

protected

◆ d_coarse_solver_max_iterations

int IBTK::PoissonFACPreconditionerStrategy::d_coarse_solver_max_iterations = 10

protected

◆ d_context

SAMRAI::tbox::Pointer<SAMRAI::hier::VariableContext> IBTK::PoissonFACPreconditionerStrategy::d_context

protected

◆ d_scratch_idx

int IBTK::PoissonFACPreconditionerStrategy::d_scratch_idx = IBTK::invalid_index

protected

◆ d_bc_op

SAMRAI::tbox::Pointer<RobinPhysBdryPatchStrategy> IBTK::PoissonFACPreconditionerStrategy::d_bc_op

protected

◆ d_cf_bdry_op

SAMRAI::tbox::Pointer<CoarseFineBoundaryRefinePatchStrategy> IBTK::PoissonFACPreconditionerStrategy::d_cf_bdry_op

protected

◆ d_op_stencil_fill_pattern

SAMRAI::tbox::Pointer<SAMRAI::xfer::VariableFillPattern<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_op_stencil_fill_pattern

protected

◆ d_synch_fill_pattern

SAMRAI::tbox::Pointer<SAMRAI::xfer::VariableFillPattern<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_synch_fill_pattern

protected

◆ d_prolongation_refine_operator

SAMRAI::tbox::Pointer<SAMRAI::xfer::RefineOperator<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_prolongation_refine_operator

private

◆ d_prolongation_refine_patch_strategy

SAMRAI::tbox::Pointer<SAMRAI::xfer::RefinePatchStrategy<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_prolongation_refine_patch_strategy

private

◆ d_prolongation_refine_algorithm

SAMRAI::tbox::Pointer<SAMRAI::xfer::RefineAlgorithm<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_prolongation_refine_algorithm

private

◆ d_prolongation_refine_schedules

std::vector<SAMRAI::tbox::Pointer<SAMRAI::xfer::RefineSchedule<NDIM> > > IBTK::PoissonFACPreconditionerStrategy::d_prolongation_refine_schedules

private

◆ d_restriction_coarsen_operator

SAMRAI::tbox::Pointer<SAMRAI::xfer::CoarsenOperator<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_restriction_coarsen_operator

private

◆ d_restriction_coarsen_algorithm

SAMRAI::tbox::Pointer<SAMRAI::xfer::CoarsenAlgorithm<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_restriction_coarsen_algorithm

private

◆ d_restriction_coarsen_schedules

std::vector<SAMRAI::tbox::Pointer<SAMRAI::xfer::CoarsenSchedule<NDIM> > > IBTK::PoissonFACPreconditionerStrategy::d_restriction_coarsen_schedules

private

◆ d_ghostfill_nocoarse_refine_algorithm

SAMRAI::tbox::Pointer<SAMRAI::xfer::RefineAlgorithm<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_ghostfill_nocoarse_refine_algorithm

private

◆ d_ghostfill_nocoarse_refine_schedules

std::vector<SAMRAI::tbox::Pointer<SAMRAI::xfer::RefineSchedule<NDIM> > > IBTK::PoissonFACPreconditionerStrategy::d_ghostfill_nocoarse_refine_schedules

private

◆ d_synch_refine_algorithm

SAMRAI::tbox::Pointer<SAMRAI::xfer::RefineAlgorithm<NDIM> > IBTK::PoissonFACPreconditionerStrategy::d_synch_refine_algorithm

private

◆ d_synch_refine_schedules

std::vector<SAMRAI::tbox::Pointer<SAMRAI::xfer::RefineSchedule<NDIM> > > IBTK::PoissonFACPreconditionerStrategy::d_synch_refine_schedules

private

◆ d_preconditioner

SAMRAI::tbox::ConstPointer<IBTK::FACPreconditioner> IBTK::FACPreconditionerStrategy::d_preconditioner

protectedinherited

◆ d_object_name

const std::string IBTK::FACPreconditionerStrategy::d_object_name

protectedinherited

◆ d_is_initialized

bool IBTK::FACPreconditionerStrategy::d_is_initialized = false

protectedinherited

◆ d_homogeneous_bc

bool IBTK::FACPreconditionerStrategy::d_homogeneous_bc

protectedinherited

◆ d_solution_time

double IBTK::FACPreconditionerStrategy::d_solution_time = std::numeric_limits<double>::quiet_NaN()

protectedinherited

◆ d_current_time

double IBTK::FACPreconditionerStrategy::d_current_time = std::numeric_limits<double>::quiet_NaN()

protectedinherited

◆ d_new_time

double IBTK::FACPreconditionerStrategy::d_new_time = std::numeric_limits<double>::quiet_NaN()

protectedinherited

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

ibtk/include/ibtk/PoissonFACPreconditionerStrategy.h

Public Member Functions

Logging functions.

Functions for configuring the solver.

Partial implementation of FACPreconditionerStrategy interface.

Methods for executing, caching, and resetting communication

Various refine and coarsen objects.

Detailed Description

Constructor & Destructor Documentation

◆ PoissonFACPreconditionerStrategy() [1/3]

◆ ~PoissonFACPreconditionerStrategy()

◆ PoissonFACPreconditionerStrategy() [2/3]

◆ PoissonFACPreconditionerStrategy() [3/3]

Member Function Documentation

◆ setPoissonSpecifications()

◆ setPhysicalBcCoef()

◆ setPhysicalBcCoefs()

◆ setResetLevels()

◆ setSmootherType()

◆ setCoarseSolverType()

◆ setCoarseSolverMaxIterations()

◆ setCoarseSolverAbsoluteTolerance()

◆ setCoarseSolverRelativeTolerance()

◆ setProlongationMethod()

◆ setRestrictionMethod()

◆ setToZero()

◆ restrictResidual()

◆ prolongError()

◆ prolongErrorAndCorrect()

◆ initializeOperatorState()

◆ deallocateOperatorState()

◆ initializeOperatorStateSpecialized()

◆ deallocateOperatorStateSpecialized()

◆ xeqScheduleProlongation()

◆ xeqScheduleRestriction()

◆ xeqScheduleGhostFillNoCoarse()

◆ xeqScheduleDataSynch()

◆ operator=()

◆ getName()

◆ getIsInitialized()

◆ setFACPreconditioner()

◆ setHomogeneousBc()

◆ getHomogeneousBc()

◆ setSolutionTime()

◆ getSolutionTime()

◆ setTimeInterval()

◆ getTimeInterval()

◆ getDt()

◆ smoothError()

◆ solveCoarsestLevel()

◆ computeResidual()

◆ allocateScratchData()

◆ deallocateScratchData()

◆ printClassData()

◆ getLevelSAMRAIVectorReal()

Member Data Documentation

◆ d_poisson_spec

◆ d_default_bc_coef

◆ d_bc_coefs

◆ d_gcw

◆ d_solution

◆ d_rhs

◆ d_hierarchy

◆ d_coarsest_ln

◆ d_finest_ln

◆ d_level_data_ops

◆ d_level_bdry_fill_ops

◆ d_level_math_ops

◆ d_in_initialize_operator_state

◆ d_coarsest_reset_ln

◆ d_finest_reset_ln

◆ d_smoother_type

◆ d_prolongation_method

◆ d_restriction_method

◆ d_coarse_solver_type

◆ d_coarse_solver_default_options_prefix

◆ d_coarse_solver_rel_residual_tol

◆ d_coarse_solver_abs_residual_tol

◆ d_coarse_solver_max_iterations

◆ d_context

◆ d_scratch_idx