Developer Reference for Intel® oneAPI Math Kernel Library for C
?trnlsp_get
Retrieves the number of iterations, stop criterion, initial residual, and final residual.
Syntax
MKL_INTstrnlsp_get ( _TRNSP_HANDLE_t*handle , MKL_INT*iter , MKL_INT*st_cr , float*r1 , float*r2 );
MKL_INTdtrnlsp_get ( _TRNSP_HANDLE_t*handle , MKL_INT*iter , MKL_INT*st_cr , double*r1 , double*r2 );
Include Files
mkl.h
Description
The routine retrieves the current number of iterations, the stop criterion, the initial residual, and final residual.
The initial residual is the value of the functional (||y - f(x)||) of the initial x values provided by the user.
The final residual is the value of the functional (||y - f(x)||) of the final x resulting from the algorithm operation.
The st_cr parameter contains a number indicating the stop criterion:
st_cr Value |
Description |
|---|---|
1 |
The algorithm has exceeded the maximum number of iterations |
2 |
Δ < eps(1)[0] |
3 |
||F(x)||_{2} < eps(2)[1] |
4 |
The Jacobian matrix is singular. ||J(x)(1:m,j)[m*(j-1)…m*j-1]||2 :code:` < ` eps(3)[2], j = 1, ..., n |
5 |
||s||_{2} < eps(4)[3] |
6 |
||F(x)||_{2} - ||F(x) - J(x)s||_{2} < eps(5)[4] |
Note:
J(x) is the Jacobian matrix.
Δ is the trust-region area.
F(x) is the value of the functional.
s is the trial step.
Input Parameters
handle
Type _TRNSP_HANDLE_t .
Output Parameters
iter
Contains the current number of iterations.
st_cr
Contains the stop criterion.
See the Description section for the parameter values and their meanings.
r1
Contains the residual, (||y - f(x)||) given the initial x .
r2
Contains the final residual, that is, the value of the functional (||y - f(x)||) of the final x resulting from the algorithm operation.
res
Indicates the task completion.
res = TR_SUCCESS - the routine completed the task normally.
TR_SUCCESS is defined in the mkl_rci.hmkl_rci.fi include file.