#include <tmatrix.hh>

Inheritance diagram for concepts::TMatrixBlock< F >:

Public Member Functions
	TMatrixBlock (const TMatrix< F > T0, F weight0=1.0, const TMatrix< F > T1=0, F weight1=0.0)

virtual void	usedIdx (TColumn< bool > &c) const

virtual void	usedIdx (Set< uint > &c) const

virtual void	extract (const concepts::Vector< F > &solution, concepts::Array< F > &coeff) const

virtual void	extract (const concepts::Vector<::std::complex< F > > &solution, concepts::Array<::std::complex< F > > &coeff) const

uint	offsetrow () const

void	operator() (const ElementMatrix< F > &A, ElementMatrix< F > &B) const

void	operator() (const ElementMatrix<::std::complex< F > > &A, ElementMatrix<::std::complex< F > > &B) const

void	operator() (const Vector< F > &A, Vector< F > &B) const

void	applyOne (const ElementMatrix< F > &A, ElementMatrix< F > &B) const

virtual uint	index (const uint i) const

void	append (TColumn< F > *T)

const TMatrix::Control *	control (uint i) const

const TMatrix::Data *	data (uint i) const
	Returns the ith entry of the data array.

TColumn< F > *	columns () const

uint	nEntries () const

void	extractOne (const concepts::Vector< F > &solution, concepts::Array< F > &coeff) const

::std::ostream &	outputLocalMap (::std::ostream &os) const

uint	m () const
	Returns the number of rows.

void	setM (uint m)

uint	n () const
	Returns the number of columns.

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

virtual std::ostream &	info (std::ostream &os) const
	Returns information in an output stream.

Protected Attributes
uint	n_
	Number of columns.

uint	m_
	Number of rows.

Detailed Description

template<class F>
class concepts::TMatrixBlock< F >

TMatrixBlock are special Tmatrices in block diagonal structure, builded with two Tmatrices itsself.

The columns of the matrix are TColumn.

If a Tmatrix T0 or T1 is not to be added, i.e. its corresponding weight is zero, the TMatrixBlock coincides with the other input Tmatrix or is empty.

Author: Robert Gruhlke,2013

See also: TColumn the columns of the matrix.; NeumannTraceSpace application of TMatrixBlock

Definition at line 682 of file tmatrix.hh.

Constructor & Destructor Documentation

◆ TMatrixBlock()

template<class F >

concepts::TMatrixBlock< F >::TMatrixBlock	(	const TMatrix< F > *	T0,
		F	weight0 = `1.0`,
		const TMatrix< F > *	T1 = `0`,
		F	weight1 = `0.0`
	)

Constructor. Builds TMatrix which blockdiagonals are smaller TMatrices.

Parameters

T0	TMatrix for upper block.
T1	Tmatrix for possible bottom block.

◆ ~TMatrixBlock()

template<class F >

virtual concepts::TMatrixBlock< F >::~TMatrixBlock ( )

inlinevirtual

Definition at line 690 of file tmatrix.hh.

Member Function Documentation

◆ append()

template<class F >

void concepts::TMatrix< F >::append ( TColumn< F > * T )

inherited

Appends the columns to the matrix. n_ is updated to reflect the real size of the matrix. m_ is updated to show the number of columns which are stored. The columns are scanned and the needed space is allocated. Then the new data is stored.

Parameters

T	a linked list of columns (in full notation) to be stored.

◆ control()

template<class F >

const TMatrix::Control * concepts::TMatrix< F >::control ( uint i ) const

inlineinherited

Returns the ith entry of the control data array

Parameters

i	a colum index, i.e. i < n()

Definition at line 601 of file tmatrix.hh.

◆ data()

template<class F >

const TMatrix::Data * concepts::TMatrix< F >::data ( uint i ) const

inlineinherited

Returns the ith entry of the data array.

Definition at line 604 of file tmatrix.hh.

◆ extract() [1/2]

template<class F >

virtual void concepts::TMatrixBlock< F >::extract	(	const concepts::Vector< F > &	solution,
		concepts::Array< F > &	coeff
	)		const

inlinevirtual

Extracts the part of solution belonging to this T matrix into coeff.

coeff is resized and zeroed before filling it with the coefficients.

Parameters

solution	Vector in the global space (input)
coeff	Local coefficients of this T matrix (output)

Reimplemented from concepts::TMatrix< F >.

Definition at line 699 of file tmatrix.hh.

◆ extract() [2/2]

template<class F >

virtual void concepts::TMatrixBlock< F >::extract	(	const concepts::Vector<::std::complex< F > > &	solution,
		concepts::Array<::std::complex< F > > &	coeff
	)		const

inlinevirtual

Reimplemented from concepts::TMatrix< F >.

Definition at line 703 of file tmatrix.hh.

◆ index()

template<class F >

virtual uint concepts::TMatrix< F >::index ( const uint i ) const

inlinevirtualinherited

Mapping of the column index to the global degree of freedom

Remember: the columns represent the global degrees of freedom to which the shape functions of this element contribute.

More technical: the columns of a TMatrix contain the column index in Control::idx and the relevant data in TMatrix::Data but the number of columns stored in TMatrixBase::n_ does not reflect the global number of degrees of freedom. Therefore, there might be empty columns and TMatrixBase::n_ could be lower than the global number of degrees of freedom.

Implements concepts::TMatrixBase< F >.

Definition at line 587 of file tmatrix.hh.

◆ info()

virtual std::ostream & concepts::OutputOperator::info ( std::ostream & os ) const

protectedvirtualinherited

Returns information in an output stream.

◆ m()

template<class F >

uint concepts::TMatrixBase< F >::m ( ) const

inlineinherited

Returns the number of rows.

Definition at line 388 of file tmatrix.hh.

◆ n()

template<class F >

uint concepts::TMatrixBase< F >::n ( ) const

inlineinherited

Returns the number of columns.

Definition at line 393 of file tmatrix.hh.

◆ nEntries()

template<class F >

uint concepts::TMatrix< F >::nEntries ( ) const

inlineinherited

number of entries in the data vector

Definition at line 610 of file tmatrix.hh.

◆ offsetrow()

template<class F >

uint concepts::TMatrixBlock< F >::offsetrow ( ) const

inline

Returns the offset row, that is starting row of the (possible) second matrix block

Definition at line 711 of file tmatrix.hh.

◆ operator()() [1/2]

template<class F >

void concepts::TMatrix< F >::operator()	(	const ElementMatrix< F > &	A,
		ElementMatrix< F > &	B
	)		const

virtualinherited

Application operator.

Computes the application of the T matrix on A and returns B: $B = A \cdot T$ . The typical usage is explained in the base class.

More detailed: B is resized to a $n_A \times m_T$ matrix, then $B_{ij} = \sum_k A_{ik} T_{kj}$ where $i=1,\dots,n_A$ and $j=1,\dots,m_T$ and $\sum_k$ means sum over all which are present in the T matrix.