MATLAB Function Reference 
Syntax
Description
The sparse
function generates matrices in the MATLAB sparse storage organization.
S = sparse(A)
converts a full matrix to sparse form by squeezing out any zero elements. If S
is already sparse, sparse(S)
returns S
.
S = sparse(i,j,s,m,n,nzmax)
uses vectors i
, j
, and s
to generate an m
byn
sparse matrix such that S(i(k),j(k)) = s(k)
, with space allocated for nzmax
nonzeros. Vectors i
, j
, and s
are all the same length. Any elements of s
that are zero are ignored, along with the corresponding values of i
and j
. Any elements of s
that have duplicate values of i
and j
are added together.
Note
If any value in i or j is larger than the maximum integer size, 2^311 , then the sparse matrix cannot be constructed.

To simplify this sixargument call, you can pass scalars for the argument s
and one of the arguments i
or j
in which case they are expanded so that i
, j
, and s
all have the same length.
S = sparse(i,j,s,m,n)
uses nzmax
=
length(s)
.
S = sparse(i,j,s)
uses m
=
max(i)
and n
=
max(j)
. The maxima are computed before any zeros in s
are removed, so one of the rows of [i
j
s]
might be [m
n
0]
.
S = sparse(m,n)
abbreviates sparse([],[],[],m,n,0)
. This generates the ultimate sparse matrix, an m
byn
all zero matrix.
Remarks
All of the MATLAB builtin arithmetic, logical, and indexing operations can be applied to sparse matrices, or to mixtures of sparse and full matrices. Operations on sparse matrices return sparse matrices and operations on full matrices return full matrices.
In most cases, operations on mixtures of sparse and full matrices return full matrices. The exceptions include situations where the result of a mixed operation is structurally sparse, for example, A.*S
is at least as sparse as S
.
Examples
S
=
sparse(1:n,1:n,1)
generates a sparse representation of the n
byn
identity matrix. The same S
results from S
=
sparse(eye(n,n))
, but this would also temporarily generate a full n
byn
matrix with most of its elements equal to zero.
B
=
sparse(10000,10000,pi)
is probably not very useful, but is legal and works; it sets up a 10000
by10000
matrix with only one nonzero element. Don't try full(B);
it requires 800 megabytes of storage.
This dissects and then reassembles a sparse matrix:
So does this, if the last row and column have nonzero entries:
See Also
diag
, find
, full
, issparse
, nnz
, nonzeros
, nzmax
, spones
, sprandn
, sprandsym
, spy
spalloc  spaugment 
© 19942005 The MathWorks, Inc.