Visible to Intel only — GUID: GUID-20CCD7E6-4A71-4DC0-B82C-A8792E216A8B
Visible to Intel only — GUID: GUID-20CCD7E6-4A71-4DC0-B82C-A8792E216A8B
?trnlspbc_check
Checks the correctness of handle and arrays containing Jacobian matrix, objective function, lower and upper bounds, and stopping criteria.
Syntax
res = strnlspbc_check(handle, n, m, fjac, fvec, LW, UP, eps, info)
res = dtrnlspbc_check(handle, n, m, fjac, fvec, LW, UP, eps, info)
Include Files
- Fortran: mkl_rci.fi, mkl_rci.f90
Description
The ?trnlspbc_check routine checks the arrays passed into the solver as input parameters. If an array contains any INF or NaN values, the routine sets the flag in output array info(see the description of the values returned in the Output Parameters section for the info array).
Input Parameters
- handle
-
Type INTEGER*8.
- n
-
INTEGER. Length of x.
- m
-
INTEGER. Length of F(x).
- fjac
-
REAL for strnlspbc_check
DOUBLE PRECISION for dtrnlspbc_check
Array of size m by n. Contains the Jacobian matrix of the function.
- fvec
-
REAL for strnlspbc_check
DOUBLE PRECISION for dtrnlspbc_check
Array of size m. Contains the function values at X, where fvec(i) = (yi – fi(x)).
- LW
-
REAL for strnlspbc_check
DOUBLE PRECISION for dtrnlspbc_check
Array of size n.
Contains low bounds for x (lwi < xi ).
- UP
-
REAL for strnlspbc_check
DOUBLE PRECISION for dtrnlspbc_check
Array of size n.
Contains upper bounds for x (upi > xi ).
- eps
-
REAL for strnlspbc_check
DOUBLE PRECISION for dtrnlspbc_check
Array of size 6; contains stopping criteria. See the values in the Description section of the ?trnlspbc_init.
Output Parameters
- info
-
INTEGER
Array of size 6.
Results of input parameter checking:
Parameter Used for Value
Description
info(1)
Flags for handle
0 The handle is valid.
1 The handle is not allocated.
info(2)
Flags for fjac
0 The fjac array is valid.
1 The fjac array is not allocated
2 The fjac array contains NaN.
3 The fjac array contains Inf.
info(3)
Flags for fvec
0 The fvec array is valid.
1 The fvec array is not allocated
2 The fvec array contains NaN.
3 The fvec array contains Inf.
info(4)
Flags for LW
0 The LW array is valid.
1 The LW array is not allocated
2 The LW array contains NaN.
3 The LW array contains Inf.
4 The lower bound is greater than the upper bound.
info(5)
Flags for up
0 The up array is valid.
1 The up array is not allocated
2 The up array contains NaN.
3 The up array contains Inf.
4 The upper bound is less than the lower bound.
info(6)
Flags for eps
0 The eps array is valid.
1 The eps array is not allocated
2 The eps array contains NaN.
3 The eps array contains Inf.
4 The eps array contains a value less than or equal to zero.
- res
-
INTEGER. Information about completion of the task.
res = TR_SUCCESS - the routine completed the task normally.
TR_SUCCESS is defined in the mkl_rci.fi include file.