General matrix and vectors class, meant for classic math manipulation such as additions, multiplications, and linear systems of equations solving. More...

#include <juce_Matrix.h>

Collaboration diagram for juce::dsp::Matrix< ElementType >:

[legend]

Public Member Functions
	Matrix (size_t numRows, size_t numColumns)
	Creates a new matrix with a given number of rows and columns. More...

	Matrix (size_t numRows, size_t numColumns, const ElementType *dataPointer)
	Creates a new matrix with a given number of rows and columns, with initial data coming from an array, stored in row-major order. More...

	Matrix (const Matrix &)=default
	Creates a copy of another matrix. More...

	Matrix (Matrix &&) noexcept=default
	Moves a copy of another matrix. More...

ElementType *	begin () noexcept

const ElementType *	begin () const noexcept

void	clear () noexcept
	Fills the contents of the matrix with zeroes. More...

ElementType *	end () noexcept

const ElementType *	end () const noexcept

size_t	getNumColumns () const noexcept
	Returns the number of columns in the matrix. More...

size_t	getNumRows () const noexcept
	Returns the number of rows in the matrix. More...

ElementType *	getRawDataPointer () noexcept
	Returns a pointer to the raw data of the matrix object, ordered in row-major order (for modifying). More...

const ElementType *	getRawDataPointer () const noexcept
	Returns a pointer to the raw data of the matrix object, ordered in row-major order (for reading). More...

Array< size_t >	getSize () const noexcept
	Returns an Array of 2 integers with the number of rows and columns in the matrix. More...

Matrix &	hadarmard (const Matrix &other) noexcept
	Does a hadarmard product with the receiver and other and stores the result in the receiver. More...

bool	isNullMatrix () const noexcept
	Tells if the matrix is a null matrix. More...

bool	isOneColumnVector () const noexcept
	Tells if the matrix is a one column vector. More...

bool	isOneRowVector () const noexcept
	Tells if the matrix is a one row vector. More...

bool	isSquare () const noexcept
	Tells if the matrix is a square matrix. More...

bool	isVector () const noexcept
	Tells if the matrix is a vector. More...

ElementType	operator() (size_t row, size_t column) const noexcept
	Returns the value of the matrix at a given row and column (for reading). More...

ElementType &	operator() (size_t row, size_t column) noexcept
	Returns the value of the matrix at a given row and column (for modifying). More...

Matrix	operator* (ElementType scalar) const
	Scalar multiplication. More...

Matrix	operator* (const Matrix &other) const
	Matrix multiplication. More...

Matrix &	operator*= (ElementType scalar) noexcept
	Scalar multiplication. More...

Matrix	operator+ (const Matrix &other) const
	Addition of two matrices. More...

Matrix &	operator+= (const Matrix &other) noexcept
	Addition of two matrices. More...

Matrix	operator- (const Matrix &other) const
	Addition of two matrices. More...

Matrix &	operator-= (const Matrix &other) noexcept
	Subtraction of two matrices. More...

Matrix &	operator= (const Matrix &)=default
	Creates a copy of another matrix. More...

Matrix &	operator= (Matrix &&) noexcept=default
	Moves another matrix into this one. More...

bool	operator== (const Matrix &other) const noexcept

bool	solve (Matrix &b) const noexcept
	Solves a linear system of equations represented by this object and the argument b, using various algorithms depending on the size of the arguments. More...

Matrix &	swapColumns (size_t columnOne, size_t columnTwo) noexcept
	Swaps the contents of two columns in the matrix and returns a reference to itself. More...

Matrix &	swapRows (size_t rowOne, size_t rowTwo) noexcept
	Swaps the contents of two rows in the matrix and returns a reference to itself. More...

String	toString () const
	Returns a String displaying in a convenient way the matrix contents. More...

Static Public Member Functions
static bool	compare (const Matrix &a, const Matrix &b, ElementType tolerance=0) noexcept
	Compare to matrices with a given tolerance. More...

