Relative Energy Increment Test: Difference between revisions

From OpenSeesWiki
Jump to navigation Jump to search
No edit summary
No edit summary
Line 4: Line 4:


{|  
{|  
| style="background:yellow; color:black; width:800px" | '''test RelativeEnergyIncr $tol $iter <$pFlag>'''
| style="background:yellow; color:black; width:800px" | '''test RelativeEnergyIncr $tol $iter <$pFlag> <$nType>'''
|}
|}


Line 25: Line 25:
|-
|-
| || 5 if it fails to converge at end of $numIter it will print an error message BUT RETURN A SUCEESSFULL test
| || 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, ...)
|}
|}



Revision as of 02:09, 1 September 2012




This command is used to construct a convergence test which uses the dot product of the solution vector and norm of the right hand side of the matrix equation to determine if convergence has been reached. The physical meaning of this quantitity depends on the integraor and constraint handler chosen. Usually, though not always, it is equal to the energy unbalance in the system. The test is relatiive to the first dor product computed for each step. The command to create a EnergyIncr test is the following:

test RelativeEnergyIncr $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 successfull test
4 at each step it will print the norms and also the <math>\Delta U</math> and <math>R(U)</math> 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 had side, making

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

  • When Lagrange multipliesr are use, the soln vector contains the lagrange multiplies.

THEORY:

If the system of equations formed by the integrator is:

<math>K \Delta U^i = R(U^i)\,\!</math>

This integrator is testing:

<math> \frac{\Delta U^i R(U^i)}{\Delta U^0 R(U^0)} < \text{tol} \!</math>



Code Developed by: fmk