The user can apply the RS preconditioners. With these
preconditioners, the reduced system is not explicitly
computed, and the matrix-vector products using the reduced
system matrix are implicitly calculated using the COEF
matrix. The user must first fill the integer vector P
with a coloring vector for either point or line
red-black ordering. For point red-black ordering, the
REDBLK subroutine can be used to generate the coloring
vector:
CALL REDBLK (NDIM,N,MAXNZ,COEF,JCOEF,P,IP,NSTORE,IWKSP,IER)
The variable NSTORE takes on the same values as the IPARM
parameter, namely
NSTORE = 1 |
for primary format |
= 2 |
for symmetric diagonal format |
= 3 |
for nonsymmetric diagonal format |
= 4 |
for symmetric coordinate format |
= 5 |
for nonsymmetric coordinate format |
P, IP, and IWKSP are integer workspace vectors of length
N upon input. Upon output, P contains the coloring
vector for red-black ordering if such an ordering exists.
IER on output will be either 0, in which case a red-
black coloring vector was successfully found, or -8,
in which case matrix A does not have point Property A.
For line red-black ordering, the user can use the COLOR
subroutine described in Section 12 for generating the
coloring vector P. COLOR can also be used to generate
the coloring vector for point red-black ordering.