naginterfaces.library.matop.real_​gen_​matrix_​sqrt

naginterfaces.library.matop.real_gen_matrix_sqrt(a)

real_gen_matrix_sqrt computes the principal matrix square root, $A^{1/2}$, of a real $n\times n$ matrix $A$.

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

https://support.nag.com/numeric/nl/nagdoc_30.3/flhtml/f01/f01enf.html

Parameters

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

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

Returns

afloat, ndarray, shape $(n,n)$

Contains, if no exception or warning is raised, the $n\times n$ principal matrix square root, $A^{1/2}$. Alternatively, if $errno$ = 1, contains an $n\times n$ non-principal square root of $A$.

Raises

NagValueError

(errno $-1$)

On entry, $n=⟨value⟩$.

Constraint: $n\ge 0$.

(errno $2$)

$A$ has a defective vanishing eigenvalue. The square root cannot be found in this case.

(errno $3$)

$A$ has a negative real eigenvalue. The principal square root is not defined. complex_gen_matrix_sqrt() can be used to return a complex, non-principal square root.

(errno $4$)

An internal error occurred. It is likely that the function was called incorrectly.

Warns

NagAlgorithmicWarning

(errno $1$)

$A$ has a semisimple vanishing eigenvalue. A non-principal square root is returned.

Notes

A square root of a matrix $A$ is a solution $X$ to the equation $X^2=A$. A nonsingular matrix has multiple square roots. For a matrix with no eigenvalues on the closed negative real line, the principal square root, denoted by $A^{1/2}$, is the unique square root whose eigenvalues lie in the open right half-plane.

$A^{1/2}$ is computed using the algorithm described in Higham (1987). This is a real arithmetic version of the algorithm of Björck and Hammarling (1983). In addition a blocking scheme described in Deadman et al. (2013) is used.

References

Björck, Å and Hammarling, S, 1983, A Schur method for the square root of a matrix, Linear Algebra Appl. (52/53), 127–140

Deadman, E, Higham, N J and Ralha, R, 2013, Blocked Schur Algorithms for Computing the Matrix Square Root, Applied Parallel and Scientific Computing: 11th International Conference, (PARA 2012, Helsinki, Finland), P. Manninen and P. Öster, Eds, Lecture Notes in Computer Science (7782), 171–181, Springer–Verlag

Higham, N J, 1987, Computing real square roots of a real matrix, Linear Algebra Appl. (88/89), 405–430

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