Files
SPHLite/docs/06_test_and_verification_plan.md
2026-07-05 21:41:34 +08:00

32 KiB
Raw Permalink Blame History

06 测试与验证计划

文档状态:0.7.1 gate 记录

1. 测试原则

SPHLite 测试体系仿照 FEMLite,采用 CMake + CTest + Python checker + release gate。求解器、粒子/单元语义、材料和物理模块等算法核心使用 Fortran 95;worker、CLI、IPC 等外围集成层及其测试/工具性 Fortran 代码可使用 Fortran 2018,但不得倒逼核心模块引入 Fortran 2018 语法。C ABI、C++ wrapper、Python API 和 CLI 作为接口层分别测试。

测试设计原则:

  • 新物理能力必须配套小型、可重复测试或 checker。
  • 默认 release gate 只包含快速、稳定、小规模测试。
  • 长跑、工程 benchmark 和研究项不进入默认 gate。
  • C ABI 是第一优先接口测试对象。
  • C++ wrapper 测试保留,但不作为 0.1 最小 gate 必选项。
  • Python 基础 smoke 纳入默认 gate。
  • 从第一版开始启用 source size 门禁。

2. 测试分层

层级 目标
单元测试 核函数、邻域搜索、EOS、Velocity-Verlet、Johnson-Cook 材料点、Mindlin-Reissner 局部量
输入测试 Abaqus .inp 子集、*SPHLITE ... 扩展关键词、warning/error 路径
模块测试 Water、Gas、Explosive、Solid、Shell、CouplingInterface
接口测试 Fortran API、C ABI、C++ wrapper、Python ctypes、CLI
示例 smoke 小型可运行模型,检查方向、量级和关键输出
benchmark 带 checker 的紧凑工程验收
外部集成测试 与外部 CouplingModule/FEMLite 的联合验证,不属于 SPHLite 默认 gate
release gate 当前版本发布前必须通过的组合测试

3. 第一批默认测试

第一批默认测试按长期能力逐步扩展。0.1.0 的默认 gate 只覆盖工程骨架、接口、最小输入、最小显式步进和 source size;下列物理项在对应版本实现后再进入默认 gate:

  • Wendland C2 核函数归一性和梯度反对称性。
  • Wendland C4 和 cubic spline 对比/回归测试。
  • uniform cell/bin 邻域搜索与朴素搜索一致性。
  • Tait EOS 压力计算。
  • JWL EOS 压力计算。
  • 理想气体 EOS 压力计算。
  • Stiffened gas EOS 压力计算。
  • Monaghan 人工黏性方向和量级。
  • Velocity-Verlet 自由运动、恒力或简化振动步进。
  • 水相连续性方程小算例。
  • 小型压力波 smoke。
  • 解析爆轰到达时间。
  • programmed burn 反应进度 lambda。
  • 气体团簇体积和等效气泡半径统计。
  • Johnson-Cook 材料点。
  • Johnson-Cook 失效与渐进软化材料点。
  • Mindlin-Reissner 板壳小变形 smoke。
  • C ABI 空指针、非正容量和小缓冲区错误。
  • Python ctypes 基础 smoke。

4. 输入解析测试

SPHLite 支持 Abaqus .inp 明确子集,不追求完整 Abaqus 兼容。输入测试必须覆盖:

  • *NODE。
  • *ELEMENT。
  • *NSET。
  • *ELSET。
  • *MATERIAL。
  • *SECTION 或等价 section 关键词。
  • *SPHLITE ... 扩展关键词。
  • 未支持但不影响运行的关键词 warning。
  • 缺失关键数据或无法继续运行的 error。
  • set 只表示集合,不作为类型判断依据。
  • material 和 section 对 phase/物理路径的识别。

输入解析测试应同时覆盖 CLI 路径和 API 路径。

5. 模块测试顺序

模块测试按开发路线递进:

  1. Water:核函数、邻域、Tait EOS、连续性方程、压力波 smoke。
  2. Gas:JWL、理想气体、Stiffened gas、气体团簇和气泡诊断。
  3. Explosive:爆轰到达时间、反应进度、质量/动量/能量源项。
  4. Solid:Johnson-Cook 材料点、失效和渐进软化。
  5. Shell:Mindlin-Reissner 小变形、厚度积分点选择。
  6. CouplingInterface:中立耦合状态导出、外力导入、耦合功和能量诊断。

