Relative Total Norm Unbalance Convergence Test

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

Description

This test is particularly suitable for:

  • Force-controlled problems with cumulative loading

  • Cases where total force history is important

  • Nonlinear static analysis

  • Problems with significant material nonlinearity

The test calculates the ratio of the unbalanced force norm to the total 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 Total Norm Unbalance convergence test
fm.analysis.test.create_test("RelativeTotalNormUnbalance", tol=1.0e-6, maxIter=10, printFlag=0, normType=2)