static Matrix	hadarmard (const Matrix &a, const Matrix &b)
	Does a hadarmard product with a and b returns the result. More...

static Matrix	hankel (const Matrix &vector, size_t size, size_t offset=0)
	Creates a squared size x size Hankel Matrix from a vector with an optional offset. More...

static Matrix	identity (size_t size)
	Creates the identity matrix. More...

static Matrix	toeplitz (const Matrix &vector, size_t size)
	Creates a Toeplitz Matrix from a vector with a given squared size. More...

Private Member Functions
template<typename BinaryOperation >
Matrix &	apply (const Matrix &other, BinaryOperation binaryOp)

void	resize ()
	Resizes the matrix. More...

Private Attributes
size_t	columns

Array< ElementType >	data

Array< size_t >	dataAcceleration

size_t	rows

Detailed Description

template<typename ElementType>
class juce::dsp::Matrix< ElementType >

General matrix and vectors class, meant for classic math manipulation such as additions, multiplications, and linear systems of equations solving.

See also: LinearAlgebra

{DSP}

Constructor & Destructor Documentation

◆ Matrix() [1/4]

template<typename ElementType >

juce::dsp::Matrix< ElementType >::Matrix	(	size_t	numRows,
		size_t	numColumns
	)

inline

Creates a new matrix with a given number of rows and columns.

References juce::dsp::Matrix< ElementType >::clear(), and juce::dsp::Matrix< ElementType >::resize().

Referenced by juce::dsp::Matrix< ElementType >::Matrix().

◆ Matrix() [2/4]

template<typename ElementType >

juce::dsp::Matrix< ElementType >::Matrix	(	size_t	numRows,
		size_t	numColumns,
		const ElementType *	dataPointer
	)

inline

Creates a new matrix with a given number of rows and columns, with initial data coming from an array, stored in row-major order.

References juce::dsp::Matrix< ElementType >::columns, juce::dsp::Matrix< ElementType >::data, juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::getRawDataPointer(), juce::dsp::Matrix< ElementType >::hankel(), juce::dsp::Matrix< ElementType >::identity(), juce::dsp::Matrix< ElementType >::Matrix(), juce::dsp::Matrix< ElementType >::operator=(), juce::dsp::Matrix< ElementType >::resize(), juce::dsp::Matrix< ElementType >::rows, and juce::dsp::Matrix< ElementType >::toeplitz().

◆ Matrix() [3/4]

template<typename ElementType >

juce::dsp::Matrix< ElementType >::Matrix ( const Matrix< ElementType > & )

default

Creates a copy of another matrix.

◆ Matrix() [4/4]

template<typename ElementType >

juce::dsp::Matrix< ElementType >::Matrix ( Matrix< ElementType > && )

defaultnoexcept

Moves a copy of another matrix.

Member Function Documentation

◆ apply()

template<typename ElementType >

template<typename BinaryOperation >

Matrix& juce::dsp::Matrix< ElementType >::apply	(	const Matrix< ElementType > &	other,
		BinaryOperation	binaryOp
	)

inlineprivate

References juce::dsp::Matrix< ElementType >::columns, juce::dsp::Matrix< ElementType >::getRawDataPointer(), jassert, and juce::dsp::Matrix< ElementType >::rows.

Referenced by juce::dsp::Matrix< ElementType >::hadarmard(), juce::dsp::Matrix< ElementType >::operator+=(), and juce::dsp::Matrix< ElementType >::operator-=().

◆ begin() [1/2]

template<typename ElementType >

ElementType* juce::dsp::Matrix< ElementType >::begin ( )

inlinenoexcept

References juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::begin(), and juce::dsp::Matrix< ElementType >::data.

Referenced by juce::dsp::Matrix< ElementType >::end(), and juce::dsp::Matrix< ElementType >::operator*=().

◆ begin() [2/2]

template<typename ElementType >

const ElementType* juce::dsp::Matrix< ElementType >::begin ( ) const

inlinenoexcept

References juce::dsp::Matrix< ElementType >::data, and juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::getReference().

