Column-major symmetric sparse-matrix class. More...

#include <Matrix_ArrayComplexSparse.hxx>

Inheritance diagram for Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >:

Public Types
typedef Allocator::value_type	value_type

typedef Prop	property

typedef ArrayColSymComplexSparse	storage

typedef Allocator	allocator

typedef complex< value_type >	entry_type

typedef Allocator::pointer	pointer

typedef Allocator::const_pointer	const_pointer

typedef Allocator::reference	reference

typedef Allocator::const_reference	const_reference

typedef complex< value_type >	access_type

typedef complex< value_type >	const_access_type

Public Member Functions
	Matrix ()
	Default constructor. More...

	Matrix (int i, int j)
	Constructor. More...

const entry_type	operator() (int i, int j) const
	Access operator. More...

value_type &	ValReal (int i, int j)
	Returns access to real part of element (i, j) More...

const value_type &	ValReal (int i, int j) const
	Returns access to real part element (i, j) More...

value_type &	ValImag (int i, int j)
	Returns access to imaginary part of element (i, j) More...

const value_type &	ValImag (int i, int j) const
	Returns access to imaginary part of element (i, j) More...

value_type &	GetReal (int i, int j)
	Returns access to real part element (i, j) More...

const value_type &	GetReal (int i, int j) const
	Returns access to real part of element (i, j) More...

value_type &	GetImag (int i, int j)
	Returns access to imaginary part of element (i, j) More...

const value_type &	GetImag (int i, int j) const
	Returns access to imaginary part element (i, j) More...

void	Set (int i, int j, const entry_type &x)
	Sets element (i, j) of the matrix. More...

void	ClearRealColumn (int i)
	Clears a column.

void	ClearImagColumn (int i)
	Clears a column.

void	ReallocateRealColumn (int i, int j)
	Reallocates column i. More...

void	ReallocateImagColumn (int i, int j)
	Reallocates column i. More...

void	ResizeRealColumn (int i, int j)
	Reallocates column i. More...

void	ResizeImagColumn (int i, int j)
	Reallocates column i. More...

void	SwapRealColumn (int i, int i_)
	Swaps two columns. More...

void	SwapImagColumn (int i, int i_)
	Swaps two columns. More...

void	ReplaceRealIndexColumn (int i, IVect &new_index)
	Sets row numbers of non-zero entries of a column. More...

void	ReplaceImagIndexColumn (int i, IVect &new_index)
	Sets row numbers of non-zero entries of a column. More...

int	GetRealColumnSize (int i) const
	Returns the number of non-zero entries of a column. More...

int	GetImagColumnSize (int i) const
	Returns the number of non-zero entries of a column. More...

void	PrintRealColumn (int i) const
	Displays non-zero values of a column.

void	PrintImagColumn (int i) const
	Displays non-zero values of a column.

void	AssembleRealColumn (int i)
	Assembles a column. More...

void	AssembleImagColumn (int i)
	Assembles a column. More...

void	AddInteraction (int i, int j, const entry_type &val)
	Adds a coefficient in the matrix. More...

void	AddInteractionRow (int i, int nb, const IVect &col, const Vector< entry_type > &val, bool sorted=false)
	Adds coefficients in a row. More...

void	AddInteractionColumn (int i, int nb, const IVect &row, const Vector< entry_type > &val, bool sorted=false)
	Adds coefficients in a column. More...

void	Clear ()
	Clears the matrix. More...

void	Reallocate (int i, int j)
	Reallocates memory to resize the matrix. More...

void	Resize (int i, int j)
	Reallocates additional memory to resize the matrix. More...

long	GetRealNonZeros () const
	Returns the number of non-zero elements (real part). More...

long	GetImagNonZeros () const
	Returns the number of non-zero elements (imaginary part). More...

long	GetNonZeros () const
	Returns the number of elements stored in memory (real+imaginary part). More...

long	GetRealDataSize () const
	Returns the number of elements stored in memory (real part). More...

long	GetImagDataSize () const
	Returns the number of elements stored in memory (imaginary part). More...

long	GetDataSize () const
	Returns the number of elements stored in memory (real+imaginary part). More...

size_t	GetMemorySize () const
	returns size of matrix in bytes

int *	GetRealInd (int i) const
	Returns column indices of non-zero entries in row (real part). More...

int *	GetImagInd (int i) const
	Returns column indices of non-zero entries in row (imaginary part). More...

value_type *	GetRealData (int i) const
	Returns values of non-zero entries of a row (real part). More...

Vector< value_type, VectSparse, Allocator > *	GetRealData () const

value_type *	GetImagData (int i) const
	Returns values of non-zero entries of a row (imaginary part). More...

