#include <linalg/Matrix.hpp>

Detailed Description

Square matrix class.

Definition at line 529 of file Matrix.hpp.

Inheritance diagram for SquareMatrix:

Collaboration diagram for SquareMatrix:

Constructors and assignment
	SquareMatrix ()=default
	Default constructor. More...

	SquareMatrix (size_t size)
	Create a square matrix of zeros. More...

	SquareMatrix (std::initializer_list< std::initializer_list< double >> init)
	Create a square matrix with the given values. More...

	SquareMatrix (Matrix &&matrix)
	Convert a general matrix to a square matrix. More...

	SquareMatrix (const Matrix &matrix)
	Convert a general matrix to a square matrix. More...

SquareMatrix &	operator= (std::initializer_list< std::initializer_list< double >> init)
	Assign the given values to the square matrix. More...

Matrix size
void	reshape (size_t, size_t)=delete
	Reshaping a square matrix to a general matrix requires an explicit cast. More...

Matrix	reshaped (size_t, size_t)=delete
	Reshaping a square matrix to a general matrix requires an explicit cast. More...

Transposition
void	transpose_inplace ()
	Transpose the matrix in-place. More...

static void	transpose_inplace (Matrix &A)
	Transpose the matrix in-place. More...

Matrix size
size_t	rows () const
	Get the number of rows of the matrix. More...

size_t	cols () const
	Get the number of columns of the matrix. More...

size_t	num_elems () const
	Get the number of elements in the matrix: More...

Matrix	reshaped (size_t newrows, size_t newcols) const
	Create a reshaped copy of the matrix. More...

Element access
double &	operator() (size_t row, size_t col)
	Get the element at the given position in the matrix. More...

const double &	operator() (size_t row, size_t col) const
	Get the element at the given position in the matrix. More...

double &	operator() (size_t index)
	Get the element at the given position in the linearized matrix. More...

const double &	operator() (size_t index) const
	Get the element at the given position in the linearized matrix. More...

Memory management
void	clear_and_deallocate ()
	Set the number of rows and columns to zero, and deallocate the storage. More...

Filling matrices
void	fill (double value)
	Fill the matrix with a constant value. More...

void	fill_identity ()
	Fill the matrix as an identity matrix (all zeros except the diagonal which is one). More...

void	fill_random (double min=0, double max=1, std::default_random_engine::result_type seed=std::default_random_engine::default_seed)
	Fill the matrix with uniformly distributed random values. More...

Swapping rows and columns
void	swap_rows (size_t a, size_t b)
	Swap two rows of the matrix. More...

void	swap_columns (size_t a, size_t b)
	Swap two columns of the matrix. More...

Comparison
bool	operator== (const Matrix &other) const
	Check for equality of two matrices. More...

bool	operator!= (const Matrix &other) const
	Check for inequality of two matrices. More...

Matrix norms
double	normFro () const &
	Compute the Frobenius norm of the matrix. More...

double	normFro () &&
	Compute the Frobenius norm of the matrix. More...

Iterators
storage_t::iterator	begin ()
	Get the iterator to the first element of the matrix. More...

storage_t::const_iterator	begin () const
	Get the iterator to the first element of the matrix. More...

storage_t::const_iterator	cbegin () const
	Get the iterator to the first element of the matrix. More...

storage_t::iterator	end ()
	Get the iterator to the element past the end of the matrix. More...

storage_t::const_iterator	end () const
	Get the iterator to the element past the end of the matrix. More...

storage_t::const_iterator	cend () const
	Get the iterator to the element past the end of the matrix. More...

Printing
void	print (std::ostream &os, uint8_t precision=0, uint8_t width=0) const
	Print a matrix. More...

Creating special matrices
static SquareMatrix	ones (size_t rows)
	Create a square matrix filled with ones. More...

static SquareMatrix	zeros (size_t rows)
	Create a square matrix filled with zeros. More...

static SquareMatrix	constant (size_t rows, double value)
	Create a square matrix filled with a constant value. More...

static SquareMatrix	identity (size_t rows)
	Create a square identity matrix. More...

static SquareMatrix	random (size_t rows, double min=0, double max=1, std::default_random_engine::result_type seed=std::default_random_engine::default_seed)
	Create a matrix with uniformly distributed random values. More...

Create special matrices
static Matrix	ones (size_t rows, size_t cols)
	Create a matrix filled with ones. More...

