751 lines
27 KiB
Markdown
751 lines
27 KiB
Markdown
# 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、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 对应包装返回当前线性求解器、预条件器、最近一次迭代数、残差和状态;模块测试覆盖 BiCGSTAB 非对称小系统,`implicit_inp` 覆盖隐式路径切换到 BiCGSTAB。
|
||
- 删除单元状态可输出。
|
||
|
||
示例结果留存策略:
|
||
|
||
- 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` 无双击脚本”的回退。
|
||
- 已接入 `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 静力 smoke、membrane uniaxial 静力 smoke、shell-solid connection 静力 smoke、strength reduction slope 静力 smoke 和 golf ball impact 短步数动力 smoke;rigid/golf impact smoke 需要 final contact CSV 中出现 active contact,sliding friction smoke 需要 final contact CSV 中出现正摩擦耗散,Scordelis-Lo 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` 和五个文档派生 `example_smoke`,Python 可用时 Windows GCC 16 CTest 当前为 47 项。
|
||
|
||
## 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 失败。
|