Matrix.ExtractUpperTriangle Method

Definition

Namespace: Numerics.NET
Assembly: Numerics.NET (in Numerics.NET.dll) Version: 9.0.4

Overload List

ExtractUpperTriangle<T>(DenseMatrix<T>) Constructs a TriangularMatrix<T> whose elements are contained in the storedTriangle triangular portion of a DenseMatrix<T>.
ExtractUpperTriangle<T>(HermitianMatrix<T>) Constructs a TriangularMatrix<T> whose elements are contained in the lower triangular portion of a HermitianMatrix<T>.
ExtractUpperTriangle<T>(DenseMatrix<T>, MatrixDiagonal) Constructs a TriangularMatrix<T> whose elements are contained in the upper triangular portion of a DenseMatrix<T>.
ExtractUpperTriangle<T>(HermitianMatrix<T>, MatrixDiagonal) Constructs an upper TriangularMatrix<T> whose elements are contained in the upper triangular portion of a HermitianMatrix<T>.
ExtractUpperTriangle<T>(SymmetricMatrix<T>, MatrixDiagonal) Constructs an upper TriangularMatrix<T> whose elements are contained in the upper triangular portion of a SymmetricMatrix<T>.
ExtractUpperTriangle<T>(DenseMatrix<T>, Int32, Int32, MatrixDiagonal) Constructs a TriangularMatrix<T> whose elements are contained in the upper triangular portion of a DenseMatrix<T>.

ExtractUpperTriangle<T>(DenseMatrix<T>)

Constructs a TriangularMatrix<T> whose elements are contained in the storedTriangle triangular portion of a DenseMatrix<T>.
C#
public static TriangularMatrix<T> ExtractUpperTriangle<T>(
	DenseMatrix<T> matrix
)

Parameters

matrix  DenseMatrix<T>
A DenseMatrix<T>.

Type Parameters

T

Return Value

TriangularMatrix<T>
A TriangularMatrix<T> whose elements are contained in the storedTriangle triangular portion of matrix.

Exceptions

ArgumentNullException

matrix is null.

ExtractUpperTriangle<T>(HermitianMatrix<T>)

Constructs a TriangularMatrix<T> whose elements are contained in the lower triangular portion of a HermitianMatrix<T>.
C#
public static TriangularMatrix<T> ExtractUpperTriangle<T>(
	HermitianMatrix<T> matrix
)

Parameters

matrix  HermitianMatrix<T>
A HermitianMatrix<T>.

Type Parameters

T

Return Value

TriangularMatrix<T>
A TriangularMatrix<T> whose elements are contained in the lower triangular portion of matrix.

Exceptions

ArgumentNullException

matrix is null.

ExtractUpperTriangle<T>(DenseMatrix<T>, MatrixDiagonal)

Constructs a TriangularMatrix<T> whose elements are contained in the upper triangular portion of a DenseMatrix<T>.
C#
public static TriangularMatrix<T> ExtractUpperTriangle<T>(
	DenseMatrix<T> matrix,
	MatrixDiagonal unitDiagonal
)

Parameters

matrix  DenseMatrix<T>
A DenseMatrix<T>.
unitDiagonal  MatrixDiagonal
If true, the matrix is unit triangular. Only the elements below the diagonal in matrix are considered. If false, the diagonal elements of matrix are taken as the diagonal elements of the triangular matrix.

Type Parameters

T

Return Value

TriangularMatrix<T>
A TriangularMatrix<T> whose elements are contained in the upper triangular portion of matrix.

Exceptions

ArgumentNullException

matrix is null.

ExtractUpperTriangle<T>(HermitianMatrix<T>, MatrixDiagonal)

Constructs an upper TriangularMatrix<T> whose elements are contained in the upper triangular portion of a HermitianMatrix<T>.
C#
public static TriangularMatrix<T> ExtractUpperTriangle<T>(
	HermitianMatrix<T> matrix,
	MatrixDiagonal unitDiagonal
)

Parameters

matrix  HermitianMatrix<T>
A HermitianMatrix<T>.
unitDiagonal  MatrixDiagonal
If true, the matrix is unit triangular. Only the elements below the diagonal in matrix are considered. If false, the diagonal elements of matrix are taken as the diagonal elements of the triangular matrix.

Type Parameters

T

Return Value

TriangularMatrix<T>
A TriangularMatrix<T> whose elements are contained in the lower triangular portion of matrix.

Exceptions

ArgumentNullException

matrix is null.

ExtractUpperTriangle<T>(SymmetricMatrix<T>, MatrixDiagonal)

Constructs an upper TriangularMatrix<T> whose elements are contained in the upper triangular portion of a SymmetricMatrix<T>.
C#
public static TriangularMatrix<T> ExtractUpperTriangle<T>(
	SymmetricMatrix<T> matrix,
	MatrixDiagonal unitDiagonal = MatrixDiagonal.NonUnitDiagonal
)

Parameters

matrix  SymmetricMatrix<T>
A SymmetricMatrix<T>.
unitDiagonal  MatrixDiagonal  (Optional)
If true, the matrix is unit triangular. Only the elements below the diagonal in matrix are considered. If false, the diagonal elements of matrix are taken as the diagonal elements of the triangular matrix.

Type Parameters

T

Return Value

TriangularMatrix<T>
A TriangularMatrix<T> whose elements are contained in the lower triangular portion of matrix.

Exceptions

ArgumentNullException

matrix is null.

ExtractUpperTriangle<T>(DenseMatrix<T>, Int32, Int32, MatrixDiagonal)

Constructs a TriangularMatrix<T> whose elements are contained in the upper triangular portion of a DenseMatrix<T>.
C#
public static TriangularMatrix<T> ExtractUpperTriangle<T>(
	DenseMatrix<T> matrix,
	int rowCount,
	int columnCount,
	MatrixDiagonal unitDiagonal = MatrixDiagonal.NonUnitDiagonal
)

Parameters

matrix  DenseMatrix<T>
A DenseMatrix<T>.
rowCount  Int32
The number of rows in the TriangularMatrix<T>.
columnCount  Int32
The number of columns in the TriangularMatrix<T>.
unitDiagonal  MatrixDiagonal  (Optional)
If true, the matrix is unit triangular. Only the elements below the diagonal in matrix are considered. If false, the diagonal elements of matrix are taken as the diagonal elements of the triangular matrix.

Type Parameters

T

Return Value

TriangularMatrix<T>
A TriangularMatrix<T> whose elements are contained in the lower triangular portion of matrix.

Exceptions

ArgumentNullException

matrix is null.

ArgumentOutOfRangeException

rowCount is less than zero or greater than or equal to the number of rows in matrix.

-or-

columnCount is less than zero or greater than or equal to the number of columns in matrix.

See Also