naginterfaces.library.matop.complex_​gen_​matrix_​frcht_​exp

naginterfaces.library.matop.complex_gen_matrix_frcht_exp(a, e)

complex_gen_matrix_frcht_exp computes the Fréchet derivative $L(A,E)$ of the matrix exponential of a complex $n\times n$ matrix $A$ applied to the complex $n\times n$ matrix $E$. The matrix exponential $e^A$ is also returned.

For full information please refer to the NAG Library document for f01kh

https://support.nag.com/numeric/nl/nagdoc_30.1/flhtml/f01/f01khf.html

Parameters

acomplex, array-like, shape $(n,n)$

The $n\times n$ matrix $A$.

ecomplex, array-like, shape $(n,n)$

The $n\times n$ matrix $E$

Returns

acomplex, ndarray, shape $(n,n)$

The $n\times n$ matrix exponential $e^A$.

ecomplex, ndarray, shape $(n,n)$

The Fréchet derivative $L(A,E)$

Raises

NagValueError

(errno $-1$)

On entry, $n=⟨value⟩$.

Constraint: $n\ge 0$.

(errno $1$)

The linear equations to be solved for the Padé approximant are singular; it is likely that this function has been called incorrectly.

(errno $3$)

An unexpected internal error has occurred. Please contact NAG.

Warns

NagAlgorithmicWarning

(errno $2$)

The arithmetic precision is higher than that used for the Padé approximant computed matrix exponential.

Notes

The Fréchet derivative of the matrix exponential of $A$ is the unique linear mapping $E⟼L(A,E)$ such that for any matrix $E$

$$e^{A+E}-e^A-L(A,E)=o\left(\parallel E\parallel \right)\text{.}$$

The derivative describes the first-order effect of perturbations in $A$ on the exponential $e^A$.

complex_gen_matrix_frcht_exp uses the algorithms of Al–Mohy and Higham (2009a) and Al–Mohy and Higham (2009b) to compute $e^A$ and $L(A,E)$. The matrix exponential $e^A$ is computed using a Padé approximant and the scaling and squaring method. The Padé approximant is then differentiated in order to obtain the Fréchet derivative $L(A,E)$.

References

Al–Mohy, A H and Higham, N J, 2009, A new scaling and squaring algorithm for the matrix exponential, SIAM J. Matrix Anal. (31(3)), 970–989

Al–Mohy, A H and Higham, N J, 2009, Computing the Fréchet derivative of the matrix exponential, with an application to condition number estimation, SIAM J. Matrix Anal. Appl. (30(4)), 1639–1657

Higham, N J, 2008, Functions of Matrices: Theory and Computation, SIAM, Philadelphia, PA, USA

Moler, C B and Van Loan, C F, 2003, Nineteen dubious ways to compute the exponential of a matrix, twenty-five years later, SIAM Rev. (45), 3–49