Vector< value_type, VectSparse, Allocator > *	GetImagData () const

entry_type &	Val (int i, int j)
	Unavailable access method. More...

const entry_type &	Val (int i, int j) const
	Unavailable access method. More...

entry_type &	Get (int i, int j)
	Unavailable access method. More...

const entry_type &	Get (int i, int j) const
	Unavailable access method. More...

const value_type &	ValueReal (int num_row, int i) const
	Returns j-th non-zero value of row i (real part). More...

value_type &	ValueReal (int num_row, int i)
	Returns j-th non-zero value of row i (real part). More...

int	IndexReal (int num_row, int i) const
	Returns column number of j-th non-zero value of row i (real part). More...

int &	IndexReal (int num_row, int i)
	Returns column number of j-th non-zero value of row i (real part). More...

const value_type &	ValueImag (int num_row, int i) const
	Returns j-th non-zero value of row i (imaginary part). More...

value_type &	ValueImag (int num_row, int i)
	Returns j-th non-zero value of row i (imaginary part). More...

int	IndexImag (int num_row, int i) const
	Returns column number of j-th non-zero value of row i (imaginary part). More...

int &	IndexImag (int num_row, int i)
	Returns column number of j-th non-zero value of row i (imaginary part). More...

void	SetRealData (int, int, Vector< value_type, VectSparse, Allocator > *)
	Redefines the real part of the matrix. More...

void	SetRealData (int, int, value_type , int )
	Redefines a row/column of the matrix. More...

void	SetImagData (int, int, Vector< value_type, VectSparse, Allocator > *)
	Redefines the imaginary part of the matrix. More...

void	SetImagData (int, int, value_type , int )
	Redefines a row/column of the matrix. More...

void	NullifyReal (int i)
	Clears a row without releasing memory. More...

void	NullifyReal ()
	Clears the matrix without releasing memory. More...

void	NullifyImag (int i)
	Clears a row without releasing memory. More...

void	NullifyImag ()
	Clears the matrix without releasing memory. More...

void	Print () const
	Displays the matrix on the standard output. More...

void	Write (string FileName) const
	Writes the matrix in a file. More...

void	Write (ostream &FileStream) const
	Writes the matrix to an output stream. More...

void	WriteText (string FileName, bool cplx=false) const
	Writes the matrix in a file. More...

void	WriteText (ostream &FileStream, bool cplx=false) const
	Writes the matrix to an output stream. More...

void	Read (string FileName)
	Reads the matrix from a file. More...

void	Read (istream &FileStream)
	Reads the matrix from an input stream. More...

void	ReadText (string FileName, bool cplx=false)
	Reads the matrix from a file. More...

void	ReadText (istream &FileStream, bool cplx=false)
	Reads the matrix from an input stream. More...

void	Assemble ()
	Assembles the matrix. More...

void	RemoveSmallEntry (const T0 &epsilon)
	removes small entries

void	SetIdentity ()
	Matrix is initialized to the identity matrix.

void	Zero ()
	Non-zero entries are set to 0 (but not removed).

void	Fill ()
	Non-zero entries are filled with values 0, 1, 2, 3 ...

void	Fill (const complex< T0 > &x)
	Non-zero entries are set to a given value x. More...

void	FillRand ()
	Non-zero entries take a random value.

int	GetM () const
	Returns the number of rows. More...

int	GetM (const Seldon::SeldonTranspose &status) const
	Returns the number of rows of the matrix possibly transposed. More...

int	GetM (const CBLAS_TRANSPOSE &status) const
	Returns the number of rows of the matrix possibly transposed. More...

int	GetN () const
	Returns the number of columns. More...

int	GetN (const Seldon::SeldonTranspose &status) const
	Returns the number of columns of the matrix possibly transposed. More...

int	GetN (const CBLAS_TRANSPOSE &status) const
	Returns the number of columns of the matrix possibly transposed. More...

long	GetSize () const
	Returns the number of elements in the matrix. More...

Protected Attributes
Vector< Vector< value_type, VectSparse, Allocator >, VectFull, NewAlloc< Vector< value_type, VectSparse, Allocator > > >	val_real_
	real part rows or columns

Vector< Vector< value_type, VectSparse, Allocator >, VectFull, NewAlloc< Vector< value_type, VectSparse, Allocator > > >	val_imag_
	imaginary part rows or columns

int	m_

int	n_

Detailed Description

template<class T, class Prop, class Allocator>
class Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >

Column-major symmetric sparse-matrix class.

Definition at line 430 of file Matrix_ArrayComplexSparse.hxx.