static Matrix	zeros (size_t rows, size_t cols)
	Create a matrix filled with zeros. More...

static Matrix	constant (size_t rows, size_t cols, double value)
	Create a matrix filled with a constant value. More...

static Matrix	identity (size_t rows, size_t cols)
	Create an identity matrix. More...

static Matrix	random (size_t rows, size_t cols, double min=0, double max=1, std::default_random_engine::result_type seed=std::default_random_engine::default_seed)
	Create a matrix with uniformly distributed random values. More...

Protected Attributes
size_t	rows_ = 0

size_t	cols_ = 0

storage_t	storage

Private Types
using	storage_t = util::storage_t< double >
	Container to store the elements of the matrix internally. More...

Related Functions
(Note that these are not member functions.)
std::ostream &	operator<< (std::ostream &os, const Matrix &M)
	Print a matrix. More...

Member Typedef Documentation

◆ storage_t

using storage_t = util::storage_t<double>

privateinherited

Container to store the elements of the matrix internally.

Definition at line 28 of file Matrix.hpp.

Constructor & Destructor Documentation

◆ SquareMatrix() [1/5]

SquareMatrix ( )

default

Default constructor.

◆ SquareMatrix() [2/5]

SquareMatrix ( size_t size )

inline

Create a square matrix of zeros.

Definition at line 538 of file Matrix.hpp.

◆ SquareMatrix() [3/5]

SquareMatrix ( std::initializer_list< std::initializer_list< double >> init )

Create a square matrix with the given values.

Definition at line 536 of file Matrix.cpp.

◆ SquareMatrix() [4/5]

SquareMatrix ( Matrix && matrix )

explicit

Convert a general matrix to a square matrix.

Definition at line 541 of file Matrix.cpp.

◆ SquareMatrix() [5/5]

SquareMatrix ( const Matrix & matrix )

explicit

Convert a general matrix to a square matrix.

Definition at line 545 of file Matrix.cpp.

Member Function Documentation

◆ operator=()

SquareMatrix & operator= ( std::initializer_list< std::initializer_list< double >> init )

Assign the given values to the square matrix.

Definition at line 549 of file Matrix.cpp.

◆ reshape()

void reshape	(	size_t	,
		size_t
	)

delete

Reshaping a square matrix to a general matrix requires an explicit cast.

◆ reshaped() [1/2]

Matrix reshaped	(	size_t	,
		size_t
	)

delete

Reshaping a square matrix to a general matrix requires an explicit cast.

◆ transpose_inplace() [1/2]

void transpose_inplace ( Matrix & A )

static

Transpose the matrix in-place.

Definition at line 560 of file Matrix.cpp.

◆ transpose_inplace() [2/2]

void transpose_inplace ( )

inline

Transpose the matrix in-place.

Definition at line 572 of file Matrix.hpp.

◆ ones() [1/2]

SquareMatrix ones ( size_t rows )

static

Create a square matrix filled with ones.

Definition at line 571 of file Matrix.cpp.

◆ zeros() [1/2]

SquareMatrix zeros ( size_t rows )

static

Create a square matrix filled with zeros.

Definition at line 574 of file Matrix.cpp.

◆ constant() [1/2]

SquareMatrix constant	(	size_t	rows,
		double	value
	)

static

Create a square matrix filled with a constant value.

Definition at line 577 of file Matrix.cpp.

◆ identity() [1/2]

SquareMatrix identity ( size_t rows )

static

Create a square identity matrix.

Definition at line 580 of file Matrix.cpp.

◆ random() [1/2]

SquareMatrix random	(	size_t	rows,
		double	min = `0`,
		double	max = `1`,
		std::default_random_engine::result_type	seed = `std::default_random_engine::default_seed`
	)

static

Create a matrix with uniformly distributed random values.

Definition at line 586 of file Matrix.cpp.

◆ rows()

size_t rows ( ) const

inlineinherited

Get the number of rows of the matrix.

Examples: Basics.cpp.

Definition at line 69 of file Matrix.hpp.

◆ cols()

size_t cols ( ) const

inlineinherited

Get the number of columns of the matrix.

Examples: Basics.cpp.

Definition at line 71 of file Matrix.hpp.

◆ num_elems()

size_t num_elems ( ) const

inlineinherited

Get the number of elements in the matrix:

Examples: Basics.cpp.

Definition at line 73 of file Matrix.hpp.

