Typesetting math: 100%
f01vd unpacks a complex triangular matrix, stored in packed format in a one-dimensional array, to full format in a two-dimensional array. Packed storage format is described in [] in the F07 class Chapter Introduction.

Syntax

C#
public static void f01vd(
	string uplo,
	int n,
	Complex[] ap,
	Complex[,] a,
	out int info
)
Visual Basic
Public Shared Sub f01vd ( _
	uplo As String, _
	n As Integer, _
	ap As Complex(), _
	a As Complex(,), _
	<OutAttribute> ByRef info As Integer _
)
Visual C++
public:
static void f01vd(
	String^ uplo, 
	int n, 
	array<Complex>^ ap, 
	array<Complex,2>^ a, 
	[OutAttribute] int% info
)
F#
static member f01vd : 
        uplo : string * 
        n : int * 
        ap : Complex[] * 
        a : Complex[,] * 
        info : int byref -> unit 

Parameters

uplo
Type: System..::..String
On entry: specifies whether  is upper or lower triangular.
 is upper triangular.
 is lower triangular.
Constraint:  or .
n
Type: System..::..Int32
On entry: , the order of the matrix .
Constraint: .
ap
Type: array<NagLibrary..::..Complex>[]()[][]
An array of size []
On entry: the  by  triangular matrix , packed by columns.
More precisely,
  • if , the upper triangle of  must be stored with element  in  for ;
  • if , the lower triangle of  must be stored with element  in  for .
a
Type: array<NagLibrary..::..Complex,2>[,](,)[,][,]
An array of size [dim1, dim2]
Note: dim1 must satisfy the constraint:
Note: the second dimension of the array a must be at least .
On exit: the triangular matrix .
  • If ,  is upper triangular and the elements of the array below the diagonal are not referenced.
  • If ,  is lower triangular and the elements of the array above the diagonal are not referenced.
info
Type: System..::..Int32%
On exit:  unless the method detects an error (see [Error Indicators and Warnings]).

Description

f01vd unpacks a complex  by  triangular matrix , stored in a one-dimensional array of length  to conventional storage in a two-dimensional array. This method is intended for possible use in conjunction with methods from F06 class F07 class F08 class where some methods use triangular matrices stored in the packed form.

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.
If , argument  had an illegal value. An explanatory message is output, and execution of the program is terminated.
An error occured, see message report.
Invalid Parameters
Invalid dimension for array
Negative dimension for array
Invalid Parameters

Accuracy

Not applicable.

Parallelism and Performance

None.

Further Comments

None.

Example

This example reads in a triangular matrix packed by columns and unpacks it to full format.

Example program (C#): f01vde.cs

Example program data: f01vde.d

Example program results: f01vde.r

See Also