Constructor & Destructor Documentation

◆ Matrix() [1/2]

template<class T , class Prop , class Allocator >

Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::Matrix

inline

Default constructor.

Builds an empty matrix.

Definition at line 1318 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Matrix() [2/2]

template<class T , class Prop , class Allocator >

Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::Matrix	(	int	i,
		int	j
	)

inlineexplicit

Constructor.

Builds a i by j matrix

Parameters

i	number of rows.
j	number of columns.

Note: Matrix values are not initialized.

Definition at line 1331 of file Matrix_ArrayComplexSparseInline.cxx.

Member Function Documentation

◆ AddInteraction()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::AddInteraction	(	int	i,
		int	j,
		const entry_type &	val
	)

Adds a coefficient in the matrix.

Parameters

[in]	i	row number.
[in]	j	column number.
[in]	val	coefficient to add.

Definition at line 752 of file Matrix_ArrayComplexSparse.cxx.

◆ AddInteractionColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::AddInteractionColumn	(	int	i,
		int	nb,
		const IVect &	row,
		const Vector< entry_type > &	val,
		bool	sorted = `false`
	)

Adds coefficients in a column.

Parameters

[in]	i	column number.
[in]	nb	number of coefficients to add.
[in]	row	row numbers of coefficients.
[in]	val	values of coefficients.

Definition at line 791 of file Matrix_ArrayComplexSparse.cxx.

◆ AddInteractionRow()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::AddInteractionRow	(	int	i,
		int	nb,
		const IVect &	col,
		const Vector< entry_type > &	val,
		bool	sorted = `false`
	)

Adds coefficients in a row.

Parameters

[in]	i	row number.
[in]	nb	number of coefficients to add.
[in]	col	column numbers of coefficients.
[in]	val	values of coefficients.

Definition at line 774 of file Matrix_ArrayComplexSparse.cxx.

◆ Assemble()

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Assemble

inherited

Assembles the matrix.

All the row numbers are sorted. If same row numbers exist, values are added.

Warning: If you are using the methods AddInteraction/AddInteractions, you don't need to call that method.

Definition at line 457 of file Matrix_ArrayComplexSparse.cxx.

◆ AssembleImagColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::AssembleImagColumn ( int i )

inline

Assembles a column.

Parameters

[in] i column number.

Warning: If you are using the methods AddInteraction, you don't need to call that method.

Definition at line 1731 of file Matrix_ArrayComplexSparseInline.cxx.

◆ AssembleRealColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::AssembleRealColumn ( int i )

inline

Assembles a column.

Parameters

[in] i column number.

Warning: If you are using the methods AddInteraction, you don't need to call that method.

Definition at line 1717 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Clear()

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Clear

inlineinherited

Clears the matrix.

This methods is equivalent to the destructor. On exit, the matrix is empty (0 by 0).

Definition at line 79 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Fill()

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allo >::Fill ( const complex< T0 > & x )

inherited

Non-zero entries are set to a given value x.

real non-zero entries are set to real(x) whereas imaginary non-zero entries are set to imag(x)

Definition at line 531 of file Matrix_ArrayComplexSparse.cxx.

◆ Get() [1/2]

Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::entry_type & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Get	(	int	i,
		int	j
	)

inlineinherited

Unavailable access method.

This method is declared for consistency with other classes, but it is not defined because no reference can possibly be returned.

Parameters

[in]	i	row index.
[in]	j	column index.

Returns: Raises an exception.

Definition at line 280 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Get() [2/2]

const Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::entry_type & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Get	(	int	i,
		int	j
	)		const

inlineinherited

Unavailable access method.

This method is declared for consistency with other classes, but it is not defined because no reference can possibly be returned.

Parameters

[in]	i	row index.
[in]	j	column index.

Returns: Raises an exception.

Definition at line 297 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetDataSize()

long Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetDataSize

inlineinherited

Returns the number of elements stored in memory (real+imaginary part).

Returns the number of elements stored in memory, i.e. the number of non-zero entries.

Returns: The number of elements stored in memory.

Definition at line 143 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetImag() [1/2]

template<class T , class Prop , class Allocator >

Allocator::value_type & Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::GetImag	(	int	i,
		int	j
	)

inline

Returns access to imaginary part of element (i, j)

Parameters

i	row index.
j	column index.

Returns: imaginary part of element (i, j) of the matrix.

Definition at line 1506 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetImag() [2/2]

template<class T , class Prop , class Allocator >

const Allocator::value_type & Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::GetImag	(	int	i,
		int	j
	)		const

inline

Returns access to imaginary part element (i, j)

Parameters

i	row index.
j	column index.

