ITK  5.4.0
Insight Toolkit
Public Types | Public Member Functions | Static Public Attributes | Private Attributes | List of all members
itk::Matrix< T, VRows, VColumns > Class Template Reference
Data Representation ObjectsGroup 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, Examples/DataRepresentation/Mesh/MeshTraits.cxx, SphinxExamples/src/Core/Common/Matrix/Code.cxx, SphinxExamples/src/Core/Common/MatrixInverse/Code.cxx, and SphinxExamples/src/Core/Transform/ApplyAffineTransformFromHomogeneousMatrixAndResample/Code.cxx.

Definition at line 52 of file itkMatrix.h.

Public Types

using CompatibleSquareMatrixType = Matrix< T, VColumns, VColumns >
 
using ComponentType = T
 
using InternalMatrixType = vnl_matrix_fixed< T, VRows, VColumns >
 
using Self = Matrix
 
using ValueType = T
 

Public Member Functions

void Fill (const T &value)
 
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 SetIdentity ()
 
void swap (Self &other)
 
vnl_matrix_fixed< T, VColumns, VRows > GetInverse () const
 
vnl_matrix_fixed< T, VColumns, VRows > GetTranspose () const
 

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 72 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 60 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 67 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 56 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 59 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 225 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 234 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 272 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

◆ 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.

Examples
Examples/DataRepresentation/Image/Image4.cxx.

Definition at line 210 of file itkMatrix.h.

Referenced by TestBaseClassMethodsMeshIO().

◆ 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 200 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
inline

Return the inverse matrix.

Definition at line 278 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
inline

Return the transposed matrix.

Definition at line 291 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 179 of file itkMatrix.h.

Referenced by itk::OpenCVBasicTypeBridge< itk::Matrix< T, VRows, VColumns >, cv::Matx< T, VRows, VColumns > >::FromITKToOpenCV(), itk::detail::GetPointerToMatrixData(), and itk::operator<<().

◆ GetVnlMatrix() [2/2]

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

Return the matrix.

Definition at line 186 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 159 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 166 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 132 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 90 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 126 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 149 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 142 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 265 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 217 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 243 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 172 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 175 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 193 of file itkMatrix.h.

Referenced by itk::IOTestHelper::SetIdentityDirection().

◆ swap()

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

Definition at line 305 of file itkMatrix.h.

Referenced by itk::swap().

Member Data Documentation

◆ ColumnDimensions

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

Definition at line 64 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 313 of file itkMatrix.h.

Referenced by itk::Matrix< double, Self::ImageDimension, Self::ImageDimension >::operator==(), and itk::Matrix< double, Self::ImageDimension, Self::ImageDimension >::swap().

◆ RowDimensions

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

Number Of Columns and Rows.

Definition at line 63 of file itkMatrix.h.

The documentation for this class was generated from the following file:
Tarballs of the nightly generated Doxygen documentation are available for the html, xml, and tag file. Previous versions of this documentation for version: 5.3, 5.2, 5.1, 5.0, 4.13, 3.20.
Generated on unknown for ITK by   doxygen 1.8.16