6. CouplingInterface 测试边界

SPHLite 默认 gate 不包含真正 FEM-SPH 联合测试。外部 CouplingModule、FEMLite 或其他求解器的联合运行属于外部集成测试。

SPHLite 仓库内只测试中立接口:

  • coupling region 解析。
  • coupling particles 导出。
  • coupling facets 或近似面片导出。
  • 外部粒子力、面力或体力导入。
  • 显式步内载荷施加。
  • 耦合功、动量交换和能量交换统计。
  • 接触耦合和连续体耦合诊断字段区分。

7. 0.1 Release Gate 草案

0.1 release gate 建议包含:

cmake --build build-codex-gcc --parallel
ctest --test-dir build-codex-gcc -R "^(smoke|input|c_api|python_debug)$" --output-on-failure
ctest --test-dir build-codex-gcc -R "^source_size$" --output-on-failure
git diff --check

其中:

  • smoke 覆盖 Fortran 生命周期、数据库、最小显式步。
  • input 覆盖 .inp 支持子集和 warning/error。
  • c_api 覆盖 C ABI 生命周期、查询和错误路径。
  • python_debug 覆盖 Python ctypes 基础调用。
  • source_size 控制单文件和单过程持续膨胀。

实际 build 目录和测试名称可在代码实现阶段按 CMake 配置调整。

7.1 0.3.1 Release Gate

0.3.1 在 0.3.0 默认 gate 基础上新增 Gas 多材料、material/EOS 分派、Gas 源项占位、扩展诊断、restart 兼容和接口扩展测试。默认 gate 包含:

  • input_gas_multimaterial
  • gas_eos_dispatch
  • gas_extended_summary
  • gas_source
  • gas_source_errors
  • gas_restart_031
  • gas_restart_030_compat
  • gas_python_extended
  • gas_cli_extended
  • gas_source_size_cleanup

0.3.1 本地 release gate:

ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check

2026-07-03 本地结果:默认 gate 37/37 通过,source_size 1/1 通过,git diff --check 通过。

7.2 0.4.0 Release Gate

0.4.0 在 0.3.1 Gas 稳定化 gate 基础上新增 Explosive 起步闭环测试。默认 gate 继续覆盖既有 Water/Gas/接口/restart/output/source-size 路径,并新增以下 Explosive 专项 gate:

  • input_explosive
  • input_explosive_errors
  • explosive_detonation_time
  • explosive_reaction_progress
  • explosive_release_source
  • explosive_to_gas_phase
  • explosive_gas_coupling
  • explosive_summary
  • explosive_restart_040
  • explosive_restart_031_compat
  • explosive_c_api
  • explosive_python
  • explosive_cli
  • explosive_source_size

0.4.0 本地 release gate:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_explosive|input_explosive_errors|explosive_detonation_time|explosive_reaction_progress|explosive_release_source|explosive_to_gas_phase|explosive_gas_coupling|explosive_summary|explosive_restart_040|explosive_restart_031_compat|explosive_c_api|explosive_python|explosive_cli|explosive_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check

2026-07-03 本地结果:完整 CTest 51/51 通过,Explosive 专项 gate 14/14 通过,source_size 1/1 通过,git diff --check 通过。

7.3 0.4.1 Release Gate

0.4.1 在 0.4.0 Explosive 起步闭环 gate 基础上新增稳定化和兼容性测试。默认 gate 继续覆盖既有 Water/Gas/Explosive/接口/restart/output/source-size 路径,并新增以下 Explosive 专项 gate:

  • input_explosive_multi_ignition
  • input_explosive_multimaterial
  • explosive_initial_mass_release
  • explosive_release_balance
  • explosive_source_targeting
  • explosive_phase_refresh
  • explosive_restart_041
  • explosive_restart_040_compat
  • explosive_restart_no_double_release
  • explosive_water_gas_smoke
  • explosive_release_c_api
  • explosive_release_python
  • explosive_release_cli
  • explosive_041_source_size

