f01vh unpacks a complex triangular matrix stored in Rectangular Full Packed (RFP) format to full format in a two-dimensional array. The RFP storage format is described in [] in the F07 class Chapter Introduction.

Syntax

C#
public static void f01vh( string transr, string uplo, int n, Complex[] arf, Complex[,] a, out int info )

Visual Basic
Public Shared Sub f01vh ( _ transr As String, _ uplo As String, _ n As Integer, _ arf As Complex(), _ a As Complex(,), _ <OutAttribute> ByRef info As Integer _ )

Visual C++
public: static void f01vh( String^ transr, String^ uplo, int n, array<Complex>^ arf, array<Complex,2>^ a, [OutAttribute] int% info )

F#
static member f01vh : transr : string * uplo : string * n : int * arf : Complex[] * a : Complex[,] * info : int byref -> unit

Parameters

transr

Type: System..::..String

On entry: specifies whether the normal RFP representation of

A

or its conjugate transpose is stored.

$transr = "N"$: The matrix $A$ is stored in normal RFP format.
$transr = "C"$: The conjugate transpose of the RFP representation of the matrix $A$ is stored.

Constraint:

transr = "N"

"C"

uplo

Type: System..::..String

On entry: specifies whether

A

is upper or lower triangular.

$uplo = "U"$: $A$ is upper triangular.
$uplo = "L"$: $A$ is lower triangular.

Constraint:

uplo = "U"

"L"

n: Type: System..::..Int32
On entry: $n$ , the order of the matrix $A$ .

Constraint: $n \geq 0$ .

arf: Type: array<NagLibrary..::..Complex>[]()[][]
An array of size [ $n \times (n + 1) / 2$ ]
On entry: the $n$ by $n$ triangular matrix $A$ in RFP format, as described in [] in the F07 class Chapter Introduction.

a

Type: array<NagLibrary..::..Complex,2>[,](,)[,][,]

An array of size [dim1, dim2]

Note: dim1 must satisfy the constraint:

dim1 \geq \max (1, n)

Note: the second dimension of the array a must be at least

n

On exit: the triangular matrix

A

If $uplo = "U"$ , $A$ is upper triangular and the elements of the array below the diagonal are not referenced.
If $uplo = "L"$ , $A$ is lower triangular and the elements of the array above the diagonal are not referenced.

info: Type: System..::..Int32%
On exit: $info = 0$ unless the method detects an error (see [Error Indicators and Warnings]).

Description

f01vh unpacks a complex

n

n

triangular matrix

A

, stored in RFP format to conventional storage in a two-dimensional array. This method is intended for possible use in conjunction with methods from F06 class F07 class where some methods that use triangular matrices store them in RFP format.

References

None.

Error Indicators and Warnings

Some error messages may refer to parameters that are dropped from this interface (LDA) In these cases, an error in another parameter has usually caused an incorrect value to be inferred.