Files
FemLite/docs/v6_benchmark_matrix.md
T
shenw 175531e24d
FemLite CI / build-test (push) Has been cancelled
Release 0.6.0
2026-07-01 20:44:15 +08:00

52 lines
3.4 KiB
Markdown

# FemLite 0.6.0 Benchmark And Acceptance Matrix
Date: 2026-07-01
Scope: executable evidence for the 0.6.0 nonlinear lifecycle foundation and
rollback audit release.
Current local 0.6.0 evidence on `build-codex-gcc`:
- `cmake --build build-codex-gcc --parallel` passed.
- `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` passed 7/7.
- `ctest --test-dir build-codex-gcc -L v5_acceptance --output-on-failure` passed 39/39.
- `git diff --check` passed with line-ending normalization warnings only.
## Release Boundary
0.6.0 delivers lifecycle diagnostics and rollback audit infrastructure for the
covered nonlinear subset. It does not deliver a complete industrial AL/mortar
consistent tangent rewrite, generalized mixed-control continuation, cohesive
contact mainline integration, DEM/FEM subcycling or a production roll-forming
workflow.
## 0.6.0 Matrix
| Area | Code or output target | Test/checker | Acceptance evidence |
|---|---|---|---|
| Lifecycle core | `src/solver/fem_nonlinear_lifecycle.f90` | `nonlinear_lifecycle` | Stable event names, empty snapshot, event history, arc defaults and audit status transitions. |
| Static nonlinear lifecycle | `src/solver/fem_solver_static_nonlinear.f90` | `solver_implicit` | Increment/trial/iteration/result/commit/accept/reject/cutback events are observable without changing convergence rules. |
| Nonlinear Newmark lifecycle | `src/solver/fem_solver_newmark.f90` | `solver_implicit` | Dynamic nonlinear success and rejection paths expose lifecycle state. |
| Riks/arc lifecycle | static nonlinear Riks path | `solver_implicit` | Accepted path records lifecycle accept, load factor, arc residual and path append state. |
| Material rollback audit | `src/element/fem_element_state.f90` | `solver_implicit`, `nonlinear_lifecycle` | Covered material state rollback is audited by checksum and status counters. |
| Contact rollback audit | `src/boundary/fem_contact_multiplier.f90` | `contact`, `restart` | Contact multiplier trial/commit/rollback contributes audit status without changing contact physics. |
| Cohesive audit | `src/boundary/fem_cohesive_state.f90` | `cohesive_contact` | Compact cohesive state rollback/commit emits lifecycle audit status. |
| Particle audit | `src/particle/fem_particle_audit.f90` | `particle_step` | Particle audit pass/fail maps into lifecycle commit/rollback-failed status. |
| Lifecycle CSV output | `continuation_path.csv` | `solver_implicit` | Old path columns remain stable; lifecycle event/status, increment/iteration and accept/reject counters are appended. |
| Lifecycle restart | restart version 5 optional block | `restart` | Accepted-increment lifecycle diagnostics round-trip; files without the optional block still read. |
## Regression 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
```
Additional focused lifecycle evidence used during development:
```powershell
ctest --test-dir build-codex-gcc -R "^(nonlinear_lifecycle|solver_implicit|restart|contact|cohesive_contact|particle_step)$" --output-on-failure
```