◆ clear()

template<typename ElementType >

void juce::dsp::Matrix< ElementType >::clear ( )

inlinenoexcept

Fills the contents of the matrix with zeroes.

References juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::begin(), juce::dsp::Matrix< ElementType >::data, juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::size(), juce::dsp::Matrix< ElementType >::swapColumns(), juce::dsp::Matrix< ElementType >::swapRows(), and juce::zeromem().

Referenced by juce::dsp::Matrix< ElementType >::Matrix().

◆ compare()

template<typename ElementType >

static bool juce::dsp::Matrix< ElementType >::compare	(	const Matrix< ElementType > &	a,
		const Matrix< ElementType > &	b,
		ElementType	tolerance = `0`
	)

staticnoexcept

Compare to matrices with a given tolerance.

Referenced by juce::dsp::Matrix< ElementType >::hadarmard(), and juce::dsp::Matrix< ElementType >::operator==().

◆ end() [1/2]

template<typename ElementType >

ElementType* juce::dsp::Matrix< ElementType >::end ( )

inlinenoexcept

References juce::dsp::Matrix< ElementType >::data, and juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::end().

Referenced by juce::dsp::Matrix< ElementType >::operator*=().

◆ end() [2/2]

template<typename ElementType >

const ElementType* juce::dsp::Matrix< ElementType >::end ( ) const

inlinenoexcept

References juce::dsp::Matrix< ElementType >::begin(), juce::dsp::Matrix< ElementType >::data, and juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::size().

◆ getNumColumns()

template<typename ElementType >

size_t juce::dsp::Matrix< ElementType >::getNumColumns ( ) const

inlinenoexcept

Returns the number of columns in the matrix.

References juce::dsp::Matrix< ElementType >::columns.

◆ getNumRows()

template<typename ElementType >

size_t juce::dsp::Matrix< ElementType >::getNumRows ( ) const

inlinenoexcept

Returns the number of rows in the matrix.

References juce::dsp::Matrix< ElementType >::rows.

◆ getRawDataPointer() [1/2]

template<typename ElementType >

ElementType* juce::dsp::Matrix< ElementType >::getRawDataPointer ( )

inlinenoexcept

Returns a pointer to the raw data of the matrix object, ordered in row-major order (for modifying).

References juce::dsp::Matrix< ElementType >::data, and juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::getRawDataPointer().

Referenced by juce::dsp::Matrix< ElementType >::apply().

◆ getRawDataPointer() [2/2]

template<typename ElementType >

const ElementType* juce::dsp::Matrix< ElementType >::getRawDataPointer ( ) const

inlinenoexcept

Returns a pointer to the raw data of the matrix object, ordered in row-major order (for reading).

References juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::begin(), and juce::dsp::Matrix< ElementType >::data.

◆ getSize()

template<typename ElementType >

Array<size_t> juce::dsp::Matrix< ElementType >::getSize ( ) const

inlinenoexcept

Returns an Array of 2 integers with the number of rows and columns in the matrix.

References juce::dsp::Matrix< ElementType >::columns, and juce::dsp::Matrix< ElementType >::rows.

◆ hadarmard() [1/2]

template<typename ElementType >

Matrix& juce::dsp::Matrix< ElementType >::hadarmard ( const Matrix< ElementType > & other )

inlinenoexcept

Does a hadarmard product with the receiver and other and stores the result in the receiver.

References juce::dsp::Matrix< ElementType >::apply().

Referenced by juce::dsp::Matrix< ElementType >::hadarmard().

◆ hadarmard() [2/2]

template<typename ElementType >

static Matrix juce::dsp::Matrix< ElementType >::hadarmard	(	const Matrix< ElementType > &	a,
		const Matrix< ElementType > &	b
	)

inlinestatic

Does a hadarmard product with a and b returns the result.

References juce::dsp::Matrix< ElementType >::compare(), and juce::dsp::Matrix< ElementType >::hadarmard().

◆ hankel()

template<typename ElementType >

