nzmax

Amount of storage allocated for nonzero matrix elements

Syntax

n = nzmax(S)


Description

n = nzmax(S) returns the amount of storage allocated for nonzero elements in sparse matrix S. For sparse matrices, nzmax(S) >= 1.

• If S is a full matrix, then nzmax(S) is equal to prod(size(S)).

Often, nnz(S) and nzmax(S) are the same. But if S is created by an operation which produces fill-in matrix elements, such as sparse matrix multiplication or sparse LU factorization, then more storage might be allocated than is actually required, and nzmax(S) reflects this. Alternatively, sparse(i,j,s,m,n,nzmax) or its simpler form, spalloc(m,n,nzmax), can set nzmax in anticipation of later fill-in.

Extended Capabilities

C/C++ Code Generation
Generate C and C++ code using MATLAB® Coder™.

Thread-Based Environment

Run code in the background using MATLAB® backgroundPool or accelerate code with Parallel Computing Toolbox™ ThreadPool.

This function fully supports thread-based environments. For more information, see Run MATLAB Functions in Thread-Based Environment.

GPU Arrays

Accelerate code by running on a graphics processing unit (GPU) using Parallel Computing Toolbox™.

The nzmax function fully supports GPU arrays. To run the function on a GPU, specify the input data as a gpuArray (Parallel Computing Toolbox). For more information, see Run MATLAB Functions on a GPU (Parallel Computing Toolbox).

Distributed Arrays

Partition large arrays across the combined memory of your cluster using Parallel Computing Toolbox™.

This function fully supports distributed arrays. For more information, see Run MATLAB Functions with Distributed Arrays (Parallel Computing Toolbox).

Version History

Introduced before R2006a