KOKO\Mimi
105 lines
4.2 KiB
Markdown
105 lines
4.2 KiB
Markdown
# Step 6: backend-neutral-tangent-solver
|
|
|
|
> 과거 개발 계획이다. 아래 작업·상태·예시는 현재 실행 지시가 아니다.
|
|
> 현재 구현과 검증 한계는 [기능 요약](../../docs/nonlinear-static-newton-raphson/README.md)을 따른다.
|
|
|
|
## 읽어야 할 파일
|
|
|
|
- `AGENTS.md`
|
|
- `../../docs/solver-core/README.md`
|
|
- `../../docs/solver-core/README.md`
|
|
- `../../docs/nonlinear-static-newton-raphson/formulation.md`
|
|
- `../../docs/nonlinear-static-newton-raphson/README.md`
|
|
- `include/fesa/solvers/linear/linear_solver.h`
|
|
- `include/fesa/solvers/linear/mkl_pardiso_solver.h`
|
|
- `src/fesa/solvers/linear/mkl_pardiso_solver.cpp`
|
|
- `tests/unit/solvers/linear/linear_solver_test.cpp`
|
|
- `tests/unit/solvers/linear/mkl_pardiso_solver_test.cpp`
|
|
- Step 4 files: `include/fesa/elements/nonlinear_mitc4_shell.h`
|
|
|
|
## 이전 Step 전제
|
|
|
|
Step 4 defines generally nonsymmetric nonlinear tangent matrices. Current SPD `MklPardisoSolver` must remain unchanged.
|
|
|
|
## 소유 파일
|
|
|
|
- Create: `include/fesa/solvers/linear/tangent_solver.h`
|
|
- Create: `include/fesa/solvers/linear/mkl_pardiso_tangent_solver.h`
|
|
- Create: `src/fesa/solvers/linear/mkl_pardiso_tangent_solver.cpp`
|
|
- Create: `tests/unit/solvers/linear/tangent_solver_test.cpp`
|
|
- Test: `tests/unit/solvers/linear/mkl_pardiso_solver_test.cpp`
|
|
- Modify: `src/fesa/CMakeLists.txt`
|
|
- Modify: `tests/CMakeLists.txt`
|
|
|
|
## 인터페이스
|
|
|
|
```cpp
|
|
namespace fesa {
|
|
|
|
class TangentSolver {
|
|
public:
|
|
virtual ~TangentSolver() = default;
|
|
virtual Status FactorizeFresh(const SparseMatrix& matrix) = 0;
|
|
virtual Status SolveCorrection(const Vector& rhs,
|
|
Vector& correction) const = 0;
|
|
};
|
|
|
|
class MklPardisoTangentSolver final : public TangentSolver {
|
|
public:
|
|
MklPardisoTangentSolver();
|
|
~MklPardisoTangentSolver() override;
|
|
Status FactorizeFresh(const SparseMatrix& matrix) override;
|
|
Status SolveCorrection(const Vector& rhs, Vector& correction) const override;
|
|
};
|
|
|
|
} // namespace fesa
|
|
```
|
|
|
|
The MKL tangent adapter uses unsymmetric PARDISO full CSR with `mtype=11`. Existing `MklPardisoSolver` keeps `mtype=2`, SPD symmetry validation, and upper-triangle copy unchanged.
|
|
|
|
## RED
|
|
|
|
Add tests first.
|
|
|
|
- `NSNR-SOLVER-001`: nonsymmetric 2x2 matrix factorizes and solves a known correction.
|
|
- `NSNR-SOLVER-002`: `0x0` matrix factorize/solve succeeds with zero-size vectors.
|
|
- `NSNR-SOLVER-003`: nonfinite matrix or RHS values fail without modifying output correction.
|
|
- `NSNR-SOLVER-004`: singular/factorization failure maps to deterministic solver diagnostic.
|
|
- `NSNR-SOLVER-005`: solve before successful factorization fails with solver diagnostic.
|
|
- `NSNR-SOLVER-006`: existing SPD `MklPardisoSolver` still rejects nonsymmetric public CSR and passes prior tests.
|
|
|
|
Run:
|
|
|
|
```powershell
|
|
cmake --build --preset windows-msvc-ninja-debug
|
|
ctest --preset windows-msvc-ninja-debug -R "TangentSolver|MklPardiso" --output-on-failure
|
|
```
|
|
|
|
Expected: new tests fail. Unexpected pass stops.
|
|
|
|
## GREEN
|
|
|
|
Implement backend-neutral tangent solver boundary and MKL full-CSR adapter. Factorization is fresh per call, releases previous backend state, validates dimensions and finite values, and translates PARDISO errors to FESA `Status`.
|
|
|
|
## VERIFY
|
|
|
|
```powershell
|
|
cmake --preset windows-msvc-ninja-debug
|
|
cmake --build --preset windows-msvc-ninja-debug
|
|
ctest --preset windows-msvc-ninja-debug -R "TangentSolver|MklPardiso" --output-on-failure
|
|
ctest --preset windows-msvc-ninja-debug --show-only=json-v1
|
|
ctest --preset windows-msvc-ninja-debug --output-on-failure
|
|
```
|
|
|
|
Use the ignored 과거 검증 자료(정리됨) preset contract. The Harness process must inherit VsDevCmd x64 and `FESA_GTEST_SOURCE_DIR`, `MKL_DIR`, `TBB_DIR`, and `HDF5_DIR` from its parent launch environment.
|
|
|
|
## 상태 기록
|
|
|
|
Update only Step 6 status and one-line payload. Executor owns timestamps, commits, retry, and advancement.
|
|
|
|
## 금지사항
|
|
|
|
- Do not modify SPD `MklPardisoSolver` behavior except tests proving it is unchanged. 이유: existing linear solver contract must remain stable.
|
|
- Do not symmetrize or regularize tangent matrices. 이유: approved tangent may be nonsymmetric and failures must surface.
|
|
- Do not expose MKL types in public headers. 이유: backend types remain behind solver boundaries.
|