# 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 包装层接口测试。 ## 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 包括: - 性能长跑。 - 长时间动力学稳定测试。 - 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。 边界与载荷测试: - Dirichlet 位移约束。 - 节点力施加。 - 面压力等效节点力。 - amplitude 常值和表格插值。 输出测试: - `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 集合测试: - *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 驱动式调用流程。 典型流程测试: ```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 ``` ## 15. 第一版验证算例 第一版验收算例: - 单元 patch test。 - 单轴拉伸。 - 弹塑性加载卸载。 - 弹性波传播。 - 板受压力脉冲。 - 简化 SPH-FEM 边界力传递接口。 覆盖要求: - patch test 覆盖 C3D4、C3D8、S4。 - 单轴拉伸覆盖线弹性和 J2 弹塑性。 - 弹塑性加载卸载覆盖小应变 J2 和大变形 J2。 - 弹性波传播覆盖 C3D8 和 C3D4。 - 板受压力脉冲覆盖第一版所有板壳单元。 - SPH 接口覆盖压力、剪切力和节点力三类载荷。 每个验证算例应包含: - 输入文件。 - 运行命令。 - 参考结果来源。 - 允许误差。 - 关键输出字段。 - 日志检查项。 - 回归判据。 ## 16. 确认算例 第一版可选确认算例: - 板受冲击压力载荷。 - 简化船体板架爆炸响应。 - 简化 SPH-FEM 压力传递。 第二版或后续确认算例: - Taylor impact。 - 接触冲击算例。 - 壳-实体混合模型响应。 - Abaqus/Explicit 对比算例。 ## 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 读取耗时。 - 数据库构建耗时。 - 集中质量计算耗时。 - 显式单步平均耗时。 - 总耗时。 - 峰值内存。 - 删除单元数量。 - 最小稳定时间步。 第一版不要求: - 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 回归测试。 ## 21. 发布阻断条件 以下任一情况应阻断第一版发布: - P0 测试失败。 - 输入解析关键测试失败。 - 材料单点测试失败。 - 显式动力学稳定测试失败。 - SPH 接口总力映射失败。 - 单元删除关键测试失败。 - 跨平台编译失败。 - 输出结果字段缺失。 - 核心接口未通过 ierr 返回错误。 - 文档与实现明显不一致。 ## 22. 第一版验收准则 第一版完成条件: - P0 全部通过。 - P1 验证算例全部通过。 - P2 性能长跑完成并形成报告。 - Windows 和 Linux 均可编译。 - gfortran 默认可用。 - Intel Fortran 兼容性检查通过或记录明确限制。 - SPH 三类接口均通过测试。 - CSV 输出符合接口文档。 - 所有第一版文档更新到与实现一致。