static Matrix juce::dsp::Matrix< ElementType >::hankel	(	const Matrix< ElementType > &	vector,
		size_t	size,
		size_t	offset = `0`
	)

static

Creates a squared size x size Hankel Matrix from a vector with an optional offset.

Parameters

vector	The vector from which the Hankel matrix should be generated. Its number of rows should be at least 2 * (size - 1) + 1
size	The size of resulting square matrix.
offset	An optional offset into the given vector.

Referenced by juce::dsp::Matrix< ElementType >::Matrix().

◆ identity()

template<typename ElementType >

static Matrix juce::dsp::Matrix< ElementType >::identity ( size_t size )

static

Creates the identity matrix.

Referenced by juce::dsp::Matrix< ElementType >::Matrix().

◆ isNullMatrix()

template<typename ElementType >

bool juce::dsp::Matrix< ElementType >::isNullMatrix ( ) const

inlinenoexcept

Tells if the matrix is a null matrix.

References juce::dsp::Matrix< ElementType >::columns, juce::dsp::Matrix< ElementType >::rows, juce::dsp::Matrix< ElementType >::solve(), and juce::dsp::Matrix< ElementType >::toString().

◆ isOneColumnVector()

template<typename ElementType >

bool juce::dsp::Matrix< ElementType >::isOneColumnVector ( ) const

inlinenoexcept

Tells if the matrix is a one column vector.

References juce::dsp::Matrix< ElementType >::columns.

Referenced by juce::dsp::Matrix< ElementType >::isVector().

◆ isOneRowVector()

template<typename ElementType >

bool juce::dsp::Matrix< ElementType >::isOneRowVector ( ) const

inlinenoexcept

Tells if the matrix is a one row vector.

References juce::dsp::Matrix< ElementType >::rows.

Referenced by juce::dsp::Matrix< ElementType >::isVector().

◆ isSquare()

template<typename ElementType >

bool juce::dsp::Matrix< ElementType >::isSquare ( ) const

inlinenoexcept

Tells if the matrix is a square matrix.

References juce::dsp::Matrix< ElementType >::columns, and juce::dsp::Matrix< ElementType >::rows.

◆ isVector()

template<typename ElementType >

bool juce::dsp::Matrix< ElementType >::isVector ( ) const

inlinenoexcept

Tells if the matrix is a vector.

References juce::dsp::Matrix< ElementType >::isOneColumnVector(), and juce::dsp::Matrix< ElementType >::isOneRowVector().

◆ operator()() [1/2]

template<typename ElementType >

ElementType juce::dsp::Matrix< ElementType >::operator()	(	size_t	row,
		size_t	column
	)		const

inlinenoexcept

Returns the value of the matrix at a given row and column (for reading).

References juce::dsp::Matrix< ElementType >::columns, juce::dsp::Matrix< ElementType >::data, juce::dsp::Matrix< ElementType >::dataAcceleration, juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::getReference(), jassert, and juce::dsp::Matrix< ElementType >::rows.

◆ operator()() [2/2]

template<typename ElementType >

ElementType& juce::dsp::Matrix< ElementType >::operator()	(	size_t	row,
		size_t	column
	)

inlinenoexcept

Returns the value of the matrix at a given row and column (for modifying).

References juce::dsp::Matrix< ElementType >::columns, juce::dsp::Matrix< ElementType >::data, juce::dsp::Matrix< ElementType >::dataAcceleration, juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::getReference(), jassert, and juce::dsp::Matrix< ElementType >::rows.

◆ operator*() [1/2]

template<typename ElementType >

Matrix juce::dsp::Matrix< ElementType >::operator* ( ElementType scalar ) const

inline

Scalar multiplication.

◆ operator*() [2/2]

template<typename ElementType >

Matrix juce::dsp::Matrix< ElementType >::operator* ( const Matrix< ElementType > & other ) const

Matrix multiplication.

◆ operator*=()

template<typename ElementType >

Matrix& juce::dsp::Matrix< ElementType >::operator*= ( ElementType scalar )

