Files
FemLite/docs/06_test_and_verification_plan.md
T
shenw 678d2006cc
FemLite CI / build-test (push) Has been cancelled
Document V4.8 solver and example coverage
2026-06-25 12:19:35 +08:00

751 lines
28 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# FEM Test and Verification Plan
文档状态:测试验证基线草稿
适用对象:船舶接触爆炸船体结构 FEM 核心库与小型分析程序
## 1. 文档目的
本文档定义 FemLite 各阶段的测试层级、测试工具、验证算例、确认算例、回归测试、性能测试、误差容限和发布阻断条件。
本文档用于判断各阶段是否达到可开发、可联调、可回归和可验收状态。
## 2. 测试目标
第一版测试目标:
- 验证有限元形函数、积分和单元公式实现正确。
- 验证材料更新算法正确,包括线弹性、J2、Johnson-Cook、温升和失效。
- 验证显式动力学时间推进稳定可靠。
- 验证 Abaqus inp 子集解析正确。
- 验证 SPH-FEM 边界接口可用。
- 验证单元删除后内存、质量、状态和外载处理符合设计。
- 建立可重复运行的回归测试基准。
- 建立第一版验收算例集合。
## 3. 测试工具与环境
第一版测试工具:
- Fortran 独立测试程序。
- CMake/CTest 统一管理测试。
- Python 辅助 CSV 对比和报告生成,可选执行。
Python 环境约定:
- 在 `.\Python\` 中建立本软件专用 Python 虚拟环境。
- 建议虚拟环境路径为 `.\Python\.venv`。
- 虚拟环境只用于测试辅助脚本、CSV 对比和报告生成。
- 虚拟环境本体不应提交到 git。
- 只提交必要的脚本、依赖说明和测试数据。
第二版扩展:
- 接入 CI。
- Python 调试接口测试。
- C ABI 包装层接口测试。
第三版扩展:
- 线性静力和非线性静力测试。
- 壳单元静力基准测试。
- 隐式 Newmark 动力学测试。
- 通用接触测试。
- 静力反力、收敛历史和 VTK 输出测试。
- 源码规模检查:普通过程/函数尽量不超过 100 行,超过 128 行必须登记审查理由;源文件尽量不超过 1500 行,超过 2000 行必须审查是否拆分。
第四版扩展:
- surface/contact 输入增强测试,包括 node-based surface、analytical rigid plane surface 和 contact property。
- active set、gap residual 和 augmented penalty 诊断测试。
- 摩擦正则化、摩擦功和最大累计滑移输出测试。
- 接触示例 smoke 测试应覆盖刚性平面压入、两实体块面-面压缩和壳-刚性平面接触。
- 线性求解器分发测试应覆盖 CG、BiCGSTAB、GMRES、none/Jacobi 预条件、外部求解器占位和最近一次求解统计。
- 壳 V4.7 测试应覆盖 drilling 稳定参数、S3 剪切锁定折减诊断、J2 剪切/弯曲塑性、trial/rollback 和 Scordelis-Lo 静力基准 smoke。
## 4. 测试目录结构
建议目录结构:
```text
tests/unit
tests/module
tests/integration
tests/verification
tests/coupling
tests/performance
tests/data
tests/reference
tests/scripts
```
目录说明:
- `tests/unit`:形函数、材料点、数学工具等小粒度测试。
- `tests/module`:单元、边界、输出、输入解析等模块测试。
- `tests/integration`:完整 inp 读取、建模、求解、输出流程测试。
- `tests/verification`:解析解、手算解、Abaqus 可选参考和冻结基准算例。
- `tests/coupling`:SPH-FEM 接口测试。
- `tests/performance`:规模和耗时测试。
- `tests/data`:测试输入文件。
- `tests/reference`:小型参考结果和抽样基准。
- `tests/scripts`:Python 辅助脚本。
## 5. 测试优先级
测试分为三类:
```text
P0 每次提交前必须运行并通过
P1 阶段性运行,发布前必须通过
P2 长算例、性能测试或专项测试,发布前或专项评审时运行
```
P0 包括:
- 编译测试。
- 核心单元测试。
- 材料单点测试。
- 小型 INP 解析测试。
- 小型显式单步/多步测试。
- SPH 总力映射测试。
P1 包括:
- 第一版验收验证算例。
- 中等规模动力学回归测试。
- 小型线性静力和非线性静力回归测试。
- 阶段性能测试。
- 跨平台编译检查。
P2 包括:
- 性能长跑。
- 长时间动力学稳定测试。
- Scordelis-Lo 壳静力基准和网格收敛测试。
- Abaqus/Explicit 可选对比。
- 复杂耦合流程测试。
## 6. 误差容限
默认误差容限:
```text
单元级解析测试 relative tolerance 1.0e-10 to 1.0e-8
材料单点测试 relative tolerance 1.0e-8
输入解析测试 exact match unless floating data are involved
SPH总力映射测试 relative tolerance 1.0e-10 to 1.0e-8
动力学回归测试 key history relative tolerance 1.0e-5
工程验证算例 displacement/energy relative tolerance 1.0e-3 to 1.0e-2
```
说明:
- 解析测试应使用更严格阈值。
- 动力学测试允许不同编译器和平台导致的小幅历史量漂移。
- 工程验证算例应同时检查趋势、数量级和能量合理性。
## 7. 参考结果来源
允许的参考结果来源:
- 解析解。
- 手算结果。
- Abaqus/Explicit 可选参考。
- 内部冻结基准 CSV。
- 网格收敛趋势。
优先级:
```text
解析解/手算结果 > Abaqus/Explicit 可选参考 > 冻结基准 CSV > 收敛趋势
```
说明:
- Abaqus/Explicit 结果作为可选参考,不作为开发环境强依赖。
- 冻结基准 CSV 应尽量小,只保存关键历史量和抽样结果。
## 8. 单元测试计划
形函数测试:
- C3D4 形函数 Kronecker delta 性质。
- C3D8 形函数 Kronecker delta 性质。
- S4 形函数 Kronecker delta 性质。
- partition of unity。
- 自然坐标导数正确性。
积分与几何测试:
- C3D4 体积。
- C3D8 2x2x2 积分。
- S4 面积和厚度。
- Jacobian 正负检查。
- 退化单元检测。
质量测试:
- C3D4 集中质量守恒。
- C3D8 集中质量守恒。
- S4 平动质量守恒。
- S4 简化对角转动惯量非负。
压力等效节点力测试:
- 均布压力总力正确。
- 压力符号符合 `t = -p n`。
- 等效节点力矩平衡在简单面片上合理。
## 9. 材料算法测试
第一版材料测试必须包含:
- 线弹性单轴拉伸。
- 线弹性纯剪切。
- 小应变 J2 弹性步。
- 小应变 J2 塑性步。
- 小应变 J2 加载卸载。
- 大变形 J2 加载卸载。
- Jaumann 客观率刚体转动测试。
- Johnson-Cook 应变率敏感测试。
- Johnson-Cook 温度软化测试。
- 绝热塑性温升测试。
- 等效塑性应变阈值失效测试。
- Johnson-Cook 损伤失效测试。
材料测试要求:
- 单点材料测试优先使用解析或半解析参考。
- 每个材料测试应检查应力、等效塑性应变、温度、损伤和失效标志。
- 失效测试应检查 fail_flag 是否正确设置。
## 10. 模块测试计划
实体单元测试:
- C3D4 单元质量。
- C3D4 单元内力。
- C3D4 patch test。
- C3D8 单元质量。
- C3D8 单元内力。
- C3D8 patch test。
- C3D8 全积分路径。
- 第一版不支持 C3D8R,应返回明确错误或不支持信息。
壳单元测试:
- S4 单元质量。
- S4 膜响应。
- S4 弯曲响应。
- S4 横向剪切响应。
- S4 选择性减缩积分路径。
- S4 patch test。
- S3/S4/S6/S8 线性静力刚度测试。
- S4 J2/J2_JC 膜内塑性状态更新和膜内/弯曲/剪切 section tangent 对称性测试。
- V4.7 增加 drilling 稳定参数敏感性、S3 剪切锁定诊断、S4 J2 剪切塑性、代表性外纤维弯曲塑性和 trial rollback 回归。
- Scordelis-Lo 壳静力位移基准测试。
- 板壳弯曲静力基准测试。
静力与隐式求解测试:
- CSR 线性静力装配。
- Dirichlet 约束施加后的反力平衡。
- 线性静力实体 patch test。
- 线性静力壳 patch test。
- 非线性静力 Newton 收敛。
- 非线性静力收敛状态查询,检查最新增量、迭代号、残差范数、修正范数、cutback 次数、最后步长、最后有效时间、状态码、失败原因码和收敛标志。
- 非线性静力步长缩减。
- 非线性静力线搜索和失败回滚测试。
- 隐式 Newmark 单步预测校正。
- C3D4 单步隐式 Newmark 拉伸解析对照。
- Rayleigh 质量比例阻尼解析对照。
- `--implicit-newmark` 命令行回归测试。
- 非线性 Newmark-Newton 线弹性退化解析对照。
- 实体 J2 算法切线基本性质测试。
- 非线性 Newmark-Newton 失败后 trial rollback 测试。
- 非线性 Newmark-Newton Robin/MPC/contact 切线解析对照。
- 非线性 Newmark-Newton 线搜索和动态步长缩减测试。
- `--implicit-newmark-nonlinear` 命令行回归测试。
- 隐式动力弹性波传播。
边界与载荷测试:
- Dirichlet 位移约束。
- 节点力施加。
- 面压力等效节点力。
- amplitude 常值和表格插值。
- 刚性平面 contact penalty/damping 力和切线。
- 面-面 contact pair 法向力、阻尼项、Coulomb 粘滑历史、多 master 分摊、投影裁剪 mortar 权重、空间网格候选、BVH 宽相搜索、空间 broad-phase、CSR 图案、切线块和壳 `SPOS`/`SNEG` 侧向语义。
- contact pair active set 的 activated/maintained/released 状态切换、gap residual、augmented penalty 乘子更新和释放后清零。
- contact pair Coulomb 摩擦默认路径、正则化 Coulomb 路径、正则化切线折减、滑移耗散功和累计滑移。
工程卫生测试:
- `source_size` CTest 调用 `tests/scripts/check_source_size.py`,检查 `src` 和 `tests` 下 `.f90/.c/.h/.py` 源文件规模。
- 普通过程/函数 review target 为 100 行,超过 128 行必须在 `tests/source_size_exceptions.txt` 中登记具体审查理由和后续拆分方向。
- 源文件 review target 为 1500 行,超过 2000 行必须在 `tests/source_size_exceptions.txt` 中登记是否拆分、为何暂缓拆分及后续计划。
- 例外表只允许登记当前仍超过硬阈值的项目;过期例外会使 `source_size` 失败。
- 0.4.3 当前无 active hard-threshold exception;剩余输出为 review-target warning,不阻断发布。
输出测试:
- `history.csv` 字段存在。
- `nodes_step_xxxxx.csv` 字段存在。
- `elements_step_xxxxx.csv` 字段存在。
- `contact_XXXXXXXX.csv` 字段存在,并包含 summary 与逐 contact pair 行、stick/slip 计数、累计滑移、切向力历史、summary 和 pair 级搜索统计、BVH 候选缓存统计和 CPU 时间统计。
- `fem_get_contact_summary` 返回激活数、单步/累计接触功、最大穿透量和接触力范数。
- `fem_get_contact_diagnostics` 返回 active pair 数、activated/maintained/released pair 数、最大 gap residual 和最大 augmented penalty 乘子;C ABI 包装函数与 Fortran API 结果一致。
- `fem_get_contact_friction` 和 C ABI `femlite_get_contact_friction_summary` 返回摩擦 step/total 功和最大累计滑移。
- `fem_get_contact_hist_stats` 和 C ABI `femlite_get_contact_history_stats` 返回 mortar 积分点历史槽数、单槽最大滑移、单槽最大摩擦功和单槽最大切向力。
- `fem_get_contact_search_stats` 和 C ABI `femlite_get_contact_search_stats` 返回 contact pair 搜索 facet/master/candidate/active/BVH 节点统计。
- `fem_get_contact_perf_stats` 和 C ABI `femlite_get_contact_perf_stats` 返回 contact search/force/tangent CPU 时间统计。
- `fem_get_contact_cache_stats` 和 C ABI `femlite_get_contact_cache_stats` 返回 BVH 候选缓存使用和溢出统计。
- `fem_get_convergence_status` / `fem_get_convergence_metrics` / `fem_get_convergence_diagnostics` 和 C ABI 对应包装返回最近一次求解的增量、迭代、残差、相对残差、修正范数、contact gap residual、combined norm、cutback 次数、最后步长、最后有效时间、状态码、失败原因码和收敛标志;空模型零状态、非线性静力收敛状态、contact gap 非零状态和 cutback 失败状态均需覆盖。
- `fem_set_linear_solver` / `fem_get_linear_solver_settings` / `fem_get_linear_solver_stats` 和 C ABI 对应包装返回当前线性求解器、预条件器、最近一次迭代数、残差和状态;模块测试覆盖 CG、BiCGSTAB 和 GMRES,BiCGSTAB/GMRES 使用非对称小系统,`implicit_inp` 覆盖隐式路径切换到 BiCGSTAB,C ABI 覆盖切换到 GMRES + Jacobi。
- 删除单元状态可输出。
示例结果留存策略:
- Git 中保留网格/输入生成脚本、`.inp` 文件、`README.md` 和小型 summary/check 文件。
- 不提交每一步全场 `VTK/CSV/contact` 结果;这些文件通过 `.gitignore` 忽略。
- 对需要回归比较的案例,只保留抽样结果或紧凑统计量。
- 大型长跑结果由本地复现实验生成,并在 README 中记录命令、版本和关键误差指标。
壳基准扩展矩阵:
- Scordelis-Lo:输入位于 `examples/scordelis_lo_roof/`,S3/S4 smoke 检查自由角竖向位移符号和最小量级;网格收敛和参考误差记录作为后续长跑扩展。
- Kirsch plate:记录 S3/S4 孔边应力集中和远场应力误差。
- shell patch test:记录 S3/S4 位移误差和局部应力误差,作为线性精度回归。
- clamped square plate pressure pulse:记录 S3/S4 中心位移峰值、能量历史和稳定时间步。
- V4.7 模块回归已覆盖剪切锁定折减和钻转稳定参数敏感性;后续补充更密网格基准误差表。
接触验证扩展矩阵:
- `*CONTACT PAIR` 合法/缺参/空格/引号/大小写输入解析。
- `*SURFACE` element-target 子集、混合 elset/element-id 数据行、省略 face label、face label 筛选、`OP=ADD/NEW` 同名 surface 追加/覆盖、node-based surface、analytical rigid plane surface、壳 `SPOS`/`SNEG` 法向符号和 slave 侧向筛选、非法 TYPE 拒绝与数据行式 `*CONTACT PAIR` 输入解析。
- `*SURFACE INTERACTION` / `*CONTACT PROPERTY` 中 penalty、damping、search、friction、friction regularization、augment 参数解析和 contact pair 继承。
- contact CSV schema 和 summary/pair 行字段检查,包括 search facet/master/candidate/active/BVH 节点统计列、BVH 候选缓存列、CPU 时间统计列和逐 `PAIR` 行统计值。
- contact diagnostics API 和 C ABI 包装层检查。
- contact friction summary API 和 C ABI 包装层检查。
- contact history stats Fortran API 和 C ABI 包装层检查。
- contact search stats Fortran API 和 C ABI 包装层检查;小算例要求候选数和 active 候选数非零,空模型要求全零。
- contact performance stats Fortran API 和 C ABI 包装层检查;小算例要求非负,空模型要求全零。
- contact cache stats Fortran API 和 C ABI 包装层检查;BVH 小算例要求 cache used 非零且 overflow 为零,空模型要求全零。
- BVH 跨调用候选缓存检查;第一次 BVH 力计算应建立缓存,第二次同几何力计算应命中缓存且 `search_bvh_nodes=0`,后续切线装配应复用同一候选缓存,slave facet 移动超过失效阈值后应失效并重新构建 BVH。
- restart v2 写读 mortar 积分点摩擦历史,验证重启后历史槽、累计滑移、摩擦功和切向力保持一致。
- 法向接触功、摩擦功、stick/slip 计数、mortar 积分点历史槽、正则化摩擦切线和累计滑移 sanity check。
- V4.2 新增示例:rigid plane indentation、two blocks compression、shell rigid plane contact;每个示例应可通过目录内 `run_case.bat` 自动运行和检查结果。
- V4.3 新增示例:contact block sliding friction;检查正则化参数、累计滑移、切向力、摩擦功非负和 VTK 输出。
- V4.8 补齐文档型示例目录的可运行输入和 `run_case.bat`,新增 `examples_layout` CTest 检查“有文档无 `.inp`”和“有 `.inp` 无双击脚本”的回退;文档后缀包含 `.md`、`.pdf`、`.ppt`、`.pptx`、`.txt` 和 `.rst`。
- 已接入 `example_smoke` CTest 分组:shell patch S3/S4 静力 smoke、Scordelis-Lo S3/S4 静力 smoke、clamped square plate pressure pulse S4 短步数动力 smoke、rigid sphere impact plate S3/S4 短步数动力 smoke、contact block sliding friction 短步数动力 smoke、elliptic membrane、membrane uniaxial、shell-solid connection、strength reduction slope、golf ball impact、node analytical contact、block-on-arch、cylinder roller contact、sliding wedge、roll forming、falling objects、ball adhesion contact、buckling corrugated shell、dynamic grain container、thick plate、membrane airbag、spherical cap、blasting rock、nonlinear harmonic、layered shell、two arches、pinched hemisphere 和 stress dependent elasticity smoke;接触类 smoke 检查 active contact,摩擦滑移类 smoke 检查正摩擦耗散,壳/静力基准 smoke 通过节点位移探针检查方向和最小量级。
- rigid sphere impact plate 的长步数结果保留为示例复现实验。
## 11. 输入解析测试
第一版支持 keyword 均应有最小 inp 测试:
- *NODE
- *ELEMENT
- *NSET
- *ELSET
- *MATERIAL
- *DENSITY
- *ELASTIC
- *PLASTIC
- *SOLID SECTION
- *SHELL SECTION
- *BOUNDARY
- *CLOAD
- *DLOAD
- *AMPLITUDE
- *STEP
- *DYNAMIC
第三版新增 keyword 测试:
- *STATIC
- *CONTROLS
- *SURFACE
- *CONTACT PAIR
- *TIE
- *OUTPUT
- *NODE PRINT
- *EL PRINT
- *NODE FILE
- *EL FILE
第四版新增 keyword 和参数测试:
- *SURFACE, TYPE=NODE
- *SURFACE, TYPE=ANALYTICAL
- *SURFACE INTERACTION
- *CONTACT PROPERTY
- *FRICTION
- *CONTACT PAIR, INTERACTION=...
- *CONTACT PAIR, AUGMENT=...
集合测试:
- *NSET, GENERATE。
- *ELSET, GENERATE。
- 普通显式集合。
- 空集合错误处理。
错误处理测试:
- 不支持 keyword warning 后跳过。
- 关键数据缺失返回 error。
- 缺失材料返回 error。
- 缺失密度返回 error。
- 非法单元类型返回 error。
- 原始编号到内部编号映射正确。
## 12. SPH-FEM 接口测试
SPH 接口第一版必须测试三类输入:
- facet 压力。
- facet 压力加剪切。
- 节点力。
facet 导出测试:
- facet 数量正确。
- facet 编号稳定。
- facet 节点连接使用 Abaqus 原始节点编号。
- facet 所属单元使用 Abaqus 原始单元编号。
- facet 外法向方向正确。
- facet 面积正确。
- facet 节点坐标和速度维度正确。
力映射测试:
- 压力映射总力正确。
- 压力符号符合受压为正。
- 剪切映射总力正确。
- 节点力直接累加正确。
- 删除单元不会导出有效 facet。
- 删除单元不再接受 SPH facet 外载。
## 13. 单元删除与失效测试
必须测试:
- C3D4 使用 ANY_FAILED_GP 删除。
- C3D8 使用 FRACTION_FAILED_GP,fraction = 0.5 删除。
- S4 使用 FRACTION_FAILED_GP,fraction = 0.5 删除。
- 删除后单元仍在内存中且可查询。
- 删除后单元不贡献内力。
- 删除后单元不接受面压力。
- 删除后单元不接受 SPH facet 外载。
- 删除后质量保留。
- 删除后不触发自由度重编号。
- 输出中记录 deleted 状态。
## 14. 集成测试计划
集成测试覆盖:
- inp 读取到数据库构建。
- 数据库到自由度编号。
- facet 构造。
- 集中质量初始化。
- 显式单步推进。
- 显式多步推进。
- CSV 输出。
- 错误日志检查。
- 独立 femlite 程序运行。
- 外部 SPH 驱动式调用流程。
- 静力线性完整求解流程。
- 静力非线性完整求解流程。
- 隐式 Newmark 动力学完整求解流程。
典型流程测试:
```text
fem_initialize
fem_read_inp
fem_build_model
fem_compute_lumped_mass
fem_estimate_stable_dt
fem_advance_explicit
fem_write_output
fem_finalize
```
SPH 驱动流程测试:
```text
fem_get_boundary_facet_count
fem_get_boundary_facets
fem_clear_sph_forces
fem_apply_sph_facet_pressure / fem_apply_sph_facet_tractions / fem_apply_sph_nodal_forces
fem_advance_explicit
fem_get_nodal_kinematics
```
第三版静力流程测试:
```text
fem_initialize
fem_read_inp
fem_build_model
fem_solve_static_linear / fem_solve_static_nonlinear
fem_get_nodal_reactions
fem_get_convergence_status
fem_write_output
fem_finalize
```
## 15. 第一版验证算例
第一版验收算例:
- 单元 patch test。
- 单轴拉伸。
- 弹塑性加载卸载。
- 弹性波传播。
- 板受压力脉冲。
- 简化 SPH-FEM 边界力传递接口。
覆盖要求:
- patch test 覆盖 C3D4、C3D8、S4。
- 单轴拉伸覆盖线弹性和 J2 弹塑性。
- 弹塑性加载卸载覆盖小应变 J2 和大变形 J2。
- 弹性波传播覆盖 C3D8 和 C3D4。
- 板受压力脉冲覆盖第一版所有板壳单元。
- SPH 接口覆盖压力、剪切力和节点力三类载荷。
每个验证算例应包含:
- 输入文件。
- 运行命令。
- 参考结果来源。
- 允许误差。
- 关键输出字段。
- 日志检查项。
- 回归判据。
## 16. 确认算例
第一版可选确认算例:
- 板受冲击压力载荷。
- 简化船体板架爆炸响应。
- 简化 SPH-FEM 压力传递。
第二版或后续确认算例:
- Taylor impact。
- 接触冲击算例。
- 壳-实体混合模型响应。
- Abaqus/Explicit 对比算例。
第三版确认算例:
- Scordelis-Lo 屋面壳体静力基准。
- 板壳弯曲静力基准。
- 实体单元线弹性静力 patch test。
- 实体单元 J2 弹塑性静力加载卸载。
- 隐式动力弹性波传播。
- 简化接触静力压入。
- 简化接触动力冲击。
## 17. 回归测试
基准结果目录:
```text
tests/reference
```
允许存储:
- 小型 `history.csv`。
- 抽样节点结果。
- 抽样单元结果。
- 日志关键模式。
- 小型参考输入文件。
不应提交:
- 每一步全场大 CSV。
- 大型二进制结果。
- Python 虚拟环境本体。
- 临时构建目录。
回归比较:
- P0 回归比较关键标量和少量抽样场变量。
- P1 回归比较完整历史量和更多抽样节点/单元。
- P2 回归重点检查性能、稳定性和长期漂移。
## 18. 性能测试
第一版性能目标:
```text
目标节点数 10000
目标单元数 10000
目标时间步数 10000
```
阶段性能测试 P1:
```text
10000 节点
10000 单元
100 步
```
性能长跑 P2:
```text
10000 节点
10000 单元
10000 步
```
性能指标:
- INP 读取耗时。
- 数据库构建耗时。
- 集中质量计算耗时。
- 显式单步平均耗时。
- 总耗时。
- 峰值内存。
- 删除单元数量。
- 最小稳定时间步。
- contact pair 全局与逐 pair facet/master/candidate/active/BVH 节点统计。
- contact pair 全局与逐 pair BVH 候选缓存命中和溢出统计。
- contact 全局与逐 pair search/force/tangent CPU 时间统计。
V4.4 contact pair 性能 smoke:
- `perf_contact_pair_smoke` 使用程序内生成的 S4 master/slave 面对,默认 CTest 规模为 32 对面片;`perf_contact_pair_medium` 使用 64 对面片覆盖更厚的 BVH/cache/tangent 路径。
- smoke 必须触发 BVH 搜索、active 接触和 BVH 候选缓存命中。
- `perf_contact_pair_omp_consistency` 通过 `tests/scripts/check_perf_contact_pair_omp.py` 分别以 `OMP_NUM_THREADS=1/4` 运行同一性能 smoke,并要求 active、broad/active 候选、BVH 节点和缓存命中等非计时统计一致;该用例覆盖缩短后的 force 全局提交临界区和 tangent CSR 合并临界区。
- 可执行程序 `perf_contact_pair <facet_count> <do_tangent>` 可用于放大到中等规模专项测试;`facet_count` 必须大于 16 才能触发 BVH 路径。
第一版不要求:
- OpenMP。
- MPI。
- GPU。
- 外部求解器加速。
## 19. 鲁棒性测试
必须覆盖:
- 输入文件不存在。
- 缺失材料。
- 缺失密度。
- 非法材料参数。
- 非法塑性曲线。
- 非法 Johnson-Cook 参数。
- 非法温度参数。
- 退化单元。
- 负 Jacobian。
- 非法边界自由度。
- 不支持 keyword。
- 空集合。
- 时间步小于等于零。
- SPH facet_id 非法。
- SPH node_id 非法。
- 输出目录不可写。
鲁棒性判据:
- 错误必须通过 ierr 返回。
- 关键错误必须写入日志。
- warning 不应导致程序异常终止。
- 不支持 keyword 应 warning 后跳过。
- 关键数据缺失应 error 并终止当前分析。
## 20. 本地测试与 CI 策略
第一版:
- 使用本地 CTest。
- P0 作为每次提交前必须通过的测试集合。
- P1 作为阶段评审和发布前测试集合。
- P2 作为专项长跑和发布候选验证。
第二版:
- 接入 CI。
- 增加 Windows/Linux 自动编译。
- 增加 C ABI 和 Python 接口测试。
- 增加 VTK/restart 回归测试;V4.3 已覆盖接触摩擦历史 restart 回归。
第三版:
- CI 增加静力学和隐式求解 P0/P1 测试。
- CI 增加壳静力小型基准测试。
- 本地发布前运行 Scordelis-Lo 和接触 P2 测试。
- 保留 Windows GCC、WSL gfortran 和 Intel Fortran 兼容性检查记录。
- 0.4.2 本地发布记录:Windows GCC 16 CTest 33/33,WSL Ubuntu + gfortran 13.3 CTest 33/33,Windows Intel oneAPI `ifx` 2026.0 + MSVC `cl` 19.44 CTest 33/33;Intel/NMake `/machine:x64` ifx warning 已清理。
- 0.4.3 当前 Windows GCC 16 回归记录:CTest 34/34。
- V4.4 开发态新增 `contact_omp1` / `contact_omp4`,用 `OMP_NUM_THREADS=1/4` 重跑 contact 模块回归;新增 `perf_contact_pair_smoke` 和 `perf_contact_pair_medium` 覆盖 BVH contact pair 性能 smoke;新增 `perf_contact_pair_omp_consistency` 对比性能 smoke 在 OpenMP 1/4 线程下的非计时统计;contact CSV 已覆盖 summary 和逐 pair 统计;BVH force 权重准备统计改为 OpenMP reduction 后由 contact 定向回归覆盖;BVH force 并行装配已将法向/mortar/接触面积准备移出全局提交临界区,BVH tangent 并行装配已将 mortar/切线块准备移出 CSR 临界区;`contact` 覆盖跨调用候选缓存 force/tangent 命中和失效条件。
- V4.8 阶段验收新增 `examples_layout`、GMRES 回归、node analytical contact、P1 contact 性能 smoke,以及完整文档派生 `example_smoke` 矩阵;Python 可用时 Windows GCC 16 CTest 当前记录为 66/66 passed。
## 21. 发布阻断条件
以下任一情况应阻断第一版发布:
- P0 测试失败。
- 输入解析关键测试失败。
- 材料单点测试失败。
- 显式动力学稳定测试失败。
- SPH 接口总力映射失败。
- 单元删除关键测试失败。
- 跨平台编译失败。
- 输出结果字段缺失。
- 核心接口未通过 ierr 返回错误。
- 文档与实现明显不一致。
## 22. 第一版验收准则
第一版完成条件:
- P0 全部通过。
- P1 验证算例全部通过。
- P2 性能长跑完成并形成报告。
- Windows 和 Linux 均可编译。
- gfortran 默认可用。
- Intel Fortran 兼容性检查通过或记录明确限制。
- SPH 三类接口均通过测试。
- CSV 输出符合接口文档。
- 所有第一版文档更新到与实现一致。
## 23. 第三版验收准则
第三版完成条件:
- 第一版和第二版全部 P0/P1 测试无回退。
- 线性静力实体单元 patch test 通过。
- 线性静力壳单元 patch test 通过。
- Scordelis-Lo 壳静力基准通过参考位移容限检查。
- 实体单元 J2 弹塑性静力加载卸载通过。
- 非线性静力 Newton 收敛历史和失败回退测试通过。
- 隐式 Newmark 动力学小算例通过。
- 简化接触静力和动力算例通过。
- 静力 VTK、CSV、反力和收敛历史输出字段完整。
- Windows 和 Linux 均可编译并通过第三版 P0 测试。
## 24. 第四版 V4.2 阶段验收准则
V4.2 阶段完成条件:
- V4.1 的 surface/contact 输入增强无回退。
- contact pair active set 可区分 open、activated、maintained 和 released。
- augmented penalty 参数可由 contact property 或 contact pair 输入,并按 pair 级优先级继承。
- 刚性平面 analytical contact pair 和面-面 contact pair 均使用统一的 penalty + augmented multiplier 法向压力路径。
- contact CSV 输出包含状态、激活/释放次数、gap residual、augment factor 和 augmented multiplier。
- Fortran API 和 C ABI 可查询接触诊断统计。
- rigid plane indentation、two blocks compression 和 shell rigid plane contact 三个小算例可运行并生成 VTK 与接触结果。
- CTest 全量回归通过,`source_size` 无 hard-threshold 失败。