0.4.1 本地 release gate:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_explosive_multi_ignition|input_explosive_multimaterial|explosive_initial_mass_release|explosive_release_balance|explosive_source_targeting|explosive_phase_refresh|explosive_restart_041|explosive_restart_040_compat|explosive_restart_no_double_release|explosive_water_gas_smoke|explosive_release_c_api|explosive_release_python|explosive_release_cli|explosive_041_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check

2026-07-03 本地结果:完整 CTest 66/66 通过,0.4.1 Explosive 专项 gate 14/14 通过,source_size 1/1 通过,git diff --check 通过。

7.4 0.5.0 Release Gate

0.5.0 在 0.4.1 Explosive 稳定化 gate 基础上新增 Solid 起步闭环测试。默认 gate 继续覆盖既有 Water/Gas/Explosive/接口/restart/output/source-size 路径,并新增以下 Solid 专项 gate:

  • input_solid_material
  • input_solid_errors
  • solid_state_build
  • solid_elastic_material
  • solid_johnson_cook_flow
  • solid_johnson_cook_failure
  • solid_progressive_softening
  • solid_gradient_correction
  • solid_stable_dt
  • solid_explicit_smoke
  • solid_output
  • solid_restart_050
  • solid_restart_041_compat
  • solid_c_api
  • solid_python
  • solid_cli
  • solid_source_size

0.5.0 本地 release gate:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_explosive_multi_ignition|input_explosive_multimaterial|explosive_initial_mass_release|explosive_release_balance|explosive_source_targeting|explosive_phase_refresh|explosive_restart_041|explosive_restart_040_compat|explosive_restart_no_double_release|explosive_water_gas_smoke|explosive_release_c_api|explosive_release_python|explosive_release_cli|explosive_041_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_solid_material|input_solid_errors|solid_state_build|solid_elastic_material|solid_johnson_cook_flow|solid_johnson_cook_failure|solid_progressive_softening|solid_gradient_correction|solid_stable_dt|solid_explicit_smoke|solid_output|solid_restart_050|solid_restart_041_compat|solid_c_api|solid_python|solid_cli|solid_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check

2026-07-03 本地结果:完整 CTest 83/83 通过,0.4.1 Explosive 回归 gate 14/14 通过,0.5.0 Solid 专项 gate 17/17 通过,source_size 1/1 通过,git diff --check 通过。

0.5.0 不验收 Shell 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。

7.5 0.5.1 Release Gate

0.5.1 在 0.5.0 Solid 起步闭环 gate 基础上新增 Solid 稳定化和结构算法加固测试。默认 gate 继续覆盖既有 Water/Gas/Explosive/Solid/接口/restart/output/source-size 路径,并新增以下 Solid 0.5.1 专项 gate:

  • solid_051_input_validation
  • solid_reference_neighbor
  • solid_correction_matrix
  • solid_velocity_gradient
  • solid_strain_increment
  • solid_internal_force_pair
  • solid_uniform_stress_balance
  • solid_softening_force
  • solid_energy_diagnostics
  • solid_dt_acceleration
  • solid_restart_051
  • solid_restart_050_compat
  • solid_state_api
  • solid_python_051
  • solid_cli_051
  • solid_051_source_size

0.5.1 本地 release gate:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_solid_material|input_solid_errors|solid_state_build|solid_elastic_material|solid_johnson_cook_flow|solid_johnson_cook_failure|solid_progressive_softening|solid_gradient_correction|solid_stable_dt|solid_explicit_smoke|solid_output|solid_restart_050|solid_restart_041_compat|solid_c_api|solid_python|solid_cli|solid_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(solid_051_input_validation|solid_reference_neighbor|solid_correction_matrix|solid_velocity_gradient|solid_strain_increment|solid_internal_force_pair|solid_uniform_stress_balance|solid_softening_force|solid_energy_diagnostics|solid_dt_acceleration|solid_restart_051|solid_restart_050_compat|solid_state_api|solid_python_051|solid_cli_051|solid_051_source_size)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|solid_source_size|solid_051_source_size)$" --output-on-failure
git diff --check

