13.2.1 Initialize_ELL_Matrix Procedure

The Initialize_ELL_Matrix procedure allocates and initializes an ELL_Matrix object.

Calling syntax:

call Initialize (ELLM, Max_Nonzeros, Row_Structure, Column_Structure, Name, status)

Input variables:

 ELLM  The ELL_Matrix object to be initialized.
 Max_Nonzeros  The maximum number of nonzero elements per row.
 Row_Structure  The Base_Structure giving the row distribution for the ELL_Matrix.
 Column_Structure  The Base_Structure giving the column distribution for the ELL_Matrix.
 Name  The name for this variable. [Optional]

Output variables:

 ELLM  The ELL_Matrix object has been allocated and initialized.
 status  If present, the status variable is set to either 'Memory Error' or 'Success' depending on program execution. If not present, the procedure aborts if unsuccessful when the DEBUG_LEVEL is set high enough.

Internal variables:

 allocate_status  Allocation Status.
 consolidated_status  Consolidated Status.

The Initialize_ELL_Matrix code listing contains additional documentation.

Michael L. Hall