MATLAB Function Reference Previous page   Next Page
spconvert

Import matrix from sparse matrix external format

Syntax

Description

spconvert is used to create sparse matrices from a simple sparse format easily produced by non-MATLAB sparse programs. spconvert is the second step in the process:

  1. Load an ASCII data file containing [i,j,v] or [i,j,re,im] as rows into a MATLAB variable.
  2. Convert that variable into a MATLAB sparse matrix.

S = spconvert(D) converts a matrix D with rows containing [i,j,s] or [i,j,r,s] to the corresponding sparse matrix. D must have an nnz or nnz+1 row and three or four columns. Three elements per row generate a real matrix and four elements per row generate a complex matrix. A row of the form [m n 0] or [m n 0 0] anywhere in D can be used to specify size(S). If D is already sparse, no conversion is done, so spconvert can be used after D is loaded from either a MAT-file or an ASCII file.

Examples

Suppose the ASCII file uphill.dat contains

Then the statements

recreate sparse(triu(hilb(4))), possibly with roundoff errors. In this case, the last line of the input file is not necessary because the earlier lines already specify that the matrix is at least 4-by-4.


Previous page  spaugment spdiags Next page

© 1994-2005 The MathWorks, Inc.