Next: 13.3 Solver Class Up: 13.2 ELL_Matrix Class Previous: 13.2.13 Set_Not_Up_to_Date_ELL_Matrix Procedure
The Set_Values_ELL_Matrix procedure sets the values for the ELL Matrix. It may be called three different ways.
The single value form replaces a single matrix entry. If this form is used, then the same number of procedure calls must take place on every processor - this is required by internal verification calls that use global communication. If a different number of values are to be set on each processor, then one of the other calling forms should be used.
The array form, without the Rows variable, can be used to replace the entire contents of the ELL Matrix. The Values and Columns variables must be exactly the same size as the ELL Matrix variables with the same name.
The array form, with the Rows variable, can be used to replace selected values in the ELL Matrix. Only the rows listed in the Rows vector are modified.
Calling syntax:
| call Set_Values (ELLM, Values, Columns) | , |
| call Set_Values (ELLM, Values, Rows, Columns, Global) | or |
| call Set_Values (ELLM, Value, Row, Column, Global) |
Input variable:
| Values | An array of values for the ELL_Matrix object. If the Rows variable is not present, Values must be the same size as the ELL_Matrix. Otherwise, Values must have a size smaller than or equal to the size of the ELL_Matrix. | ||
| Rows | An integer vector of rows to be replaced. This vector may be sized smaller than the row size of the ELL_Matrix object. [optional] | ||
| Columns | An array of columns for the ELL_Matrix object. If the Rows variable is not present, Columns must be the same size as the ELL_Matrix. Otherwise, Columns must have a size smaller than or equal to the size of the ELL_Matrix. | ||
| Global | A toggle between using global or local (on this PE) indices for the Rows variables. Default is true (use global). Note that the Columns variables are always global. | ||
| Value | A single value for the ELL_Matrix object. The Row and Column variables must be present for this form of the procedure. | ||
| Row | The row index for the Value variable. | ||
| Column | The column index for the Value variable. |
Input/Output variable:
| ELLM | The ELL_Matrix object to be set. |
The Set_Values_ELL_Matrix code listing contains additional documentation.