2026-07-03 本地结果:完整 CTest 99/99 通过,0.5.0 Solid 回归 gate 17/17 通过,0.5.1 Solid 专项 gate 16/16 通过,source_size/solid_source_size/solid_051_source_size 3/3 通过,git diff --check 通过。

0.5.1 不验收 Shell 生产路径,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级结构破坏 benchmark。0.5.1 的 Solid gate 只证明参考构型、速度梯度、应变率、最小内力、诊断、restart 和接口可观测性在小型模型内闭合。

7.6 0.6.0 Release Gate

0.6.0 在 0.5.1 Solid 稳定化 gate 基础上启动 Shell 板壳粒子版本线。当前发布范围限定为 Shell 输入解析、Shell section 校验、粒子级状态数组和厚度积分点状态数组的基线验收;不把尚未完成的 director/转动更新、Mindlin-Reissner 应变路径、Shell 材料点更新、Shell 内力、显式推进、restart 或公开 API 纳入本次验收。

0.6.0 Shell 输入与状态基线专项 gate 包含:

  • input_shell_section
  • input_shell_errors
  • shell_state_build
  • shell_section_integration

0.6.0 本地 release gate:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
git diff --check

2026-07-03 本地结果:完整 CTest 103/103 通过,0.6.0 Shell 输入/状态基线专项 gate 4/4 通过,source_size 1/1 通过,git diff --check 通过。

0.6.0 不验收完整 Shell 动力学闭环,不验收真实水-气-结构工程爆炸响应,不验收真实 FEM-SPH 联合运行,也不验收工程级船舱破坏 benchmark。0.6.0 的 Shell gate 只证明 Shell material/section 输入、厚度/积分点/剪切修正校验、Shell 粒子状态数组和厚度积分点状态数组在小型模型内可构建、可检查。

7.7 0.6.1 Release Gate

0.6.1 在 0.6.0 Shell 输入与状态基线之上新增 director 输入/推断、局部坐标、转动状态、参考面积/惯量、Mindlin-Reissner 小变形膜/弯曲/横向剪切应变和厚度积分点应变增量映射。当前 gate 仍限定为小型运动学链路,不把 Shell 材料点更新、Shell 内力、Shell 内力矩、完整显式推进、restart、公开接口或工程响应纳入验收。

0.6.1 Shell 运动学专项 gate 包含:

  • input_shell_section
  • input_shell_errors
  • shell_state_build
  • shell_section_integration
  • shell_director_input
  • shell_reference_geometry
  • shell_director_update
  • shell_rotation_kinematics
  • shell_local_frame
  • shell_membrane_strain
  • shell_bending_strain
  • shell_shear_strain
  • shell_ip_strain_increment
  • shell_061_source_size

0.6.1 本地 release gate:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration|shell_director_input|shell_reference_geometry|shell_director_update|shell_rotation_kinematics|shell_local_frame|shell_membrane_strain|shell_bending_strain|shell_shear_strain|shell_ip_strain_increment)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|shell_061_source_size)$" --output-on-failure
git diff --check

2026-07-03 本地结果:完整 CTest 113/113 通过,0.6.1 Shell 运动学专项 gate 13/13 通过,source_size/shell_061_source_size 2/2 通过,git diff --check 通过。

0.6.1 不验收完整 Shell 动力学闭环,不验收 Shell 材料点更新、内力、内力矩、稳定时间步、显式推进生产路径、restart、公开 C ABI/C++/Python/CLI 诊断字段、真实水-气-结构工程爆炸响应、真实 FEM-SPH 联合运行或工程级船舱破坏 benchmark。

7.8 0.7.0 Release Gate

0.7.0 在 0.6.1 Shell 运动学基线之上新增水-气-结构局部爆炸 smoke 起点。该 gate 只验收小型 Water/Gas/Explosive/Solid/Shell 链路、局部爆炸输入控制、源/目标筛选、结构外载荷缓存、显式推进接入、诊断输出和 restart 边界,不验收真实工程级水下接触爆炸响应。

