ITK 6.0.0
Insight Toolkit
 
Loading...
Searching...
No Matches
Public Types | Public Member Functions | Static Public Member Functions | Static Public Attributes | Private Attributes | List of all members
itk::Matrix< T, VRows, VColumns > Class Template Reference
Data Representation Objects | Group Core » Module ITKCommon

#include <itkMatrix.h>

Detailed Description

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
class itk::Matrix< T, VRows, VColumns >

A templated class holding a M x N size Matrix.

This class contains a vnl_matrix_fixed in order to make all the vnl mathematical methods available.

ITK Sphinx Examples:
Examples
Examples/DataRepresentation/Image/Image4.cxx, and Examples/DataRepresentation/Mesh/MeshTraits.cxx.

Definition at line 70 of file itkMatrix.h.

Public Types

using CompatibleSquareMatrixType = Matrix<T, VColumns, VColumns>
 
using ComponentType = T
 
using const_iterator = const ValueType *
 
using const_pointer = const ValueType *
 
using const_reference = const ValueType &
 
using InternalMatrixType = vnl_matrix_fixed<T, VRows, VColumns>
 
using iterator = ValueType *
 
using pointer = ValueType *
 
using reference = ValueType &
 
using Self = Matrix
 
using ValueType = T
 

Public Member Functions

iterator begin ()
 
const_iterator begin () const
 
const_iterator cbegin () const
 
const_iterator cend () const
 
iterator end ()
 
const_iterator end () const
 
void Fill (const T &value)
 
vnl_matrix_fixed< T, VColumns, VRows > GetInverse () const
 
vnl_matrix_fixed< T, VColumns, VRows > GetTranspose () const
 
InternalMatrixType & GetVnlMatrix ()
 
const InternalMatrixType & GetVnlMatrix () const
 
 ITK_UNEQUAL_OPERATOR_MEMBER_FUNCTION (Self)
 
 Matrix ()=default
 
 Matrix (const InternalMatrixType &matrix)
 
template<typename TElement>
 Matrix (const TElement(&elements)[VRows][VColumns])
 
 Matrix (const vnl_matrix< T > &matrix)
 
T & operator() (unsigned int row, unsigned int col)
 
const T & operator() (unsigned int row, unsigned int col) const
 
Self operator* (const CompatibleSquareMatrixType &matrix) const
 
CovariantVector< T, VRows > operator* (const CovariantVector< T, VColumns > &covect) const
 
Point< T, VRows > operator* (const Point< T, VColumns > &pnt) const
 
Self operator* (const T &value) const
 
Vector< T, VRows > operator* (const Vector< T, VColumns > &vect) const
 
vnl_matrix< T > operator* (const vnl_matrix< T > &matrix) const
 
template<unsigned int OuterDim>
Matrix< T, VRows, OuterDim > operator* (const vnl_matrix_fixed< T, VRows, OuterDim > &matrix) const
 
vnl_vector< T > operator* (const vnl_vector< T > &vc) const
 
vnl_vector_fixed< T, VRows > operator* (const vnl_vector_fixed< T, VColumns > &inVNLvect) const
 
void operator*= (const CompatibleSquareMatrixType &matrix)
 
void operator*= (const T &value)
 
void operator*= (const vnl_matrix< T > &matrix)
 
Self operator+ (const Self &matrix) const
 
const Self & operator+= (const Self &matrix)
 
Self operator- (const Self &matrix) const
 
const Self & operator-= (const Self &matrix)
 
Self operator/ (const T &value) const
 
void operator/= (const T &value)
 
Self & operator= (const InternalMatrixType &matrix)
 
Self & operator= (const vnl_matrix< T > &matrix)
 
bool operator== (const Self &matrix) const
 
T * operator[] (unsigned int i)
 
const T * operator[] (unsigned int i) const
 
void PrintSelf (std::ostream &os, Indent indent) const
 
void SetIdentity ()
 
constexpr unsigned int size () const
 
void swap (Self &other) noexcept
 

Static Public Member Functions

static Self GetIdentity ()
 

Static Public Attributes

static constexpr unsigned int ColumnDimensions = VColumns
 
static constexpr unsigned int RowDimensions = VRows
 

Private Attributes

InternalMatrixType m_Matrix {}
 

Member Typedef Documentation

◆ CompatibleSquareMatrixType

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::CompatibleSquareMatrixType = Matrix<T, VColumns, VColumns>

