TriangularMatrix<T> Class

public abstract class TriangularMatrix<T> : Matrix<T>

Public MustInherit Class TriangularMatrix(Of T)
	Inherits Matrix(Of T)

generic<typename T>
public ref class TriangularMatrix abstract : public Matrix<T>

[<AbstractClassAttribute>]
type TriangularMatrix<'T> = 
    class
        inherit Matrix<'T>
    end

Inheritance

Object  →  LinearOperator<T>  →  Matrix<T>  →  TriangularMatrix<T>

Type Parameters

T

Use the TriangularMatrix<T> class to represent dense matrices whose elements above or below the diagonal are zero. The name is derived from the shape of the non-zero elements, which form a triangle. However, this class also represents rectangular matrices, whose non-zero elements may form a trapezoid.

A TriangularMatrix<T> can be either upper or lower-triangular, depending on which components are non-zero. This property is available as the StoredTriangle property. It is of type MatrixTriangle, and must be specified at construction.

Sometimes, the components on the diagonal are all equal to one. In this case, the matrix is said to be unit-diagonal, and the IsUnitDiagonal property will be true. Once again, this must be specified at the time the matrix is constructed.

Only the non-zero components of a triangular matrix can be modified. The diagonal components of a unit-diagonal matrix can't be modified. An attempt to do so will result in an ComponentReadOnlyException. You can verify if a component can be modified by calling the IsElementWritable(Int32, Int32) method.

The components of a TriangularMatrix<T> are stored in a one-dimensional array of values. By default, components that are adjacent in a column of the matrix are adjacent in the storage array. The components are said to be stored in column major order. It is also possible to have elements stored in row major order.

Triangular matrices can be constructed from scratch, or they can be derived or extracted from a DenseMatrix<T> using one of the ExtractLowerTriangle<T>(DenseMatrix<T>) or ExtractUpperTriangle<T>(DenseMatrix<T>) methods.

The rows and column vectors of a triangular matrix are of type BlockVector<T>.

The TriangularMatrix<T> class implements algorithms using the triangular matrix BLAS and LAPACK routines. These routines assume matrix components are stored in column major order. However, any necessary conversions are performed transparently. No additional work is needed. In some cases there might be a small performance penalty.

TriangularMatrix<T> objects are used as properties of many matrix decompositions. Both factors of the LU decomposition are triangular. So is at least one factor of the Cholesky Decomposition and the QR Decomposition.

Reference