◆ reshaped() [2/2]

Matrix reshaped	(	size_t	newrows,
		size_t	newcols
	)		const

inherited

Create a reshaped copy of the matrix.

See also: reshape

Definition at line 80 of file Matrix.cpp.

◆ operator()() [1/4]

double & operator()	(	size_t	row,
		size_t	col
	)

inherited

Get the element at the given position in the matrix.

Definition at line 90 of file Matrix.cpp.

◆ operator()() [2/4]

const double & operator()	(	size_t	row,
		size_t	col
	)		const

inherited

Get the element at the given position in the matrix.

Definition at line 98 of file Matrix.cpp.

◆ operator()() [3/4]

double& operator() ( size_t index )

inlineinherited

Get the element at the given position in the linearized matrix.

Definition at line 95 of file Matrix.hpp.

◆ operator()() [4/4]

const double& operator() ( size_t index ) const

inlineinherited

Get the element at the given position in the linearized matrix.

Definition at line 97 of file Matrix.hpp.

◆ clear_and_deallocate()

void clear_and_deallocate ( )

inherited

Set the number of rows and columns to zero, and deallocate the storage.

Definition at line 110 of file Matrix.cpp.

◆ fill()

void fill ( double value )

inherited

Fill the matrix with a constant value.

Definition at line 121 of file Matrix.cpp.

◆ fill_identity()

void fill_identity ( )

inherited

Fill the matrix as an identity matrix (all zeros except the diagonal which is one).

Definition at line 125 of file Matrix.cpp.

◆ fill_random()

void fill_random	(	double	min = `0`,
		double	max = `1`,
		std::default_random_engine::result_type	seed = `std::default_random_engine::default_seed`
	)

inherited

Fill the matrix with uniformly distributed random values.

Definition at line 131 of file Matrix.cpp.

◆ ones() [2/2]

Matrix ones	(	size_t	rows,
		size_t	cols
	)

staticinherited

Create a matrix filled with ones.

Examples: Basics.cpp.

Definition at line 142 of file Matrix.cpp.

◆ zeros() [2/2]

Matrix zeros	(	size_t	rows,
		size_t	cols
	)

staticinherited

Create a matrix filled with zeros.

Examples: Basics.cpp.

Definition at line 146 of file Matrix.cpp.

◆ constant() [2/2]

Matrix constant	(	size_t	rows,
		size_t	cols,
		double	value
	)

staticinherited

Create a matrix filled with a constant value.

Examples: Basics.cpp.

Definition at line 151 of file Matrix.cpp.

◆ identity() [2/2]

Matrix identity	(	size_t	rows,
		size_t	cols
	)

staticinherited

Create an identity matrix.

Examples: Basics.cpp.

Definition at line 157 of file Matrix.cpp.

◆ random() [2/2]

Matrix random	(	size_t	rows,
		size_t	cols,
		double	min = `0`,
		double	max = `1`,
		std::default_random_engine::result_type	seed = `std::default_random_engine::default_seed`
	)

staticinherited

Create a matrix with uniformly distributed random values.

Examples: Basics.cpp, and QR-PerfTest.cpp.

Definition at line 165 of file Matrix.cpp.

◆ swap_rows()

void swap_rows	(	size_t	a,
		size_t	b
	)

inherited

Swap two rows of the matrix.

Definition at line 181 of file Matrix.cpp.

◆ swap_columns()

void swap_columns	(	size_t	a,
		size_t	b
	)

inherited

Swap two columns of the matrix.

Definition at line 176 of file Matrix.cpp.

◆ operator==()

bool operator== ( const Matrix & other ) const

inherited

Check for equality of two matrices.

Warning: Uses exact comparison, which is often not appropriate for floating point numbers.

Definition at line 190 of file Matrix.cpp.

◆ operator!=()

bool operator!= ( const Matrix & other ) const

inlineinherited

Check for inequality of two matrices.

Warning: Uses exact comparison, which is often not appropriate for floating point numbers.

Definition at line 177 of file Matrix.hpp.

◆ normFro() [1/2]

double normFro ( ) const &

inherited

Compute the Frobenius norm of the matrix.

Implementation

double Matrix::normFro() const & {
    // Reinterpret the matrix as one big vector, and compute the dot product
    // with itself. This is the 2-norm of the vector squared, so the Frobenius
    // norm of the matrix is the square root of this dot product.
    // ‖A‖f = ‖vec(A)‖₂ = √(vec(A)ᵀvec(A))
    return std::sqrt(Vector::dot_unchecked(*this, *this));
}