0.7.0 局部爆炸专项 gate 包含:

  • input_blast_region
  • input_blast_errors
  • blast_source_snapshot
  • blast_target_filter
  • blast_load_accumulator
  • blast_load_conservation
  • blast_solver_order
  • blast_solid_response
  • blast_shell_response
  • blast_noop_regression
  • blast_summary
  • blast_output
  • blast_restart_boundary
  • blast_smoke

0.7.0 本地 release gate:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_blast_region|input_blast_errors|blast_source_snapshot|blast_target_filter|blast_load_accumulator|blast_load_conservation|blast_solver_order|blast_solid_response|blast_shell_response|blast_noop_regression|blast_summary|blast_output|blast_restart_boundary|blast_smoke)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|explosive_source_size|explosive_041_source_size|gas_source_size_cleanup|solid_source_size|solid_051_source_size|shell_061_source_size)$" --output-on-failure
git diff --check

2026-07-03 本地结果:完整 CTest 127/127 通过,0.7.0 局部爆炸专项 gate 14/14 通过,source size 相关 gate 7/7 通过,git diff --check 通过。

0.7.0 不验收真实工程级水下接触爆炸响应,不验收真实 FEM-SPH 接触耦合或连续体耦合,不验收完整舱段破坏 benchmark,不验收复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。0.7.0 的局部爆炸诊断先提供 Fortran API 和 CSV 调试输出,不新增公开 C ABI/C++/Python 稳定接口,也不写入正式 STATE_0_7 restart。

7.9 0.7.1 Release Gate

0.7.1 在 0.7.0 局部爆炸 smoke 起点之上进行稳定化。该 gate 只验收多 blast region 输入、启用/禁用控制、源/目标统计、结构载荷叠加、显式推进顺序、输出字段、restart 边界和小模型 smoke,不验收真实工程级水下接触爆炸响应。

0.7.1 局部爆炸专项 gate 包含:

  • input_blast_multiregion
  • input_blast_region_errors_071
  • blast_multiregion_snapshot
  • blast_multiregion_target_filter
  • blast_load_superposition
  • blast_load_diagnostics_071
  • blast_solver_order_071
  • blast_response_multiregion
  • blast_noop_regression_071
  • blast_output_071
  • blast_restart_boundary_071
  • blast_smoke_071

0.7.1 本地 release gate:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(water_eos|water_density|water_viscosity|water_force|solver_water|pressure_wave_smoke)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_gas|input_gas_multimaterial|gas_eos_ideal|gas_eos_jwl|gas_eos_stiffened|gas_eos_dispatch|gas_state|gas_summary|gas_extended_summary|gas_source|gas_source_errors|solver_gas|gas_output|gas_restart|gas_restart_031|gas_restart_030_compat)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_explosive|input_explosive_errors|input_explosive_multi_ignition|input_explosive_multimaterial|explosive_detonation_time|explosive_reaction_progress|explosive_initial_mass_release|explosive_release_balance|explosive_release_source|explosive_source_targeting|explosive_to_gas_phase|explosive_phase_refresh|explosive_gas_coupling|explosive_water_gas_smoke|explosive_summary|explosive_restart_040|explosive_restart_041|explosive_restart_040_compat|explosive_restart_no_double_release|explosive_restart_031_compat|explosive_c_api|explosive_release_c_api|explosive_release_cpp_api|explosive_python|explosive_release_python|explosive_cli|explosive_release_cli)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_solid_material|input_solid_errors|solid_051_input_validation|solid_state_build|solid_elastic_material|solid_johnson_cook_flow|solid_johnson_cook_failure|solid_progressive_softening|solid_gradient_correction|solid_reference_neighbor|solid_correction_matrix|solid_velocity_gradient|solid_strain_increment|solid_internal_force_pair|solid_uniform_stress_balance|solid_softening_force|solid_energy_diagnostics|solid_dt_acceleration|solid_stable_dt|solid_explicit_smoke|solid_output|solid_state_api|solid_restart_050|solid_restart_051|solid_restart_050_compat|solid_restart_041_compat|solid_c_api|solid_python|solid_python_051|solid_cli|solid_cli_051)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_shell_section|input_shell_errors|shell_state_build|shell_section_integration|shell_director_input|shell_reference_geometry|shell_director_update|shell_rotation_kinematics|shell_local_frame|shell_membrane_strain|shell_bending_strain|shell_shear_strain|shell_ip_strain_increment)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_blast_region|input_blast_errors|blast_source_snapshot|blast_target_filter|blast_load_accumulator|blast_load_conservation|blast_solver_order|blast_solid_response|blast_shell_response|blast_noop_regression|blast_summary|blast_output|blast_restart_boundary|blast_smoke)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(input_blast_multiregion|input_blast_region_errors_071|blast_multiregion_snapshot|blast_multiregion_target_filter|blast_load_superposition|blast_load_diagnostics_071|blast_solver_order_071|blast_response_multiregion|blast_noop_regression_071|blast_output_071|blast_restart_boundary_071|blast_smoke_071)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|explosive_source_size|explosive_041_source_size|gas_source_size_cleanup|solid_source_size|solid_051_source_size|shell_061_source_size)$" --output-on-failure
git diff --check

