Part VI
Verification
E. Algorithm and software checks · All four support types at one tip
A frame member is fixed at its root. Tip forces are 10.0 N along x, 1.0 N along y and 3.0 N along z. Tip moment is 1.8 N·mm about z. The supports are friction in x, a 0.0002 mm gap in y, one-way in z and lift-off on rotation. Can all four change state in one iteration and settle?
This page preserves a recorded benchmark and its expected values. The dated run below is not a new run of the current product.
The current product limits active-set solves to four iterations. Current mechanics combinations with nonlinear supports are withheld. These recorded transitions and free-degree residuals do not establish general equilibrium or convergence for other models.
1.Inputs.
Illustrative values, taken from no standard and chosen so the arithmetic can be followed by hand. Most do not describe a real pipe; read them in any consistent set of units.
| Quantity | Symbol | Value |
|---|---|---|
| Tip axial force | Fx | 10.0 N |
| Tip transverse force | Fy | 1.0 N |
| Tip vertical force | Fz | 3.0 N |
| Tip moment about z | Mz | 1.8 N·mm |
| Friction support | — | Ux |
| Gap support | — | Uy |
| One-way support | — | Uz |
| Lift-off support | — | Rz |
| Friction coefficient | μ | 0.30 |
| Normal reaction (given) | N | 20.0 N |
| Friction limit | μN | 6.0 N |
| Gap clearance | c | 0.0002 mm |
| Initial states | — | one-way active, gap open, friction sticking, lift-off in contact |
2.Method.
With a given normal reaction of 20.0 N and μ = 0.30, the friction limit is 6.0 N, and the friction support slides. In the same first iteration the one-way support releases, the gap closes and the rotational lift-off support releases: four changes in all. On the second iteration nothing changes, so the loop has converged.
The reference for this group records the expected support states, changed-support counts and final residuals. It does not work out displacements or reactions, so none are tabulated here.
3.Results.
| Quantity | Expected |
|---|---|
| Changed supports, iteration 1 | 4 |
| Final changed-support count | 0 |
| Iteration count | 2 |
| Free-DOF force residual | 0.0 N |
| Free-DOF moment residual | 0.0 N·mm |
| Final free-DOF work residual | 0.0 N·mm |
| Final one-way state | inactive (released) |
| Final gap state | active (closed) |
| Final friction state | sliding |
| Final lift-off state | inactive (released) |
| Converged | true |
| Diagnostic | none |
The case record describes these checks:
- The solve converges in exactly 2 iterations: 4 supports change state on the first iteration and none on the last.
- Final states match the reference: one-way released, gap closed, friction sliding, lift-off released. No diagnostics are raised.
- At the final iteration the out-of-balance force, moment and work at the free degrees of freedom are all exactly 0.0.
- The changes in displacement, rotation and reaction over the last iteration stay inside the recorded envelope for this group.
What it shows. Compares final support states, the iteration count, and force balance. It does not compare movements or reactions with a hand calculation.
Path exercised. The benchmark calls the solver’s components directly: elements, loads, frame solver and stress recovery. It does not go through the program’s own model-to-solve path.
Agreement. The loop counts as converged only when no support changes state between iterations. The changed-support count must reach exactly 0 within at most 4 iterations, with no relative or absolute allowance. At the final iteration, out-of-balance force, moment and work at free degrees of freedom must be 0.0. Changes in displacement, rotation and reaction over the last iteration must stay inside the recorded envelope. Long values are shown here to seven significant figures; the tests compare the full values in the record.
4.Recorded command.
This command belongs to the linked case record and its recorded execution path. This website update did not rerun it. A historical command or result does not establish current product support.
cd projects/chirality-piping cargo test --manifest-path validation/benchmarks/nonlinear/Cargo.toml multisupport_acceptance_inventory_uses_narrow_dec_046_policy
Hand calculation:
validation/hand_calcs/nonlinear/assembled_multi_support_four_class_acceptance.md.
Test record, with the recorded run of 2026-07-10:
nl-assembled-multi-dof-four-class-accepted-original.md.