Returns: imaginary part of element (i, j) of the matrix.

Definition at line 1528 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetImagColumnSize()

template<class T , class Prop , class Allocator >

int Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::GetImagColumnSize ( int i ) const

inline

Returns the number of non-zero entries of a column.

Parameters

[in] i column number.

Returns: The number of non-zero entries of the column i.

Definition at line 1685 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetImagData()

Allocator::value_type * Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetImagData ( int i ) const

inlineinherited

Returns values of non-zero entries of a row (imaginary part).

Parameters

[in] i row number.

Returns: The array of values of non-zero entries of row i.

Definition at line 198 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetImagDataSize()

long Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetImagDataSize

inlineinherited

Returns the number of elements stored in memory (imaginary part).

Returns the number of elements stored in memory, i.e. the number of non-zero entries.

Returns: The number of elements stored in memory.

Definition at line 129 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetImagInd()

int * Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetImagInd ( int i ) const

inlineinherited

Returns column indices of non-zero entries in row (imaginary part).

Parameters

[in] i row number.

Returns: the array of column indices of non-zero entries of row i.

Definition at line 185 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetImagNonZeros()

long Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetImagNonZeros

inherited

Returns the number of non-zero elements (imaginary part).

Returns: The number of non-zero elements for imaginary part of matrix.

Definition at line 51 of file Matrix_ArrayComplexSparse.cxx.

◆ GetM() [1/3]

template<class T >

int Seldon::VirtualMatrix< T >::GetM

inlineinherited

Returns the number of rows.

Returns: The number of rows.

Definition at line 69 of file Matrix_BaseInline.cxx.

◆ GetM() [2/3]

template<class T >

int Seldon::VirtualMatrix< T >::GetM ( const CBLAS_TRANSPOSE & status ) const

inlineinherited

Returns the number of rows of the matrix possibly transposed.

Parameters

status assumed status about the transposition of the matrix.

Returns: The number of rows of the possibly-transposed matrix.

Definition at line 122 of file Matrix_BaseInline.cxx.

◆ GetM() [3/3]

template<class T >

int Seldon::VirtualMatrix< T >::GetM ( const Seldon::SeldonTranspose & status ) const

inlineinherited

Returns the number of rows of the matrix possibly transposed.

Parameters

status assumed status about the transposition of the matrix.

Returns: The number of rows of the possibly-transposed matrix.

Definition at line 92 of file Matrix_BaseInline.cxx.

◆ GetN() [1/3]

template<class T >

int Seldon::VirtualMatrix< T >::GetN

inlineinherited

Returns the number of columns.

Returns: The number of columns.

Definition at line 80 of file Matrix_BaseInline.cxx.

◆ GetN() [2/3]

template<class T >

int Seldon::VirtualMatrix< T >::GetN ( const CBLAS_TRANSPOSE & status ) const

inlineinherited

Returns the number of columns of the matrix possibly transposed.

Parameters

status assumed status about the transposition of the matrix.

Returns: The number of columns of the possibly-transposed matrix.

Definition at line 137 of file Matrix_BaseInline.cxx.

◆ GetN() [3/3]

template<class T >

int Seldon::VirtualMatrix< T >::GetN ( const Seldon::SeldonTranspose & status ) const

inlineinherited

Returns the number of columns of the matrix possibly transposed.

Parameters

status assumed status about the transposition of the matrix.

Returns: The number of columns of the possibly-transposed matrix.

Definition at line 107 of file Matrix_BaseInline.cxx.

◆ GetNonZeros()

long Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetNonZeros

inlineinherited

Returns the number of elements stored in memory (real+imaginary part).

Returns the number of elements stored in memory, i.e. the number of non-zero entries.

Returns: The number of elements stored in memory.

Definition at line 101 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetReal() [1/2]

template<class T , class Prop , class Allocator >

Allocator::value_type & Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::GetReal	(	int	i,
		int	j
	)

inline

Returns access to real part element (i, j)

Returns the value of element (i, j).

Parameters

i	row index.
j	column index.

Returns: real part of element (i, j) of the matrix.

Definition at line 1419 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetReal() [2/2]

template<class T , class Prop , class Allocator >

const Allocator::value_type & Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::GetReal	(	int	i,
		int	j
	)		const

inline

Returns access to real part of element (i, j)

Returns the value of element (i, j).

Parameters

i	row index.
j	column index.

Returns: real part of element (i, j) of the matrix.

Definition at line 1442 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetRealColumnSize()

template<class T , class Prop , class Allocator >

int Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::GetRealColumnSize ( int i ) const

inline

Returns the number of non-zero entries of a column.

Parameters

[in] i column number.

