7.5. KINSOL Constants
Below we list all input and output constants used by the main solver and linear solver modules, together with their numerical values and a short description of their meaning.
7.5.1. KINSOL input constants
Constant Name |
Value |
Description |
---|---|---|
|
1 |
Use Eisenstat and Walker Choice 1 for \(\eta\). |
|
2 |
Use Eisenstat and Walker Choice 2 for \(\eta\). |
|
3 |
Use constant value for \(\eta\). |
|
0 |
Use Newton iteration. |
|
1 |
Use Newton iteration with linesearch globalization. |
|
2 |
Use Picard iteration. |
Constant Name |
Value |
Description |
---|---|---|
|
0 |
No preconditioning |
|
2 |
Preconditioning on the right. |
|
1 |
Use modified Gram-Schmidt procedure. |
|
2 |
Use classical Gram-Schmidt procedure. |
Constant Name |
Value |
Description |
---|---|---|
|
0 |
Use Modified Gram-Schmidt for Anderson acceleration. |
|
1 |
Use Inverse Compact WY Modified Gram-Schmidt for Anderson acceleration. |
|
2 |
Use Classical Gram-Schmidt with Reorthogonalization (CGS-2) for Anderson Acceleration. |
|
3 |
Use CGS-2 with Delayed Reorthogonalization for Anderson acceleration. |
7.5.2. KINSOL output constants
Constant Name |
Value |
Description |
---|---|---|
|
0 |
Successful function return. |
|
1 |
The initial user-supplied guess already satisfies the stopping criterion. |
|
2 |
The stopping tolerance on scaled step length was satisfied. |
|
99 |
A non-fatal warning. The solver will continue. |
|
-1 |
The |
|
-2 |
One of the function inputs is illegal. |
|
-3 |
The KINSOL memory was not allocated
by a call to |
|
-4 |
A memory allocation failed. |
|
-5 |
The linesearch algorithm was unable to find an iterate sufficiently distinct from the current iterate. |
|
-6 |
The maximum number of nonlinear iterations has been reached. |
|
-7 |
Five consecutive steps have been taken that satisfy a scaled step length test. |
|
-8 |
The linesearch algorithm was unable
to satisfy the
\(\beta\)-condition for
|
|
-9 |
The user-supplied routine preconditioner slve function failed recoverably, but the preconditioner is already current. |
|
-10 |
The linear solver’s initialization function failed. |
|
-11 |
The linear solver’s setup function failed in an unrecoverable manner. |
|
-12 |
The linear solver’s solve function failed in an unrecoverable manner. |
|
-13 |
The system function failed in an unrecoverable manner. |
|
-14 |
The system function failed with a recoverable error at the first call. |
|
-15 |
The system function had repeated recoverable errors. |
Constant Name |
Value |
Description |
---|---|---|
|
0 |
Successful function return. |
|
-1 |
The |
|
-2 |
The KINLS linear solver has not been initialized. |
|
-3 |
The KINLS solver is not compatible with
the current |
|
-4 |
A memory allocation request failed. |
|
-5 |
The preconditioner module has not been initialized. |
|
-6 |
The Jacobian function failed |
|
-7 |
An error occurred with the current
|
|
-8 |
An error occurred with the current
|