Compatible square matrix. This is currently used by operator* to help with wrapping.

Todo
In the future, the method should be templated to allow multiplication by VColumns by XRows.

Definition at line 108 of file itkMatrix.h.

◆ ComponentType

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::ComponentType = T

Definition at line 78 of file itkMatrix.h.

◆ const_iterator

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::const_iterator = const ValueType *

The return type of cbegin() and cend(), and the const overloads of begin() and end().

Definition at line 96 of file itkMatrix.h.

◆ const_pointer

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::const_pointer = const ValueType *

A const pointer to the ValueType.

Definition at line 84 of file itkMatrix.h.

◆ const_reference

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::const_reference = const ValueType &

A const reference to the ValueType.

Definition at line 90 of file itkMatrix.h.

◆ InternalMatrixType

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::InternalMatrixType = vnl_matrix_fixed<T, VRows, VColumns>

Internal matrix type

Definition at line 103 of file itkMatrix.h.

◆ iterator

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::iterator = ValueType *

The return type of the non-const overloads of begin() and end().

Definition at line 93 of file itkMatrix.h.

◆ pointer

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::pointer = ValueType *

A pointer to the ValueType.

Definition at line 81 of file itkMatrix.h.

◆ reference

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::reference = ValueType &

A reference to the ValueType.

Definition at line 87 of file itkMatrix.h.

◆ Self

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::Self = Matrix

Standard class type aliases.

Definition at line 74 of file itkMatrix.h.

◆ ValueType

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
using itk::Matrix< T, VRows, VColumns >::ValueType = T

Component value type

Definition at line 77 of file itkMatrix.h.

Constructor & Destructor Documentation

◆ Matrix() [1/4]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
itk::Matrix< T, VRows, VColumns >::Matrix ( const vnl_matrix< T > & matrix)
inlineexplicit

Explicit constructor. Copies the elements from the specified vnl_matrix (assuming it has the same dimensions).

Definition at line 277 of file itkMatrix.h.

◆ Matrix() [2/4]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
template<typename TElement>
itk::Matrix< T, VRows, VColumns >::Matrix ( const TElement(&) elements[VRows][VColumns])
inlineexplicit

Explicit constructor template. Copies the elements from the specified C-style array of rows.

Note
It might have been clearer to just declare a Matrix(const T (&)[VRows][VColumns]) constructor, but SWIG did not like that, saying: "Wrapping/Typedefs/itkMatrix.i:76: Error: Syntax error in input(3)."

Definition at line 286 of file itkMatrix.h.

◆ Matrix() [3/4]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
itk::Matrix< T, VRows, VColumns >::Matrix ( const InternalMatrixType & matrix)
inline

Converting constructor (implicit).

Definition at line 324 of file itkMatrix.h.

◆ Matrix() [4/4]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
itk::Matrix< T, VRows, VColumns >::Matrix ( )
default

Defaulted default-constructor. Zero-initializes all of its elements.

Note
The other five "special member functions" (copy-constructor, copy-assignment operator, move-constructor, move-assignment operator, and destructor) are implicitly defaulted, following the C++ "Rule of Zero".

Member Function Documentation

