97 lines
4.5 KiB
Markdown
97 lines
4.5 KiB
Markdown
# FemLite 0.6.0 Acceptance Report
|
|
|
|
Date: 2026-07-01
|
|
|
|
Status: release close-out candidate.
|
|
|
|
## Scope
|
|
|
|
FemLite 0.6.0 closes the first algorithm-foundation loop after the 0.5.x V5
|
|
diagnostic hardening line. The release adds a shared nonlinear lifecycle
|
|
module, lifecycle hooks for the covered static/Newmark/Riks paths, rollback
|
|
audit adapters, lifecycle CSV output fields and restart version 5 lifecycle
|
|
diagnostics.
|
|
|
|
0.6.0 does not claim delivery of complete industrial AL/mortar consistent
|
|
tangents, generalized mixed-control continuation, cohesive contact mainline,
|
|
DEM/FEM subcycling, nonzero harmonic cyclic solving or production roll-forming
|
|
workflow support.
|
|
|
|
## Delivered Evidence
|
|
|
|
| Item | Evidence |
|
|
|---|---|
|
|
| Lifecycle ids and snapshot | `nonlinear_lifecycle` covers event names, empty snapshot, history and audit names. |
|
|
| Static nonlinear hook | `solver_implicit` covers accepted and rejected/cutback lifecycle paths. |
|
|
| Nonlinear Newmark hook | `solver_implicit` covers nonlinear Newmark success and rejection. |
|
|
| Riks/arc hook | `solver_implicit` covers lifecycle accept, load factor, arc residual and path append. |
|
|
| Rollback audit | Material, contact, cohesive and particle audit adapters feed the shared lifecycle status. |
|
|
| Output schema | `continuation_path.csv` appends lifecycle fields without reordering older columns. |
|
|
| Restart schema | Restart version 5 writes optional `LIFECYCLE_DIAGNOSTICS`; reader accepts files without the block. |
|
|
| Documentation | Design, algorithm, interface, test, user and developer docs state lifecycle boundaries and deferred solver rewrites. |
|
|
|
|
## Planned Close-Out Commands
|
|
|
|
```powershell
|
|
cmake --build build-codex-gcc --parallel
|
|
ctest --test-dir build-codex-gcc -R "^(solver_implicit|implicit_inp|restart|contact_mortar_report|contact_multiplier_report|cohesive_contact|particle_acceptance)$" --output-on-failure
|
|
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure
|
|
git diff --check
|
|
```
|
|
|
|
## Results
|
|
|
|
| Command | Result |
|
|
|---|---|
|
|
| `cmake --build build-codex-gcc --parallel` | passed; CMake regenerated and full build completed. |
|
|
| 0.6.0 targeted regression command | 7/7 passed. |
|
|
| `ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure` | 39/39 passed after updating version assertions to 0.6.0. |
|
|
| `git diff --check` | passed; Git reported line-ending normalization warnings only. |
|
|
|
|
## Close-Out Conclusion
|
|
|
|
FemLite 0.6.0 meets the planned lifecycle foundation acceptance criteria on
|
|
the local `build-codex-gcc` configuration. The release remains bounded to
|
|
diagnostic lifecycle infrastructure and rollback audit coverage for the
|
|
documented subset.
|
|
|
|
## Deferred Work
|
|
|
|
- Complete industrial AL/mortar consistent tangent and full contact
|
|
state-machine rewrite.
|
|
- Generalized mixed-control continuation and branch switching.
|
|
- Complete shell preload `K_G` and high-order solid geometric stiffness.
|
|
- Cohesive contact mainline integration.
|
|
- Nonzero harmonic cyclic symmetry.
|
|
- DEM/FEM subcycling and large-particle long runs.
|
|
- Production roll-forming process chain.
|
|
- Additional solver scaling and block preconditioning work.
|
|
|
|
## 0.6.1 Diagnostic Hardening Addendum
|
|
|
|
0.6.1 keeps the 0.6.0 release boundary and hardens diagnostics around the
|
|
covered nonlinear/contact paths. It adds lifecycle summary queries,
|
|
cutback-reason taxonomy, `nonlinear_lifecycle.csv`, stable contact state
|
|
counters, compact contact long-path checker coverage, AL/friction summary
|
|
fields, a shared tangent-audit report shell, Riks/arc path indicators,
|
|
restart-after-each-accepted audit coverage and fuller linear-solver fields in
|
|
nonlinear rows.
|
|
|
|
Final 0.6.1 evidence on `build-codex-gcc`:
|
|
|
|
```powershell
|
|
cmake --build build-codex-gcc --parallel
|
|
ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|solver_implicit|implicit_inp|restart|contact|contact_mortar_report|contact_multiplier_report|cohesive_contact|particle_acceptance|linear_solver_cg)$" --output-on-failure
|
|
ctest --test-dir build-codex-gcc -R "^example_(contact_two_blocks_compression|contact_block_sliding|shell_shell_contact|shell_solid_contact)_benchmark$" --output-on-failure
|
|
ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure
|
|
git diff --check
|
|
```
|
|
|
|
0.6.1 targeted regression passed 10/10, the compact contact benchmark smoke
|
|
passed 4/4, the V5 acceptance subset passed 39/39 and the version-specific
|
|
smoke checks passed 2/2 after the public version was raised to 0.6.1.
|
|
|
|
0.6.1 still does not claim complete industrial AL/mortar consistent tangent
|
|
delivery, generalized mixed-control continuation, cohesive contact mainline,
|
|
DEM/FEM subcycling or production roll-forming workflow support.
|