8.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.
8.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 GramSchmidt procedure. 

2 
Use classical GramSchmidt procedure. 
Constant Name 
Value 
Description 


0 
Use Modified GramSchmidt for Anderson acceleration. 

1 
Use Inverse Compact WY Modified GramSchmidt for Anderson acceleration. 

2 
Use Classical GramSchmidt with Reorthogonalization (CGS2) for Anderson Acceleration. 

3 
Use CGS2 with Delayed Reorthogonalization for Anderson acceleration. 
8.5.2. KINSOL output constants
Constant Name 
Value 
Description 


0 
Successful function return. 

1 
The initial usersupplied guess already satisfies the stopping criterion. 

2 
The stopping tolerance on scaled step length was satisfied. 

99 
A nonfatal 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 usersupplied 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
