NAG Library Routine Document
f01vcf (dtpttr) unpacks a real triangular matrix, stored in a standard packed format array, to a full format array.
|Integer, Intent (In)||:: ||n, lda|
|Integer, Intent (Out)||:: ||info|
|Real (Kind=nag_wp), Intent (In)||:: ||ap(n*(n+1)/2)|
|Real (Kind=nag_wp), Intent (Inout)||:: ||a(lda,*)|
|Character (1), Intent (In)||:: ||uplo|C Header Interface
f01vcf_ (const char *uplo, const Integer *n, const double ap, double a, const Integer *lda, Integer *info, const Charlen length_uplo)|
The routine may be called by its
unpacks a real
, stored in an array of length
, to conventional storage in a full format array. This routine is intended for possible use in conjunction with routines from Chapters F06
where some routines use triangular matrices stored in the packed form.
Packed storage format is described in Section 3.3.2
in the F07 Chapter Introduction.
- 1: – Character(1)Input
: specifies whether
is upper or lower triangular.
- is upper triangular.
- is lower triangular.
- 2: – IntegerInput
On entry: , the order of the matrix .
- 3: – Real (Kind=nag_wp) arrayInput
, packed by columns.
- if , the upper triangle of must be stored with element in for ;
- if , the lower triangle of must be stored with element in for .
- 4: – Real (Kind=nag_wp) arrayOutput
the second dimension of the array a
must be at least
: 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.
- 5: – IntegerInput
: the first dimension of the array a
as declared in the (sub)program from which f01vcf (dtpttr)
- 6: – IntegerOutput
unless the routine detects an error (see Section 6
Error Indicators and Warnings
If , argument had an illegal value. An explanatory message is output, and execution of the program is terminated.
Parallelism and Performance
f01vcf (dtpttr) is not threaded in any implementation.
This example reads in a triangular matrix packed by columns and unpacks it to full format.
Program Text (f01vcfe.f90)
Program Data (f01vcfe.d)
Program Results (f01vcfe.r)