inlinenoexcept

Scalar multiplication.

References juce::dsp::Matrix< ElementType >::begin(), and juce::dsp::Matrix< ElementType >::end().

◆ operator+()

template<typename ElementType >

Matrix juce::dsp::Matrix< ElementType >::operator+ ( const Matrix< ElementType > & other ) const

inline

Addition of two matrices.

◆ operator+=()

template<typename ElementType >

Matrix& juce::dsp::Matrix< ElementType >::operator+= ( const Matrix< ElementType > & other )

inlinenoexcept

Addition of two matrices.

References juce::dsp::Matrix< ElementType >::apply().

◆ operator-()

template<typename ElementType >

Matrix juce::dsp::Matrix< ElementType >::operator- ( const Matrix< ElementType > & other ) const

inline

Addition of two matrices.

◆ operator-=()

template<typename ElementType >

Matrix& juce::dsp::Matrix< ElementType >::operator-= ( const Matrix< ElementType > & other )

inlinenoexcept

Subtraction of two matrices.

References juce::dsp::Matrix< ElementType >::apply().

◆ operator=() [1/2]

template<typename ElementType >

Matrix& juce::dsp::Matrix< ElementType >::operator= ( const Matrix< ElementType > & )

default

Creates a copy of another matrix.

Referenced by juce::dsp::Matrix< ElementType >::Matrix().

◆ operator=() [2/2]

template<typename ElementType >

Matrix& juce::dsp::Matrix< ElementType >::operator= ( Matrix< ElementType > && )

defaultnoexcept

Moves another matrix into this one.

◆ operator==()

template<typename ElementType >

bool juce::dsp::Matrix< ElementType >::operator== ( const Matrix< ElementType > & other ) const

inlinenoexcept

References juce::dsp::Matrix< ElementType >::compare().

◆ resize()

template<typename ElementType >

void juce::dsp::Matrix< ElementType >::resize ( )

inlineprivate

Resizes the matrix.

References juce::dsp::Matrix< ElementType >::columns, juce::dsp::Matrix< ElementType >::data, juce::dsp::Matrix< ElementType >::dataAcceleration, juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::resize(), juce::dsp::Matrix< ElementType >::rows, and juce::Array< ElementType, TypeOfCriticalSectionToUse, minimumAllocatedSize >::setUnchecked().

Referenced by juce::dsp::Matrix< ElementType >::Matrix().

◆ solve()

template<typename ElementType >

bool juce::dsp::Matrix< ElementType >::solve ( Matrix< ElementType > & b ) const

noexcept

Solves a linear system of equations represented by this object and the argument b, using various algorithms depending on the size of the arguments.

The matrix must be a square matrix N times N, and b must be a vector N times 1, with the coefficients of b. After the execution of the algorithm, the vector b will contain the solution.

Returns true if the linear system of euqations was successfully solved.

Referenced by juce::dsp::Matrix< ElementType >::isNullMatrix().

◆ swapColumns()

template<typename ElementType >

Matrix& juce::dsp::Matrix< ElementType >::swapColumns	(	size_t	columnOne,
		size_t	columnTwo
	)

noexcept

Swaps the contents of two columns in the matrix and returns a reference to itself.

Referenced by juce::dsp::Matrix< ElementType >::clear().

◆ swapRows()

template<typename ElementType >

Matrix& juce::dsp::Matrix< ElementType >::swapRows	(	size_t	rowOne,
		size_t	rowTwo
	)

noexcept

Swaps the contents of two rows in the matrix and returns a reference to itself.

Referenced by juce::dsp::Matrix< ElementType >::clear().

◆ toeplitz()

template<typename ElementType >

static Matrix juce::dsp::Matrix< ElementType >::toeplitz	(	const Matrix< ElementType > &	vector,
		size_t	size
	)

static

Creates a Toeplitz Matrix from a vector with a given squared size.

Referenced by juce::dsp::Matrix< ElementType >::Matrix().

◆ toString()