2026-07-04 本地结果:完整 CTest 139/139 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、16/16、27/27、31/31、13/13 通过,0.7.0 blast 回归 gate 14/14 通过,0.7.1 blast 专项 gate 12/12 通过,source size 相关 gate 7/7 通过,git diff --check 通过。

0.7.1 不验收真实工程级水下接触爆炸响应,不验收真实 FEM-SPH 接触耦合或连续体耦合,不验收完整舱段破坏 benchmark,不验收复杂撕裂、穿孔、碎片云、焊缝失效库、大规模并行或 GPU 后端。0.7.1 的 Blast 诊断仍限定为 Fortran 内部查询和 CSV 调试边界,不新增公开 C ABI/C++/Python 稳定接口,也不写入新的正式 restart state。

7.10 0.8.0 Release Gate

0.8.0 在 0.7.1 局部爆炸稳定化版本之上交付 SPHLite 侧中立接触耦合接口。该 gate 验收 coupling region 输入、粒子/Facet Proxy 导出、外部粒子力、facet load、运动边界、显式步响应、diagnostics、STATE_0_8 restart、C ABI/C++/Python/CLI 接口和 mock coupling smoke。

0.8.0 coupling 专项 gate 包含:

  • input_coupling_region_080
  • input_coupling_errors_080
  • coupling_region_build_080
  • coupling_particle_export_080
  • coupling_facet_export_080
  • coupling_facet_errors_080
  • coupling_particle_force_import_080
  • coupling_facet_load_import_080
  • coupling_motion_boundary_080
  • coupling_diagnostics_080
  • coupling_solver_order_080
  • coupling_solid_response_080
  • coupling_shell_response_080
  • coupling_noop_regression_080
  • coupling_output_080
  • coupling_restart_080
  • coupling_restart_071_compat
  • coupling_fortran_api_080
  • coupling_c_api_080
  • coupling_cpp_api_080
  • coupling_python_080
  • coupling_cli_080
  • coupling_smoke_080
  • coupling_source_size_080

0.8.0 本地 release gate:

cmake --build build-codex-unix
ctest --test-dir build-codex-unix -R "^(input_coupling_region_080|input_coupling_errors_080|coupling_region_build_080|coupling_particle_export_080|coupling_facet_export_080|coupling_facet_errors_080|coupling_particle_force_import_080|coupling_facet_load_import_080|coupling_motion_boundary_080|coupling_diagnostics_080|coupling_solver_order_080|coupling_solid_response_080|coupling_shell_response_080|coupling_noop_regression_080|coupling_restart_080|coupling_restart_071_compat|coupling_output_080|coupling_fortran_api_080|coupling_c_api_080|coupling_cpp_api_080|coupling_python_080|coupling_cli_080|coupling_smoke_080|coupling_source_size_080)$" --output-on-failure
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|explosive_source_size|explosive_041_source_size|gas_source_size_cleanup|solid_source_size|solid_051_source_size|shell_061_source_size|coupling_source_size_080)$" --output-on-failure
git diff --check

2026-07-04 本地结果:完整 CTest 163/163 通过,0.8.0 coupling 专项 gate 24/24 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、28/28、33/33、14/14 通过,0.7.0 blast 回归 gate 19/19 通过,0.7.1 blast 专项 gate 7/7 通过,source size 相关 gate 8/8 通过,git diff --check 通过。

