Thyra::ScalarProdVectorSpaceBase< Scalar > Class Template Reference
[Basic Support Subclasses Abstracting Application-Specific Scalar Products]

Base subclass for VectorSpaceBase that allows the definition of an application-specific scalar product to be swapped in and out. More...

#include <Thyra_ScalarProdVectorSpaceBaseDecl.hpp>

Inheritance diagram for Thyra::ScalarProdVectorSpaceBase< Scalar >:

[legend]List of all members.

Constructors / initializers
	ScalarProdVectorSpaceBase ()
	Construct to use dot product as the default.
	ScalarProdVectorSpaceBase (const Teuchos::RCP< const ScalarProdBase< Scalar > > &scalarProd)
	Construct with a different scalar product.
virtual void	setScalarProd (const Teuchos::RCP< const ScalarProdBase< Scalar > > &scalarProd)
	Set a different scalar product.
Teuchos::RCP< const ScalarProdBase< Scalar > >	getScalarProd () const
	Return the current scalar product.
Overridden from VectorSpaceBase
bool	isEuclidean () const
	Returns getScalarProd()->isEuclidean().
Scalar	scalarProd (const VectorBase< Scalar > &x, const VectorBase< Scalar > &y) const
	Returns getScalarProd()->scalarProd(x,y).
void	scalarProds (const MultiVectorBase< Scalar > &X, const MultiVectorBase< Scalar > &Y, Scalar scalar_prods[]) const
	Calls getScalarProd()->scalarProds(X,Y,scalar_prods).

---

Detailed Description

template<class Scalar>
class Thyra::ScalarProdVectorSpaceBase< Scalar >

Base subclass for VectorSpaceBase that allows the definition of an application-specific scalar product to be swapped in and out.

This subclass defines machinery for extracting out the definition of a scalar product as an object that can be replaced. The default implementation of scalar product is the Euclidean scalar product (i.e. dot product). The idea is that, in most cases, the definition of a scalar product may be more general than a specific concrete vector implementation (i.e. a single scalar product may work with all serial and all MPI-based vectors if, for example, it is implemented through an RTOpPack::RTOpT object). Or, a scalar product way work with any MPI SPMD vector or multi-vector. This subclass allows an application code to set a specialized scalar product without having to depend on a particular concrete vector (and vector space) implementation.

Almost every data-structure centric concrete VectorSpaceBase subclass should inherit from this subclass since it makes it easy for application developers to redefine the scalar product without having to create a new VectorSpaceBase subclass which can have many repercussions.

The reason that this machinery in this base subclass is separated out from the VectorSpaceDefaultBase interface class is that, first it would clutter the base interface since this machinery is an implementation artifact and, second, every VectorSpaceBase subclass will not utilize this machinery. For example, composite (see ProductVectorSpaceBase) and decorator subclasses should not derive from this subclass.

Definition at line 70 of file Thyra_ScalarProdVectorSpaceBaseDecl.hpp.

---

Constructor & Destructor Documentation

template<class Scalar>

Thyra::ScalarProdVectorSpaceBase< Scalar >::ScalarProdVectorSpaceBase

(

)

Construct to use dot product as the default.

Postconditions:

• dynamic_cast<const EuclideanScalarProd<Scalar>*>(&*this->getScalarProd()) != NULL

Definition at line 42 of file Thyra_ScalarProdVectorSpaceBase.hpp.

template<class Scalar>

Thyra::ScalarProdVectorSpaceBase< Scalar >::ScalarProdVectorSpaceBase

(

const Teuchos::RCP< const ScalarProdBase< Scalar > > &

scalarProd

)

Construct with a different scalar product.

Preconditions:

• scalarProd.get()!=NULL (throw std::invalid_argument)

Postconditions:

• this->getScalarProd().get() == scalarProd.get()

Definition at line 47 of file Thyra_ScalarProdVectorSpaceBase.hpp.

---

Member Function Documentation

template<class Scalar>

void Thyra::ScalarProdVectorSpaceBase< Scalar >::setScalarProd

(

const Teuchos::RCP< const ScalarProdBase< Scalar > > &

scalarProd

)

[virtual]

Set a different scalar product.

This function is made virtual so that subclasses can override it and take control of what happens. However, any override should call back on this base implementation to set the actual scalar product object.

Preconditions:

• scalarProd.get()!=NULL (throw std::invalid_argument)

Postconditions:

• this->getScalarProd().get() == scalarProd.get()

Definition at line 54 of file Thyra_ScalarProdVectorSpaceBase.hpp.

template<class Scalar>

Teuchos::RCP< const ScalarProdBase< Scalar > > Thyra::ScalarProdVectorSpaceBase< Scalar >::getScalarProd

(

)

const

Return the current scalar product.

Definition at line 62 of file Thyra_ScalarProdVectorSpaceBase.hpp.

template<class Scalar>

bool Thyra::ScalarProdVectorSpaceBase< Scalar >::isEuclidean

(

)

const [virtual]

Returns getScalarProd()->isEuclidean().

Reimplemented from Thyra::VectorSpaceBase< Scalar >.

Definition at line 70 of file Thyra_ScalarProdVectorSpaceBase.hpp.

template<class Scalar>

Scalar Thyra::ScalarProdVectorSpaceBase< Scalar >::scalarProd	(	const VectorBase< Scalar > &	x,
		const VectorBase< Scalar > &	y
	)			const [virtual]

Returns getScalarProd()->scalarProd(x,y).

Implements Thyra::VectorSpaceBase< Scalar >.

Definition at line 76 of file Thyra_ScalarProdVectorSpaceBase.hpp.

template<class Scalar>

void Thyra::ScalarProdVectorSpaceBase< Scalar >::scalarProds	(	const MultiVectorBase< Scalar > &	X,
		const MultiVectorBase< Scalar > &	Y,
		Scalar	scalar_prods[]
	)			const [virtual]

Calls getScalarProd()->scalarProds(X,Y,scalar_prods).

Implements Thyra::VectorSpaceBase< Scalar >.

Definition at line 86 of file Thyra_ScalarProdVectorSpaceBase.hpp.

---

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

• Thyra_ScalarProdVectorSpaceBaseDecl.hpp
• Thyra_ScalarProdVectorSpaceBase.hpp

---