Files
FESADev/docs/mitc4-shell-feast-eigen/ADR.md
T

5.1 KiB

MITC4 Shell Mass Matrix와 FEAST 고유치해석 결정 기록

  • Feature ID: mitc4-shell-feast-eigen
  • Owner: coordinator-agent
  • Input contract revision: r1

기준: 프로젝트 지침, 프로젝트 PRD, 프로젝트 ADR, SOLVER_AGENT_DESIGN. 문서 목록은 FEATURED_AGENTS.md, 상태 원본은 coordination.md에 있다.

MFE-ADR-001 — 사용자 지정 backend와 reference 범위

  • 상태: 사용자 요청으로 확정된 intake 범위.
  • 결정 owner: user; 기록 owner: coordinator-agent.
  • 결정: MITC4 질량행렬 및 고유치해석을 구현하고 고유치 계산에는 MKL FEAST를 사용한다. 지정된 reference/shellNL-eigen-meshfine reference에서 외부 비교는 고유치만 수행한다.
  • 근거: 2026-09-06 사용자 요청; Feature PRD 사용자 요구.
  • 영향: backend 대체, 외부 mode-shape acceptance 추가 또는 reference 변경으로 요구를 우회하지 않는다.

MFE-ADR-002 — MITC4 질량 이산화

  • 상태: 사용자 후속 요구로 확정됨; 상세 lumping 수식은 Research/Formulation 소유.
  • 결정 owner: user; 선택지 검토 owner: requirement-agent; 상세 수식 owner: formulation-agent.
  • 결정: consistent mass를 계산하고 이를 이용하여 lumped mass도 계산한다. 앞서 제안한 둘 중 하나의 선택이 아니라 두 계산의 연결이 사용자 요구이다.
  • 근거: 2026-09-06 사용자 후속 답변 “mass matrix는 consistent mass를 계산하고 이를 이용해서 lumped mass를 계산합니다.”; 원래 질문 evidence.
  • 영향: Requirement owner는 r1에서 두 계산과 관계를 baseline에 반영한다. 실제 FEAST 질량은 후속 명시 답변으로 lumped로 확정되었으며 MFE-ADR-004를 따른다.
  • 경계: 기존 비물리 drilling DOF에 인공 관성을 추가하지 않는 방향을 권고한다. FEAST generalized problem의 mass SPD 조건과 질량 없는 drilling 처리는 Research와 Formulation이 물리 spectrum 보존 근거를 제시해야 한다. 축소 수식은 이 관리문서에서 정하지 않는다.

해석 기준 상태, backend 입력 관례 및 additive 결과량은 Requirement owner의 reference와 기존 계약 evidence로 정리한다. 새로 밝혀지는 비호환 영속 계약 또는 다른 critical 선택이 있으면 별도 근거와 함께 기록한다.

MFE-ADR-003 — Local 검증 경로와 점진적 커밋

  • 상태: 사용자 요청으로 승인됨.
  • 결정 owner: user; 기록 owner: coordinator-agent.
  • 결정: FESA_GTEST_SOURCE_DIR는 C:\git\googletest를 사용한다. 사용자 수정 AGENTS.md를 커밋하고 이후 작업도 Git에 점진적으로 커밋한다.
  • 근거: 2026-09-06 사용자 후속 답변; Root가 해당 GoogleTest CMakeLists.txt 존재를 확인했다.
  • 영향: Root는 사용자 수정 AGENTS.md와 완료된 upstream 문서의 정확한 경로 checkpoint를 커밋한다. 구현 단계 branch·step 선택·source/phase 커밋은 기존 Harness Executor 소유를 유지한다. Remote 작업 승인은 포함하지 않는다.

MFE-ADR-004 — FEAST에 사용하는 질량행렬

  • 상태: 사용자 명시 답변으로 승인됨.
  • 결정 owner: user; 대안·영향 owner: requirement-agent.
  • 결정: consistent mass -> lumped mass -> 고유치 해석 순서로 수행하고 FEAST/reference baseline의 M은 derived lumped mass를 사용한다. Consistent는 lumping 원본과 내부 질량 검증 대상으로 유지한다.
  • 이유와 영향: 사용자가 최종 계산 흐름과 해석 사용 질량을 직접 명시했다. Modal residual, normalization 및 orthogonality의 기준 M도 실제 사용한 lumped mass이다.
  • 근거: 2026-09-06 사용자 답변 “고유치 해석에서는 lumped mass를 사용합니다. 따라서 고유치 해석을 할 때 consistent mass -> lumped mass -> 고유치 해석 입니다”; Requirement owner r1 결정 evidence의 MFE-OQ-002를 해소한다.
  • 경계: 두 mass variant 외부 비교 또는 사용자 선택 API를 추가 요구하지 않는다. Lumping 수식은 Research/Formulation이 계약과 evidence로 구체화한다.

MFE-ADR-005 — 요청 고유치 개수의 입력 권위

  • 상태: 사용자 명시 확인; 기존 r1 요구사항의 의미 유지.
  • 결정 owner: user; 기록 owner: coordinator-agent.
  • 결정: 고유치 개수는 .inp의 *FREQUENCY data를 사용한다. 지정 input의 요청은 10개이며 reference 행수나 FEAST 내부 count 추정으로 요청 개수를 역추론하지 않는다.
  • 근거: 2026-09-06 사용자 답변 “inp 파일의 고유치 개수를 사용합니다”; r1 FEM-REQ-MITC4-EIGEN-009/015.
  • 영향: 기존 mode-count 의미의 확인이므로 contract revision은 r1을 유지한다. FEAST interval/subspace는 입력 요청의 낮은 N개와 multiplicity·누락 검증을 충족하기 위한 내부 처리이다. 새 입력 설정 기능을 추가하지 않는다.