f01vk copies a complex triangular matrix stored in packed format to Rectangular Full Packed (RFP) format. The RFP storage format is described in [] in the F07 class Chapter Introduction and the packed storage format is described in [] in the F07 class Chapter Introduction.

Syntax

C#
public static void f01vk(
	string transr,
	string uplo,
	int n,
	Complex[] ap,
	Complex[] arf,
	out int info
)
Visual Basic
Public Shared Sub f01vk ( _
	transr As String, _
	uplo As String, _
	n As Integer, _
	ap As Complex(), _
	arf As Complex(), _
	<OutAttribute> ByRef info As Integer _
)
Visual C++
public:
static void f01vk(
	String^ transr, 
	String^ uplo, 
	int n, 
	array<Complex>^ ap, 
	array<Complex>^ arf, 
	[OutAttribute] int% info
)
F#
static member f01vk : 
        transr : string * 
        uplo : string * 
        n : int * 
        ap : Complex[] * 
        arf : 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" or "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" or "L".
n
Type: System..::..Int32
On entry: n, the order of the matrix A.
Constraint: n≥0.
ap
Type: array<NagLibrary..::..Complex>[]()[][]
An array of size [n×n+1/2]
On entry: the n by n triangular matrix A, packed by columns.
More precisely,
  • if uplo="U", the upper triangle of A must be stored with element Aij in ap[i+jj-1/2] for i≤j;
  • if uplo="L", the lower triangle of A must be stored with element Aij in ap[i+2n-jj-1/2] for i≥j.
arf
Type: array<NagLibrary..::..Complex>[]()[][]
An array of size [n×n+1/2]
On exit: the triangular matrix A in RFP format, as described in [] in the F07 class Chapter Introduction.
info
Type: System..::..Int32%
On exit: info=0 unless the method detects an error (see [Error Indicators and Warnings]).

Description

f01vk copies a complex n by n triangular matrix, A, stored packed format, to RFP format. 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

info<0
If info=-i, argument i had an illegal value. An explanatory message is output, and execution of the program is terminated.
ifail=-9000
An error occured, see message report.
ifail=-6000
Invalid Parameters value
ifail=-8000
Negative dimension for array value
ifail=-6000
Invalid Parameters value

Accuracy

Not applicable.

Parallelism and Performance

None.

Further Comments

None.

Example

This example reads in a triangular matrix in packed format and copies it to RFP format.

Example program (C#): f01vke.cs

Example program data: f01vke.d

Example program results: f01vke.r

See Also