Files
FemLite/docs/06_test_and_verification_plan.md
T

16 KiB
Raw Blame History

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 输出测试。

4. 测试目录结构

建议目录结构:

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. 测试优先级

测试分为三类:

P0 每次提交前必须运行并通过
P1 阶段性运行,发布前必须通过
P2 长算例、性能测试或专项测试,发布前或专项评审时运行

P0 包括:

  • 编译测试。
  • 核心单元测试。
  • 材料单点测试。
  • 小型 INP 解析测试。
  • 小型显式单步/多步测试。
  • SPH 总力映射测试。

P1 包括:

  • 第一版验收验证算例。
  • 中等规模动力学回归测试。
  • 小型线性静力和非线性静力回归测试。
  • 阶段性能测试。
  • 跨平台编译检查。

P2 包括:

  • 性能长跑。
  • 长时间动力学稳定测试。
  • Scordelis-Lo 壳静力基准和网格收敛测试。
  • Abaqus/Explicit 可选对比。
  • 复杂耦合流程测试。

6. 误差容限

默认误差容限:

单元级解析测试      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。
  • 网格收敛趋势。

优先级:

解析解/手算结果 > 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 对称性测试。
  • Scordelis-Lo 壳静力位移基准测试。
  • 板壳弯曲静力基准测试。

静力与隐式求解测试:

  • CSR 线性静力装配。
  • Dirichlet 约束施加后的反力平衡。
  • 线性静力实体 patch test。
  • 线性静力壳 patch test。
  • 非线性静力 Newton 收敛。
  • 非线性静力步长缩减。
  • 非线性静力线搜索和失败回滚测试。
  • 隐式 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 分摊、空间 broad-phase、CSR 图案和切线块。

输出测试:

  • history.csv 字段存在。
  • nodes_step_xxxxx.csv 字段存在。
  • elements_step_xxxxx.csv 字段存在。
  • 删除单元状态可输出。

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

集合测试:

  • *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 动力学完整求解流程。

典型流程测试:

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 驱动流程测试:

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

第三版静力流程测试:

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. 回归测试

基准结果目录:

tests/reference

允许存储:

  • 小型 history.csv。
  • 抽样节点结果。
  • 抽样单元结果。
  • 日志关键模式。
  • 小型参考输入文件。

不应提交:

  • 每一步全场大 CSV。
  • 大型二进制结果。
  • Python 虚拟环境本体。
  • 临时构建目录。

回归比较:

  • P0 回归比较关键标量和少量抽样场变量。
  • P1 回归比较完整历史量和更多抽样节点/单元。
  • P2 回归重点检查性能、稳定性和长期漂移。

18. 性能测试

第一版性能目标:

目标节点数 10000
目标单元数 10000
目标时间步数 10000

阶段性能测试 P1:

10000 节点
10000 单元
100 步

性能长跑 P2:

10000 节点
10000 单元
10000 步

性能指标:

  • INP 读取耗时。
  • 数据库构建耗时。
  • 集中质量计算耗时。
  • 显式单步平均耗时。
  • 总耗时。
  • 峰值内存。
  • 删除单元数量。
  • 最小稳定时间步。

第一版不要求:

  • 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 回归测试。

第三版:

  • CI 增加静力学和隐式求解 P0/P1 测试。
  • CI 增加壳静力小型基准测试。
  • 本地发布前运行 Scordelis-Lo 和接触 P2 测试。
  • 保留 Windows GCC、WSL gfortran 和 Intel Fortran 兼容性检查记录。

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 测试。