Returns: The number of non-zero entries of the column i.

Definition at line 1672 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetRealData()

Allocator::value_type * Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetRealData ( int i ) const

inlineinherited

Returns values of non-zero entries of a row (real part).

Parameters

[in] i row number.

Returns: The array of values of non-zero entries of row i.

Definition at line 170 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetRealDataSize()

long Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetRealDataSize

inlineinherited

Returns the number of elements stored in memory (real part).

Returns the number of elements stored in memory, i.e. the number of non-zero entries.

Returns: The number of elements stored in memory.

Definition at line 115 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetRealInd()

int * Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetRealInd ( int i ) const

inlineinherited

Returns column indices of non-zero entries in row (real part).

Parameters

[in] i row number.

Returns: The array of column indices of non-zero entries of row i.

Definition at line 157 of file Matrix_ArrayComplexSparseInline.cxx.

◆ GetRealNonZeros()

long Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::GetRealNonZeros

inherited

Returns the number of non-zero elements (real part).

Returns: The number of non-zero elements for real part of matrix.

Definition at line 35 of file Matrix_ArrayComplexSparse.cxx.

◆ GetSize()

template<class T >

long Seldon::VirtualMatrix< T >::GetSize

inlineinherited

Returns the number of elements in the matrix.

Returns the number of elements in the matrix, i.e. the number of rows multiplied by the number of columns.

Returns: The number of elements in the matrix.

Definition at line 153 of file Matrix_BaseInline.cxx.

◆ IndexImag() [1/2]

int & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::IndexImag	(	int	i,
		int	j
	)

inlineinherited

Returns column number of j-th non-zero value of row i (imaginary part).

Parameters

[in]	i	row number.
[in]	j	local number.

Returns: column number of j-th non-zero entry of row i.

Definition at line 575 of file Matrix_ArrayComplexSparseInline.cxx.

◆ IndexImag() [2/2]

int Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::IndexImag	(	int	i,
		int	j
	)		const

inlineinherited

Returns column number of j-th non-zero value of row i (imaginary part).

Parameters

[in]	i	row number.
[in]	j	local number.

Returns: Column number of j-th non-zero entry of row i.

Definition at line 555 of file Matrix_ArrayComplexSparseInline.cxx.

◆ IndexReal() [1/2]

int & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::IndexReal	(	int	i,
		int	j
	)

inlineinherited

Returns column number of j-th non-zero value of row i (real part).

Parameters

[in]	i	row number.
[in]	j	local number.

Returns: column number of j-th non-zero entry of row i.

Definition at line 493 of file Matrix_ArrayComplexSparseInline.cxx.

◆ IndexReal() [2/2]

int Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::IndexReal	(	int	i,
		int	j
	)		const

inlineinherited

Returns column number of j-th non-zero value of row i (real part).

Parameters

[in]	i	row number.
[in]	j	local number.

Returns: Column number of j-th non-zero entry of row i.

Definition at line 473 of file Matrix_ArrayComplexSparseInline.cxx.