0.8.0 不验收真实 FEMLite 联合运行,不验收外部 CouplingModule/CoupleLite/CoupledLite/CouplingLite,不验收连续体一部分 FEM 一部分 SPH 的生产级连续体耦合,不验收工程级船舶水下接触爆炸舱段破坏 benchmark,不验收复杂接触搜索、真实接触约束求解、大规模并行或 GPU 后端。

7.11 0.8.1 Release Gate

0.8.1 默认 gate 在 0.8.0 中立接触耦合接口基础上做稳定化。该 gate 只验收 SPHLite 侧小型、可重复 mock coupling 链路、载荷分配、接触诊断、输出、restart 和接口契约,不验收真实 FEMLite 联合运行、外部 CouplingModule/CoupleLite/CoupledLite/CouplingLite、连续体耦合或工程级船舶水下接触爆炸破坏 benchmark。

0.8.1 coupling 专项测试:

  • input_coupling_load_mode_081
  • input_coupling_load_errors_081
  • coupling_contact_state_081
  • coupling_facet_pressure_081
  • coupling_facet_traction_081
  • coupling_facet_resultant_081
  • coupling_distribution_uniform_081
  • coupling_distribution_area_081
  • coupling_distribution_mass_081
  • coupling_load_balance_081
  • coupling_contact_diagnostics_081
  • coupling_solver_order_081
  • coupling_stale_epoch_081
  • coupling_solid_surface_pressure_081
  • coupling_shell_pressure_081
  • coupling_mixed_pressure_motion_081
  • coupling_output_081
  • coupling_restart_081
  • coupling_restart_080_compat
  • coupling_fortran_api_081
  • coupling_c_api_081
  • coupling_cpp_api_081
  • coupling_python_081
  • coupling_cli_081
  • coupling_smoke_081
  • coupling_source_size_081

0.8.1 本地 release gate:

cmake --build build-codex-unix --parallel
ctest --test-dir build-codex-unix -R "^(input_coupling_load_mode_081|input_coupling_load_errors_081|coupling_contact_state_081|coupling_facet_pressure_081|coupling_facet_traction_081|coupling_facet_resultant_081|coupling_distribution_uniform_081|coupling_distribution_area_081|coupling_distribution_mass_081|coupling_load_balance_081|coupling_contact_diagnostics_081|coupling_solver_order_081|coupling_stale_epoch_081|coupling_solid_surface_pressure_081|coupling_shell_pressure_081|coupling_mixed_pressure_motion_081|coupling_output_081|coupling_restart_081|coupling_restart_080_compat|coupling_fortran_api_081|coupling_c_api_081|coupling_cpp_api_081|coupling_python_081|coupling_cli_081|coupling_smoke_081|coupling_source_size_081)$" --output-on-failure
ctest --test-dir build-codex-unix --output-on-failure
ctest --test-dir build-codex-unix -R "^(source_size|explosive_source_size|explosive_041_source_size|gas_source_size_cleanup|solid_source_size|solid_051_source_size|shell_061_source_size|coupling_source_size_080|coupling_source_size_081)$" --output-on-failure
git diff --check

2026-07-04 本地结果:完整 CTest 189/189 通过,0.8.1 coupling 专项 gate 26/26 通过,0.8.0 coupling 回归 gate 24/24 通过,Water/Gas/Explosive/Solid/Shell 分类 gate 6/6、19/19、29/29、33/33、14/14 通过,0.7.0 blast 回归 gate 15/15 通过,0.7.1 blast 专项 gate 11/11 通过,source size 相关 gate 9/9 通过,git diff --check 通过。代码、构建脚本、测试和工具目录未新增 FEMLite 直接依赖,输出目录、CSV、VTK、restart 和临时结果未进入待提交清单。

0.8.1 不验收真实 FEMLite 联合运行,不验收外部 CouplingModule/CoupleLite/CoupledLite/CouplingLite,不验收连续体一部分 FEM 一部分 SPH 的生产级连续体耦合,不验收工程级船舶水下接触爆炸舱段破坏 benchmark,不验收生产级接触搜索、接触约束、摩擦、复杂撕裂/穿孔/碎片云、焊缝失效库、大规模并行或 GPU 后端。

