Developer Reference for Intel® oneAPI Math Kernel Library for C
?jacobi_init
Initializes the solver for Jacobian calculations.
Syntax
MKL_INTsjacobi_init ( _JACOBIMATRIX_HANDLE_t*handle , constMKL_INT*n , constMKL_INT*m , constfloat*x , constfloat*fjac , constfloat*eps );
MKL_INTdjacobi_init ( _JACOBIMATRIX_HANDLE_t*handle , constMKL_INT*n , constMKL_INT*m , constdouble*x , constdouble*fjac , constdouble*eps );
Include Files
mkl.h
Description
The routine initializes the solver.
Input Parameters
n
m
Length of F .
x
Array of size n . Vector, at which the function is evaluated.
A reference to this array is stored in handle for later use and modification by ?jacobi_solve .
eps
Precision of the Jacobian matrix calculation.
fjac
Array of size m by n . Contains the Jacobian matrix of the function.
A reference to this array is stored in handle for later use and modification by ?jacobi_solve .
Output Parameters
handle
Data object of the _JACOBIMATRIX_HANDLE_t type INTEGER*8 . Stores internal data, including pointers to the user-provided arrays x and fjac . It is important that the user does not move or deallocate these arrays until after calling the ?jacobi_delete routine.
res
Indicates task completion status.
res = TR_SUCCESS - the routine completed the task normally.
res = TR_INVALID_OPTION - there was an error in the input parameters.
res = TR_OUT_OF_MEMORY - there was a memory error.
TR_SUCCESS , TR_INVALID_OPTION , and TR_OUT_OF_MEMORY are defined in the mkl_rci.fimkl_rci.h include file.