gdaReadSparse

Purpose

Gets a sparse matrix from a GAUSS Data Archive.

Format

sm = gdaReadSparse(filename, varname)
Parameters:
  • filename (string) – name of data file.
  • varname (string) – name of sparse matrix variable in the GDA.
Returns:

sm (sparse matrix) – .- The data contained in the variables in varname.

Examples

// Declare sparse matrix sm1
sparse matrix sm1;

sm1 = gdaReadSparse("myfile.gda", "sm");

Remarks

If gdaReadSparse() fails, it will return a sparse scalar error code. Call scalerr() to get the value of the error code. The error code may be any of the following:

1 Null file name.
2 File open error.
4 File read error.
5 Invalid file type.
8 Variable not found.
10 File contains no variables.
14 File too large to be read on current platform.

See also

Functions gdaRead(), gdaReadStruct(), gdaWrite()