Relative Norm Unbalance Convergence Test

The Relative Norm Unbalance test checks convergence based on the ratio of the norm of the unbalanced force vector to the norm of the applied force vector.

Description

This test is particularly suitable for:

Force-controlled problems with varying load magnitudes
Cases where relative force equilibrium is important
Nonlinear static analysis
Problems with significant material nonlinearity

The test calculates the ratio of the unbalanced force norm to the applied force norm and compares it to a specified tolerance.

Parameters

Parameter	Type	Description
`tol`	float	Tolerance for convergence (default: 1.0e-6)
`maxIter`	int	Maximum number of iterations (default: 10)
`printFlag`	int	Print flag for convergence information (default: 0)
`normType`	int	Norm type to use: 0 for max-norm, 1 for 1-norm, 2 for 2-norm (default: 2)

Usage Example

# Create a Femora instance


# Create a Relative Norm Unbalance convergence test
fm.analysis.test.create_test("RelativeNormUnbalance", tol=1.0e-6, maxIter=10, printFlag=0, normType=2)