7.12 0.8.3 CCLite Worker Release Gate

0.8.3 worker gate 用于 CCLite 集成加固。验收对象是 worker CLI 参数、capabilities 查询、状态/命令枚举、IPC adapter mock、Windows shared memory/named event self-test、命令到 SPHLite API 的映射表、AOR v1 数据契约、worker 诊断文件和 CCLite mock command/data block 闭环。

专项测试:

  • worker_protocol
  • worker_cli
  • worker_ipc
  • worker_ipc_selftest
  • worker_dispatch
  • worker_contract
  • worker_blocks
  • worker_reports
  • worker_runtime_reports
  • worker_mock
  • input_cclite_082

建议命令:

ctest --test-dir build-codex-unix -R "^(worker_protocol|worker_cli|worker_ipc|worker_ipc_selftest|worker_dispatch|worker_contract|worker_blocks|worker_reports|worker_runtime_reports|worker_mock|input_cclite_082)$" --output-on-failure
ctest --test-dir build-codex-unix -R "^(worker|coupling_.*_08[01]|coupling_source_size_08[01])" --output-on-failure

2026-07-05 本地结果:完整 CTest 200/200 通过,worker/coupling 专项 gate 55/55 通过,source size 相关 gate 9/9 通过,git diff --check 通过。无限水域爆炸示例脚本生成 VTU/PVD,tools/publish_to_cclite.bat -TargetRoot ..\CCLite\SPHLite 实际发布通过。

该 gate 已验收 SPHLite 侧 Windows shared memory/named event self-test,但不验收真实外部 CCLite 进程联调,不验收 FEM-SPH 接触搜索、接触约束、摩擦、tied/release 物理作用或生产级 FSI。

8. Source Size 门禁

从第一版开始设置 source size 门禁。建议沿用 FEMLite 风格:

  • 普通过程设置 review target 和 hard limit。
  • 普通源文件设置 review target 和 hard limit。
  • 必要例外登记到例外清单。
  • stale exception 应被检查。

0.6.1 当前新增 Shell 运动学路径,src/shell/sph_shell.f90 暂作为 Shell 输入、状态和运动学 owner 登记说明性例外,并新增 shell_061_source_size gate 保持 stale exception 检查。后续进入 Shell 材料点、内力、restart 或接口层前,应优先拆分 Shell geometry/kinematics/diagnostics 模块,减少主文件例外范围。src/solid/sph_solid.f90 继续作为 Solid 输入/material 表 owner,并在例外清单中登记说明;后续若拆分 Solid material ownership 应同步移除此例外。

具体阈值可在实现阶段与 FEMLite 保持一致或按 SPHLite 文件结构微调。

9. 非默认长跑和研究项

以下内容不进入默认 release gate:

  • 自由场水下爆炸工程曲线。
  • 气泡多周期脉动。
  • 板壳穿孔、撕裂和碎片云。
  • 舱段局部水下接触爆炸破坏。
  • FEM-SPH 联合长算例。
  • 大规模粒子数性能测试。
  • 近场强冲击 Riemann-SPH 对比。
  • 多材料复杂断裂和焊缝失效。

这些内容应作为非默认 benchmark、研究项或外部集成测试维护,并配套独立 checker 和运行说明。

10. 文档与产物检查

发布前必须确认:

  • README 和 01-11 文档与当前版本能力一致。
  • 默认 gate 结果写入版本历史和 benchmark 矩阵。
  • 输出目录、CSV、VTK、restart 和大型临时结果不提交。
  • Python 生成器仅作为测试/示例辅助工具,不宣传为求解器几何或粒子生成功能。
  • 文档使用 UTF-8 without BOM。

11. 待讨论问题

  • 0.1 source size 具体阈值。
  • 第一批 CTest 测试名称和 label。
  • Python checker 的目录组织。
  • 非默认 benchmark 的运行入口和命名。
  • 外部集成测试与 CouplingModule 仓库的边界。