There are several different combinations of command line arguments
that can be used with EigTool
Basic EigTool Operation
The most basic way to run EigTool is simply to type eigtool
at the MATLAB command prompt. EigTool will then be started, and will
wait for you to run a Demo from the Demos Menu, or input a New Matrix.
If you already have a matrix (say A) you wish to use
EigTool for, simply type eigtool(A) and the eigenvalues and
pseudospectra will be computed automatically; depending on the Matrix Type, you may be asked some
questions before the computation begins.
Using OPTIONS to Control the Plot
EigTool has many options available to control the final plot and the
computation method used. These are particularly useful when writing
scripts to call EigTool automatically as part of another
calculation. To run EigTool with options, type
eigtool(A,opts), where the options allowed are as follows:
Option | Description | Value and {Default} |
opts.npts | number of gridpoints to use in the pseudospectra computation (if the axes are not square, this is the number used in longer direction; the number in the shorter direction will be in proportion to the aspect ratio of the axes); see Mesh | [scalar | {automatic}] |
opts.levels | log10(eps) for desired eps-pseudospectra to plot; see Contour Levels | [vector | {automatic}] |
opts.ax | axes on which to compute the pseudospectra/display the eigenvalues; see Figure Axes | [4-by-1 vector | {automatic}] |
opts.proj_lev | pojection level to use (0..Inf); see the Projection Tutorial and Projection Level | [scalar | {Inf}] |
opts.colour or opts.color |
draw the pseudospectra using colored lines. See Colour | [0 | {1}] |
opts.thick_lines | draw the pseudospectra using thick lines; see Thick Lines | [0 | {1}] |
opts.scale_equal | use `axis equal' on axes; see Figure Axes | [0 | {1}] |
opts.print_plot | only create a plot with eigenvalues and pseudospectra (no user interface controls); see Printable Plot | [{0} | 1] |
opts.no_graphics | compute singular value data only, i.e., no user interface or graphical output | [{0} | 1] |
opts.no_waitbar | suppress display of waitbar during computations (useful if calling EigTool from within a script) | [{0} | 1] |
opts.isreal | is A (complex) unitarily similar to a real matrix? If so, pseudospectra will be symmetric about the real axes, saving as much as a factor of two (depending on the axes) in the pseudospectra computation time. Useful if A was obtained from a Schur decomposition. | [{0} | 1] |
opts.ews | eigenvalues of rectangular or sparse matrices are not computed by default in EigTool (unless using ARPACK/eigs); if they are known in advance, they can be added to the plot using this option | [vector | {[]}] |
opts.dim | display the matrix dimension on the plot; see Display Dimension | [0 | {1}] |
opts.grid | display the grid as dots on the plot; see Display Grid | [{0} | 1] |
opts.no_ews | suppress display of the eigenvalues (plot pseudospectra only); see Display Eigenvalues | [{0} | 1] |
opts.no_psa | suppress display of the pseudospectra (plot eigenvalues only); see Display Pseudospectra | [{0} | 1] |
opts.fov | compute and display the field of values; see Field of Vals. | [{0} | 1] |
opts.unitary_mtx | a unitary transformation to apply to eigenmodes and pseudoeigenmodes, useful if the input matrix was gererated from a unitary transformation of the original matrix. | [matrix | {[]}] |
opts.imag_axis | highlight the imaginary axis in grey? See Display Imaginary Axis | [{0} | 1] |
opts.unit_circle | highlight the unit circle in grey? See Display Unit Circle | [{0} | 1] |
opts.colourbar | Display the colourbar showing the epsilon levels plotted? See Display Colourbar | [{0} | 1] |
opts.direct | Use direct (rather than iterative) method; see Direct/Iterative | [0 | {automatic}] |
opts.k | No. of eigenvalues for eigs to search for. The default value is set by eigs, and is currently 6. | [1..n | {automatic}] |
opts.p | Maximum subspace size for eigs. The default value is determined by eigs, and is approximately twice the number of requested eigenvalues. | [1..n | {default}] |
opts.which | Which eigenvalues should eigs look for?. The default value is set by eigs, and is currently 'LM'. | [string| {default}] |
opts.tol | Tolerance for eigs to use. The default value is set by eigs, and is currently machine epsilon. | [scalar | {default}] |
opts.maxit | Maximum number of iterations for eigs. The default value is determined by eigs, and is max(300,2*n/p). | [1..Inf | {default}] |
opts.v0 | Starting vector for eigs. The default value is determined by eigs, and is a random vector. | [vector | {default}] |
eigtool(A,fig) will start EigTool in the figure number fig.
eigtool(A,opts,fig) will start EigTool in the figure number fig and use the options opts.
eigtool(data_file) will create a Printable Plot from data saved with Save for Quick Print Creation.
[x,y,sigs] = eigtool(A) will output the computed pseudospectra data as vectors x and y defining the grid, and sigs the singular value data.
eigtool(x,y,sigs) will create a Printable Plot using the pseudospectra data x, y and sigs.
eigtool(x,y,sigs,fig) as above, but the plot is created in figure number fig.
eigtool(x,y,sigs,opts) as above, but opts contains options data to control the look of the plot. Note that not all options are applicable here; for example, the axes are determined by x and y, not opts.ax.
eigtool(x,y,sigs,opts,fig) as above, but the plot is created in figure number fig using options opts.
EigTool home page.