This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.


Spectral radius of a matrix

MuPAD® notebooks are not recommended. Use MATLAB® live scripts instead.

MATLAB live scripts support most MuPAD functionality, though there are some differences. For more information, see Convert MuPAD Notebooks to MATLAB Live Scripts.


numeric::spectralRadius(A, <x0>, <n>, <mode>, <ReturnType = t>, <NoWarning>)


numeric::spectralRadius and numeric::spectralradius are equivalent. For details and examples, see numeric::spectralradius.

Environment Interactions

The function is sensitive to the environment variable DIGITS, which determines the numerical working precision.



An m×m array of domain type DOM_ARRAY or DOM_HFARRAY or a matrix of category Cat::Matrix


A starting vector: a one-dimensional array, or an hfarray, or a list of length m. Also two-dimensional arrays (array(1..m, 1..1, ...), hfarray(1..m, 1..1, ...)) and matrices representing vectors are accepted.


The maximal number of iterations: a positive integer. The default value is 1000.


One of the flags Hard, HardwareFloats, Soft, or SoftwareFloats

Return Values

A list [lambda, x, residue] is returned. The floating-point number lambda is an approximation of the eigenvalue of largest absolute value. The vector x is a numerical eigenvector corresponding to lambda. residue is a floating-point number indicating the numerical quality of lambda and x.

If no return type is requested via the ReturnType option, the type of the returned vector x coincides with the type of the input vector x0 (i.e., it is a one-dimensional array of type DOM_ARRAY or DOM_HFARRAY, respectively, or a list, or a column vector of type matrix or densematrix. If no starting vector is specified, the type of x is determined by the type of A.

Was this topic helpful?