Abstract view of a block vector. More...

#include <BlockVectorView.hpp>

Inheritance diagram for geos::BlockVectorView< VECTOR >:

Public Types
using	Vector = VECTOR
	Alias for sub-vector type.

Public Member Functions
Constructors
BlockVectorView &	operator= (BlockVectorView const &rhs)=delete
	Deleted copy assignment. More...

BlockVectorView &	operator= (BlockVectorView &&rhs) noexcept=delete
	Deleted move assignment. More...

virtual	~BlockVectorView ()=default
	Destructor.

Setters
void	copy (BlockVectorView const &src)
	Update vector `y` as `y` = `x`. More...

Linear Algebra Operations
void	scale (real64 const factor)
	Scale the block vector with `factor`. More...

void	zero ()
	Set the vector to zero.

void	rand (unsigned const seed)
	Set vector elements to random entries. More...

real64	dot (BlockVectorView const &x) const
	Dot product. More...

real64	norm2 () const
	2-norm of the block vector. More...

real64	normInf () const
	Inf-norm of the block vector. More...

void	axpy (real64 const alpha, BlockVectorView const &x)
	Update vector `y` as `y = alpha*x + y`. More...

void	axpby (real64 const alpha, BlockVectorView const &x, real64 const beta)
	Update vector `y` as `y = alphax + betay`. More...

Accessors
localIndex	blockSize () const
	Get block size. More...

globalIndex	globalSize () const
	Get global size. More...

localIndex	localSize () const
	Get local size. More...

void	print (std::ostream &os=std::cout) const
	Print the block vector. More...

const VECTOR &	block (localIndex const blockIndex) const
	Get a reference to the vector corresponding to block `blockRowIndex`. More...

VECTOR &	block (localIndex const blockIndex)
	Get a reference to the vector corresponding to block `blockRowIndex`. More...

const VECTOR &	operator() (localIndex const blockIndex) const
	Get a reference to the vector corresponding to block `blockRowIndex`. More...

VECTOR &	operator() (localIndex const blockIndex)
	Get a reference to the vector corresponding to block `blockRowIndex`. More...

Protected Member Functions
void	resize (localIndex const size)
	Resize to a new number of blocks. More...

void	setPointer (localIndex i, VECTOR *vec)
	Set pointer to a vector. More...

Constructor/assignment Methods
Note Protected to prevent users from creating/copying/moving base class objects. Derived classes should still use them to size/copy/move pointer array.
	BlockVectorView (localIndex const nBlocks)
	Create a vector of `nBlocks` blocks. More...

	BlockVectorView (BlockVectorView const &)=default
	Copy constructor.

	BlockVectorView (BlockVectorView &&)=default
	Move constructor.

Detailed Description

template<typename VECTOR>
class geos::BlockVectorView< VECTOR >

Abstract view of a block vector.

Template Parameters

VECTOR type of sub-vectors

This class does not deal with constructing or storing sub-vectors, only provides high-level access functions. See derived classes BlockVector and BlockVectorWrapper for ways to construct a block vector.

Definition at line 36 of file BlockVectorView.hpp.

Constructor & Destructor Documentation

◆ BlockVectorView()

template<typename VECTOR >

geos::BlockVectorView< VECTOR >::BlockVectorView ( localIndex const nBlocks )

inlineexplicitprotected

Create a vector of nBlocks blocks.

Parameters

nBlocks number of blocks

Definition at line 219 of file BlockVectorView.hpp.

Member Function Documentation

◆ axpby()

template<typename VECTOR >

void geos::BlockVectorView< VECTOR >::axpby	(	real64 const	alpha,
		BlockVectorView< VECTOR > const &	x,
		real64 const	beta
	)

Update vector y as y = alpha*x + beta*y.

Note: The naming convention follows the logic of the BLAS library.

Parameters

alpha	scaling factor for added vector
x	vector to add
beta	scaling factor for self vector

Definition at line 344 of file BlockVectorView.hpp.

◆ axpy()

template<typename VECTOR >

void geos::BlockVectorView< VECTOR >::axpy	(	real64 const	alpha,
		BlockVectorView< VECTOR > const &	x
	)

Update vector y as y = alpha*x + y.

Note: The naming convention follows the logic of the BLAS library.

Parameters

alpha	scaling factor for added vector
x	vector to add

Definition at line 333 of file BlockVectorView.hpp.

◆ block() [1/2]

template<typename VECTOR >

VECTOR& geos::BlockVectorView< VECTOR >::block ( localIndex const blockIndex )

inline

Get a reference to the vector corresponding to block blockRowIndex.

Parameters

blockIndex index of the block to return

Returns: a reference to the sub-block

Definition at line 181 of file BlockVectorView.hpp.

◆ block() [2/2]

template<typename VECTOR >

const VECTOR& geos::BlockVectorView< VECTOR >::block ( localIndex const blockIndex ) const

inline

Get a reference to the vector corresponding to block blockRowIndex.

Parameters

blockIndex index of the block to return

Returns: a reference to the sub-block

Definition at line 172 of file BlockVectorView.hpp.

◆ blockSize()