◆ NullifyImag() [1/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::NullifyImag

inlineinherited

Clears the matrix without releasing memory.

On exit, the matrix is empty and the memory has not been released. It is useful for low level manipulations on a Matrix instance.

Definition at line 693 of file Matrix_ArrayComplexSparseInline.cxx.

◆ NullifyImag() [2/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::NullifyImag ( int i )

inlineinherited

Clears a row without releasing memory.

On exit, the row is empty and the memory has not been released. It is useful for low level manipulations on a Matrix instance.

Definition at line 635 of file Matrix_ArrayComplexSparseInline.cxx.

◆ NullifyReal() [1/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::NullifyReal

inlineinherited

Clears the matrix without releasing memory.

On exit, the matrix is empty and the memory has not been released. It is useful for low level manipulations on a Matrix instance.

Definition at line 679 of file Matrix_ArrayComplexSparseInline.cxx.

◆ NullifyReal() [2/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::NullifyReal ( int i )

inlineinherited

Clears a row without releasing memory.

On exit, the row is empty and the memory has not been released. It is useful for low level manipulations on a Matrix instance.

Definition at line 623 of file Matrix_ArrayComplexSparseInline.cxx.

◆ operator()()

template<class T , class Prop , class Allocator >

const Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::entry_type Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::operator()	(	int	i,
		int	j
	)		const

inline

Access operator.

Returns the value of element (i, j).

Parameters

i	row index.
j	column index.

Returns: Element (i, j) of the matrix.

Definition at line 1352 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Print()

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Print

inherited

Displays the matrix on the standard output.

Displays elements on the standard output, in text format. Each row is displayed on a single line and elements of a row are delimited by tabulations.

Definition at line 195 of file Matrix_ArrayComplexSparse.cxx.

◆ Read() [1/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Read ( istream & FileStream )

inherited

Reads the matrix from an input stream.

Reads a matrix in binary format from an input stream.

Parameters

FileStream input stream

Definition at line 371 of file Matrix_ArrayComplexSparse.cxx.

◆ Read() [2/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Read ( string FileName )

inherited

Reads the matrix from a file.

Reads a matrix stored in binary format in a file.

Parameters

FileName input file name.

Definition at line 346 of file Matrix_ArrayComplexSparse.cxx.

◆ ReadText() [1/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::ReadText	(	istream &	FileStream,
		bool	cplx = `false`
	)

inherited

Reads the matrix from an input stream.

Reads a matrix from a stream in text format.

Parameters

FileStream input stream.

Definition at line 439 of file Matrix_ArrayComplexSparse.cxx.

◆ ReadText() [2/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::ReadText	(	string	FileName,
		bool	cplx = `false`
	)

inherited

Reads the matrix from a file.

Reads the matrix from a file in text format.

Parameters

FileName input file name.

Definition at line 414 of file Matrix_ArrayComplexSparse.cxx.

◆ Reallocate()

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Reallocate	(	int	i,
		int	j
	)

inherited

Reallocates memory to resize the matrix.

On exit, the matrix is a i x j matrix.

Parameters

i	number of rows.
j	number of columns.

Warning: Data is lost.

Definition at line 92 of file Matrix_ArrayComplexSparse.cxx.

◆ ReallocateImagColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ReallocateImagColumn	(	int	i,
		int	j
	)

inline

Reallocates column i.

Parameters

[in]	i	column number.
[in]	j	new number of non-zero entries in the column.

Warning: Data may be lost.

Definition at line 1579 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ReallocateRealColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ReallocateRealColumn	(	int	i,
		int	j
	)

inline

Reallocates column i.

Parameters

[in]	i	column number.
[in]	j	new number of non-zero entries in the column.

Warning: Data may be lost.

Definition at line 1565 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ReplaceImagIndexColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ReplaceImagIndexColumn	(	int	i,
		IVect &	new_index
	)

inline

Sets row numbers of non-zero entries of a column.

Parameters

[in]	i	column number.
[in]	new_index	new row numbers.

Definition at line 1658 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ReplaceRealIndexColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ReplaceRealIndexColumn	(	int	i,
		IVect &	new_index
	)

inline

Sets row numbers of non-zero entries of a column.

Parameters

[in]	i	column number.
[in]	new_index	new row numbers.

Definition at line 1644 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Resize()

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Resize	(	int	i,
		int	j
	)

inherited

Reallocates additional memory to resize the matrix.

On exit, the matrix is a i x j matrix.

Parameters

i	number of rows.
j	number of columns.

Note: Data is kept.

Definition at line 115 of file Matrix_ArrayComplexSparse.cxx.

◆ ResizeImagColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ResizeImagColumn	(	int	i,
		int	j
	)

inline

Reallocates column i.

Parameters

[in]	i	column number.
[in]	j	new number of non-zero entries in the column.

Definition at line 1605 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ResizeRealColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ResizeRealColumn	(	int	i,
		int	j
	)

inline

Reallocates column i.

Parameters

[in]	i	column number.
[in]	j	new number of non-zero entries in the column.

Definition at line 1592 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Set()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::Set	(	int	i,
		int	j,
		const entry_type &	x
	)

Sets element (i, j) of the matrix.

Parameters

i	row index
j	column index
x	A(i, j) = x

Definition at line 703 of file Matrix_ArrayComplexSparse.cxx.

◆ SetImagData() [1/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::SetImagData	(	int	i,
		int	n,
		value_type *	val,
		int *	ind
	)

inlineinherited

Redefines a row/column of the matrix.

Parameters

[in]	i	row/col number
[in]	n	number of non-zero entries in the row
[in]	val	values
[in]	ind	column numbers

Definition at line 611 of file Matrix_ArrayComplexSparseInline.cxx.

◆ SetImagData() [2/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::SetImagData	(	int	m,
		int	n,
		Vector< value_type, VectSparse, Allocator > *	val
	)

inlineinherited

Redefines the imaginary part of the matrix.

Parameters

[in]	m	new number of rows.
[in]	n	new number of columns.
[in]	val	array of sparse rows/columns.

Definition at line 665 of file Matrix_ArrayComplexSparseInline.cxx.

◆ SetRealData() [1/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::SetRealData	(	int	i,
		int	n,
		value_type *	val,
		int *	ind
	)

inlineinherited

Redefines a row/column of the matrix.

Parameters

[in]	i	row/col number
[in]	n	number of non-zero entries in the row
[in]	val	values
[in]	ind	column numbers

Definition at line 596 of file Matrix_ArrayComplexSparseInline.cxx.

◆ SetRealData() [2/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::SetRealData	(	int	m,
		int	n,
		Vector< value_type, VectSparse, Allocator > *	val
	)

inlineinherited

Redefines the real part of the matrix.

Parameters

[in]	m	new number of rows.
[in]	n	new number of columns.
[in]	val	array of sparse rows/columns.

Definition at line 649 of file Matrix_ArrayComplexSparseInline.cxx.

◆ SwapImagColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::SwapImagColumn	(	int	i,
		int	j
	)

inline

Swaps two columns.

Parameters

[in]	i	first column number.
[in]	j	second column number.

Definition at line 1631 of file Matrix_ArrayComplexSparseInline.cxx.

◆ SwapRealColumn()

template<class T , class Prop , class Allocator >

void Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::SwapRealColumn	(	int	i,
		int	j
	)

inline

Swaps two columns.

Parameters

[in]	i	first column number.
[in]	j	second column number.

Definition at line 1618 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Val() [1/2]

Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::entry_type & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Val	(	int	i,
		int	j
	)

inlineinherited

Unavailable access method.

This method is declared for consistency with other classes, but it is not defined because no reference can possibly be returned.

Parameters

[in]	i	row index.
[in]	j	column index.

Returns: Raises an exception.

Definition at line 246 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Val() [2/2]

const Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::entry_type & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Val	(	int	i,
		int	j
	)		const

inlineinherited

Unavailable access method.

This method is declared for consistency with other classes, but it is not defined because no reference can possibly be returned.

Parameters

[in]	i	row index.
[in]	j	column index.

Returns: Raises an exception.

Definition at line 263 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ValImag() [1/2]

template<class T , class Prop , class Allocator >

Allocator::value_type & Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ValImag	(	int	i,
		int	j
	)

inline

Returns access to imaginary part of element (i, j)

Returns the value of element (i, j).

Parameters

i	row index.
j	column index.

Returns: imaginary part of element (i, j) of the matrix.

Definition at line 1464 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ValImag() [2/2]

template<class T , class Prop , class Allocator >

const Allocator::value_type & Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ValImag	(	int	i,
		int	j
	)		const

inline

Returns access to imaginary part of element (i, j)

Parameters

i	row index.
j	column index.

Returns: imaginary part of element (i, j) of the matrix.

Definition at line 1486 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ValReal() [1/2]

template<class T , class Prop , class Allocator >

Allocator::value_type & Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ValReal	(	int	i,
		int	j
	)

inline

Returns access to real part of element (i, j)

Parameters

i	row index.
j	column index.

Returns: real part of element (i, j) of the matrix.

Definition at line 1374 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ValReal() [2/2]

template<class T , class Prop , class Allocator >

const Allocator::value_type & Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >::ValReal	(	int	i,
		int	j
	)		const

inline

Returns access to real part element (i, j)

Returns the value of element (i, j).

Parameters

i	row index.
j	column index.

Returns: real part of element (i, j) of the matrix.

Definition at line 1397 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ValueImag() [1/2]

Allocator::value_type & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::ValueImag	(	int	i,
		int	j
	)

inlineinherited

Returns j-th non-zero value of row i (imaginary part).

Parameters

[in]	i	row number.
[in]	j	local number.

Returns: j-th non-zero entry of row i.

Definition at line 535 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ValueImag() [2/2]

const Allocator::value_type & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::ValueImag	(	int	i,
		int	j
	)		const

inlineinherited

Returns j-th non-zero value of row i (imaginary part).

Parameters

[in]	i	row number.
[in]	j	local number.

Returns: j-th non-zero entry of row i.

Definition at line 514 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ValueReal() [1/2]

Allocator::value_type & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::ValueReal	(	int	i,
		int	j
	)

inlineinherited

Returns j-th non-zero value of row i (real part).

Parameters

[in]	i	row number.
[in]	j	local number.

Returns: j-th non-zero entry of row i.

Definition at line 453 of file Matrix_ArrayComplexSparseInline.cxx.

◆ ValueReal() [2/2]

const Allocator::value_type & Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::ValueReal	(	int	i,
		int	j
	)		const

inlineinherited

Returns j-th non-zero value of row i (real part).

Parameters

[in]	i	row number.
[in]	j	local number.

Returns: j-th non-zero entry of row i.

Definition at line 432 of file Matrix_ArrayComplexSparseInline.cxx.

◆ Write() [1/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Write ( ostream & FileStream ) const

inherited

Writes the matrix to an output stream.

Stores the matrix in a file in binary format. The number of rows (integer) and the number of columns (integer) are written and matrix elements are then written in the same order as in memory (e.g. row-major storage).

Parameters

FileStream output file name.

Definition at line 260 of file Matrix_ArrayComplexSparse.cxx.

◆ Write() [2/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::Write ( string FileName ) const

inherited

Writes the matrix in a file.

Stores the matrix in a file in binary format. The number of rows (integer) and the number of columns (integer) are written and matrix elements are then written in the same order as in memory (e.g. row-major storage).

Parameters

FileName output file name.

Definition at line 232 of file Matrix_ArrayComplexSparse.cxx.

◆ WriteText() [1/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::WriteText	(	ostream &	FileStream,
		bool	cplx = `false`
	)		const

inherited

Writes the matrix to an output stream.

Stores the matrix in a file in ascii format. The entries are written in coordinate format (row column value). 1-index convention is used.

Parameters

FileStream output file name.

Definition at line 319 of file Matrix_ArrayComplexSparse.cxx.

◆ WriteText() [2/2]

void Seldon::Matrix_ArrayComplexSparse< T, Prop, ArrayColSymComplexSparse , Allocator >::WriteText	(	string	FileName,
		bool	cplx = `false`
	)		const

inherited

Writes the matrix in a file.

Stores the matrix in a file in ascii format. The entries are written in coordinate format (row column value). 1-index convention is used.

Parameters

FileName output file name.

Definition at line 291 of file Matrix_ArrayComplexSparse.cxx.

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

matrix_sparse/complex/Matrix_ArrayComplexSparse.hxx
matrix_sparse/complex/Matrix_ArrayComplexSparse.cxx
matrix_sparse/complex/Matrix_ArrayComplexSparseInline.cxx

Public Types

Public Member Functions

Protected Attributes

Detailed Description

template<class T, class Prop, class Allocator> class Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >

Constructor & Destructor Documentation

◆ Matrix() [1/2]

◆ Matrix() [2/2]

Member Function Documentation

◆ AddInteraction()

◆ AddInteractionColumn()

◆ AddInteractionRow()

◆ Assemble()

◆ AssembleImagColumn()

◆ AssembleRealColumn()

◆ Clear()

◆ Fill()

◆ Get() [1/2]

◆ Get() [2/2]

◆ GetDataSize()

◆ GetImag() [1/2]

◆ GetImag() [2/2]

◆ GetImagColumnSize()

◆ GetImagData()

◆ GetImagDataSize()

◆ GetImagInd()

◆ GetImagNonZeros()

◆ GetM() [1/3]

◆ GetM() [2/3]

◆ GetM() [3/3]

◆ GetN() [1/3]

◆ GetN() [2/3]

◆ GetN() [3/3]

◆ GetNonZeros()

◆ GetReal() [1/2]

◆ GetReal() [2/2]

◆ GetRealColumnSize()

◆ GetRealData()

◆ GetRealDataSize()

◆ GetRealInd()

◆ GetRealNonZeros()

◆ GetSize()

◆ IndexImag() [1/2]

◆ IndexImag() [2/2]

◆ IndexReal() [1/2]

◆ IndexReal() [2/2]

◆ NullifyImag() [1/2]

◆ NullifyImag() [2/2]

◆ NullifyReal() [1/2]

◆ NullifyReal() [2/2]

◆ operator()()

◆ Print()

◆ Read() [1/2]

◆ Read() [2/2]

◆ ReadText() [1/2]

◆ ReadText() [2/2]

◆ Reallocate()

◆ ReallocateImagColumn()

◆ ReallocateRealColumn()

◆ ReplaceImagIndexColumn()

◆ ReplaceRealIndexColumn()

◆ Resize()

◆ ResizeImagColumn()

◆ ResizeRealColumn()

◆ Set()

◆ SetImagData() [1/2]

◆ SetImagData() [2/2]

◆ SetRealData() [1/2]

◆ SetRealData() [2/2]

◆ SwapImagColumn()

◆ SwapRealColumn()

◆ Val() [1/2]

◆ Val() [2/2]

◆ ValImag() [1/2]

◆ ValImag() [2/2]

◆ ValReal() [1/2]

◆ ValReal() [2/2]

◆ ValueImag() [1/2]

◆ ValueImag() [2/2]

◆ ValueReal() [1/2]

template<class T, class Prop, class Allocator>
class Seldon::Matrix< T, Prop, ArrayColSymComplexSparse, Allocator >