Function

sparse_insert_entries_double

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

Declaration

sparse_status sparse_insert_entries_double(sparse_matrix_double A, sparse_dimension N, const double *restrict val, const sparse_index *restrict indx, const sparse_index *restrict jndx);

Parameters

A

The sparse matrix, A, which must have been created with sparse_matrix_create_double. SPARSE_ILLEGAL_PARAMETER is returned if not met.

N

The number of values to insert into A. Each of indx, jndx and val are of size N.

val

Pointer to list of scalar values to insert into A. The value is inserted into the location specified by the corresponding indices in indx and jndx. Must hold N values.

indx

An array of row indices that correspond to the values in val. Must hold N values.

jndx

An array of column indices that correspond to the values in val. Must hold N values.

Discussion

Use to build a sparse matrix by providing a list of point entries. For each entry provided, update A[indx[i],jndx[i]] = val[i].

Note that matrix properties cannot be modified after value insertion begins. This includes properties such as specifying a triangular matrix.

Insertion can be expensive, generally speaking it is best to do a batch update. Inserted values may be temporarily held internally within the object and only inserted into the sparse format when a later computation triggers a need to insert.

Indices in indx and jndx an are assumed to be unique. Additionally, indices are assumed to be in the bounds of the matrix. Undefined behavior if any of these assumptions are not met.All indices are 0 based (the first element of a pointer is ptr[0]).

See Also

Matrix Creation and Population

sparse_matrix_create_double

Returns a double-precision sparse matrix object.

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_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.