This manual relates to an old release of the Library.
The documentation for the current release is also available on this site.

NAG FL Interface
f06rdf (dlansp)

Settings help

FL Name Style:


FL Specification Language:


1 Purpose

f06rdf returns, via the function name, the value of the 1-norm, the -norm, the Frobenius norm, or the maximum absolute value of the elements of a real n×n symmetric matrix, stored in packed form.

2 Specification

Fortran Interface
Function f06rdf ( norm, uplo, n, ap, work)
Real (Kind=nag_wp) :: f06rdf
Integer, Intent (In) :: n
Real (Kind=nag_wp), Intent (In) :: ap(*)
Real (Kind=nag_wp), Intent (Inout) :: work(*)
Character (1), Intent (In) :: norm, uplo
C Header Interface
#include <nag.h>
double  f06rdf_ (const char *norm, const char *uplo, const Integer *n, const double ap[], double work[], const Charlen length_norm, const Charlen length_uplo)
The routine may be called by the names f06rdf or nagf_blas_dlansp.

3 Description

None.

4 References

None.

5 Arguments

1: norm Character(1) Input
On entry: specifies the value to be returned.
norm='1' or 'O'
The 1-norm.
norm='I'
The -norm (= the 1-norm for a symmetric matrix).
norm='F' or 'E'
The Frobenius (or Euclidean) norm.
norm='M'
The value maxi,j|aij| (not a norm).
Constraint: norm='1', 'O', 'I', 'F', 'E' or 'M'.
2: uplo Character(1) Input
On entry: specifies whether the upper or lower triangular part of A is stored.
uplo='U'
The upper triangular part of A is stored.
uplo='L'
The lower triangular part of A is stored.
Constraint: uplo='U' or 'L'.
3: n Integer Input
On entry: n, the order of the matrix A.
When n=0, f06rdf returns zero.
Constraint: n0.
4: ap(*) Real (Kind=nag_wp) array Input
Note: the dimension of the array ap must be at least n× (n+1)/2 .
On entry: the n×n symmetric matrix A, packed by columns.
More precisely,
  • if uplo='U', the upper triangle of A must be stored with element Aij in ap(i+j(j-1)/2) for ij;
  • if uplo='L', the lower triangle of A must be stored with element Aij in ap(i+(2n-j)(j-1)/2) for ij.
5: work(*) Real (Kind=nag_wp) array Workspace
Note: the dimension of the array work must be at least max(1,n) if norm='1', 'O' or 'I', and at least 1 otherwise.

6 Error Indicators and Warnings

None.

7 Accuracy

Not applicable.

8 Parallelism and Performance

f06rdf is not threaded in any implementation.

9 Further Comments

None.

10 Example

None.