Developer Reference

Contents

dcgmrhs_check

Checks consistency and correctness of the user defined data.

Syntax

void
dcgmrhs_check
(
const
MKL_INT
*n
,
const
double
*x
,
const
MKL_INT
*nrhs
,
const
double
*b
,
MKL_INT
*RCI_request
,
MKL_INT
*ipar
,
double
*dpar
,
double
*tmp
);
Include Files
  • mkl.h
Description
The routine
dcgmrhs_check
checks the consistency and correctness of the parameters to be passed to the solver routine
dcgmrhs
. While this operation reduces the chance of making a mistake in the parameters, it does not guarantee that the solver returns the correct result.
If you are sure that the correct data is
specified
in the solver parameters, you can skip this operation.
The lengths of all vectors must be defined in a previous call to the
dcgmrhs_init
routine.
If none of the stopping criteria (
ipar
[7]-
ipar
[9]
) has been enabled, both
ipar
[7] and
ipar
[8]
will be set to 1.
Input Parameters
n
Sets the size of the problem.
x
Array of size
n
*
nrhs
. Contains the initial approximation to the solution vectors. Normally it is equal to 0 or to
b
.
nrhs
This parameter sets the number of right-hand sides.
b
Array of size
n
*
nrhs
. Contains the right-hand side vectors.
Output Parameters
RCI_request
Returns information about the results of the routine.
ipar
Array of size
(128+2*
nrhs
)
. Refer to the CG Common Parameters. Only
ipar
[7]-
ipar
[8]
might be changed.
dpar
Array of size
(128+2*
nrhs
)
. Refer to the CG Common Parameters.
tmp
Array of size
(
n
*
(3+
nrhs
))
. Refer to the CG Common Parameters.
Return Values
RCI_request
= 0
Indicates that the task completed normally.
RCI_request
= -1100
Indicates that the task is interrupted and the errors occur.
RCI_request
= -1001
Indicates that there are some warning messages.
RCI_request
= -1010
Indicates that the routine changed some parameters to make them consistent or correct.
RCI_request
= -1011
Indicates that there are some warning messages and that the routine changed some parameters.

Product and Performance Information

1

Performance varies by use, configuration and other factors. Learn more at www.Intel.com/PerformanceIndex.