This command is used to construct a CTestEnergyIncr object which tests positive force convergence if one half of the inner-product of the x and b vectors (displacement increment and unbalance) in the LinearSOE object is less than the specified tolerance.
test EnergyIncr $tol $maxNumIter <$printFlag>
| $tol | convergence tolerance | ||
| $maxNumIter | maximum number of iterations that will be performed before "failure to converge" is returned | ||
| $printFlag | flag used to print information on convergence (optional) | ||
| 
 | 
 | 0 | no print output (default) | 
| 
 | 
 | 1 | print information on each step | 
| 
 | 
 | 2 | print information when convergence has been achieved | 
| 
 | 
 | 4 | print norm, dU and dR vectors | 
| 
 | 
 | 5 | at convergence failure, carry on, print error message, but do not stop analysis | 
The test performs the following check:
