|
NAG[f02awc] NAG[nag_hermitian_eigenvalues] - All eigenvalues of complex Hermitian matrix
|
|
Calling Sequence
f02awc(a, r, 'n'=n, 'tda'=tda, 'fail'=fail)
nag_hermitian_eigenvalues(. . .)
Parameters
|
a - Matrix(1..n, 1..tda, datatype=complex[8], order=C_order);
|
|
|
On exit: the array is overwritten.
|
|
|
r - Vector(1..n, datatype=float[8]);
|
|
|
On exit: the eigenvalues in ascending order.
|
|
|
'n'=n - integer; (optional)
|
|
|
Default value: the first dimension of the arrays a, r and the second dimension of the arrays a, rthe array a.
|
|
On entry: , the order of the matrix .
|
|
Constraint: . .
|
|
|
'tda'=tda - integer; (optional)
|
|
|
On entry: the second dimension of the array a as declared in the function from which nag_hermitian_eigenvalues (f02awc) is called.
|
|
Constraint: . .
|
|
|
'fail'=fail - table; (optional)
|
|
|
The NAG error argument, see the documentation for NagError.
|
|
|
|
Description
|
|
|
Purpose
|
|
nag_hermitian_eigenvalues (f02awc) calculates all the eigenvalues of a complex Hermitian matrix.
|
|
Error Indicators and Warnings
|
|
"NE_ALLOC_FAIL"
Dynamic memory allocation failed.
"NE_INT_ARG_LT"
On entry, n must not be less than 1: .
"NE_TOO_MANY_ITERATIONS"
More than iterations are required to isolate all the eigenvalues.
|
|
Accuracy
|
|
For a detailed error analysis see page 235 of Wilkinson and Reinsch (1971).
|
|
Further Comments
|
|
The time taken by nag_hermitian_eigenvalues (f02awc) is approximately proportional to .
|
|
|
Examples
|
|
>
|
n := 4:
tda := 4:
a := Matrix([[0.5 +0*I , 0 +0*I , 1.84 +1.38*I , 2.08 -1.56*I ], [0 +0*I , 0.5 +0*I , 1.12 +0.84*I , -0.5600000000000001 +0.42*I ], [1.84 -1.38*I , 1.12 -0.84*I , 0.5 +0*I , 0 +0*I ], [2.08 +1.56*I , -0.5600000000000001 -0.42*I , 0 +0*I , 0.5 +0*I ]], datatype=complex[8], order='C_order'):
r := Vector(4, datatype=float[8]):
NAG:-f02awc(a, r, 'n' = n, 'tda' = tda):
|

|
|