PDF version (NAG web site
, 64-bit version, 64-bit version)
NAG Toolbox: nag_matop_complex_gen_matrix_pow (f01fq)
Purpose
nag_matop_complex_gen_matrix_pow (f01fq) computes an abitrary real power of a complex by matrix .
Syntax
[
a,
ifail] = nag_matop_complex_gen_matrix_pow(
a,
p, 'n',
n)
Description
For a matrix
with no eigenvalues on the closed negative real line,
(
) can be defined as
where
is the principal logarithm of
(the unique logarithm whose spectrum lies in the strip
).
is computed using the Schur–Padé algorithm described in
Higham and Lin (2011) and
Higham and Lin (2013).
The real number is expressed as where and . Then . The integer power is found using a combination of binary powering and, if necessary, matrix inversion. The fractional power is computed using a Schur decomposition and a Padé approximant.
References
Higham N J (2008) Functions of Matrices: Theory and Computation SIAM, Philadelphia, PA, USA
Higham N J and Lin L (2011) A Schur–Padé algorithm for fractional powers of a matrix SIAM J. Matrix Anal. Appl. 32(3) 1056–1078
Higham N J and Lin L (2013) An improved Schur–Padé algorithm for fractional powers of a matrix and their Fréchet derivatives
MIMS Eprint 2013.1 Manchester Institute for Mathematical Sciences, School of Mathematics, University of Manchester
http://eprints.ma.man.ac.uk/
Parameters
Compulsory Input Parameters
- 1:
– complex array
-
The first dimension of the array
a must be at least
.
The second dimension of the array
a must be at least
.
The by matrix .
- 2:
– double scalar
-
The required power of .
Optional Input Parameters
- 1:
– int64int32nag_int scalar
-
Default:
the first dimension of the array
a.
, the order of the matrix .
Constraint:
.
Output Parameters
- 1:
– complex array
-
The first dimension of the array
a will be
.
The second dimension of the array
a will be
.
If , the by matrix th power, . Alternatively, if , contains an by non-principal power of .
- 2:
– int64int32nag_int scalar
unless the function detects an error (see
Error Indicators and Warnings).
Error Indicators and Warnings
Errors or warnings detected by the function:
-
-
has eigenvalues on the negative real line. The principal th power is not defined so a non-principal power is returned.
-
-
is singular so the th power cannot be computed.
-
-
has been computed using an IEEE double precision Padé approximant, although the arithmetic precision is higher than IEEE double precision.
-
-
An unexpected internal error occurred. This failure should not occur and suggests that the function has been called incorrectly.
-
-
Constraint: .
-
-
Constraint: .
-
An unexpected error has been triggered by this routine. Please
contact
NAG.
-
Your licence key may have expired or may not have been installed correctly.
-
Dynamic memory allocation failed.
Accuracy
For positive integer , the algorithm reduces to a sequence of matrix multiplications. For negative integer , the algorithm consists of a combination of matrix inversion and matrix multiplications.
For a normal matrix (for which ) and non-integer , the Schur decomposition is diagonal and the algorithm reduces to evaluating powers of the eigenvalues of and then constructing using the Schur vectors. This should give a very accurate result. In general however, no error bounds are available for the algorithm.
Further Comments
The cost of the algorithm is . The exact cost depends on the matrix but if then the cost is independent of .
complex allocatable memory is required by the function.
If estimates of the condition number of
are required then
nag_matop_complex_gen_matrix_cond_pow (f01ke) should be used.
Example
This example finds
where
and
Open in the MATLAB editor:
f01fq_example
function f01fq_example
fprintf('f01fq example results\n\n');
a = [ 2 3 2 1+3i;
2+i 1 1 2+2i;
2+i 2+2i 2i 2+4i;
3 2+2i 3 1];
p = 0.2;
[pa, ifail] = f01fq(a,p);
disp('A^p:');
disp(pa);
f01fq example results
A^p:
1.1766 - 0.0758i 0.1375 + 0.2241i 0.2742 - 0.2223i -0.1435 + 0.0816i
0.2074 - 0.0998i 1.1118 - 0.0039i -0.1343 - 0.0404i 0.1794 + 0.3590i
-0.0859 - 0.0824i 0.5224 - 0.0530i 1.0616 + 0.3921i 0.2308 + 0.1856i
0.3313 + 0.1303i -0.1507 + 0.0982i 0.2178 - 0.0061i 1.1710 - 0.2136i
PDF version (NAG web site
, 64-bit version, 64-bit version)
© The Numerical Algorithms Group Ltd, Oxford, UK. 2009–2015