SingleTriangularMatrix Class

Members See Also

Represents a SingleMatrix whose elements above or below the main diagonal are zero.

Namespace: Extreme.Mathematics.LinearAlgebra
Assembly: Extreme.Numerics.SinglePrecision.Net40 (in Extreme.Numerics.SinglePrecision.Net40.dll) Version: 4.0.10170.0 (4.0.11003.0)

Syntax

C#
[SerializableAttribute] public sealed class SingleTriangularMatrix : SingleMatrix, ISingleStorage, ISerializable

Visual Basic (Declaration)
<SerializableAttribute> _ Public NotInheritable Class SingleTriangularMatrix _ Inherits SingleMatrix _ Implements ISingleStorage, ISerializable

Visual C++
[SerializableAttribute] public ref class SingleTriangularMatrix sealed : public SingleMatrix, ISingleStorage, ISerializable

F#
[<SealedAttribute>] [<SerializableAttribute>] type SingleTriangularMatrix = class inherit SingleMatrix interface ISingleStorage interface ISerializable end

Remarks

Use the SingleTriangularMatrix 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 SingleTriangularMatrix can be either upper or lower-triangular, depending on which components are non-zero. This property is available as the TriangleMode 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 IsComponentWritable(Int32, Int32) method.

The components of a SingleTriangularMatrix are stored in a one-dimensional array of Single 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 SingleDenseMatrix using one of the ExtractLowerTriangle(SingleDenseMatrix, Int32, Int32, MatrixDiagonal) or ExtractUpperTriangle(SingleDenseMatrix) methods.

The rows and column vectors of a triangular matrix are of type BandVector.

The SingleTriangularMatrix 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 transparantly. No additional work is needed. In some cases there might be a small performance penalty.

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

Inheritance Hierarchy

System..::..Object
  Extreme.Mathematics.LinearAlgebra..::..SingleLinearTransformation
    Extreme.Mathematics..::..SingleMatrix
      Extreme.Mathematics.LinearAlgebra..::..SingleTriangularMatrix