◆ begin() [1/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
iterator itk::Matrix< T, VRows, VColumns >::begin ( )
inlinenodiscard

Returns an iterator to the first element.

Definition at line 362 of file itkMatrix.h.

◆ begin() [2/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
const_iterator itk::Matrix< T, VRows, VColumns >::begin ( ) const
inlinenodiscard

Returns a const iterator to the first element.

Definition at line 376 of file itkMatrix.h.

◆ cbegin()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
const_iterator itk::Matrix< T, VRows, VColumns >::cbegin ( ) const
inlinenodiscard

Returns a const iterator to the first element.

Definition at line 390 of file itkMatrix.h.

◆ cend()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
const_iterator itk::Matrix< T, VRows, VColumns >::cend ( ) const
inlinenodiscard

Returns a const iterator just beyond the last element.

Definition at line 397 of file itkMatrix.h.

◆ end() [1/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
iterator itk::Matrix< T, VRows, VColumns >::end ( )
inlinenodiscard

Returns an iterator just beyond the last element.

Definition at line 369 of file itkMatrix.h.

◆ end() [2/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
const_iterator itk::Matrix< T, VRows, VColumns >::end ( ) const
inlinenodiscard

Returns a const iterator just beyond the last element.

Definition at line 383 of file itkMatrix.h.

◆ Fill()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
void itk::Matrix< T, VRows, VColumns >::Fill ( const T & value)
inline

Fill the matrix with a value.

Definition at line 262 of file itkMatrix.h.

◆ GetIdentity()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
static Self itk::Matrix< T, VRows, VColumns >::GetIdentity ( )
inlinestatic

Get an identity matrix.

Definition at line 253 of file itkMatrix.h.

◆ GetInverse()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
vnl_matrix_fixed< T, VColumns, VRows > itk::Matrix< T, VRows, VColumns >::GetInverse ( ) const
inlinenodiscard

Return the inverse matrix.

Definition at line 330 of file itkMatrix.h.

◆ GetTranspose()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
vnl_matrix_fixed< T, VColumns, VRows > itk::Matrix< T, VRows, VColumns >::GetTranspose ( ) const
inlinenodiscard

Return the transposed matrix.

Definition at line 341 of file itkMatrix.h.

◆ GetVnlMatrix() [1/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
InternalMatrixType & itk::Matrix< T, VRows, VColumns >::GetVnlMatrix ( )
inline

Return the matrix.

Definition at line 232 of file itkMatrix.h.

Referenced by itk::Math::Determinant(), itk::OpenCVBasicTypeBridge< Matrix< T, static_cast< unsigned int >(VRows), static_cast< unsigned int >(VColumns)>, cv::Matx< T, VRows, VColumns > >::FromITKToOpenCV(), itk::detail::GetPointerToMatrixData(), itk::Math::MatrixExponential(), itk::operator<<(), itk::Math::SolveSymmetric(), itk::Math::SVD(), and itk::Math::SVD().

◆ GetVnlMatrix() [2/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
const InternalMatrixType & itk::Matrix< T, VRows, VColumns >::GetVnlMatrix ( ) const
inlinenodiscard

Return the matrix.

Definition at line 239 of file itkMatrix.h.

◆ ITK_UNEQUAL_OPERATOR_MEMBER_FUNCTION()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
itk::Matrix< T, VRows, VColumns >::ITK_UNEQUAL_OPERATOR_MEMBER_FUNCTION ( Self )

◆ operator()() [1/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
T & itk::Matrix< T, VRows, VColumns >::operator() ( unsigned int row,
unsigned int col )
inline

Return an element of the matrix.

Definition at line 204 of file itkMatrix.h.

◆ operator()() [2/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
const T & itk::Matrix< T, VRows, VColumns >::operator() ( unsigned int row,
unsigned int col ) const
inline

Return an element of the matrix.

Definition at line 211 of file itkMatrix.h.

◆ operator*() [1/9]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
Self itk::Matrix< T, VRows, VColumns >::operator* ( const CompatibleSquareMatrixType & matrix) const

Matrix by Matrix multiplication.

◆ operator*() [2/9]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
CovariantVector< T, VRows > itk::Matrix< T, VRows, VColumns >::operator* ( const CovariantVector< T, VColumns > & covect) const

Matrix by CovariantVector multiplication.

◆ operator*() [3/9]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
Point< T, VRows > itk::Matrix< T, VRows, VColumns >::operator* ( const Point< T, VColumns > & pnt) const

Matrix by Point multiplication.

◆ operator*() [4/9]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
Self itk::Matrix< T, VRows, VColumns >::operator* ( const T & value) const
inline

Matrix by scalar multiplication.

Definition at line 177 of file itkMatrix.h.

◆ operator*() [5/9]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
Vector< T, VRows > itk::Matrix< T, VRows, VColumns >::operator* ( const Vector< T, VColumns > & vect) const

Matrix by Vector multiplication.

◆ operator*() [6/9]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
vnl_matrix< T > itk::Matrix< T, VRows, VColumns >::operator* ( const vnl_matrix< T > & matrix) const

Matrix by vnl_matrix multiplication.

◆ operator*() [7/9]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
template<unsigned int OuterDim>
Matrix< T, VRows, OuterDim > itk::Matrix< T, VRows, VColumns >::operator* ( const vnl_matrix_fixed< T, VRows, OuterDim > & matrix) const
inline

Definition at line 132 of file itkMatrix.h.

◆ operator*() [8/9]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
vnl_vector< T > itk::Matrix< T, VRows, VColumns >::operator* ( const vnl_vector< T > & vc) const

Matrix by vnl_vector multiplication.

◆ operator*() [9/9]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
vnl_vector_fixed< T, VRows > itk::Matrix< T, VRows, VColumns >::operator* ( const vnl_vector_fixed< T, VColumns > & inVNLvect) const

Matrix by vnl_vector_fixed multiplication.

◆ operator*=() [1/3]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
void itk::Matrix< T, VRows, VColumns >::operator*= ( const CompatibleSquareMatrixType & matrix)

Matrix by Matrix multiplication.

◆ operator*=() [2/3]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
void itk::Matrix< T, VRows, VColumns >::operator*= ( const T & value)
inline

Matrix by scalar multiplication.

Definition at line 170 of file itkMatrix.h.

◆ operator*=() [3/3]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
void itk::Matrix< T, VRows, VColumns >::operator*= ( const vnl_matrix< T > & matrix)

Matrix by vnl_matrix multiplication.

◆ operator+()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
Self itk::Matrix< T, VRows, VColumns >::operator+ ( const Self & matrix) const

Matrix addition.

◆ operator+=()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
const Self & itk::Matrix< T, VRows, VColumns >::operator+= ( const Self & matrix)

◆ operator-()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
Self itk::Matrix< T, VRows, VColumns >::operator- ( const Self & matrix) const

Matrix addition.

◆ operator-=()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
const Self & itk::Matrix< T, VRows, VColumns >::operator-= ( const Self & matrix)

◆ operator/()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
Self itk::Matrix< T, VRows, VColumns >::operator/ ( const T & value) const
inline

Matrix by scalar division.

Definition at line 194 of file itkMatrix.h.

◆ operator/=()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
void itk::Matrix< T, VRows, VColumns >::operator/= ( const T & value)
inline

Matrix by scalar division.

Definition at line 187 of file itkMatrix.h.

◆ operator=() [1/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
Self & itk::Matrix< T, VRows, VColumns >::operator= ( const InternalMatrixType & matrix)
inline

Definition at line 317 of file itkMatrix.h.

◆ operator=() [2/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
Self & itk::Matrix< T, VRows, VColumns >::operator= ( const vnl_matrix< T > & matrix)
inline

Assignment operator.

Definition at line 269 of file itkMatrix.h.

◆ operator==()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
bool itk::Matrix< T, VRows, VColumns >::operator== ( const Self & matrix) const
inline

Comparison operators.

Definition at line 295 of file itkMatrix.h.

◆ operator[]() [1/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
T * itk::Matrix< T, VRows, VColumns >::operator[] ( unsigned int i)
inline

Return a row of the matrix.

Definition at line 218 of file itkMatrix.h.

◆ operator[]() [2/2]

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
const T * itk::Matrix< T, VRows, VColumns >::operator[] ( unsigned int i) const
inline

Return a row of the matrix.

Definition at line 225 of file itkMatrix.h.

◆ PrintSelf()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
void itk::Matrix< T, VRows, VColumns >::PrintSelf ( std::ostream & os,
Indent indent ) const
inline

Definition at line 411 of file itkMatrix.h.

◆ SetIdentity()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
void itk::Matrix< T, VRows, VColumns >::SetIdentity ( )
inline

Set the matrix to identity.

Definition at line 246 of file itkMatrix.h.

◆ size()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
unsigned int itk::Matrix< T, VRows, VColumns >::size ( ) const
inlinenodiscardconstexpr

Returns the number of elements.

Definition at line 355 of file itkMatrix.h.

◆ swap()

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
void itk::Matrix< T, VRows, VColumns >::swap ( Self & other)
inlinenoexcept

Definition at line 403 of file itkMatrix.h.

Member Data Documentation

◆ ColumnDimensions

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
unsigned int itk::Matrix< T, VRows, VColumns >::ColumnDimensions = VColumns
staticconstexpr

Definition at line 100 of file itkMatrix.h.

◆ m_Matrix

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
InternalMatrixType itk::Matrix< T, VRows, VColumns >::m_Matrix {}
private

Definition at line 426 of file itkMatrix.h.

Referenced by itk::Matrix< VComponent, VRows, VCols >::operator==().

◆ RowDimensions

template<typename T, unsigned int VRows = 3, unsigned int VColumns = 3>
unsigned int itk::Matrix< T, VRows, VColumns >::RowDimensions = VRows
staticconstexpr

Number Of Columns and Rows.

Definition at line 99 of file itkMatrix.h.

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