refactor: extract mitc4 geometry strain helpers

This commit is contained in:
NINI
2026-05-05 23:11:23 +09:00
parent 421ad5a707
commit 150653c3c7
9 changed files with 691 additions and 434 deletions
+35 -1
View File
@@ -13,10 +13,44 @@ Every new agent session must read this file together with `PLAN.md` before plann
- Do not remove history unless the user explicitly asks for archival cleanup.
## Current Status
Phase 1 has a completed rebaseline execution path in `phases/1-linear-static-mitc4-rebaseline`. Steps 0 through 15 are complete, and P1R-15 recorded a pass-with-documented-gaps evaluator closeout. The follow-up architecture refactor phase in `phases/1-structure-alignment-refactor` is underway because the current production implementation is concentrated in `include/fesa/fesa.hpp` instead of the module directories documented in `docs/ARCHITECTURE.md`; P1A-00 through P1A-05 are complete, so the next step is P1A-06 MITC4 geometry/strain extraction. `quad_02_phase1.inp` is the normalized Phase 1-compatible input path for the stored `quad_02` S4 reference pair, while the original `quad_02.inp` remains preserved unsupported provenance. Core numeric aliases, DOF mapping, validation harness, model diagnostic context, the Phase 1 parser/domain subset, validation/singular diagnostics, DofManager/reaction foundation, minimum result model metadata, displacement CSV comparator foundation, MITC4 geometry/director scaffolding, MITC4 displacement/strain/tying row scaffolding, MITC4 material/transform/integration scaffolding, MITC4 stiffness/drilling/internal-force scaffolding, MITC4 patch/locking-sensitivity tests, full-space assembly, reduced projection, sparse-pattern scaffold, solver adapter injection, full-vector internal/reaction force state, active AnalysisModel construction, input-to-AnalysisState-to-U/RF result workflow, and the first stored Abaqus displacement regression have been revalidated. Full PRD Phase 1 completion still depends on the open architecture/reference gaps R-014, R-010, and R-013. The old `phases/1-linear-static-mitc4` path is historical and superseded after the MITC4 formulation reset.
Phase 1 has a completed rebaseline execution path in `phases/1-linear-static-mitc4-rebaseline`. Steps 0 through 15 are complete, and P1R-15 recorded a pass-with-documented-gaps evaluator closeout. The follow-up architecture refactor phase in `phases/1-structure-alignment-refactor` is underway because the current production implementation is concentrated in `include/fesa/fesa.hpp` instead of the module directories documented in `docs/ARCHITECTURE.md`; P1A-00 through P1A-06 are complete, so the next step is P1A-07 MITC4 material/stiffness extraction. `quad_02_phase1.inp` is the normalized Phase 1-compatible input path for the stored `quad_02` S4 reference pair, while the original `quad_02.inp` remains preserved unsupported provenance. Core numeric aliases, DOF mapping, validation harness, model diagnostic context, the Phase 1 parser/domain subset, validation/singular diagnostics, DofManager/reaction foundation, minimum result model metadata, displacement CSV comparator foundation, MITC4 geometry/director scaffolding, MITC4 displacement/strain/tying row scaffolding, MITC4 material/transform/integration scaffolding, MITC4 stiffness/drilling/internal-force scaffolding, MITC4 patch/locking-sensitivity tests, full-space assembly, reduced projection, sparse-pattern scaffold, solver adapter injection, full-vector internal/reaction force state, active AnalysisModel construction, input-to-AnalysisState-to-U/RF result workflow, and the first stored Abaqus displacement regression have been revalidated. Full PRD Phase 1 completion still depends on the open architecture/reference gaps R-014, R-010, and R-013. The old `phases/1-linear-static-mitc4` path is historical and superseded after the MITC4 formulation reset.
## Completed Work
### 2026-05-05 - P1A-06 MITC4 geometry strain extraction completed
Author: Codex
Changed files:
- `CMakeLists.txt`
- `include/fesa/Element/Element.hpp`
- `include/fesa/Element/MITC4Geometry.hpp`
- `include/fesa/Element/MITC4Kinematics.hpp`
- `include/fesa/fesa.hpp`
- `tests/test_element_module_includes.cpp`
- `phases/1-structure-alignment-refactor/index.json`
- `PLAN.md`
- `PROGRESS.md`
Summary:
- Extracted `ShapeData`, `shapeFunctions`, `LocalBasis`, MITC4 natural-coordinate and tying-point helpers, director frames, geometry construction, integration basis construction, MITC4 diagnostics, and `computeLocalBasis` into `include/fesa/Element/MITC4Geometry.hpp`.
- Extracted MITC4 element DOF/strain vector aliases, strain component ordering helpers, local rotation mapping, director increment, displacement derivatives, direct covariant strain evaluation/rows, row evaluation, and MITC transverse shear tying rows into `include/fesa/Element/MITC4Kinematics.hpp`.
- Updated `include/fesa/Element/Element.hpp` to expose the MITC4 geometry/kinematics layer through the Element module.
- Updated `include/fesa/fesa.hpp` to include the Element facade and removed the relocated MITC4 geometry/strain definitions from the umbrella body.
- Added `fesa_element_module_tests`, a direct Element include smoke/regression test that does not include `fesa/fesa.hpp`.
- Preserved FESA/Abaqus S4 node order, A/B/C/D tying labels and signs, director fallback policy, invalid thickness/singular geometry diagnostics, direct covariant strain rows, and MITC shear interpolation behavior.
- No material law, stiffness integration, drilling stabilization, assembly, parser, results, or analysis behavior was changed.
- Remaining large groups in `fesa.hpp` are MITC4 material transform/integration/stiffness/internal-force helpers, Assembly helpers (`buildReducedSparsePattern`, `recoverFullReaction`, assembly/project functions), and Analysis workflow.
Verification:
- First ran `python scripts\validate_workspace.py` after adding the direct Element include test; it failed as expected because `fesa/Element/Element.hpp` did not yet expose MITC4 geometry/strain symbols.
- After extraction, `python scripts\validate_workspace.py` configured CMake, built `fesa_core`, `fesa_tests`, `fesa_core_module_tests`, `fesa_math_module_tests`, `fesa_io_module_tests`, `fesa_results_module_tests`, and `fesa_element_module_tests`, and ran CTest successfully.
- CTest result: 6 test executables passed.
Follow-up:
- Continue with P1A-07 MITC4 material/stiffness extraction.
- Keep R-014 open until P1A-09 independently accepts the final architecture alignment.
- Keep R-010 and R-013 open; this refactor does not add Abaqus RF artifacts or additional stored reference cases.
### 2026-05-05 - P1A-05 Results reference extraction completed
Author: Codex