NormUnbalance

This command is used to construct a convergence test which uses the norm of the right hand side of the matrix equation to determine if convergence has been reached. What the right-hand-side of the matrix equation is depends on integrator and constraint handler chosen. Usually, though not always, it is equal to the unbalanced forces in the system. The command to create a NormUnbalance test is the following:

test NormUnbalance $tol $iter < $pFlag > < $nType >

tol	the tolerance criteria used to check for convergence
iter	the max number of iterations to check before returning failure condition
pFlag	optional print flag, default is 0. valid options:
	0 print nothing
	1 print information on norms each time test() is invoked
	2 print information on norms and number of iterations at end of successful test
	4 at each step it will print the norms and also the \(\Delta U\) and \(R(U)\) vectors.
	5 if it fails to converge at end of $numIter it will print an error message BUT RETURN A SUCEESSFULL test
nType	optional type of norm, default is 2. (0 = max-norm, 1 = 1-norm, 2 = 2-norm, …)

---

NOTES:

• When using the Penalty method additional large forces to enforce the penalty functions exist on the right hand side, making

convergence using this test usually impossible (even though solution might have converged).

---

Theory

If the system of equations formed by the integrator is:

\[K \Delta U^i = R(U^i)\,\!\]

This integrator is testing:

\[\parallel R(U^i) \parallel < \text{tol} \!\]

---

Code Developed by: fmk