template<typename ElementType >

String juce::dsp::Matrix< ElementType >::toString ( ) const

Returns a String displaying in a convenient way the matrix contents.

Referenced by juce::dsp::Matrix< ElementType >::isNullMatrix().

Member Data Documentation

◆ columns

template<typename ElementType >

size_t juce::dsp::Matrix< ElementType >::columns

private

Referenced by juce::dsp::Matrix< ElementType >::apply(), juce::dsp::Matrix< ElementType >::getNumColumns(), juce::dsp::Matrix< ElementType >::getSize(), juce::dsp::Matrix< ElementType >::isNullMatrix(), juce::dsp::Matrix< ElementType >::isOneColumnVector(), juce::dsp::Matrix< ElementType >::isSquare(), juce::dsp::Matrix< ElementType >::Matrix(), juce::dsp::Matrix< ElementType >::operator()(), and juce::dsp::Matrix< ElementType >::resize().

◆ data

template<typename ElementType >

Array<ElementType> juce::dsp::Matrix< ElementType >::data

private

Referenced by juce::dsp::Matrix< ElementType >::begin(), juce::dsp::Matrix< ElementType >::clear(), juce::dsp::Matrix< ElementType >::end(), juce::dsp::Matrix< ElementType >::getRawDataPointer(), juce::dsp::Matrix< ElementType >::Matrix(), juce::dsp::Matrix< ElementType >::operator()(), and juce::dsp::Matrix< ElementType >::resize().

◆ dataAcceleration

template<typename ElementType >

Array<size_t> juce::dsp::Matrix< ElementType >::dataAcceleration

private

Referenced by juce::dsp::Matrix< ElementType >::operator()(), and juce::dsp::Matrix< ElementType >::resize().

◆ rows

template<typename ElementType >

size_t juce::dsp::Matrix< ElementType >::rows

private

Referenced by juce::dsp::Matrix< ElementType >::apply(), juce::dsp::Matrix< ElementType >::getNumRows(), juce::dsp::Matrix< ElementType >::getSize(), juce::dsp::Matrix< ElementType >::isNullMatrix(), juce::dsp::Matrix< ElementType >::isOneRowVector(), juce::dsp::Matrix< ElementType >::isSquare(), juce::dsp::Matrix< ElementType >::Matrix(), juce::dsp::Matrix< ElementType >::operator()(), and juce::dsp::Matrix< ElementType >::resize().

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

juce_Matrix.h

Public Member Functions

Static Public Member Functions

Private Member Functions

Private Attributes

Detailed Description

template<typename ElementType> class juce::dsp::Matrix< ElementType >

Constructor & Destructor Documentation

◆ Matrix() [1/4]

◆ Matrix() [2/4]

◆ Matrix() [3/4]

◆ Matrix() [4/4]

Member Function Documentation

◆ apply()

◆ begin() [1/2]

◆ begin() [2/2]

◆ clear()

◆ compare()

◆ end() [1/2]

◆ end() [2/2]

◆ getNumColumns()

◆ getNumRows()

◆ getRawDataPointer() [1/2]

◆ getRawDataPointer() [2/2]

◆ getSize()

◆ hadarmard() [1/2]

◆ hadarmard() [2/2]

◆ hankel()

◆ identity()

◆ isNullMatrix()

◆ isOneColumnVector()

◆ isOneRowVector()

◆ isSquare()

◆ isVector()

◆ operator()() [1/2]

◆ operator()() [2/2]

◆ operator*() [1/2]

◆ operator*() [2/2]

◆ operator*=()

◆ operator+()

◆ operator+=()

◆ operator-()

◆ operator-=()

◆ operator=() [1/2]

◆ operator=() [2/2]

◆ operator==()

◆ resize()

◆ solve()

◆ swapColumns()

◆ swapRows()

◆ toeplitz()

◆ toString()

Member Data Documentation

◆ columns

◆ data

◆ dataAcceleration

◆ rows

template<typename ElementType>
class juce::dsp::Matrix< ElementType >