template<typename VECTOR >

localIndex geos::BlockVectorView< VECTOR >::blockSize

Get block size.

Returns: The block size.

Definition at line 356 of file BlockVectorView.hpp.

◆ copy()

template<typename VECTOR >

void geos::BlockVectorView< VECTOR >::copy ( BlockVectorView< VECTOR > const & src )

Update vector y as y = x.

Parameters

src	the vector to copy

Definition at line 261 of file BlockVectorView.hpp.

◆ dot()

template<typename VECTOR >

real64 geos::BlockVectorView< VECTOR >::dot ( BlockVectorView< VECTOR > const & x ) const

Dot product.

Parameters

x	the block vector to compute product with

Returns: the dot product

Definition at line 298 of file BlockVectorView.hpp.

◆ globalSize()

template<typename VECTOR >

globalIndex geos::BlockVectorView< VECTOR >::globalSize

Get global size.

Returns: The global size.

Definition at line 362 of file BlockVectorView.hpp.

◆ localSize()

template<typename VECTOR >

localIndex geos::BlockVectorView< VECTOR >::localSize

Get local size.

Returns: The local size.

Definition at line 373 of file BlockVectorView.hpp.

◆ norm2()

template<typename VECTOR >

real64 geos::BlockVectorView< VECTOR >::norm2

2-norm of the block vector.

Returns: 2-norm of the block vector

Definition at line 310 of file BlockVectorView.hpp.

◆ normInf()

template<typename VECTOR >

real64 geos::BlockVectorView< VECTOR >::normInf

Inf-norm of the block vector.

Returns: inf-norm of the block vector

Definition at line 322 of file BlockVectorView.hpp.

◆ operator()() [1/2]

template<typename VECTOR >

VECTOR& geos::BlockVectorView< VECTOR >::operator() ( localIndex const blockIndex )

inline

Get a reference to the vector corresponding to block blockRowIndex.

Parameters

blockIndex index of the block to return

Returns: a reference to the sub-block

Definition at line 198 of file BlockVectorView.hpp.

◆ operator()() [2/2]

template<typename VECTOR >

const VECTOR& geos::BlockVectorView< VECTOR >::operator() ( localIndex const blockIndex ) const

inline

Get a reference to the vector corresponding to block blockRowIndex.

Parameters

blockIndex index of the block to return

Returns: a reference to the sub-block

Definition at line 190 of file BlockVectorView.hpp.

◆ operator=() [1/2]

template<typename VECTOR >

BlockVectorView& geos::BlockVectorView< VECTOR >::operator= ( BlockVectorView< VECTOR > && rhs )

deletenoexcept

Deleted move assignment.

Parameters

rhs	the block vector to move from

Returns: reference to this object

◆ operator=() [2/2]

template<typename VECTOR >

BlockVectorView& geos::BlockVectorView< VECTOR >::operator= ( BlockVectorView< VECTOR > const & rhs )

delete

Deleted copy assignment.

Parameters

rhs	the block vector to copy

Returns: reference to this object

◆ print()

template<typename VECTOR >

void geos::BlockVectorView< VECTOR >::print ( std::ostream & os = std::cout ) const

Print the block vector.

Parameters

os	the stream to print to

Definition at line 384 of file BlockVectorView.hpp.

◆ rand()

template<typename VECTOR >

void geos::BlockVectorView< VECTOR >::rand ( unsigned const seed )

Set vector elements to random entries.

Parameters

seed	the random seed to use

Definition at line 289 of file BlockVectorView.hpp.

◆ resize()

template<typename VECTOR >

void geos::BlockVectorView< VECTOR >::resize ( localIndex const size )

inlineprotected

Resize to a new number of blocks.

Parameters

size	the new size

Definition at line 239 of file BlockVectorView.hpp.

◆ scale()

template<typename VECTOR >

void geos::BlockVectorView< VECTOR >::scale ( real64 const factor )

Scale the block vector with factor.

Parameters

factor multiplication factor

Definition at line 271 of file BlockVectorView.hpp.

◆ setPointer()

template<typename VECTOR >

void geos::BlockVectorView< VECTOR >::setPointer	(	localIndex	i,
		VECTOR *	vec
	)

inlineprotected

Set pointer to a vector.

Parameters

i	index of vector
vec	new pointer to vector

Definition at line 249 of file BlockVectorView.hpp.

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

coreComponents/linearAlgebra/utilities/BlockVectorView.hpp

Public Types

Public Member Functions

Protected Member Functions

Detailed Description

template<typename VECTOR> class geos::BlockVectorView< VECTOR >

Constructor & Destructor Documentation

◆ BlockVectorView()

Member Function Documentation

◆ axpby()

◆ axpy()

◆ block() [1/2]

◆ block() [2/2]

◆ blockSize()

◆ copy()

◆ dot()

◆ globalSize()

◆ localSize()

◆ norm2()

◆ normInf()

◆ operator()() [1/2]

◆ operator()() [2/2]

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ print()

◆ rand()

◆ resize()

◆ scale()

◆ setPointer()

template<typename VECTOR>
class geos::BlockVectorView< VECTOR >