Function

sparse_matrix_create_double

Returns a double-precision sparse matrix object.

Declaration

sparse_matrix_double sparse_matrix_create_double(sparse_dimension M, sparse_dimension N);

Parameters

M

The number of rows of the matrix. Must be greater than 0.

N

The number of columns of the matrix. Must be greater than 0.

Return Value

A matrix object that is ready for receiving entries. If an error occurs, nil is returned.

Discussion

This function creates a sparse matrix object that is stored in pointwise format and is ready to receive values from the various insert routines. Pointwise format means individual values are stored for a given i,j location as opposed to blocks of values. For block support use the block create routines. See the various insert routines for details on inserting entries into this matrix object.

After you've finished with the matrix, it's important that you free the memory allocated to it with sparse_matrix_destroy.

See Also

Matrix Creation and Population

sparse_matrix_create_float

Returns a single-precision sparse matrix object.

sparse_insert_entry_double

Inserts a single scalar entry into a double-precision sparse matrix.

sparse_insert_entry_float

Inserts a single scalar entry into a single-precision sparse matrix.

sparse_insert_entries_double

Inserts a list of scalar entries into a double-precision sparse matrix.

sparse_insert_entries_float

Inserts a list of scalar entries into a single-precision sparse matrix.

sparse_insert_col_double

Inserts a list of scalar entries into a single column of a double-precision sparse matrix.

sparse_insert_col_float

Inserts a list of scalar entries into a single column of a single-precision sparse matrix.

sparse_insert_row_double

Inserts a list of scalar entries into a single row of a double-precision sparse matrix.

sparse_insert_row_float

Inserts a list of scalar entries into a single row of a single-precision sparse matrix.