Wrapper for AMGX's AMG preconditioner. More...

#include <AmgxPreconditioner.hpp>

Inheritance diagram for Amgx::AmgxPreconditioner< M, X, Y >:

Public Types
using	matrix_type = M
	The matrix type the preconditioner is for. More...

using	matrix_field_type = typename M::field_type
	The field type of the matrix. More...

using	domain_type = X
	The domain type of the preconditioner. More...

using	range_type = Y
	The range type of the preconditioner. More...

using	vector_field_type = typename X::field_type
	The field type of the vectors. More...

Public Member Functions
	AmgxPreconditioner (const M &A, const Opm::PropertyTree prm)
	Constructor for AmgxPreconditioner. More...

	~AmgxPreconditioner ()
	Destructor for AmgxPreconditioner. More...

void	pre (X &, Y &) override
	Pre-processing step before applying the preconditioner. More...

void	apply (X &v, const Y &d) override
	Applies the preconditioner to a vector. More...

void	post (X &) override
	Post-processing step after applying the preconditioner. More...

void	update () override
	Updates the preconditioner with the current matrix values. More...

Dune::SolverCategory::Category	category () const override
	Returns the solver category. More...

bool	hasPerfectUpdate () const override
	Checks if the preconditioner has a perfect update. More...

Static Public Attributes
static constexpr int	block_size = 1

Detailed Description

template<class M, class X, class Y>
class Amgx::AmgxPreconditioner< M, X, Y >

Wrapper for AMGX's AMG preconditioner.

This class provides an interface to the AMG preconditioner from the AMGX library. It is designed to work with matrices, update vectors, and defect vectors specified by the template parameters. The AmgxInterface class provides a unified interface to AMGX's functionality, allowing for easy switching between CPU and GPU input data types.

Template Parameters

M	The matrix type
X	The vector type for the solution
Y	The vector type for the right-hand side

Member Typedef Documentation

◆ domain_type

template<class M , class X , class Y >

using Amgx::AmgxPreconditioner< M, X, Y >::domain_type = X

The domain type of the preconditioner.

◆ matrix_field_type

template<class M , class X , class Y >

using Amgx::AmgxPreconditioner< M, X, Y >::matrix_field_type = typename M::field_type

The field type of the matrix.

◆ matrix_type

template<class M , class X , class Y >

using Amgx::AmgxPreconditioner< M, X, Y >::matrix_type = M

The matrix type the preconditioner is for.

◆ range_type

template<class M , class X , class Y >

using Amgx::AmgxPreconditioner< M, X, Y >::range_type = Y

The range type of the preconditioner.

◆ vector_field_type

template<class M , class X , class Y >

using Amgx::AmgxPreconditioner< M, X, Y >::vector_field_type = typename X::field_type

The field type of the vectors.

Constructor & Destructor Documentation

◆ AmgxPreconditioner()

template<class M , class X , class Y >

Amgx::AmgxPreconditioner< M, X, Y >::AmgxPreconditioner	(	const M &	A,
		const Opm::PropertyTree	prm
	)

inline

Constructor for AmgxPreconditioner.

Initializes the AMGX preconditioner with the given matrix and property tree.

Parameters

A	The matrix for which to construct the preconditioner
prm	The property tree containing configuration parameters

References Amgx::AmgxPreconditioner< M, X, Y >::block_size, Opm::gpuistl::AmgxInterface::createConfig(), Opm::gpuistl::AmgxInterface::createMatrix(), Opm::gpuistl::AmgxInterface::createResources(), Opm::gpuistl::AmgxInterface::createSolver(), Opm::gpuistl::AmgxInterface::createVector(), Opm::gpuistl::AmgxInterface::initializeMatrix(), Opm::gpuistl::AmgxInterface::initializeVector(), Amgx::AmgxConfig::toString(), and Amgx::AmgxPreconditioner< M, X, Y >::update().

◆ ~AmgxPreconditioner()

template<class M , class X , class Y >

Amgx::AmgxPreconditioner< M, X, Y >::~AmgxPreconditioner ( )

inline

Destructor for AmgxPreconditioner.

Cleans up resources allocated by the preconditioner.

References Opm::gpuistl::AmgxInterface::destroyConfig(), Opm::gpuistl::AmgxInterface::destroyMatrix(), Opm::gpuistl::AmgxInterface::destroyResources(), Opm::gpuistl::AmgxInterface::destroySolver(), and Opm::gpuistl::AmgxInterface::destroyVector().

Member Function Documentation

◆ apply()

template<class M , class X , class Y >

void Amgx::AmgxPreconditioner< M, X, Y >::apply	(	X &	v,
		const Y &	d
	)

inlineoverride

Applies the preconditioner to a vector.

Performs one AMG cycle to solve the system. Involves uploading vectors to AMGX, applying the preconditioner, and transferring the result back to the vector.

Parameters

v	The update vector.
d	The defect vector.

References Opm::gpuistl::AmgxInterface::transferVectorFromAmgx(), and Opm::gpuistl::AmgxInterface::transferVectorToAmgx().

◆ category()

template<class M , class X , class Y >

Dune::SolverCategory::Category Amgx::AmgxPreconditioner< M, X, Y >::category ( ) const

inlineoverride

Returns the solver category.

Returns: The solver category (sequential).

◆ hasPerfectUpdate()

template<class M , class X , class Y >

bool Amgx::AmgxPreconditioner< M, X, Y >::hasPerfectUpdate ( ) const

inlineoverridevirtual

Checks if the preconditioner has a perfect update.

Returns: True, as the preconditioner can be perfectly updated.

Implements Dune::PreconditionerWithUpdate< X, Y >.

◆ post()

template<class M , class X , class Y >

void Amgx::AmgxPreconditioner< M, X, Y >::post ( X & )

inlineoverride

Post-processing step after applying the preconditioner.

This method is currently a no-op.

Parameters

v	The update vector.

◆ pre()

template<class M , class X , class Y >

void Amgx::AmgxPreconditioner< M, X, Y >::pre	(	X &	,
		Y &
	)

inlineoverride

Pre-processing step before applying the preconditioner.

This method is currently a no-op.

Parameters

v	The update vector.
d	The defect vector.

◆ update()

template<class M , class X , class Y >

void Amgx::AmgxPreconditioner< M, X, Y >::update ( )

inlineoverridevirtual

Updates the preconditioner with the current matrix values.

This method should be called whenever the matrix values change.

Implements Dune::PreconditionerWithUpdate< X, Y >.

References Opm::gpuistl::AmgxInterface::updateMatrixValues().

Referenced by Amgx::AmgxPreconditioner< M, X, Y >::AmgxPreconditioner().

Member Data Documentation

◆ block_size

template<class M , class X , class Y >

constexpr int Amgx::AmgxPreconditioner< M, X, Y >::block_size = 1

staticconstexpr

Referenced by Amgx::AmgxPreconditioner< M, X, Y >::AmgxPreconditioner().

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

AmgxPreconditioner.hpp

Public Types

Public Member Functions

Static Public Attributes

Detailed Description

Member Typedef Documentation

◆ domain_type

◆ matrix_field_type

◆ matrix_type

◆ range_type

◆ vector_field_type

Constructor & Destructor Documentation

◆ AmgxPreconditioner()

◆ ~AmgxPreconditioner()

Member Function Documentation

◆ apply()

◆ category()

◆ hasPerfectUpdate()

◆ post()

◆ pre()

◆ update()

Member Data Documentation

◆ block_size