Definition at line 211 of file Matrix.cpp.

◆ normFro() [2/2]

double normFro ( ) &&

inherited

Compute the Frobenius norm of the matrix.

Definition at line 220 of file Matrix.cpp.

◆ begin() [1/2]

storage_t::iterator begin ( )

inlineinherited

Get the iterator to the first element of the matrix.

Examples: QR-PerfTest.cpp.

Definition at line 197 of file Matrix.hpp.

◆ begin() [2/2]

storage_t::const_iterator begin ( ) const

inlineinherited

Get the iterator to the first element of the matrix.

Definition at line 199 of file Matrix.hpp.

◆ cbegin()

storage_t::const_iterator cbegin ( ) const

inlineinherited

Get the iterator to the first element of the matrix.

Definition at line 201 of file Matrix.hpp.

◆ end() [1/2]

storage_t::iterator end ( )

inlineinherited

Get the iterator to the element past the end of the matrix.

Examples: QR-PerfTest.cpp.

Definition at line 204 of file Matrix.hpp.

◆ end() [2/2]

storage_t::const_iterator end ( ) const

inlineinherited

Get the iterator to the element past the end of the matrix.

Definition at line 206 of file Matrix.hpp.

◆ cend()

storage_t::const_iterator cend ( ) const

inlineinherited

Get the iterator to the element past the end of the matrix.

Definition at line 208 of file Matrix.hpp.

◆ print()

void print	(	std::ostream &	os,
		uint8_t	precision = `0`,
		uint8_t	width = `0`
	)		const

inherited

Print a matrix.

Parameters

os	The stream to print to.
precision	The number of significant figures to print. (0 = auto)
width	The width of each element (number of characters). (0 = auto)

Definition at line 232 of file Matrix.cpp.

Friends And Related Function Documentation

◆ operator<<()

std::ostream & operator<<	(	std::ostream &	os,
		const Matrix &	M
	)

Definition at line 245 of file Matrix.cpp.

Member Data Documentation

◆ rows_

size_t rows_ = 0

protectedinherited

Definition at line 231 of file Matrix.hpp.

◆ cols_

size_t cols_ = 0

protectedinherited

Definition at line 231 of file Matrix.hpp.

◆ storage

storage_t storage

protectedinherited

Definition at line 232 of file Matrix.hpp.

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

Detailed Description

Constructors and assignment

Matrix size

Transposition

Matrix size

Element access

Memory management

Filling matrices

Swapping rows and columns

Comparison

Matrix norms

Iterators

Printing

Creating special matrices

Create special matrices

Protected Attributes

Private Types

Related Functions

Member Typedef Documentation

◆ storage_t

Constructor & Destructor Documentation

◆ SquareMatrix() [1/5]

◆ SquareMatrix() [2/5]

◆ SquareMatrix() [3/5]

◆ SquareMatrix() [4/5]

◆ SquareMatrix() [5/5]

Member Function Documentation

◆ operator=()

◆ reshape()

◆ reshaped() [1/2]

◆ transpose_inplace() [1/2]

◆ transpose_inplace() [2/2]

◆ ones() [1/2]

◆ zeros() [1/2]

◆ constant() [1/2]

◆ identity() [1/2]

◆ random() [1/2]

◆ rows()

◆ cols()

◆ num_elems()

◆ reshaped() [2/2]

◆ operator()() [1/4]

◆ operator()() [2/4]

◆ operator()() [3/4]

◆ operator()() [4/4]

◆ clear_and_deallocate()

◆ fill()

◆ fill_identity()

◆ fill_random()

◆ ones() [2/2]

◆ zeros() [2/2]

◆ constant() [2/2]

◆ identity() [2/2]

◆ random() [2/2]

◆ swap_rows()

◆ swap_columns()

◆ operator==()

◆ operator!=()

◆ normFro() [1/2]

Implementation

◆ normFro() [2/2]

◆ begin() [1/2]

◆ begin() [2/2]

◆ cbegin()

◆ end() [1/2]

◆ end() [2/2]

◆ cend()

◆ print()

Friends And Related Function Documentation

◆ operator<<()

Member Data Documentation

◆ rows_

◆ cols_

◆ storage