view main/sparsersb/doc/sparsersb.txt @ 11596:493ef9d1c25d octave-forge

implemented a way to specify the type of a matrix, when loading from file.
author michelemartone
date Wed, 03 Apr 2013 17:41:37 +0000
parents b0dc1a40bf8a
children b3a2cfb1a0c1
line wrap: on
line source


 -- Loadable Function: S = sparsersb (A)
     Create a sparse RSB matrix from the full matrix A.

 -- Loadable Function: [S, NROWS, NCOLS, NNZ, REPINFO, FIELD, SYMMETRY]
= sparsersb (MFN, MTS)
     Create a sparse RSB matrix by loading the Matrix Market matrix
     file named MFN. The optional argument MTS can specify either real
     ("D") or complex ("Z") type. Default is real.  In the case MFN is
     "?", a string listing the available numerical types with
     BLAS-style characters will be returned.

 -- Loadable Function: S = sparsersb (I, J, SV, M, N, NZMAX)
     Create a sparse RSB matrix given integer index vectors I and J, a
     1-by-`nnz' vector of real of complex values SV, overall dimensions
     M and N of the sparse matrix.  The argument `nzmax' is ignored but
     accepted for compatibility with MATLAB.

     *Note*: if multiple values are specified with the same I, J
     indices, the corresponding values in S will be added.

     The following are all equivalent:

          s = sparsersb (i, j, s, m, n)
          s = sparsersb (i, j, s, m, n, "summation")
          s = sparsersb (i, j, s, m, n, "sum")

 -- Loadable Function: S = sparsersb (I, J, S, M, N, "unique")
     Same as above, except that if more than two values are specified
     for the same I, J indices, the last specified value will be used.

 -- Loadable Function: S = sparsersb (I, J, SV)
     Uses `M = max (I)', `N = max (J)'

 -- Loadable Function: S = sparsersb (M, N)
     If M and N are integers, equivalent to `sparsersb ([], [], [], M,
     N, 0)'

 -- Loadable Function: S = sparsersb ("set", OPN, OPV)
     If OPN is a string representing a valid librsb option name and OPV
     is a string representing a valid librsb option value, the
     correspondent librsb option will be set to that value.

 -- Loadable Function: S = sparsersb (A, "get", MIF)
     If MIF is a string specifying a valid librsb matrix info string
     (valid for librsb's rsb_mtx_get_info_from_string()), then the
     correspondent value will be returned for matrix A. If MIF is the
     an empty string (""), matrix structure information will be
     returned.

 -- Loadable Function: S = sparsersb (A, S)
     If A is a sparsersb matrix and S is a string, S will be
     interpreted as a query string about matrix A.

     Please note that on `sparsersb' type variables are available most,
     but not all of the operators available for `full' or `sparse'
     typed variables.

     See also: full, sparse



Additional help for built-in functions and operators is
available in the on-line version of the manual.  Use the command
`doc <topic>' to search the manual index.

Help and information about Octave is also available on the WWW
at http://www.octave.org and via the help@octave.org
mailing list.