Linear combination of two operators. More...

#include <compositions.hh>

Inheritance diagram for concepts::LiCo< F >:

Public Types
typedef Cmplxtype< F >::type	c_type
	Real type of data type. More...

typedef Realtype< F >::type	r_type
	Real type of data type. More...

typedef F	type
	Type of data, e.g. matrix entries. More...

Public Member Functions
bool	collapse (Matrix< F > &dest, const F fact=1.0) const
	Collapses the linear combination of matrices into one matrix. More...

virtual const uint	dimX () const
	Returns the size of the image space of the operator (number of rows of the corresponding matrix) More...

virtual const uint	dimY () const
	Returns the size of the source space of the operator (number of columns of the corresponding matrix) More...

	LiCo (Operator< F > &A, Operator< F > &B, F a=1.0, F b=1.0)
	Constructor. More...

virtual void	operator() ()
	Application operator without argument. More...

void	operator() (const Function< c_type > &fncY, Function< c_type > &fncX)
	Application operator for complex function `fncY`. More...

void	operator() (const Function< r_type > &fncY, Function< F > &fncX)
	Application operator. More...

virtual void	show_messages ()

Protected Member Functions
virtual std::ostream &	info (std::ostream &os) const

Protected Attributes
uint	dimX_
	Dimension of image space and the source space. More...

uint	dimY_

Private Member Functions
template<class H , class I >
void	apply_ (const Function< H > &fncY, Function< I > &fncX)

Private Attributes
Operator< F > &	A_
	Operator A. More...

F	a_
	Scalar a. More...

Operator< F > &	B_
	Operator B. More...

F	b_
	Scalar b. More...

Detailed Description

template<class F>
class concepts::LiCo< F >

Linear combination of two operators.

The application operator evaluates a*A + b*B.

Test:

test::CompositionsTest

test::DeepCompositionsTest

Examples: linearDG1d.cc, linearFEM1d-simple.cc, and linearFEM1d.cc.

Definition at line 364 of file compositions.hh.

Member Typedef Documentation

◆ c_type

template<class F >

typedef Cmplxtype<F>::type concepts::LiCo< F >::c_type

Real type of data type.

Definition at line 369 of file compositions.hh.

◆ r_type

template<class F >

typedef Realtype<F>::type concepts::LiCo< F >::r_type

Real type of data type.

Definition at line 367 of file compositions.hh.

◆ type

template<class F >

typedef F concepts::Operator< F >::type

inherited

Type of data, e.g. matrix entries.

Definition at line 45 of file compositions.hh.

Constructor & Destructor Documentation

◆ LiCo()

template<class F >

concepts::LiCo< F >::LiCo	(	Operator< F > &	A,
		Operator< F > &	B,
		F	a = `1.0`,
		F	b = `1.0`
	)

inline

Constructor.

The operator consists of $a A + b B$ where $A$ and $B$ are two operators and $a$ and $b$ are scalars.

Parameters

A	First operator
B	Second operator
a	Coefficient of $A$, defaults to 1
b	Coefficient of $B$, defaults to 1

Definition at line 379 of file compositions.hh.

Member Function Documentation

◆ apply_()

template<class F >

template<class H , class I >

void concepts::LiCo< F >::apply_	(	const Function< H > &	fncY,
		Function< I > &	fncX
	)

inlineprivate

Definition at line 436 of file compositions.hh.

◆ collapse()

template<class F >

bool concepts::LiCo< F >::collapse	(	Matrix< F > &	dest,
		const F	fact = `1.0`
	)		const

Collapses the linear combination of matrices into one matrix.

This only works in some rare combinations, test it out. This method calls addInto on each matrix which makes part of this linear combination or itself on a linear combination.

The method fails if it encounters something else than a LiCo, LiCoI or a matrix.

Returns: True, if the operation was successful

Parameters

dest	Matrix into which the operator should be collapsed. Should be zero on startup since the components are added into the matrix.
fact	Factor by which both components should be multiplied. Defaults to 1, ie. can be omitted.

◆ dimX()

template<class F >

virtual const uint concepts::Operator< F >::dimX ( ) const

inlinevirtualinherited

Returns the size of the image space of the operator (number of rows of the corresponding matrix)

Definition at line 93 of file compositions.hh.

◆ dimY()

template<class F >

virtual const uint concepts::Operator< F >::dimY ( ) const

inlinevirtualinherited

Returns the size of the source space of the operator (number of columns of the corresponding matrix)

Definition at line 98 of file compositions.hh.

◆ info()

template<class F >

virtual std::ostream& concepts::LiCo< F >::info ( std::ostream & os ) const

protectedvirtual

Reimplemented from concepts::Operator< F >.

◆ operator()() [1/3]

template<class F >

virtual void concepts::Operator< F >::operator() ( )

virtualinherited

Application operator without argument.

Reimplemented in concepts::VecOperator< F >, concepts::VecOperator< T >, concepts::VecOperator< F::d_type >, concepts::VecOperator< Cmplx >, concepts::VecOperator< Real >, and concepts::BelosSolver< T >.

◆ operator()() [2/3]

template<class F >

void concepts::LiCo< F >::operator()	(	const Function< c_type > &	fncY,
		Function< c_type > &	fncX
	)

inlinevirtual

Application operator for complex function fncY.

Computes fncX = A(fncY) where A is this operator. fncX becomes complex.

In derived classes its enough to implement the operator() for complex Operator's. If a real counterpart is not implemented, the function fncY is splitted into real and imaginary part and the application operator for real functions is called for each. Then the result is combined.

If in a derived class the operator() for complex Operator's is not implemented, a exception is thrown from here.

Reimplemented from concepts::Operator< F >.

Definition at line 397 of file compositions.hh.