MATLAB Function Reference |
Set parameters for sparse matrix routines
Syntax
spparms('key',
value) spparms values = spparms [keys,
values] = spparms spparms(values) value = spparms('key') spparms('default') spparms('tight')
Description
spparms('key',value)
sets one or more of the tunable parameters used in the sparse routines, particularly the minimum degree orderings, colmmd
and symmmd
, and also within sparse backslash. In ordinary use, you should never need to deal with this function.
The meanings of the key
parameters are
spparms,
by itself, prints a description of the current settings.
values = spparms
returns a vector whose components give the current settings.
[keys,values] = spparms
returns that vector, and also returns a character matrix whose rows are the keywords for the parameters.
spparms(values),
with no output argument, sets all the parameters to the values specified by the argument vector.
value = spparms('key')
returns the current setting of one parameter.
spparms('default')
sets all the parameters to their default settings.
spparms('tight')
sets the minimum degree ordering parameters to their tight settings, which can lead to orderings with less fill-in, but which make the ordering functions themselves use more execution time.
The key parameters for default
and tight
settings are
Sparse A\b on Symmetric Positive Definite A
Sparse A\b
on symmetric positive definite A
uses a Cholesky-based solver in conjunction with the symmmd reordering routine.
The parameter 'autommd'
turns the symmmd
reordering on or off within the solver.
If symmmd
is used within the solver, then the minimum degree parameters 'thr_rel'
, 'thr_abs'
, 'exact_d'
, 'supernd'
, 'rreduce'
, and 'wh_frac'
affect the reordering routine within the solver.
Sparse A\b on General Square A
Sparse A\b
on general square A
usually uses UMFPACK in conjunction with amd
or a modified colamd
reordering routine.
The parameter 'umfpack'
turns the use of the UMFPACK software on or off within the solver.
'piv_tol'
controls pivoting within the solver.
'autoamd'
turns amd
and the modified colamd
on or off within the solver.
colmmd
reordering routine.
'autommd'
turns the colmmd
reordering routine on or off within the solver.
colmmd
is used within the solver, then the minimum degree parameters affect the reordering routine within the solver.
Sparse A\b on Rectangular A
Sparse A\b
on rectangular A
uses a QR-based solve in conjunction with the colmmd
reordering routine.
The parameter 'autommd'
turns the colmmd
reordering on or off within the solver.
If colmmd
is used within the solver, then the minimum degree parameters affect the reordering routine within the solver.
See Also
\
, chol
, lu
, qr
, colamd
, colmmd
, symmmd
References
[1] Gilbert, John R., Cleve Moler, and Robert Schreiber, "Sparse Matrices in MATLAB: Design and Implementation," SIAM Journal on Matrix Analysis and Applications, Vol. 13, 1992, pp. 333-356.
[2] Davis, T. A., UMFPACK Version 4.0 User Guide (http://www.cise.ufl.edu/research/sparse/umfpack/v4.0/UserGuide.pdf), Dept. of Computer and Information Science and Engineering, Univ. of Florida, Gainesville, FL, 2002.
spones | sprand |
© 1994-2005 The MathWorks, Inc.