Developer Reference for Intel® oneAPI Math Kernel Library for C
dcg_init
Initializes the solver.
Syntax
void dcg_init ( const MKL_INT *n,
const double *x,
const double *b,
MKL_INT *RCI_request,
MKL_INT *ipar,
double *dpar,
double *tmp);
Include Files
mkl.h
Description
The routine dcg_init initializes the solver. After initialization, all subsequent invocations of the Intel® oneAPI Math Kernel Library (oneMKL) RCI CG routines use the values of all parameters returned by the routine dcg_init . Advanced users can skip this step and set the values in the ipar and dpar arrays directly.
Input Parameters
n
Sets the size of the problem.
x
Array of size n . Contains the initial approximation to the solution vector. Normally it is equal to 0 or to b .
b
Array of size n . Contains the right-hand side vector.
Output Parameters
RCI_request
Gives information about the result of the routine.
ipar
Array of size 128 . Refer to the CG Common Parameters .
dpar
Array of size 128 . Refer to the CG Common Parameters .
tmp
Array of size (n*4) . Refer to the CG Common Parameters .
Return Values
- RCI_request = 0
-
Indicates that the task completed normally.
- RCI_request = -10000
-
Indicates failure to complete the task.