Start SPHLite 0.2.1 hardening
This commit is contained in:
+2
-2
@@ -1,6 +1,6 @@
|
|||||||
cmake_minimum_required(VERSION 3.20)
|
cmake_minimum_required(VERSION 3.20)
|
||||||
|
|
||||||
project(SPHLite VERSION 0.2.0 LANGUAGES C CXX Fortran)
|
project(SPHLite VERSION 0.2.1 LANGUAGES C CXX Fortran)
|
||||||
|
|
||||||
set(CMAKE_C_STANDARD 99)
|
set(CMAKE_C_STANDARD 99)
|
||||||
set(CMAKE_C_STANDARD_REQUIRED ON)
|
set(CMAKE_C_STANDARD_REQUIRED ON)
|
||||||
@@ -215,7 +215,7 @@ add_test(
|
|||||||
COMMAND "${Python3_EXECUTABLE}"
|
COMMAND "${Python3_EXECUTABLE}"
|
||||||
"${CMAKE_CURRENT_SOURCE_DIR}/tools/testing/test_cli.py"
|
"${CMAKE_CURRENT_SOURCE_DIR}/tools/testing/test_cli.py"
|
||||||
--exe "$<TARGET_FILE:sphlite>"
|
--exe "$<TARGET_FILE:sphlite>"
|
||||||
--input "${CMAKE_CURRENT_SOURCE_DIR}/tests/data/water_minimal_020.inp"
|
--input "${CMAKE_CURRENT_SOURCE_DIR}/tests/data/water_minimal_021.inp"
|
||||||
--bad-input "${CMAKE_CURRENT_SOURCE_DIR}/tests/data/water_missing_eos_020.inp"
|
--bad-input "${CMAKE_CURRENT_SOURCE_DIR}/tests/data/water_missing_eos_020.inp"
|
||||||
--output-dir "${CMAKE_BINARY_DIR}"
|
--output-dir "${CMAKE_BINARY_DIR}"
|
||||||
)
|
)
|
||||||
|
|||||||
@@ -33,6 +33,13 @@ class SPHLite:
|
|||||||
self.lib.sphlite_initialize.restype = ctypes.c_int
|
self.lib.sphlite_initialize.restype = ctypes.c_int
|
||||||
self.lib.sphlite_finalize.restype = ctypes.c_int
|
self.lib.sphlite_finalize.restype = ctypes.c_int
|
||||||
|
|
||||||
|
self.lib.sphlite_get_version.argtypes = [
|
||||||
|
ctypes.POINTER(ctypes.c_int),
|
||||||
|
ctypes.POINTER(ctypes.c_int),
|
||||||
|
ctypes.POINTER(ctypes.c_int),
|
||||||
|
]
|
||||||
|
self.lib.sphlite_get_version.restype = ctypes.c_int
|
||||||
|
|
||||||
self.lib.sphlite_read_inp.argtypes = [ctypes.c_char_p]
|
self.lib.sphlite_read_inp.argtypes = [ctypes.c_char_p]
|
||||||
self.lib.sphlite_read_inp.restype = ctypes.c_int
|
self.lib.sphlite_read_inp.restype = ctypes.c_int
|
||||||
|
|
||||||
@@ -118,6 +125,17 @@ class SPHLite:
|
|||||||
def finalize(self) -> None:
|
def finalize(self) -> None:
|
||||||
self._check(self.lib.sphlite_finalize())
|
self._check(self.lib.sphlite_finalize())
|
||||||
|
|
||||||
|
def version(self) -> tuple[int, int, int]:
|
||||||
|
major = ctypes.c_int(0)
|
||||||
|
minor = ctypes.c_int(0)
|
||||||
|
patch = ctypes.c_int(0)
|
||||||
|
self._check(self.lib.sphlite_get_version(
|
||||||
|
ctypes.byref(major),
|
||||||
|
ctypes.byref(minor),
|
||||||
|
ctypes.byref(patch),
|
||||||
|
))
|
||||||
|
return int(major.value), int(minor.value), int(patch.value)
|
||||||
|
|
||||||
def read_inp(self, filename: str | Path) -> None:
|
def read_inp(self, filename: str | Path) -> None:
|
||||||
encoded = str(Path(filename)).encode("utf-8")
|
encoded = str(Path(filename)).encode("utf-8")
|
||||||
self._check(self.lib.sphlite_read_inp(encoded))
|
self._check(self.lib.sphlite_read_inp(encoded))
|
||||||
|
|||||||
@@ -0,0 +1,526 @@
|
|||||||
|
# SPHLite v2.1 开发计划
|
||||||
|
|
||||||
|
文档状态:0.2.1 开发计划草案
|
||||||
|
|
||||||
|
目标软件版本:SPHLite 0.2.1
|
||||||
|
|
||||||
|
依据文档:
|
||||||
|
- `01_requirements_specification.md`
|
||||||
|
- `02_software_architecture_design.md`
|
||||||
|
- `03_detailed_design.md`
|
||||||
|
- `04_mathematical_model_and_algorithms.md`
|
||||||
|
- `05_interface_control_document.md`
|
||||||
|
- `06_test_and_verification_plan.md`
|
||||||
|
- `v2.0_development_plan.md`
|
||||||
|
|
||||||
|
## 1. 版本定位
|
||||||
|
|
||||||
|
SPHLite 0.2.1 是 0.2 系列的 Water 加固版本,定位为 0.2.0 基础水相弱可压 SPH 最小闭环之后的可靠性、可验证性和接口一致性增强。
|
||||||
|
|
||||||
|
0.2.0 已经打通以下最小计算链路:
|
||||||
|
|
||||||
|
```text
|
||||||
|
输入粒子状态 -> 构建邻域 -> 核函数 -> Tait EOS -> 连续性方程
|
||||||
|
-> 压力/人工黏性/外载 -> Velocity-Verlet -> 输出/restart/API/CLI/checker
|
||||||
|
```
|
||||||
|
|
||||||
|
0.2.1 不改变 0.2 系列的物理边界,不提前进入 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径。该版本的核心目标是让 0.2.0 已有 Water 路径更稳、更可诊断、更适合后续 0.3 `Gas` 开发承接。
|
||||||
|
|
||||||
|
0.2.1 应重点回答以下问题:
|
||||||
|
- Water 输入错误是否足够早、足够清楚地暴露。
|
||||||
|
- Water 显式步是否能在更多小型 3D 排布下保持有限、可重复、可 restart。
|
||||||
|
- kernel、neighbor、dt、output、restart、API、CLI 是否形成稳定契约。
|
||||||
|
- CouplingInterface 是否足够中立,能承接后续外部 CouplingModule,但不引入 FEMLite 源码依赖。
|
||||||
|
- 默认 release gate 是否仍然小规模、快速、稳定。
|
||||||
|
|
||||||
|
## 2. 版本目标
|
||||||
|
|
||||||
|
0.2.1 应完成:
|
||||||
|
|
||||||
|
- 将软件版本更新为 `0.2.1`。
|
||||||
|
- 加固 0.2.0 Water 输入解析和错误诊断。
|
||||||
|
- 加固 `*SPHLITE EOS`、`*SPHLITE VISCOSITY`、`*SPHLITE PARTICLE CONTROL`、`*SPHLITE BODY FORCE` 的字段校验。
|
||||||
|
- 明确 unsupported-but-safe 输入项继续 warning,无法运行的缺失或非法参数继续 error。
|
||||||
|
- 加固 Tait EOS 在边界密度、低密度、负压或极端参数下的错误路径和有限性检查。
|
||||||
|
- 加固 Monaghan 人工黏性在接近、远离、零距离、非 Water 粒子和 inactive 粒子路径下的行为。
|
||||||
|
- 加固连续性方程和压力力计算的对称性、有限性和跳过规则。
|
||||||
|
- 加固 uniform cell/bin 邻域重建在小粒子数、稀疏粒子、重复坐标、不同 `h(i)` 和边界 cell 下的行为。
|
||||||
|
- 加固稳定时间步估计,明确 CFL、加速度和黏性约束的诊断输出。
|
||||||
|
- 加固 Velocity-Verlet 显式步错误路径,尤其是未 build、非法 dt、非法 Water 状态、restart 后继续推进。
|
||||||
|
- 加固 output 和 restart,使 0.2.1 Water 状态可恢复、可检查、可用于后续版本兼容策略。
|
||||||
|
- 加固 Fortran API、C ABI、C++ wrapper、Python `ctypes` 和 CLI 的 Water 诊断契约。
|
||||||
|
- 扩展 pressure wave smoke,使其更明确地检查方向、有限性、质量趋势、动量趋势和输出字段。
|
||||||
|
- 保持 source size、文档同步和 release gate 记录。
|
||||||
|
|
||||||
|
## 3. 明确不交付范围
|
||||||
|
|
||||||
|
0.2.1 不交付:
|
||||||
|
|
||||||
|
- 生产级水下接触爆炸模拟。
|
||||||
|
- Riemann-SPH、Godunov-SPH 或高阶强冲击格式。
|
||||||
|
- 真实 `Gas` EOS 计算、气体团簇、气泡脉动和气泡界面演化。
|
||||||
|
- `Explosive` 解析点火、programmed burn、反应进度和向 `Gas` 的源项注入。
|
||||||
|
- `Solid` 3D 结构应力更新、Johnson-Cook 材料和失效模型。
|
||||||
|
- `Shell` Mindlin-Reissner 板壳计算。
|
||||||
|
- 水-气、水-结构、气-结构的生产级相互作用。
|
||||||
|
- 外部 CouplingModule、CoupleLite、CoupledLite 或 CouplingLite。
|
||||||
|
- 与 FEMLite 的联合运行。
|
||||||
|
- 几何、网格或粒子生成能力。
|
||||||
|
- 大规模并行、GPU 后端和性能优化专项。
|
||||||
|
- 工程 benchmark 和长跑算例。
|
||||||
|
|
||||||
|
0.2.1 可以继续保留后续模块的目录、常量、占位状态和接口边界,但不得把占位能力描述为已实现物理算法。
|
||||||
|
|
||||||
|
## 4. 继承 0.2.0 的基线
|
||||||
|
|
||||||
|
0.2.1 以 0.2.0 发布状态为基线,默认继承:
|
||||||
|
|
||||||
|
- Fortran 95 核心库。
|
||||||
|
- C ABI、C++ 薄包装、Python `ctypes` 调试入口和 CLI。
|
||||||
|
- Abaqus `.inp` 明确子集解析。
|
||||||
|
- 统一集中型 `Database`。
|
||||||
|
- `Water` 基础弱可压 SPH 路径。
|
||||||
|
- Wendland C2、Wendland C4 和 cubic spline 核函数。
|
||||||
|
- uniform cell/bin 邻域搜索。
|
||||||
|
- Tait EOS。
|
||||||
|
- Monaghan 人工黏性。
|
||||||
|
- 连续性方程密度演化。
|
||||||
|
- Velocity-Verlet 显式推进。
|
||||||
|
- Water summary、dt limits、CSV output、restart 和 pressure wave smoke。
|
||||||
|
- CouplingInterface 中立数据导出、外部粒子力导入和诊断占位。
|
||||||
|
- 0.2.0 release gate。
|
||||||
|
|
||||||
|
0.2.1 不应重写 0.2.0 架构。除非测试证明存在实际问题,否则只做局部加固、接口补全和测试覆盖。
|
||||||
|
|
||||||
|
## 5. 输入解析加固范围
|
||||||
|
|
||||||
|
0.2.1 继续遵守:
|
||||||
|
|
||||||
|
- SPHLite 是求解器,不负责几何、网格或粒子生成。
|
||||||
|
- 输入采用 Abaqus `.inp` 明确子集。
|
||||||
|
- 能复用 Abaqus 关键词时不新增关键词。
|
||||||
|
- Abaqus 无法表达的专有能力使用 `*SPHLITE ...` 扩展关键词。
|
||||||
|
- set 只表示集合,不作为物理类型判断依据。
|
||||||
|
- material 决定物理材料类型和 EOS 参数。
|
||||||
|
- section 决定实体或板壳相关 section 属性。
|
||||||
|
- 单位系统由用户保持一致,SPHLite 不做内置单位换算。
|
||||||
|
|
||||||
|
0.2.1 建议加固以下输入路径:
|
||||||
|
|
||||||
|
- `*MATERIAL, TYPE=WATER` 大小写兼容。
|
||||||
|
- Water material 与 `*DENSITY` 的匹配关系。
|
||||||
|
- `*SECTION` 指向不存在 material 时的 error。
|
||||||
|
- `*SPHLITE EOS` 缺失 `TYPE`、`MATERIAL`、`RHO0`、`C0`、`GAMMA` 时的 error。
|
||||||
|
- `*SPHLITE EOS, TYPE=TAIT` 以外类型在 0.2.1 中应 error 或明确 warning 后不进入 Water 计算。
|
||||||
|
- `B` 未给定时继续由 `rho0*c0*c0/gamma` 推导。
|
||||||
|
- `B` 给定但非法时 error。
|
||||||
|
- `*SPHLITE VISCOSITY` 缺失 `TYPE`、`MATERIAL`、`ALPHA`、`BETA`、`ETA2` 时的 error。
|
||||||
|
- `*SPHLITE PARTICLE CONTROL` 中 `H`、`MASS`、`VOLUME` 的正值校验。
|
||||||
|
- `*SPHLITE BODY FORCE` 三维分量解析和非法字段 error。
|
||||||
|
- `*SPHLITE TIME CONTROL` 中 `DT`、`TIME`、`STEPS`、`SAFETY` 的正值和一致性校验。
|
||||||
|
- 未知但不影响运行的 `*SPHLITE ...` 子关键词 warning。
|
||||||
|
- 错误消息继续包含文件名、行号或足够定位的上下文。
|
||||||
|
|
||||||
|
## 6. Database 和运行时状态加固
|
||||||
|
|
||||||
|
0.2.1 不新增新的粒子对象模型,继续使用集中型数组数据库。
|
||||||
|
|
||||||
|
建议确认或加固:
|
||||||
|
|
||||||
|
- `particle_id_ext` 在重复输入、restart 读回和 API 查询中保持稳定。
|
||||||
|
- `particle_phase`、`particle_status`、`material_id`、`section_id` 在 build model 后一致。
|
||||||
|
- `x0`、`x`、`v`、`a`、`vhalf`、`mass`、`rho`、`volume`、`pressure`、`temperature`、`h` 在初始化、finalize、重复读取、restart 读回后状态一致。
|
||||||
|
- `drho_dt`、`acc_pressure`、`acc_viscosity`、`acc_body` 在每步计算前正确清零或保留应保留状态。
|
||||||
|
- Water 诊断量在 build、advance、run、restart read 后可重复计算。
|
||||||
|
- 非 Water 粒子默认跳过 Water 计算,但仍保持通用粒子状态可查询。
|
||||||
|
- inactive 或 failed 粒子不参与 Water 相互作用。
|
||||||
|
|
||||||
|
0.2.1 可以增加小型内部一致性检查,但不应引入大规模内存管理重构。
|
||||||
|
|
||||||
|
## 7. Kernel 加固范围
|
||||||
|
|
||||||
|
0.2.1 继续沿用:
|
||||||
|
|
||||||
|
- 默认 Wendland C2。
|
||||||
|
- 可选 Wendland C4。
|
||||||
|
- cubic spline 用于对比和回归测试。
|
||||||
|
- 每粒子独立 `h(i)`。
|
||||||
|
- 3D 归一化。
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- `h <= 0` 明确 error。
|
||||||
|
- 未知 kernel type 明确 error。
|
||||||
|
- `r = 0` 时梯度有限并返回零向量。
|
||||||
|
- `r` 接近支持半径时值和梯度有限。
|
||||||
|
- 超出支持半径时 `W = 0` 且 `grad W = 0`。
|
||||||
|
- 对称粒子对梯度反对称。
|
||||||
|
- 不同 `h(i)` 结果有限。
|
||||||
|
- kernel 相关测试不变成长跑积分精度 benchmark。
|
||||||
|
|
||||||
|
## 8. Neighbor 加固范围
|
||||||
|
|
||||||
|
0.2.1 继续使用 uniform cell/bin,不引入树结构和并行优化。
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- 空模型邻域构建。
|
||||||
|
- 单粒子邻域构建。
|
||||||
|
- 两粒子刚好在支持半径内外的边界判断。
|
||||||
|
- 重复坐标或极近坐标粒子的稳定处理。
|
||||||
|
- 负坐标粒子。
|
||||||
|
- 稀疏粒子导致大包围盒时的 cell 维度控制。
|
||||||
|
- 不同 `h(i)` 对搜索半径的影响。
|
||||||
|
- 粒子移动后重建邻域。
|
||||||
|
- 邻域容量不足时的明确 error。
|
||||||
|
- 邻域统计 API 的最大邻居数和平均邻居数。
|
||||||
|
|
||||||
|
0.2.1 默认 gate 只保留小规模邻域测试,不引入性能基准。
|
||||||
|
|
||||||
|
## 9. Water 算法加固范围
|
||||||
|
|
||||||
|
### 9.1 Tait EOS
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- `rho = rho0` 时压力接近 `p0`。
|
||||||
|
- `rho > rho0` 时压力增加。
|
||||||
|
- `rho < rho0` 时压力策略明确。
|
||||||
|
- `rho <= 0` 时 error。
|
||||||
|
- `rho0 <= 0`、`c0 <= 0`、`gamma <= 0`、`B <= 0` 时 error。
|
||||||
|
- 声速或等效声速诊断保持正值。
|
||||||
|
- 压力结果有限。
|
||||||
|
|
||||||
|
0.2.1 不要求实现完整拉伸不稳定控制,但应在文档和测试中明确当前策略。
|
||||||
|
|
||||||
|
### 9.2 连续性方程
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- 双粒子压缩时 `drho_dt` 符号正确。
|
||||||
|
- 双粒子拉伸时 `drho_dt` 符号正确。
|
||||||
|
- 静止均匀粒子组密度变化接近零。
|
||||||
|
- 非 Water 粒子跳过贡献。
|
||||||
|
- inactive 粒子跳过贡献。
|
||||||
|
- `drho_dt` 每步正确重置。
|
||||||
|
- 结果有限。
|
||||||
|
|
||||||
|
### 9.3 人工黏性
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- 接近粒子产生黏性贡献。
|
||||||
|
- 远离粒子默认不产生压缩型人工黏性贡献。
|
||||||
|
- 零距离或极小距离保持有限。
|
||||||
|
- `alpha`、`beta`、`eta2` 非法时 error。
|
||||||
|
- 黏性加速度对称性或动量趋势检查。
|
||||||
|
- 非 Water 和 inactive 粒子跳过。
|
||||||
|
|
||||||
|
### 9.4 压力力和外载
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- 双粒子压力力方向正确。
|
||||||
|
- 均匀压力或零压力的净力趋势合理。
|
||||||
|
- `acc_pressure`、`acc_viscosity`、`acc_body` 的合成顺序明确。
|
||||||
|
- `*SPHLITE BODY FORCE` 对速度方向有可验证影响。
|
||||||
|
- CouplingInterface 导入的粒子力能进入显式步外载占位。
|
||||||
|
- 非 Water 和 inactive 粒子跳过 Water 力。
|
||||||
|
|
||||||
|
## 10. Solver 和时间步加固范围
|
||||||
|
|
||||||
|
0.2.1 继续只支持显式动力学和 Velocity-Verlet,不增加 implicit、static 或 nonlinear static 接口。
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- 未 initialize 调用显式步返回 state error。
|
||||||
|
- 未 build model 调用显式步返回 state error。
|
||||||
|
- `dt <= 0` 返回 argument error。
|
||||||
|
- Water 状态非法时 stable dt 返回明确 error。
|
||||||
|
- `sph_estimate_stable_dt` 同时保存并返回 CFL、加速度和黏性约束贡献。
|
||||||
|
- 安全系数 `SAFETY` 只在正值时生效。
|
||||||
|
- `sph_run_explicit` 在 `TIME`、`STEPS` 双约束下行为明确。
|
||||||
|
- 最后一小步不超过 `end_time`。
|
||||||
|
- 自动输出只在启用输出且满足间隔时发生。
|
||||||
|
- restart 读回后可继续显式步并保持时间、步号和诊断合理。
|
||||||
|
|
||||||
|
## 11. Output 和 Restart 加固范围
|
||||||
|
|
||||||
|
0.2.1 继续使用 CSV 作为默认 gate 输出,不要求新增 VTK 生产输出。
|
||||||
|
|
||||||
|
输出建议加固:
|
||||||
|
|
||||||
|
- 粒子 CSV 包含 id、phase、status、material、section、x、v、rho、pressure、temperature、h。
|
||||||
|
- summary CSV 包含 step、time、water mass、water momentum、max pressure、min/max density、dtcrit。
|
||||||
|
- 输出目录不存在或非法时 error。
|
||||||
|
- 手动 `sph_write_output` 不改变物理状态。
|
||||||
|
- CLI `--run --output` 使用实际 step/time 写出。
|
||||||
|
|
||||||
|
restart 建议加固:
|
||||||
|
|
||||||
|
- restart header 版本可识别。
|
||||||
|
- 写入并读回 current time、step、output control、safety factor。
|
||||||
|
- 写入并读回 Water EOS、viscosity、body force。
|
||||||
|
- 写入并读回粒子通用状态、rho、pressure、h、v、a、vhalf。
|
||||||
|
- 写入并读回 Water 诊断状态。
|
||||||
|
- 读回后重建邻域。
|
||||||
|
- 读回后继续执行 Water 显式步。
|
||||||
|
- 非法 restart 文件明确 error。
|
||||||
|
- 0.2.1 可以保持只兼容当前 restart 格式,但应在文档中记录格式版本策略。
|
||||||
|
|
||||||
|
## 12. Fortran API 范围
|
||||||
|
|
||||||
|
0.2.1 应保持 0.2.0 Fortran API 兼容。
|
||||||
|
|
||||||
|
必须继续可用:
|
||||||
|
|
||||||
|
- 生命周期。
|
||||||
|
- `.inp` 读取。
|
||||||
|
- build model。
|
||||||
|
- stable dt。
|
||||||
|
- advance/run explicit。
|
||||||
|
- current time。
|
||||||
|
- particle count/state。
|
||||||
|
- output/restart。
|
||||||
|
- error query。
|
||||||
|
- neighbor rebuild 和 neighbor stats。
|
||||||
|
- water summary。
|
||||||
|
- water dt limits。
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- 每个新增或已有公开 API 的未初始化错误路径。
|
||||||
|
- 每个依赖模型的 API 的未 build 错误路径。
|
||||||
|
- 输出参数在错误返回前给出安全默认值。
|
||||||
|
- API 不暴露内部 allocatable 数组指针。
|
||||||
|
- Fortran API 仍作为物理语义来源。
|
||||||
|
|
||||||
|
## 13. C ABI、C++ 和 Python 范围
|
||||||
|
|
||||||
|
C ABI 必须保持 0.2.0 兼容。
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- `sphlite_get_water_summary` 空指针返回 `-1`。
|
||||||
|
- `sphlite_get_water_dt_limits` 空指针返回 `-1`。
|
||||||
|
- Fortran 错误码原样返回 C 调用方。
|
||||||
|
- `sphlite_get_particle_state` 小容量和空指针错误路径。
|
||||||
|
- C wrapper 不重新定义物理语义。
|
||||||
|
- C++ wrapper 只做 RAII 和薄封装。
|
||||||
|
- Python `ctypes` 包装继续通过 C ABI,不直接访问 Fortran 内部符号。
|
||||||
|
- Python `inspect` 和 `run` 保持 Water summary、dt limits 和错误路径覆盖。
|
||||||
|
|
||||||
|
0.2.1 不要求提供完整 Python 包发布流程。
|
||||||
|
|
||||||
|
## 14. CLI 范围
|
||||||
|
|
||||||
|
0.2.1 CLI 继续支持:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
sphlite --version
|
||||||
|
sphlite model.inp
|
||||||
|
sphlite model.inp --check
|
||||||
|
sphlite model.inp --run
|
||||||
|
sphlite model.inp --run --output output
|
||||||
|
```
|
||||||
|
|
||||||
|
建议加固输出字段:
|
||||||
|
|
||||||
|
- `version`
|
||||||
|
- `input`
|
||||||
|
- `mode`
|
||||||
|
- `particles`
|
||||||
|
- `warnings`
|
||||||
|
- `time`
|
||||||
|
- `step`
|
||||||
|
- `water_particles`
|
||||||
|
- `water_mass`
|
||||||
|
- `max_pressure`
|
||||||
|
- `dtcrit`
|
||||||
|
- `status`
|
||||||
|
|
||||||
|
建议加固错误路径:
|
||||||
|
|
||||||
|
- 缺少输入文件。
|
||||||
|
- 输入文件不存在。
|
||||||
|
- `--run` 和 `--check` 同时给出。
|
||||||
|
- `--output` 缺少路径。
|
||||||
|
- Water 参数缺失。
|
||||||
|
- 输出目录非法。
|
||||||
|
|
||||||
|
CLI 内部必须继续调用公共生命周期 API,不得绕过 Fortran API 或 C ABI 的错误处理。
|
||||||
|
|
||||||
|
## 15. CouplingInterface 边界
|
||||||
|
|
||||||
|
0.2.1 不实现真实 FEM-SPH 耦合。
|
||||||
|
|
||||||
|
建议加固:
|
||||||
|
|
||||||
|
- Water 运行后 coupling particle count 可用。
|
||||||
|
- Water 运行后 coupling particle state 导出包含 id、position、velocity、phase、material、pressure。
|
||||||
|
- 外部粒子力导入后进入显式步外载占位。
|
||||||
|
- coupling work、momentum、energy 诊断继续可读。
|
||||||
|
- 接触耦合和连续体耦合类型字段继续保留。
|
||||||
|
- 接口命名不出现 FEMLite 内部数据结构。
|
||||||
|
- 默认 gate 不运行真实 FEM-SPH 联合测试。
|
||||||
|
|
||||||
|
如果 0.2.1 需要扩展 C ABI coupling 接口,应只采用中立命名,且不依赖外部 CouplingModule。
|
||||||
|
|
||||||
|
## 16. 测试计划
|
||||||
|
|
||||||
|
0.2.1 默认 gate 建议包含:
|
||||||
|
|
||||||
|
- `smoke`:版本 0.2.1、生命周期、基础显式步和错误路径。
|
||||||
|
- `input`:Water 输入关键字、warning/error、section/material/set 语义。
|
||||||
|
- `kernel`:核函数边界、梯度、不同 `h(i)`。
|
||||||
|
- `neighbor`:uniform cell/bin、重复坐标、稀疏粒子、容量错误。
|
||||||
|
- `water_eos`:Tait EOS 正常、边界和非法参数。
|
||||||
|
- `water_density`:连续性方程压缩、拉伸、静止和跳过路径。
|
||||||
|
- `water_viscosity`:Monaghan 人工黏性接近、远离、零距离和非法参数。
|
||||||
|
- `water_force`:压力力、body force、外载占位和跳过路径。
|
||||||
|
- `solver_water`:单步、多步、stable dt、非法 dt、restart 后继续推进。
|
||||||
|
- `output`:粒子 CSV 和 summary CSV 字段。
|
||||||
|
- `restart`:0.2.1 Water 状态写入、读回和继续运行。
|
||||||
|
- `coupling_interface`:Water 运行后状态导出和外部粒子力导入。
|
||||||
|
- `c_api`:Water summary/dt limits、空指针和原有 C ABI 兼容。
|
||||||
|
- `cpp_api`:Water summary/dt limits 薄包装。
|
||||||
|
- `python_debug`:Water inspect/run、错误路径。
|
||||||
|
- `cli`:version、inspect、check、run、output、错误输入。
|
||||||
|
- `pressure_wave_smoke`:小型压力扰动方向、有限性、质量/动量趋势和输出字段。
|
||||||
|
- `source_size`:Fortran/C/C++/Python 文件大小和 stale exception。
|
||||||
|
|
||||||
|
非默认测试可以保留:
|
||||||
|
|
||||||
|
- 更大粒子数压力传播。
|
||||||
|
- 参数收敛研究。
|
||||||
|
- 更严格波速对比。
|
||||||
|
- 自由面探索算例。
|
||||||
|
- 长时间稳定性探索。
|
||||||
|
|
||||||
|
这些不进入默认 release gate。
|
||||||
|
|
||||||
|
## 17. 0.2.1 Release Gate
|
||||||
|
|
||||||
|
建议 release gate:
|
||||||
|
|
||||||
|
```powershell
|
||||||
|
cmake --build build-codex-unix --parallel
|
||||||
|
ctest --test-dir build-codex-unix -R "^(smoke|input|kernel|neighbor|water_eos|water_density|water_viscosity|water_force|solver_water|output|restart|coupling_interface|c_api|cpp_api|python_debug|cli|pressure_wave_smoke)$" --output-on-failure
|
||||||
|
ctest --test-dir build-codex-unix -R "^source_size$" --output-on-failure
|
||||||
|
git diff --check
|
||||||
|
```
|
||||||
|
|
||||||
|
验收标准:
|
||||||
|
|
||||||
|
- 完整配置 CMake。
|
||||||
|
- 完整编译 `sphlite_core`、`sphlite_c`、`sphlite_c_shared`、`sphlite` 和测试目标。
|
||||||
|
- 默认 gate 全部通过。
|
||||||
|
- `source_size` 通过。
|
||||||
|
- `git diff --check` 通过。
|
||||||
|
- README、09 和 11 号文档记录 0.2.1 gate 结果。
|
||||||
|
- 文档不宣称已实现完整水下爆炸。
|
||||||
|
- 文档不宣称已实现 Gas/Explosive/Solid/Shell 生产路径。
|
||||||
|
- 文档不宣称已实现真实 FEM-SPH 联合运行。
|
||||||
|
- build 目录、CSV、VTK、restart 临时结果和 Python 缓存不进入提交。
|
||||||
|
- 文档使用 UTF-8 without BOM。
|
||||||
|
|
||||||
|
## 18. 开发阶段拆分
|
||||||
|
|
||||||
|
### 阶段 A:版本和基线检查
|
||||||
|
|
||||||
|
- 更新版本号到 0.2.1。
|
||||||
|
- 确认 0.2.0 release gate 仍通过。
|
||||||
|
- 确认当前 CMake、CTest 和 source size 门禁可用。
|
||||||
|
- 准备 0.2.1 专用测试输入文件。
|
||||||
|
|
||||||
|
### 阶段 B:输入解析加固
|
||||||
|
|
||||||
|
- 加固 Water material、density、section 和 set 映射。
|
||||||
|
- 加固 EOS、viscosity、particle control、body force 和 time control 参数错误路径。
|
||||||
|
- 补充输入错误消息测试。
|
||||||
|
- 补充 unknown keyword warning 测试。
|
||||||
|
|
||||||
|
### 阶段 C:Kernel 和 Neighbor 加固
|
||||||
|
|
||||||
|
- 增加 kernel 边界和非法参数测试。
|
||||||
|
- 增加 neighbor 重复坐标、稀疏粒子、边界半径和容量错误测试。
|
||||||
|
- 确认 neighbor stats API 结果稳定。
|
||||||
|
|
||||||
|
### 阶段 D:Water 算法加固
|
||||||
|
|
||||||
|
- 扩展 Tait EOS 边界测试。
|
||||||
|
- 扩展连续性方程测试。
|
||||||
|
- 扩展人工黏性测试。
|
||||||
|
- 扩展压力力和 body force 测试。
|
||||||
|
- 确认非 Water 和 inactive 粒子跳过规则。
|
||||||
|
|
||||||
|
### 阶段 E:Solver、Output 和 Restart
|
||||||
|
|
||||||
|
- 加固 stable dt 诊断。
|
||||||
|
- 加固非法 dt 和非法 Water 状态错误路径。
|
||||||
|
- 加固多步 run 和最后小步逻辑。
|
||||||
|
- 加固 CSV output 和 summary 字段检查。
|
||||||
|
- 加固 restart 读回后继续运行。
|
||||||
|
|
||||||
|
### 阶段 F:接口和 CLI
|
||||||
|
|
||||||
|
- 加固 Fortran API 错误路径。
|
||||||
|
- 加固 C ABI 空指针、小容量和错误码路径。
|
||||||
|
- 加固 C++ wrapper 测试。
|
||||||
|
- 加固 Python inspect/run 和错误路径。
|
||||||
|
- 加固 CLI 输出字段和错误输入路径。
|
||||||
|
|
||||||
|
### 阶段 G:CouplingInterface 最小加固
|
||||||
|
|
||||||
|
- 确认 Water 运行后导出状态包含 pressure、phase、material。
|
||||||
|
- 确认外部粒子力影响显式步。
|
||||||
|
- 确认 coupling 诊断继续记录。
|
||||||
|
- 确认默认 gate 不运行真实 FEM-SPH 联合测试。
|
||||||
|
|
||||||
|
### 阶段 H:Pressure Wave Smoke 和 Gate
|
||||||
|
|
||||||
|
- 扩展 pressure wave smoke checker。
|
||||||
|
- 确认小规模、短时间、快速运行。
|
||||||
|
- 更新 README、09、11 号文档。
|
||||||
|
- 跑 0.2.1 release gate。
|
||||||
|
- 清理 todo 并记录验收结果。
|
||||||
|
|
||||||
|
## 19. 风险和控制
|
||||||
|
|
||||||
|
| 风险 | 控制 |
|
||||||
|
|---|---|
|
||||||
|
| 0.2.1 膨胀为 0.3 Gas 开发 | 只加固 Water,不实现 Gas EOS、气泡和气体团簇生产路径 |
|
||||||
|
| 过早引入强冲击算法 | Riemann-SPH 继续作为后续升级方向,不进入 0.2.1 默认 gate |
|
||||||
|
| 输入语法过度扩张 | 只补 Water 已有关键词的校验和错误路径 |
|
||||||
|
| pressure wave smoke 变成长跑 benchmark | 保持小粒子数、短时间、趋势检查 |
|
||||||
|
| source size 膨胀 | 继续使用 source size 门禁,必要时拆分模块而不是登记无意义例外 |
|
||||||
|
| C ABI 与 Fortran API 分叉 | Fortran API 仍为语义来源,C ABI 只做薄封装 |
|
||||||
|
| restart 格式不清晰 | 记录 restart state version 和 0.2.1 兼容策略 |
|
||||||
|
| 文档超前宣称能力 | README、09、11 和本计划均明确 0.2.1 不交付新物理模块 |
|
||||||
|
|
||||||
|
## 20. 后续版本衔接
|
||||||
|
|
||||||
|
0.2.1 完成后,后续可以选择:
|
||||||
|
|
||||||
|
- 若 Water 仍存在明显稳定性或接口问题,则继续开发 0.2.2。
|
||||||
|
- 若 Water 基础路径和 gate 足够稳定,则进入 0.3 `Gas`。
|
||||||
|
|
||||||
|
进入 0.3 前,0.2.1 应为 `Gas` 提供:
|
||||||
|
|
||||||
|
- 稳定的统一粒子数据库。
|
||||||
|
- 稳定的 phase/status/material/section 语义。
|
||||||
|
- 可复用的 neighbor 和 kernel 路径。
|
||||||
|
- 可复用的 output、restart、API、CLI 和 release gate 框架。
|
||||||
|
- 明确的 Water/Gas 独立计算模块边界。
|
||||||
|
|
||||||
|
0.2.1 不应提前实现 JWL、理想气体、Stiffened gas 或气泡诊断生产路径。
|
||||||
|
|
||||||
|
## 21. 待确认事项
|
||||||
|
|
||||||
|
- 0.2.1 是否需要引入 Water 拉伸压力限制,还是继续保留当前 Tait 负压策略并只加固测试说明。
|
||||||
|
- `*SPHLITE EOS` 非 `TYPE=TAIT` 时在 0.2.1 中应直接 error,还是 warning 后不进入 Water 计算。
|
||||||
|
- `*SPHLITE PARTICLE CONTROL` 是否需要支持逐粒子 `H/MASS/VOLUME`,还是继续只支持统一默认值。
|
||||||
|
- pressure wave smoke 是否需要增加第二个 3D 非共线粒子布置。
|
||||||
|
- restart 格式是否需要声明兼容 0.2.0,还是 0.2.1 只保证当前版本读写闭环。
|
||||||
|
- CouplingInterface 是否需要在 0.2.1 暴露 C ABI,还是继续停留在 Fortran 模块测试层。
|
||||||
|
- 0.2.1 是否需要新增 VTK 占位输出,还是继续只用 CSV 作为默认 gate 输出。
|
||||||
@@ -4,7 +4,7 @@ module sph_precision
|
|||||||
integer, parameter :: rk = selected_real_kind(12, 100)
|
integer, parameter :: rk = selected_real_kind(12, 100)
|
||||||
integer, parameter :: SPH_VERSION_MAJOR = 0
|
integer, parameter :: SPH_VERSION_MAJOR = 0
|
||||||
integer, parameter :: SPH_VERSION_MINOR = 2
|
integer, parameter :: SPH_VERSION_MINOR = 2
|
||||||
integer, parameter :: SPH_VERSION_PATCH = 0
|
integer, parameter :: SPH_VERSION_PATCH = 1
|
||||||
integer, parameter :: SPH_NDIM = 3
|
integer, parameter :: SPH_NDIM = 3
|
||||||
integer, parameter :: SPH_ERROR_MESSAGE_LEN = 256
|
integer, parameter :: SPH_ERROR_MESSAGE_LEN = 256
|
||||||
integer, parameter :: SPH_PATH_LEN = 1024
|
integer, parameter :: SPH_PATH_LEN = 1024
|
||||||
|
|||||||
@@ -0,0 +1,20 @@
|
|||||||
|
*Node
|
||||||
|
1, 0.0, 0.0, 0.0
|
||||||
|
2, 0.1, 0.0, 0.0
|
||||||
|
3, 0.0, 0.1, 0.0
|
||||||
|
4, 0.0, 0.0, 0.1
|
||||||
|
*Element, Type=SPH3D
|
||||||
|
1, 1
|
||||||
|
2, 2
|
||||||
|
3, 3
|
||||||
|
4, 4
|
||||||
|
*Elset, Elset=WaterParticles
|
||||||
|
1, 2, 3, 4
|
||||||
|
*Material, Name=WaterCase, Type=water
|
||||||
|
*Density
|
||||||
|
1000.0
|
||||||
|
*Section, Elset=WaterParticles, Material=WaterCase
|
||||||
|
*SphLite Eos, Type=Tait, Material=WaterCase, Rho0=1000.0, C0=1480.0, Gamma=7.0, P0=0.0
|
||||||
|
*SphLite Viscosity, Type=Monaghan, Material=WaterCase, Alpha=0.1, Beta=0.0, Eta2=0.01
|
||||||
|
*SphLite Particle Control, H=0.15, Mass=1.0, Volume=0.001
|
||||||
|
*SphLite Time Control, Dt=1.0E-6, Time=1.0E-6, Steps=1, Safety=0.5
|
||||||
@@ -0,0 +1,20 @@
|
|||||||
|
*NODE
|
||||||
|
1, 0.0, 0.0, 0.0
|
||||||
|
2, 0.1, 0.0, 0.0
|
||||||
|
3, 0.0, 0.1, 0.0
|
||||||
|
4, 0.0, 0.0, 0.1
|
||||||
|
*ELEMENT, TYPE=SPH3D
|
||||||
|
1, 1
|
||||||
|
2, 2
|
||||||
|
3, 3
|
||||||
|
4, 4
|
||||||
|
*ELSET, ELSET=WATER_PARTICLES
|
||||||
|
1, 2, 3, 4
|
||||||
|
*MATERIAL, NAME=WATER, TYPE=WATER
|
||||||
|
*DENSITY
|
||||||
|
1000.0
|
||||||
|
*SECTION, ELSET=WATER_PARTICLES, MATERIAL=WATER
|
||||||
|
*SPHLITE EOS, TYPE=TAIT, MATERIAL=WATER, RHO0=1000.0, C0=1480.0, GAMMA=7.0, P0=0.0
|
||||||
|
*SPHLITE VISCOSITY, TYPE=MONAGHAN, MATERIAL=WATER, ALPHA=0.1, BETA=0.0, ETA2=0.01
|
||||||
|
*SPHLITE PARTICLE CONTROL, H=0.15, MASS=1.0, VOLUME=0.001
|
||||||
|
*SPHLITE TIME CONTROL, DT=1.0E-6, TIME=2.0E-6, STEPS=2, SAFETY=0.5
|
||||||
@@ -71,7 +71,7 @@ int main(void)
|
|||||||
|
|
||||||
ierr = sphlite_get_version(&major, &minor, &patch);
|
ierr = sphlite_get_version(&major, &minor, &patch);
|
||||||
if (ierr != 0) return fail("get_version failed");
|
if (ierr != 0) return fail("get_version failed");
|
||||||
if (major != 0 || minor != 2 || patch != 0) return fail("unexpected version");
|
if (major != 0 || minor != 2 || patch != 1) return fail("unexpected version");
|
||||||
|
|
||||||
snprintf(path, sizeof(path), "%s/minimal_particles_011.inp", SPHLITE_TEST_DATA_DIR);
|
snprintf(path, sizeof(path), "%s/minimal_particles_011.inp", SPHLITE_TEST_DATA_DIR);
|
||||||
ierr = sphlite_read_inp(path);
|
ierr = sphlite_read_inp(path);
|
||||||
|
|||||||
@@ -11,7 +11,7 @@ int main()
|
|||||||
|
|
||||||
sphlite::Session session;
|
sphlite::Session session;
|
||||||
sphlite::Version version = sphlite::version();
|
sphlite::Version version = sphlite::version();
|
||||||
if (version.major != 0 || version.minor != 2 || version.patch != 0) {
|
if (version.major != 0 || version.minor != 2 || version.patch != 1) {
|
||||||
return 1;
|
return 1;
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -37,7 +37,7 @@ program test_smoke
|
|||||||
|
|
||||||
call sph_get_version(major, minor, patch, ierr)
|
call sph_get_version(major, minor, patch, ierr)
|
||||||
call assert_ok(ierr, 'version failed')
|
call assert_ok(ierr, 'version failed')
|
||||||
if (major /= 0 .or. minor /= 2 .or. patch /= 0) call fail('unexpected version')
|
if (major /= 0 .or. minor /= 2 .or. patch /= 1) call fail('unexpected version')
|
||||||
|
|
||||||
call sph_db_allocate(2, ierr)
|
call sph_db_allocate(2, ierr)
|
||||||
call assert_ok(ierr, 'database allocation failed')
|
call assert_ok(ierr, 'database allocation failed')
|
||||||
|
|||||||
@@ -1,468 +1,476 @@
|
|||||||
# SPHLite TODO
|
# SPHLite TODO
|
||||||
|
|
||||||
当前目标版本:0.2.0
|
当前目标版本:0.2.1
|
||||||
|
|
||||||
本文档依据 `docs/v2.0_development_plan.md` 拆分。0.2.0 是 `Water` 基础 SPH 最小闭环版本,目标是打通 3D 水相弱可压 SPH 的真实计算链路,不交付 Gas、Explosive、Solid、Shell 生产路径,不交付真实 FEM-SPH 联合运行。
|
本文档依据 `docs/v2.1_development_plan.md` 拆分。0.2.1 是 `Water` 加固版本,目标是增强 0.2.0 已有水相弱可压 SPH 路径的可靠性、可验证性和接口一致性,不交付 `Gas`、`Explosive`、`Solid`、`Shell` 生产路径,不交付真实 FEM-SPH 联合运行,不新增几何、网格或粒子生成能力。
|
||||||
|
|
||||||
## 阶段 A:版本和构建骨架
|
## 阶段 A:版本和基线检查
|
||||||
|
|
||||||
- [x] 将 `sph_precision` 中的软件版本更新为 `0.2.0`。
|
- [x] 将 `sph_precision` 中的软件版本更新为 `0.2.1`。
|
||||||
- [x] 将 CMake 项目版本更新为 `0.2.0`。
|
- [x] 将 CMake 项目版本更新为 `0.2.1`。
|
||||||
|
- [x] 更新 CLI `--version` 的版本期望。
|
||||||
|
- [x] 更新 Fortran smoke 测试中的版本期望。
|
||||||
|
- [x] 更新 C API 测试中的版本期望。
|
||||||
|
- [x] 更新 C++ API 测试中的版本期望。
|
||||||
|
- [x] 更新 Python debug 测试中的版本期望。
|
||||||
- [x] 确认 `sphlite_core` 仍以 Fortran 95 核心源文件为主。
|
- [x] 确认 `sphlite_core` 仍以 Fortran 95 核心源文件为主。
|
||||||
- [x] 确认 `sphlite_c` 仍为 C ABI 薄包装库。
|
- [x] 确认 `sphlite_c` 仍为 C ABI 薄封装库。
|
||||||
|
- [x] 确认 `sphlite_c_shared` 仍可构建。
|
||||||
- [x] 确认 `sphlite` CLI 仍通过公共接口调用求解器。
|
- [x] 确认 `sphlite` CLI 仍通过公共接口调用求解器。
|
||||||
- [x] 在 CMake 中加入 `kernel` CTest 目标。
|
|
||||||
- [x] 在 CMake 中加入 `neighbor` CTest 目标。
|
|
||||||
- [x] 在 CMake 中加入 `water_eos` CTest 目标。
|
|
||||||
- [x] 在 CMake 中加入 `water_density` CTest 目标。
|
|
||||||
- [x] 在 CMake 中加入 `water_viscosity` CTest 目标。
|
|
||||||
- [x] 在 CMake 中加入 `water_force` CTest 目标。
|
|
||||||
- [x] 在 CMake 中加入 `solver_water` CTest 目标。
|
|
||||||
- [x] 在 CMake 中加入 `pressure_wave_smoke` CTest 目标。
|
|
||||||
- [x] 确认 0.1.1 既有测试目标仍保留。
|
|
||||||
- [x] 确认不新增 `geometry/` 目录。
|
- [x] 确认不新增 `geometry/` 目录。
|
||||||
- [x] 确认不新增 `mesh/` 目录。
|
- [x] 确认不新增 `mesh/` 目录。
|
||||||
|
- [x] 确认不新增粒子生成器作为求解器功能。
|
||||||
|
- [x] 跑通 0.2.0 发布状态的默认 gate。
|
||||||
|
- [x] 跑通 `source_size` 门禁。
|
||||||
|
- [x] 跑通 `git diff --check`。
|
||||||
|
- [x] 记录 0.2.1 基线检查结果。
|
||||||
|
|
||||||
## 阶段 B:0.2.0 输入数据文件
|
基线检查记录(2026-07-02):0.2.1 版本号迁移后,`cmake --build build-codex-unix` 通过;默认 `ctest` 18/18 通过;单独 `source_size` 通过;`git diff --check` 通过;未新增 `geometry/`、`mesh/` 或粒子生成器目录。
|
||||||
|
|
||||||
- [x] 创建最小 Water `.inp` 测试数据。
|
## 阶段 B:0.2.1 输入测试数据
|
||||||
- [x] 创建 Tait EOS 参数完整的 `.inp` 测试数据。
|
|
||||||
- [x] 创建 Monaghan 人工黏性参数完整的 `.inp` 测试数据。
|
|
||||||
- [x] 创建粒子控制参数完整的 `.inp` 测试数据。
|
|
||||||
- [x] 创建 body force 参数测试 `.inp`。
|
|
||||||
- [x] 创建缺失 Tait EOS 参数错误测试 `.inp`。
|
|
||||||
- [x] 创建非法 Tait EOS 参数错误测试 `.inp`。
|
|
||||||
- [x] 创建缺失人工黏性参数错误测试 `.inp`。
|
|
||||||
- [x] 创建非法人工黏性参数错误测试 `.inp`。
|
|
||||||
- [x] 创建非法粒子控制参数错误测试 `.inp`。
|
|
||||||
- [x] 创建非 water phase 被 Water 计算跳过的测试 `.inp`。
|
|
||||||
- [x] 创建小型 3D pressure wave `.inp`。
|
|
||||||
- [x] 确认测试数据不依赖求解器内置几何生成。
|
|
||||||
|
|
||||||
## 阶段 C:Database 运行时状态
|
- [x] 创建 0.2.1 Water 最小合法输入文件。
|
||||||
|
- [x] 创建 Water material 大小写兼容测试输入文件。
|
||||||
|
- [ ] 创建 Water material 缺少 `*DENSITY` 的错误输入文件。
|
||||||
|
- [ ] 创建 `*SECTION` 指向不存在 material 的错误输入文件。
|
||||||
|
- [ ] 创建缺失 `*SPHLITE EOS, TYPE` 的错误输入文件。
|
||||||
|
- [ ] 创建缺失 `*SPHLITE EOS, MATERIAL` 的错误输入文件。
|
||||||
|
- [ ] 创建缺失 `*SPHLITE EOS, RHO0` 的错误输入文件。
|
||||||
|
- [ ] 创建缺失 `*SPHLITE EOS, C0` 的错误输入文件。
|
||||||
|
- [ ] 创建缺失 `*SPHLITE EOS, GAMMA` 的错误输入文件。
|
||||||
|
- [ ] 创建非法 `*SPHLITE EOS, B` 的错误输入文件。
|
||||||
|
- [ ] 创建非 `TYPE=TAIT` 的 EOS 类型测试输入文件。
|
||||||
|
- [ ] 创建缺失 `*SPHLITE VISCOSITY` 字段的错误输入文件。
|
||||||
|
- [ ] 创建非法 `*SPHLITE VISCOSITY` 数值的错误输入文件。
|
||||||
|
- [ ] 创建非法 `*SPHLITE PARTICLE CONTROL` 数值的错误输入文件。
|
||||||
|
- [ ] 创建非法 `*SPHLITE BODY FORCE` 字段的错误输入文件。
|
||||||
|
- [ ] 创建非法 `*SPHLITE TIME CONTROL` 数值的错误输入文件。
|
||||||
|
- [ ] 创建未知但不影响运行的 `*SPHLITE` warning 输入文件。
|
||||||
|
- [ ] 创建重复坐标 Water 粒子输入文件。
|
||||||
|
- [ ] 创建稀疏 Water 粒子输入文件。
|
||||||
|
- [ ] 创建非共线 3D pressure wave 输入文件。
|
||||||
|
|
||||||
- [x] 确认 `particle_id_ext` 在 0.2.0 路径中完整初始化。
|
## 阶段 C:输入解析加固
|
||||||
- [x] 确认 `particle_phase` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `particle_status` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `material_id` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `section_id` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `x0(3,npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `x(3,npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `v(3,npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `a(3,npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `vhalf(3,npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `mass(npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `rho(npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `volume(npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `pressure(npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `internal_energy(npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `temperature(npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 确认 `h(npart)` 在 0.2.0 路径中完整初始化。
|
|
||||||
- [x] 增加 `drho_dt(npart)` 运行时状态。
|
|
||||||
- [x] 增加 `acc_pressure(3,npart)` 运行时状态。
|
|
||||||
- [x] 增加 `acc_viscosity(3,npart)` 运行时状态。
|
|
||||||
- [x] 增加外部体力或等效外载缓存。
|
|
||||||
- [x] 增加每粒子 cell id 存储。
|
|
||||||
- [x] 增加 cell 链表或压缩索引存储。
|
|
||||||
- [x] 增加邻域表或邻域对存储。
|
|
||||||
- [x] 增加每粒子邻居数量存储。
|
|
||||||
- [x] 增加水相诊断状态存储。
|
|
||||||
- [x] 确认 `sph_finalize` 释放 0.2.0 新增状态。
|
|
||||||
- [x] 确认重复 `sph_initialize` 后新增状态一致。
|
|
||||||
- [x] 确认重复读取模型前新增状态被释放。
|
|
||||||
|
|
||||||
## 阶段 D:Water 参数和输入解析
|
- [ ] 加固 `*MATERIAL, TYPE=WATER` 大小写解析。
|
||||||
|
- [ ] 加固 Water material 与 `*DENSITY` 的绑定校验。
|
||||||
|
- [ ] 加固 `*SECTION` material 引用存在性校验。
|
||||||
|
- [ ] 加固 set 只作为集合、不作为类型判断的测试。
|
||||||
|
- [ ] 加固 `*SPHLITE EOS` 的 `TYPE` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE EOS` 的 `MATERIAL` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE EOS` 的 `RHO0` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE EOS` 的 `C0` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE EOS` 的 `GAMMA` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE EOS` 的可选 `P0` 字段解析。
|
||||||
|
- [ ] 加固 `*SPHLITE EOS` 的可选 `B` 字段解析。
|
||||||
|
- [ ] 保持未给定 `B` 时由 `rho0*c0*c0/gamma` 推导。
|
||||||
|
- [ ] 明确非 `TYPE=TAIT` 的 EOS 处理策略。
|
||||||
|
- [ ] 加固 `*SPHLITE VISCOSITY` 的 `TYPE` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE VISCOSITY` 的 `MATERIAL` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE VISCOSITY` 的 `ALPHA` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE VISCOSITY` 的 `BETA` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE VISCOSITY` 的 `ETA2` 字段校验。
|
||||||
|
- [ ] 加固 `*SPHLITE PARTICLE CONTROL` 的 `H` 正值校验。
|
||||||
|
- [ ] 加固 `*SPHLITE PARTICLE CONTROL` 的 `MASS` 正值校验。
|
||||||
|
- [ ] 加固 `*SPHLITE PARTICLE CONTROL` 的 `VOLUME` 正值校验。
|
||||||
|
- [ ] 加固 `*SPHLITE BODY FORCE` 三维分量解析。
|
||||||
|
- [ ] 加固 `*SPHLITE TIME CONTROL` 的 `DT` 正值校验。
|
||||||
|
- [ ] 加固 `*SPHLITE TIME CONTROL` 的 `TIME` 正值校验。
|
||||||
|
- [ ] 加固 `*SPHLITE TIME CONTROL` 的 `STEPS` 正值校验。
|
||||||
|
- [ ] 加固 `*SPHLITE TIME CONTROL` 的 `SAFETY` 正值校验。
|
||||||
|
- [ ] 确认 unsupported-but-safe 关键词报 warning。
|
||||||
|
- [ ] 确认无法运行的缺失关键词报 error。
|
||||||
|
- [ ] 确认输入错误消息包含文件名。
|
||||||
|
- [ ] 确认输入错误消息包含行号或定位上下文。
|
||||||
|
|
||||||
- [x] 在 input 中识别 water material 类型。
|
## 阶段 D:Database 状态一致性
|
||||||
- [x] 复用 `*DENSITY` 读取参考密度。
|
|
||||||
- [x] 解析 `*SPHLITE EOS` 关键词。
|
|
||||||
- [x] 解析 `*SPHLITE EOS` 的 `TYPE` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE EOS` 的 `MATERIAL` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE EOS` 的 `RHO0` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE EOS` 的 `C0` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE EOS` 的 `GAMMA` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE EOS` 的 `P0` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE EOS` 的可选 `B` 字段。
|
|
||||||
- [x] 未给定 `B` 时由 `rho0*c0*c0/gamma` 推导。
|
|
||||||
- [x] 解析 `*SPHLITE VISCOSITY` 关键词。
|
|
||||||
- [x] 解析 `*SPHLITE VISCOSITY` 的 `TYPE` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE VISCOSITY` 的 `MATERIAL` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE VISCOSITY` 的 `ALPHA` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE VISCOSITY` 的 `BETA` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE VISCOSITY` 的 `ETA2` 字段。
|
|
||||||
- [x] 解析 `*SPHLITE PARTICLE CONTROL` 关键词。
|
|
||||||
- [x] 解析统一光滑长度 `H` 或等价字段。
|
|
||||||
- [x] 解析统一粒子质量 `MASS` 或等价字段。
|
|
||||||
- [x] 解析统一粒子体积 `VOLUME` 或等价字段。
|
|
||||||
- [x] 解析 `*SPHLITE BODY FORCE` 关键词。
|
|
||||||
- [x] 解析体力三维分量。
|
|
||||||
- [x] 对缺失 Tait EOS 关键字段报 error。
|
|
||||||
- [x] 对非法 Tait EOS 数值报 error。
|
|
||||||
- [x] 对缺失人工黏性关键字段报 error。
|
|
||||||
- [x] 对非法人工黏性数值报 error。
|
|
||||||
- [x] 对非法粒子控制数值报 error。
|
|
||||||
- [x] 对不影响运行的未知 Water 关键词报 warning。
|
|
||||||
- [x] 确认输入错误消息包含文件名。
|
|
||||||
- [x] 确认输入错误消息包含行号。
|
|
||||||
|
|
||||||
## 阶段 E:Kernel 模块
|
- [ ] 确认 `particle_id_ext` 在 build 后稳定。
|
||||||
|
- [ ] 确认 `particle_id_ext` 在 restart 读回后稳定。
|
||||||
|
- [ ] 确认 `particle_phase` 在 build 后一致。
|
||||||
|
- [ ] 确认 `particle_status` 在 build 后一致。
|
||||||
|
- [ ] 确认 `material_id` 在 build 后一致。
|
||||||
|
- [ ] 确认 `section_id` 在 build 后一致。
|
||||||
|
- [ ] 确认 `x0(3,npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `x(3,npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `v(3,npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `a(3,npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `vhalf(3,npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `mass(npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `rho(npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `volume(npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `pressure(npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `temperature(npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `h(npart)` 初始化路径一致。
|
||||||
|
- [ ] 确认 `drho_dt` 每步计算前正确重置。
|
||||||
|
- [ ] 确认 `acc_pressure` 每步计算前正确重置。
|
||||||
|
- [ ] 确认 `acc_viscosity` 每步计算前正确重置。
|
||||||
|
- [ ] 确认 `acc_body` 保留或重置策略明确。
|
||||||
|
- [ ] 确认 Water 诊断在 build 后可重复计算。
|
||||||
|
- [ ] 确认 Water 诊断在 advance 后可重复计算。
|
||||||
|
- [ ] 确认 Water 诊断在 restart read 后可重复计算。
|
||||||
|
- [ ] 确认非 Water 粒子仍可通过通用查询导出。
|
||||||
|
- [ ] 确认 inactive 粒子不参与 Water 相互作用。
|
||||||
|
- [ ] 确认重复 `sph_initialize` 后状态干净。
|
||||||
|
- [ ] 确认重复读取模型前旧状态被释放。
|
||||||
|
|
||||||
- [x] 创建 `Particle` 核函数模块文件。
|
## 阶段 E:Kernel 加固
|
||||||
- [x] 定义核函数类型常量。
|
|
||||||
- [x] 定义 Wendland C2 类型常量。
|
|
||||||
- [x] 定义 Wendland C4 类型常量。
|
|
||||||
- [x] 定义 cubic spline 类型常量。
|
|
||||||
- [x] 实现核函数支持半径查询。
|
|
||||||
- [x] 实现 Wendland C2 核函数值。
|
|
||||||
- [x] 实现 Wendland C2 核函数梯度。
|
|
||||||
- [x] 实现 Wendland C4 核函数值。
|
|
||||||
- [x] 实现 Wendland C4 核函数梯度。
|
|
||||||
- [x] 实现 cubic spline 核函数值。
|
|
||||||
- [x] 实现 cubic spline 核函数梯度。
|
|
||||||
- [x] 支持 3D 归一化系数。
|
|
||||||
- [x] 支持每粒子独立 `h(i)` 传入。
|
|
||||||
- [x] 对 `h <= 0` 返回明确错误。
|
|
||||||
- [x] 对未知核函数类型返回明确错误。
|
|
||||||
- [x] 将 Wendland C2 设置为默认核函数。
|
|
||||||
- [x] 增加 `r = 0` 核函数有限性测试。
|
|
||||||
- [x] 增加超出支持半径测试。
|
|
||||||
- [x] 增加梯度方向测试。
|
|
||||||
- [x] 增加梯度反对称性测试。
|
|
||||||
- [x] 增加不同 `h(i)` 测试。
|
|
||||||
|
|
||||||
## 阶段 F:Neighbor 模块
|
- [ ] 加固 Wendland C2 的 `h <= 0` 错误路径。
|
||||||
|
- [ ] 加固 Wendland C4 的 `h <= 0` 错误路径。
|
||||||
|
- [ ] 加固 cubic spline 的 `h <= 0` 错误路径。
|
||||||
|
- [ ] 加固未知 kernel type 错误路径。
|
||||||
|
- [ ] 加固 `r = 0` 时核函数值有限。
|
||||||
|
- [ ] 加固 `r = 0` 时核函数梯度为零向量。
|
||||||
|
- [ ] 加固接近支持半径时核函数值有限。
|
||||||
|
- [ ] 加固接近支持半径时核函数梯度有限。
|
||||||
|
- [ ] 加固超出支持半径时 `W = 0`。
|
||||||
|
- [ ] 加固超出支持半径时 `grad W = 0`。
|
||||||
|
- [ ] 加固对称粒子对梯度反对称。
|
||||||
|
- [ ] 加固不同 `h(i)` 的核函数结果有限。
|
||||||
|
- [ ] 确认默认 kernel 仍为 Wendland C2。
|
||||||
|
- [ ] 确认 kernel 测试不变成长跑积分 benchmark。
|
||||||
|
|
||||||
- [x] 创建 uniform cell/bin 邻域模块文件。
|
## 阶段 F:Neighbor 加固
|
||||||
- [x] 实现当前坐标包围盒计算。
|
|
||||||
- [x] 实现最大支持半径计算。
|
|
||||||
- [x] 根据最大支持半径确定 cell 尺寸。
|
|
||||||
- [x] 实现 cell 网格维度计算。
|
|
||||||
- [x] 实现粒子到 cell 的映射。
|
|
||||||
- [x] 实现 cell 链表或压缩索引构建。
|
|
||||||
- [x] 实现相邻 cell 遍历。
|
|
||||||
- [x] 实现邻域表生成。
|
|
||||||
- [x] 支持每粒子独立 `h(i)` 的搜索半径。
|
|
||||||
- [x] 支持空模型邻域构建。
|
|
||||||
- [x] 支持单粒子模型邻域构建。
|
|
||||||
- [x] 支持负坐标粒子邻域构建。
|
|
||||||
- [x] 支持边界 cell 粒子邻域构建。
|
|
||||||
- [x] 支持粒子移动后重建邻域。
|
|
||||||
- [x] 对邻域表容量不足返回明确错误。
|
|
||||||
- [x] 增加朴素 `O(n^2)` 对比测试辅助例程。
|
|
||||||
- [x] 增加 uniform cell/bin 与朴素搜索一致性测试。
|
|
||||||
- [x] 增加不同 `h(i)` 邻域测试。
|
|
||||||
- [x] 增加空模型邻域测试。
|
|
||||||
- [x] 增加单粒子邻域测试。
|
|
||||||
- [x] 增加粒子移动后重建测试。
|
|
||||||
- [x] 增加负坐标和边界 cell 测试。
|
|
||||||
- [x] 增加邻域容量不足错误路径测试。
|
|
||||||
|
|
||||||
## 阶段 G:Water EOS 和诊断
|
- [ ] 加固空模型邻域构建。
|
||||||
|
- [ ] 加固单粒子邻域构建。
|
||||||
|
- [ ] 加固双粒子支持半径内判定。
|
||||||
|
- [ ] 加固双粒子支持半径外判定。
|
||||||
|
- [ ] 加固支持半径边界附近判定。
|
||||||
|
- [ ] 加固重复坐标粒子的邻域构建。
|
||||||
|
- [ ] 加固极近坐标粒子的邻域构建。
|
||||||
|
- [ ] 加固负坐标粒子的邻域构建。
|
||||||
|
- [ ] 加固稀疏粒子的包围盒计算。
|
||||||
|
- [ ] 加固稀疏粒子的 cell 维度控制。
|
||||||
|
- [ ] 加固不同 `h(i)` 对搜索半径的影响。
|
||||||
|
- [ ] 加固粒子移动后邻域重建。
|
||||||
|
- [ ] 加固邻域容量不足错误路径。
|
||||||
|
- [ ] 加固 naive `O(n^2)` 对比辅助检查。
|
||||||
|
- [ ] 加固 neighbor stats 最大邻居数。
|
||||||
|
- [ ] 加固 neighbor stats 平均邻居数。
|
||||||
|
- [ ] 确认 neighbor 测试保持小规模。
|
||||||
|
|
||||||
- [x] 创建或完善 Water 参数存储模块。
|
## 阶段 G:Water EOS 加固
|
||||||
- [x] 保存 Tait EOS 的 `rho0`。
|
|
||||||
- [x] 保存 Tait EOS 的 `c0`。
|
|
||||||
- [x] 保存 Tait EOS 的 `gamma`。
|
|
||||||
- [x] 保存 Tait EOS 的 `p0`。
|
|
||||||
- [x] 保存 Tait EOS 的 `B`。
|
|
||||||
- [x] 保存人工黏性 `alpha`。
|
|
||||||
- [x] 保存人工黏性 `beta`。
|
|
||||||
- [x] 保存人工黏性 `eta2`。
|
|
||||||
- [x] 保存 body force 三维分量。
|
|
||||||
- [x] 实现 Tait EOS 压力计算。
|
|
||||||
- [x] 实现 Tait EOS 声速或声速占位计算。
|
|
||||||
- [x] 实现 Tait EOS 参数校验。
|
|
||||||
- [x] 实现 water phase 粒子筛选。
|
|
||||||
- [x] 实现非 water phase 默认跳过。
|
|
||||||
- [x] 实现水相粒子数诊断。
|
|
||||||
- [x] 实现水相总质量诊断。
|
|
||||||
- [x] 实现水相总动量诊断。
|
|
||||||
- [x] 实现水相最大压力诊断。
|
|
||||||
- [x] 实现水相最小密度诊断。
|
|
||||||
- [x] 实现水相最大密度诊断。
|
|
||||||
- [x] 实现压力冲量占位诊断。
|
|
||||||
- [x] 增加 Tait EOS 标准压力测试。
|
|
||||||
- [x] 增加 Tait EOS 参考密度零压测试。
|
|
||||||
- [x] 增加 Tait EOS 非法参数测试。
|
|
||||||
- [x] 增加 water summary 诊断测试。
|
|
||||||
|
|
||||||
## 阶段 H:Water 连续性方程
|
- [ ] 加固 `rho = rho0` 时压力接近 `p0`。
|
||||||
|
- [ ] 加固 `rho > rho0` 时压力单调增加。
|
||||||
|
- [ ] 明确 `rho < rho0` 时负压策略。
|
||||||
|
- [ ] 为当前负压策略增加测试。
|
||||||
|
- [ ] 加固 `rho <= 0` 错误路径。
|
||||||
|
- [ ] 加固 `rho0 <= 0` 错误路径。
|
||||||
|
- [ ] 加固 `c0 <= 0` 错误路径。
|
||||||
|
- [ ] 加固 `gamma <= 0` 错误路径。
|
||||||
|
- [ ] 加固 `B <= 0` 错误路径。
|
||||||
|
- [ ] 加固声速诊断保持正值。
|
||||||
|
- [ ] 加固压力计算结果有限。
|
||||||
|
- [ ] 加固 `B` 自动推导结果。
|
||||||
|
- [ ] 加固显式给定 `B` 的结果。
|
||||||
|
- [ ] 加固 Water summary 中最大压力诊断。
|
||||||
|
- [ ] 在文档中记录 0.2.1 Tait EOS 当前策略。
|
||||||
|
|
||||||
- [x] 创建或完善 Water 密度计算入口。
|
## 阶段 H:连续性方程加固
|
||||||
- [x] 初始化 `drho_dt` 数组。
|
|
||||||
- [x] 基于邻域表遍历 water-water 粒子对。
|
|
||||||
- [x] 计算粒子相对速度。
|
|
||||||
- [x] 计算核函数梯度。
|
|
||||||
- [x] 累加连续性方程密度变化率。
|
|
||||||
- [x] 保持 summation density 不进入主流程。
|
|
||||||
- [x] 对非 water 粒子跳过密度贡献。
|
|
||||||
- [x] 对失效或 inactive 粒子按 status 跳过。
|
|
||||||
- [x] 增加双粒子压缩密度变化测试。
|
|
||||||
- [x] 增加双粒子拉伸密度变化测试。
|
|
||||||
- [x] 增加静止均匀粒子密度变化近零测试。
|
|
||||||
- [x] 增加非 water 粒子跳过测试。
|
|
||||||
- [x] 增加 `drho_dt` 有限性测试。
|
|
||||||
|
|
||||||
## 阶段 I:Water 人工黏性和力
|
- [ ] 加固双粒子压缩时 `drho_dt` 符号。
|
||||||
|
- [ ] 加固双粒子拉伸时 `drho_dt` 符号。
|
||||||
|
- [ ] 加固静止均匀粒子组密度变化接近零。
|
||||||
|
- [ ] 加固非 Water 粒子跳过密度贡献。
|
||||||
|
- [ ] 加固 inactive 粒子跳过密度贡献。
|
||||||
|
- [ ] 加固 failed 粒子跳过密度贡献。
|
||||||
|
- [ ] 加固 `drho_dt` 每步重置。
|
||||||
|
- [ ] 加固密度更新结果有限。
|
||||||
|
- [ ] 加固低密度输入的错误路径。
|
||||||
|
- [ ] 加固邻域为空时密度变化处理。
|
||||||
|
- [ ] 确认 summation density 不进入主流程。
|
||||||
|
- [ ] 保留 summation density 后续 checker 入口说明。
|
||||||
|
|
||||||
- [x] 创建或完善 Water 人工黏性计算入口。
|
## 阶段 I:人工黏性加固
|
||||||
- [x] 实现 Monaghan 人工黏性开关条件。
|
|
||||||
- [x] 实现人工黏性平均声速计算。
|
|
||||||
- [x] 实现人工黏性平均密度计算。
|
|
||||||
- [x] 实现人工黏性 `mu_ij` 计算。
|
|
||||||
- [x] 实现人工黏性加速度贡献。
|
|
||||||
- [x] 对远离粒子返回零人工黏性。
|
|
||||||
- [x] 创建或完善 Water 压力力计算入口。
|
|
||||||
- [x] 实现 SPH 压力梯度加速度。
|
|
||||||
- [x] 累加 `acc_pressure(3,npart)`。
|
|
||||||
- [x] 累加 `acc_viscosity(3,npart)`。
|
|
||||||
- [x] 将 body force 加入总加速度。
|
|
||||||
- [x] 将外部耦合载荷占位加入总加速度。
|
|
||||||
- [x] 对非 water 粒子跳过水相力贡献。
|
|
||||||
- [x] 增加人工黏性方向测试。
|
|
||||||
- [x] 增加人工黏性有限性测试。
|
|
||||||
- [x] 增加人工黏性对称性测试。
|
|
||||||
- [x] 增加压力梯度双粒子测试。
|
|
||||||
- [x] 增加均匀压力净力近零测试。
|
|
||||||
- [x] 增加 body force 加速度测试。
|
|
||||||
|
|
||||||
## 阶段 J:Solver Water 集成
|
- [ ] 加固接近粒子产生人工黏性贡献。
|
||||||
|
- [ ] 加固远离粒子不产生压缩型人工黏性贡献。
|
||||||
|
- [ ] 加固零距离粒子人工黏性有限。
|
||||||
|
- [ ] 加固极小距离粒子人工黏性有限。
|
||||||
|
- [ ] 加固 `alpha < 0` 错误路径。
|
||||||
|
- [ ] 加固 `beta < 0` 错误路径。
|
||||||
|
- [ ] 加固 `eta2 <= 0` 错误路径。
|
||||||
|
- [ ] 加固人工黏性加速度方向。
|
||||||
|
- [ ] 加固人工黏性加速度有限性。
|
||||||
|
- [ ] 加固人工黏性动量趋势。
|
||||||
|
- [ ] 加固非 Water 粒子跳过黏性贡献。
|
||||||
|
- [ ] 加固 inactive 粒子跳过黏性贡献。
|
||||||
|
- [ ] 加固 viscosity 参数读入后与计算一致。
|
||||||
|
- [ ] 确认人工黏性测试保持小规模。
|
||||||
|
|
||||||
- [x] 在 build model 中构建 Water 运行时状态。
|
## 阶段 J:压力力和外载加固
|
||||||
- [x] 在 build model 中构建邻域搜索状态。
|
|
||||||
- [x] 在显式步开始前校验 Water 参数。
|
|
||||||
- [x] 在显式步中必要时重建邻域。
|
|
||||||
- [x] 在显式步中根据 `rho` 更新 `pressure`。
|
|
||||||
- [x] 在显式步中计算 `drho_dt`。
|
|
||||||
- [x] 在显式步中计算水相压力加速度。
|
|
||||||
- [x] 在显式步中计算水相黏性加速度。
|
|
||||||
- [x] 在显式步中合成总加速度。
|
|
||||||
- [x] 在 Velocity-Verlet 中更新速度。
|
|
||||||
- [x] 在 Velocity-Verlet 中更新位置。
|
|
||||||
- [x] 在 Velocity-Verlet 中更新密度。
|
|
||||||
- [x] 在 Velocity-Verlet 中更新时间和步数。
|
|
||||||
- [x] 在显式步结束后更新 Water 诊断。
|
|
||||||
- [x] 在显式运行中按输出间隔写出结果。
|
|
||||||
- [x] 对负时间步保持明确错误。
|
|
||||||
- [x] 对零时间步保持明确错误。
|
|
||||||
- [x] 对未 build model 的显式步返回明确错误。
|
|
||||||
- [x] 增加单步 Water 推进测试。
|
|
||||||
- [x] 增加多步 Water 推进测试。
|
|
||||||
- [x] 增加 `sph_run_explicit` Water 闭环测试。
|
|
||||||
|
|
||||||
## 阶段 K:稳定时间步估计
|
- [ ] 加固双粒子压力力方向。
|
||||||
|
- [ ] 加固零压力时压力力接近零。
|
||||||
|
- [ ] 加固均匀压力组净力趋势。
|
||||||
|
- [ ] 加固压力力结果有限。
|
||||||
|
- [ ] 加固 `acc_pressure` 合成前重置。
|
||||||
|
- [ ] 加固 `acc_viscosity` 合成前重置。
|
||||||
|
- [ ] 加固 `acc_body` 合成策略。
|
||||||
|
- [ ] 加固 body force 对速度方向的影响。
|
||||||
|
- [ ] 加固 body force 对加速度缓存的影响。
|
||||||
|
- [ ] 加固外部粒子力进入显式步外载占位。
|
||||||
|
- [ ] 加固非 Water 粒子跳过压力力。
|
||||||
|
- [ ] 加固 inactive 粒子跳过压力力。
|
||||||
|
- [ ] 加固 failed 粒子跳过压力力。
|
||||||
|
- [ ] 确认总加速度合成顺序清晰。
|
||||||
|
|
||||||
- [x] 实现水相 CFL 声速约束估计。
|
## 阶段 K:Solver 和时间步加固
|
||||||
- [x] 实现加速度约束估计。
|
|
||||||
- [x] 实现人工黏性约束估计。
|
|
||||||
- [x] 应用输入安全系数。
|
|
||||||
- [x] 保存 `dt_cfl` 诊断。
|
|
||||||
- [x] 保存 `dt_accel` 诊断。
|
|
||||||
- [x] 保存 `dt_viscous` 诊断。
|
|
||||||
- [x] 将三类约束最小值返回为 `dtcrit`。
|
|
||||||
- [x] 对无 water 粒子时返回明确策略。
|
|
||||||
- [x] 对非法 `h` 或声速返回明确错误。
|
|
||||||
- [x] 增加 CFL 约束测试。
|
|
||||||
- [x] 增加加速度约束测试。
|
|
||||||
- [x] 增加人工黏性约束测试。
|
|
||||||
- [x] 增加安全系数测试。
|
|
||||||
|
|
||||||
## 阶段 L:Output 和 Restart
|
- [ ] 加固未 initialize 时 `sph_advance_explicit` 错误路径。
|
||||||
|
- [ ] 加固未 build model 时 `sph_advance_explicit` 错误路径。
|
||||||
|
- [ ] 加固未 build model 时 `sph_run_explicit` 错误路径。
|
||||||
|
- [ ] 加固负 `dt` 错误路径。
|
||||||
|
- [ ] 加固零 `dt` 错误路径。
|
||||||
|
- [ ] 加固非法 Water 状态下 stable dt 错误路径。
|
||||||
|
- [ ] 加固 CFL 时间步约束诊断。
|
||||||
|
- [ ] 加固加速度时间步约束诊断。
|
||||||
|
- [ ] 加固黏性时间步约束诊断。
|
||||||
|
- [ ] 加固 safety factor 正值生效路径。
|
||||||
|
- [ ] 加固非法 safety factor 处理。
|
||||||
|
- [ ] 加固 `TIME` 与 `STEPS` 双约束运行。
|
||||||
|
- [ ] 加固最后小步不超过 `end_time`。
|
||||||
|
- [ ] 加固单步 Water 推进。
|
||||||
|
- [ ] 加固多步 Water 推进。
|
||||||
|
- [ ] 加固 `sph_run_explicit` Water 闭环。
|
||||||
|
- [ ] 加固自动输出间隔触发。
|
||||||
|
- [ ] 加固未启用输出时不自动写文件。
|
||||||
|
- [ ] 加固 restart 后继续显式步。
|
||||||
|
- [ ] 加固当前时间和步号查询。
|
||||||
|
|
||||||
- [x] 确认 CSV 输出包含 id 字段。
|
## 阶段 L:Output 加固
|
||||||
- [x] 确认 CSV 输出包含 phase 字段。
|
|
||||||
- [x] 确认 CSV 输出包含 status 字段。
|
|
||||||
- [x] 确认 CSV 输出包含 material 字段。
|
|
||||||
- [x] 确认 CSV 输出包含 section 字段。
|
|
||||||
- [x] 确认 CSV 输出包含坐标字段。
|
|
||||||
- [x] 确认 CSV 输出包含速度字段。
|
|
||||||
- [x] 确认 CSV 输出包含 rho 字段。
|
|
||||||
- [x] 确认 CSV 输出包含 pressure 字段。
|
|
||||||
- [x] 确认 CSV 输出包含 temperature 字段。
|
|
||||||
- [x] 确认 CSV 输出包含 h 字段。
|
|
||||||
- [x] 增加 Water summary 输出或诊断写出入口。
|
|
||||||
- [x] 输出 step 诊断。
|
|
||||||
- [x] 输出 time 诊断。
|
|
||||||
- [x] 输出 water mass 诊断。
|
|
||||||
- [x] 输出 water momentum 诊断。
|
|
||||||
- [x] 输出 max pressure 诊断。
|
|
||||||
- [x] 输出 min/max density 诊断。
|
|
||||||
- [x] 输出 dtcrit 诊断。
|
|
||||||
- [x] 扩展 restart 头部状态版本到 0.2。
|
|
||||||
- [x] restart 写入 Water EOS 参数。
|
|
||||||
- [x] restart 写入人工黏性参数。
|
|
||||||
- [x] restart 写入 body force 参数。
|
|
||||||
- [x] restart 写入密度状态。
|
|
||||||
- [x] restart 写入压力状态。
|
|
||||||
- [x] restart 写入 `h` 状态。
|
|
||||||
- [x] restart 写入速度、加速度和半步速度。
|
|
||||||
- [x] restart 写入邻域搜索控制参数。
|
|
||||||
- [x] restart 写入 Water 诊断状态。
|
|
||||||
- [x] restart 读入后重建邻域。
|
|
||||||
- [x] restart 读入后继续执行 Water 显式步。
|
|
||||||
- [x] 增加 0.2.0 output 测试。
|
|
||||||
- [x] 增加 0.2.0 restart 测试。
|
|
||||||
|
|
||||||
## 阶段 M:Fortran API
|
- [ ] 确认粒子 CSV 包含 id 字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含 phase 字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含 status 字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含 material 字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含 section 字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含坐标字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含速度字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含 rho 字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含 pressure 字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含 temperature 字段。
|
||||||
|
- [ ] 确认粒子 CSV 包含 h 字段。
|
||||||
|
- [ ] 确认 summary CSV 包含 step 字段。
|
||||||
|
- [ ] 确认 summary CSV 包含 time 字段。
|
||||||
|
- [ ] 确认 summary CSV 包含 water mass 字段。
|
||||||
|
- [ ] 确认 summary CSV 包含 water momentum 字段。
|
||||||
|
- [ ] 确认 summary CSV 包含 max pressure 字段。
|
||||||
|
- [ ] 确认 summary CSV 包含 min/max density 字段。
|
||||||
|
- [ ] 确认 summary CSV 包含 dtcrit 字段。
|
||||||
|
- [ ] 加固输出目录不存在时的处理。
|
||||||
|
- [ ] 加固非法输出目录错误路径。
|
||||||
|
- [ ] 确认手动 `sph_write_output` 不改变物理状态。
|
||||||
|
- [ ] 确认 CLI `--run --output` 使用实际 step/time。
|
||||||
|
|
||||||
- [x] 实现 `sph_rebuild_neighbors`。
|
## 阶段 M:Restart 加固
|
||||||
- [x] 实现 `sph_get_neighbor_stats`。
|
|
||||||
- [x] 实现 `sph_get_water_summary`。
|
|
||||||
- [x] 实现 `sph_get_water_dt_limits`。
|
|
||||||
- [x] 确认生命周期 API 兼容 0.1.1。
|
|
||||||
- [x] 确认 `.inp` 读取 API 兼容 0.1.1。
|
|
||||||
- [x] 确认 build model API 兼容 0.1.1。
|
|
||||||
- [x] 确认 stable dt API 兼容 0.1.1。
|
|
||||||
- [x] 确认 advance/run explicit API 兼容 0.1.1。
|
|
||||||
- [x] 确认 current time API 兼容 0.1.1。
|
|
||||||
- [x] 确认 particle count/state API 兼容 0.1.1。
|
|
||||||
- [x] 确认 output/restart API 兼容 0.1.1。
|
|
||||||
- [x] 确认 error query API 兼容 0.1.1。
|
|
||||||
- [x] 为新增 Fortran API 增加未初始化错误路径。
|
|
||||||
- [x] 为新增 Fortran API 增加空模型错误路径。
|
|
||||||
- [x] 为新增 Fortran API 增加正常路径测试。
|
|
||||||
|
|
||||||
## 阶段 N:C ABI、C++ 和 Python
|
- [ ] 确认 restart header 可识别。
|
||||||
|
- [ ] 确认 restart state version 记录 0.2.1 策略。
|
||||||
|
- [ ] 确认 restart 写入 current time。
|
||||||
|
- [ ] 确认 restart 写入 current step。
|
||||||
|
- [ ] 确认 restart 写入 output control。
|
||||||
|
- [ ] 确认 restart 写入 safety factor。
|
||||||
|
- [ ] 确认 restart 写入 Water EOS 参数。
|
||||||
|
- [ ] 确认 restart 写入 viscosity 参数。
|
||||||
|
- [ ] 确认 restart 写入 body force 参数。
|
||||||
|
- [ ] 确认 restart 写入粒子通用状态。
|
||||||
|
- [ ] 确认 restart 写入 rho。
|
||||||
|
- [ ] 确认 restart 写入 pressure。
|
||||||
|
- [ ] 确认 restart 写入 h。
|
||||||
|
- [ ] 确认 restart 写入 v、a、vhalf。
|
||||||
|
- [ ] 确认 restart 写入 Water 诊断状态。
|
||||||
|
- [ ] 确认 restart 读回 current time。
|
||||||
|
- [ ] 确认 restart 读回 current step。
|
||||||
|
- [ ] 确认 restart 读回 Water 参数。
|
||||||
|
- [ ] 确认 restart 读回粒子状态。
|
||||||
|
- [ ] 确认 restart 读回后重建邻域。
|
||||||
|
- [ ] 确认 restart 读回后继续 Water 显式步。
|
||||||
|
- [ ] 加固非法 restart 文件错误路径。
|
||||||
|
|
||||||
- [x] 在 C 头文件中声明 `sphlite_get_water_summary`。
|
## 阶段 N:Fortran API 加固
|
||||||
- [x] 在 C 头文件中声明 `sphlite_get_water_dt_limits`。
|
|
||||||
- [x] 在 C wrapper 中桥接 `sphlite_get_water_summary`。
|
|
||||||
- [x] 在 C wrapper 中桥接 `sphlite_get_water_dt_limits`。
|
|
||||||
- [x] 为 `sphlite_get_water_summary` 检查空指针。
|
|
||||||
- [x] 为 `sphlite_get_water_dt_limits` 检查空指针。
|
|
||||||
- [x] 确认 C 参数错误返回 `-1`。
|
|
||||||
- [x] 确认 Fortran 错误码原样返回 C 调用方。
|
|
||||||
- [x] 在 C++ wrapper 中包装 water summary。
|
|
||||||
- [x] 在 C++ wrapper 中包装 water dt limits。
|
|
||||||
- [x] 在 C++ 测试中覆盖 water summary。
|
|
||||||
- [x] 在 C++ 测试中覆盖 water dt limits。
|
|
||||||
- [x] 在 Python wrapper 中包装 water summary。
|
|
||||||
- [x] 在 Python wrapper 中包装 water dt limits。
|
|
||||||
- [x] 在 Python wrapper 中扩展 inspect 辅助函数。
|
|
||||||
- [x] 在 Python wrapper 中扩展 run 辅助函数。
|
|
||||||
- [x] 在 Python 测试中覆盖 water summary。
|
|
||||||
- [x] 在 Python 测试中覆盖 water dt limits。
|
|
||||||
- [x] 在 Python 测试中覆盖缺失 Water 参数错误。
|
|
||||||
- [x] 确认 C ABI、C++ 和 Python 不重新定义物理语义。
|
|
||||||
|
|
||||||
## 阶段 O:CLI
|
- [ ] 确认生命周期 API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 `.inp` 读取 API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 build model API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 stable dt API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 advance/run explicit API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 current time API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 particle count/state API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 output/restart API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 error query API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 neighbor rebuild API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 neighbor stats API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 water summary API 兼容 0.2.0。
|
||||||
|
- [ ] 确认 water dt limits API 兼容 0.2.0。
|
||||||
|
- [ ] 加固新增 API 未初始化错误路径。
|
||||||
|
- [ ] 加固新增 API 未 build 错误路径。
|
||||||
|
- [ ] 确认错误返回前输出参数为安全默认值。
|
||||||
|
- [ ] 确认 API 不暴露内部 allocatable 指针。
|
||||||
|
|
||||||
- [x] 保持 `sphlite --version` 可用。
|
## 阶段 O:C ABI、C++ 和 Python 加固
|
||||||
- [x] 保持 `sphlite model.inp` inspect 模式可用。
|
|
||||||
- [x] 保持 `sphlite model.inp --check` 模式可用。
|
|
||||||
- [x] 保持 `sphlite model.inp --run` 模式可用。
|
|
||||||
- [x] 保持 `sphlite model.inp --run --output output` 可用。
|
|
||||||
- [x] CLI 输出 `version` 字段。
|
|
||||||
- [x] CLI 输出 `input` 字段。
|
|
||||||
- [x] CLI 输出 `mode` 字段。
|
|
||||||
- [x] CLI 输出 `particles` 字段。
|
|
||||||
- [x] CLI 输出 `warnings` 字段。
|
|
||||||
- [x] CLI 输出 `time` 字段。
|
|
||||||
- [x] CLI 输出 `step` 字段。
|
|
||||||
- [x] CLI 输出 `status` 字段。
|
|
||||||
- [x] CLI 输出 `water_particles` 字段。
|
|
||||||
- [x] CLI 输出 `water_mass` 字段。
|
|
||||||
- [x] CLI 输出 `max_pressure` 字段。
|
|
||||||
- [x] CLI 输出 `dtcrit` 字段。
|
|
||||||
- [x] CLI 错误时打印最近错误码。
|
|
||||||
- [x] CLI 错误时打印最近错误消息。
|
|
||||||
- [x] 确认 CLI 不绕过公共生命周期接口。
|
|
||||||
- [x] 增加 0.2.0 CLI inspect 测试。
|
|
||||||
- [x] 增加 0.2.0 CLI check 测试。
|
|
||||||
- [x] 增加 0.2.0 CLI run 测试。
|
|
||||||
- [x] 增加 0.2.0 CLI output 测试。
|
|
||||||
- [x] 增加 0.2.0 CLI 错误输入测试。
|
|
||||||
|
|
||||||
## 阶段 P:CouplingInterface 最小加固
|
- [ ] 确认 C ABI 头文件保持 0.2.0 兼容。
|
||||||
|
- [ ] 加固 `sphlite_get_water_summary` 空指针错误路径。
|
||||||
|
- [ ] 加固 `sphlite_get_water_dt_limits` 空指针错误路径。
|
||||||
|
- [ ] 加固 `sphlite_get_particle_state` 空指针错误路径。
|
||||||
|
- [ ] 加固 `sphlite_get_particle_state` 小容量错误路径。
|
||||||
|
- [ ] 确认 C 参数错误返回 `-1`。
|
||||||
|
- [ ] 确认 Fortran 错误码原样返回 C 调用方。
|
||||||
|
- [ ] 确认 C wrapper 不重新定义物理语义。
|
||||||
|
- [ ] 确认 C++ wrapper 只做薄封装。
|
||||||
|
- [ ] 加固 C++ water summary 测试。
|
||||||
|
- [ ] 加固 C++ water dt limits 测试。
|
||||||
|
- [ ] 加固 C++ 生命周期 RAII 测试。
|
||||||
|
- [ ] 确认 Python 通过 C ABI 调用。
|
||||||
|
- [ ] 加固 Python water summary 包装。
|
||||||
|
- [ ] 加固 Python water dt limits 包装。
|
||||||
|
- [ ] 加固 Python inspect 辅助函数。
|
||||||
|
- [ ] 加固 Python run 辅助函数。
|
||||||
|
- [ ] 加固 Python 缺失输入错误路径。
|
||||||
|
- [ ] 加固 Python 缺失 Water 参数错误路径。
|
||||||
|
- [ ] 确认 Python 不直接访问 Fortran 内部符号。
|
||||||
|
|
||||||
- [x] 确认 Water 运行后 coupling particle count 可用。
|
## 阶段 P:CLI 加固
|
||||||
- [x] 确认 Water 运行后 coupling particle 导出可用。
|
|
||||||
- [x] 确认 coupling particle 导出包含 pressure。
|
|
||||||
- [x] 确认 coupling particle 导出包含 phase。
|
|
||||||
- [x] 确认 coupling particle 导出包含 material。
|
|
||||||
- [x] 确认外部粒子力导入接口仍可用。
|
|
||||||
- [x] 将外部粒子力导入接入显式步外载占位。
|
|
||||||
- [x] 继续记录 coupling work 占位。
|
|
||||||
- [x] 继续记录 coupling momentum 占位。
|
|
||||||
- [x] 继续记录 coupling energy 占位。
|
|
||||||
- [x] 保持接触耦合类型字段。
|
|
||||||
- [x] 保持连续体耦合类型字段。
|
|
||||||
- [x] 确认接口命名不出现 FEMLite 内部结构。
|
|
||||||
- [x] 确认默认 gate 不运行真实 FEM-SPH 联合测试。
|
|
||||||
- [x] 扩展 coupling_interface 测试覆盖 Water 运行后状态。
|
|
||||||
|
|
||||||
## 阶段 Q:Pressure Wave Smoke
|
- [ ] 保持 `sphlite --version` 可用。
|
||||||
|
- [ ] 保持 `sphlite model.inp` inspect 模式可用。
|
||||||
|
- [ ] 保持 `sphlite model.inp --check` 模式可用。
|
||||||
|
- [ ] 保持 `sphlite model.inp --run` 模式可用。
|
||||||
|
- [ ] 保持 `sphlite model.inp --run --output output` 可用。
|
||||||
|
- [ ] 确认 CLI 输出 `version` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `input` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `mode` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `particles` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `warnings` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `time` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `step` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `water_particles` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `water_mass` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `max_pressure` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `dtcrit` 字段。
|
||||||
|
- [ ] 确认 CLI 输出 `status` 字段。
|
||||||
|
- [ ] 加固缺少输入文件的错误路径。
|
||||||
|
- [ ] 加固输入文件不存在的错误路径。
|
||||||
|
- [ ] 加固 `--run` 与 `--check` 同时给出的错误路径。
|
||||||
|
- [ ] 加固 `--output` 缺少路径的错误路径。
|
||||||
|
- [ ] 加固 Water 参数缺失的错误路径。
|
||||||
|
- [ ] 加固输出目录非法的错误路径。
|
||||||
|
- [ ] 确认 CLI 不绕过公共生命周期接口。
|
||||||
|
|
||||||
- [x] 确定 pressure wave smoke 的最小粒子布置。
|
## 阶段 Q:CouplingInterface 加固
|
||||||
- [x] 确定 pressure wave smoke 的初始压力扰动。
|
|
||||||
- [x] 确定 pressure wave smoke 的运行步数。
|
|
||||||
- [x] 确定 pressure wave smoke 的 checker 阈值。
|
|
||||||
- [x] 实现 pressure wave smoke 输入文件。
|
|
||||||
- [x] 实现 pressure wave smoke 运行脚本或测试程序。
|
|
||||||
- [x] 检查 pressure wave smoke 输出有限性。
|
|
||||||
- [x] 检查 pressure wave smoke 压力扰动传播方向。
|
|
||||||
- [x] 检查 pressure wave smoke 质量趋势。
|
|
||||||
- [x] 检查 pressure wave smoke 动量趋势。
|
|
||||||
- [x] 检查 pressure wave smoke 输出字段。
|
|
||||||
- [x] 确认 pressure wave smoke 不作为工程精度 benchmark。
|
|
||||||
- [x] 确认 pressure wave smoke 保持小规模。
|
|
||||||
- [x] 将 pressure wave smoke 纳入默认 gate。
|
|
||||||
|
|
||||||
## 阶段 R:Source Size 和测试门禁
|
- [ ] 确认 Water 运行后 coupling particle count 可用。
|
||||||
|
- [ ] 确认 Water 运行后 coupling particle state 导出可用。
|
||||||
|
- [ ] 确认 coupling particle 导出包含 id。
|
||||||
|
- [ ] 确认 coupling particle 导出包含 position。
|
||||||
|
- [ ] 确认 coupling particle 导出包含 velocity。
|
||||||
|
- [ ] 确认 coupling particle 导出包含 phase。
|
||||||
|
- [ ] 确认 coupling particle 导出包含 material。
|
||||||
|
- [ ] 确认 coupling particle 导出包含 pressure。
|
||||||
|
- [ ] 确认外部粒子力导入接口可用。
|
||||||
|
- [ ] 确认外部粒子力影响显式步。
|
||||||
|
- [ ] 确认 coupling work 诊断继续记录。
|
||||||
|
- [ ] 确认 coupling momentum 诊断继续记录。
|
||||||
|
- [ ] 确认 coupling energy 诊断继续记录。
|
||||||
|
- [ ] 保持接触耦合类型字段。
|
||||||
|
- [ ] 保持连续体耦合类型字段。
|
||||||
|
- [ ] 确认接口命名不出现 FEMLite 内部结构。
|
||||||
|
- [ ] 确认默认 gate 不运行真实 FEM-SPH 联合测试。
|
||||||
|
- [ ] 评估 0.2.1 是否暴露 C ABI coupling 接口。
|
||||||
|
- [ ] 若不暴露 C ABI coupling 接口,在文档中记录原因。
|
||||||
|
|
||||||
- [x] 确认 source size 覆盖 Fortran 文件。
|
## 阶段 R:Pressure Wave Smoke 加固
|
||||||
- [x] 确认 source size 覆盖 C 文件。
|
|
||||||
- [x] 确认 source size 覆盖 C++ 头文件。
|
|
||||||
- [x] 确认 source size 覆盖 Python 文件。
|
|
||||||
- [x] 为新增大文件登记必要例外。
|
|
||||||
- [x] 确认 stale exception 检查有效。
|
|
||||||
- [x] 运行 `kernel` 测试。
|
|
||||||
- [x] 运行 `neighbor` 测试。
|
|
||||||
- [x] 运行 `water_eos` 测试。
|
|
||||||
- [x] 运行 `water_density` 测试。
|
|
||||||
- [x] 运行 `water_viscosity` 测试。
|
|
||||||
- [x] 运行 `water_force` 测试。
|
|
||||||
- [x] 运行 `solver_water` 测试。
|
|
||||||
- [x] 运行 `pressure_wave_smoke` 测试。
|
|
||||||
- [x] 运行 0.1.1 既有接口测试。
|
|
||||||
- [x] 运行 `source_size` 测试。
|
|
||||||
- [x] 运行 `git diff --check`。
|
|
||||||
|
|
||||||
## 阶段 S:文档同步
|
- [ ] 保持已有 5 粒子 pressure wave smoke 可用。
|
||||||
|
- [ ] 评估是否增加非共线 3D 粒子布置。
|
||||||
|
- [ ] 若增加非共线布置,创建对应输入文件。
|
||||||
|
- [ ] 加固初始压力扰动设置。
|
||||||
|
- [ ] 加固运行步数检查。
|
||||||
|
- [ ] 加固 checker 阈值说明。
|
||||||
|
- [ ] 检查压力扰动传播方向。
|
||||||
|
- [ ] 检查输出有限性。
|
||||||
|
- [ ] 检查质量趋势。
|
||||||
|
- [ ] 检查动量趋势。
|
||||||
|
- [ ] 检查粒子 CSV 输出字段。
|
||||||
|
- [ ] 检查 summary CSV 输出字段。
|
||||||
|
- [ ] 确认 pressure wave smoke 不作为工程精度 benchmark。
|
||||||
|
- [ ] 确认 pressure wave smoke 保持小规模。
|
||||||
|
- [ ] 确认 pressure wave smoke 进入默认 gate。
|
||||||
|
|
||||||
- [x] 更新 README 当前版本为 0.2.0。
|
## 阶段 S:Source Size 和默认 Gate
|
||||||
- [x] 更新 README 的 0.2.0 实际能力说明。
|
|
||||||
- [x] 记录 0.2.0 交付 Water 基础弱可压 SPH。
|
|
||||||
- [x] 记录 0.2.0 不交付 Gas 生产路径。
|
|
||||||
- [x] 记录 0.2.0 不交付 Explosive 生产路径。
|
|
||||||
- [x] 记录 0.2.0 不交付 Solid 生产路径。
|
|
||||||
- [x] 记录 0.2.0 不交付 Shell 生产路径。
|
|
||||||
- [x] 记录 0.2.0 不交付真实 FEM-SPH 联合运行。
|
|
||||||
- [x] 更新 `docs/09_release_history.md` 的 0.2.0 条目。
|
|
||||||
- [x] 更新 `docs/11_benchmark_matrix.md` 的 0.2.0 gate。
|
|
||||||
- [x] 确认 01-06 文档与 0.2.0 实际能力不冲突。
|
|
||||||
- [x] 确认文档使用 UTF-8 without BOM。
|
|
||||||
- [x] 确认文档不宣称已实现完整水下爆炸。
|
|
||||||
- [x] 确认文档不宣称已实现生产级多物理耦合。
|
|
||||||
|
|
||||||
## 阶段 T:0.2.0 验收
|
- [ ] 确认 source size 覆盖 Fortran 文件。
|
||||||
|
- [ ] 确认 source size 覆盖 C 文件。
|
||||||
|
- [ ] 确认 source size 覆盖 C++ 头文件。
|
||||||
|
- [ ] 确认 source size 覆盖 Python 文件。
|
||||||
|
- [ ] 为新增大文件登记必要例外。
|
||||||
|
- [ ] 确认 stale exception 检查有效。
|
||||||
|
- [ ] 运行 `smoke` 测试。
|
||||||
|
- [ ] 运行 `input` 测试。
|
||||||
|
- [ ] 运行 `kernel` 测试。
|
||||||
|
- [ ] 运行 `neighbor` 测试。
|
||||||
|
- [ ] 运行 `water_eos` 测试。
|
||||||
|
- [ ] 运行 `water_density` 测试。
|
||||||
|
- [ ] 运行 `water_viscosity` 测试。
|
||||||
|
- [ ] 运行 `water_force` 测试。
|
||||||
|
- [ ] 运行 `solver_water` 测试。
|
||||||
|
- [ ] 运行 `output` 测试。
|
||||||
|
- [ ] 运行 `restart` 测试。
|
||||||
|
- [ ] 运行 `coupling_interface` 测试。
|
||||||
|
- [ ] 运行 `c_api` 测试。
|
||||||
|
- [ ] 运行 `cpp_api` 测试。
|
||||||
|
- [ ] 运行 `python_debug` 测试。
|
||||||
|
- [ ] 运行 `cli` 测试。
|
||||||
|
- [ ] 运行 `pressure_wave_smoke` 测试。
|
||||||
|
- [ ] 运行 `source_size` 测试。
|
||||||
|
- [ ] 运行 `git diff --check`。
|
||||||
|
|
||||||
- [x] 完整配置 CMake。
|
## 阶段 T:文档同步
|
||||||
- [x] 完整编译 `sphlite_core`。
|
|
||||||
- [x] 完整编译 `sphlite_c`。
|
- [ ] 更新 README 当前版本为 0.2.1。
|
||||||
- [x] 完整编译 `sphlite`。
|
- [ ] 更新 README 的 0.2.1 实际能力说明。
|
||||||
- [x] 完整编译新增 Fortran 测试目标。
|
- [ ] 记录 0.2.1 交付 Water 加固能力。
|
||||||
- [x] 完整编译新增 C/C++ 测试目标。
|
- [ ] 记录 0.2.1 不交付 Gas 生产路径。
|
||||||
- [x] 运行 `ctest -R "^(smoke|input|kernel|neighbor|water_eos|water_density|water_viscosity|water_force|solver_water|output|restart|c_api|cpp_api|python_debug|cli|pressure_wave_smoke)$"`。
|
- [ ] 记录 0.2.1 不交付 Explosive 生产路径。
|
||||||
- [x] 运行 `ctest -R "^source_size$"`。
|
- [ ] 记录 0.2.1 不交付 Solid 生产路径。
|
||||||
- [x] 运行 `git diff --check`。
|
- [ ] 记录 0.2.1 不交付 Shell 生产路径。
|
||||||
- [x] 确认没有提交 build 目录。
|
- [ ] 记录 0.2.1 不交付真实 FEM-SPH 联合运行。
|
||||||
- [x] 确认没有提交 Python 缓存。
|
- [ ] 更新 `docs/09_release_history.md` 的 0.2.1 条目。
|
||||||
- [x] 确认没有提交 CSV 临时结果。
|
- [ ] 更新 `docs/11_benchmark_matrix.md` 的 0.2.1 gate。
|
||||||
- [x] 确认没有提交 VTK 临时结果。
|
- [ ] 确认 01-06 文档与 0.2.1 实际能力不冲突。
|
||||||
- [x] 确认没有提交 restart 临时结果。
|
- [ ] 确认文档使用 UTF-8 without BOM。
|
||||||
- [x] 确认没有残留旧模块命名。
|
- [ ] 确认文档不宣称已实现完整水下爆炸。
|
||||||
- [x] 确认没有新增 FEMLite 源码依赖。
|
- [ ] 确认文档不宣称已实现生产级多物理耦合。
|
||||||
- [x] 确认没有新增几何生成能力。
|
- [ ] 记录 restart 格式版本策略。
|
||||||
- [x] 确认没有新增网格生成能力。
|
- [ ] 记录非 `TYPE=TAIT` EOS 的 0.2.1 处理策略。
|
||||||
- [x] 记录 0.2.0 release gate 结果。
|
- [ ] 记录 Water 拉伸压力策略。
|
||||||
|
- [ ] 记录 CouplingInterface C ABI 是否进入 0.2.1。
|
||||||
|
- [ ] 记录 VTK 是否进入 0.2.1。
|
||||||
|
|
||||||
|
## 阶段 U:0.2.1 验收
|
||||||
|
|
||||||
|
- [ ] 完整配置 CMake。
|
||||||
|
- [ ] 完整编译 `sphlite_core`。
|
||||||
|
- [ ] 完整编译 `sphlite_c`。
|
||||||
|
- [ ] 完整编译 `sphlite_c_shared`。
|
||||||
|
- [ ] 完整编译 `sphlite`。
|
||||||
|
- [ ] 完整编译新增 Fortran 测试目标。
|
||||||
|
- [ ] 完整编译新增 C/C++ 测试目标。
|
||||||
|
- [ ] 运行 `ctest -R "^(smoke|input|kernel|neighbor|water_eos|water_density|water_viscosity|water_force|solver_water|output|restart|coupling_interface|c_api|cpp_api|python_debug|cli|pressure_wave_smoke)$"`。
|
||||||
|
- [ ] 运行 `ctest -R "^source_size$"`。
|
||||||
|
- [ ] 运行 `git diff --check`。
|
||||||
|
- [ ] 确认没有提交 build 目录。
|
||||||
|
- [ ] 确认没有提交 Python 缓存。
|
||||||
|
- [ ] 确认没有提交 CSV 临时结果。
|
||||||
|
- [ ] 确认没有提交 VTK 临时结果。
|
||||||
|
- [ ] 确认没有提交 restart 临时结果。
|
||||||
|
- [ ] 确认没有残留旧模块命名。
|
||||||
|
- [ ] 确认没有新增 FEMLite 源码依赖。
|
||||||
|
- [ ] 确认没有新增几何生成能力。
|
||||||
|
- [ ] 确认没有新增网格生成能力。
|
||||||
|
- [ ] 确认没有新增粒子生成能力。
|
||||||
|
- [ ] 记录 0.2.1 release gate 结果。
|
||||||
|
|||||||
@@ -43,7 +43,7 @@ def main() -> int:
|
|||||||
|
|
||||||
version = run_command([exe, "--version"])
|
version = run_command([exe, "--version"])
|
||||||
require_field(version.stdout, "version")
|
require_field(version.stdout, "version")
|
||||||
if "0.2.0" not in version.stdout:
|
if "0.2.1" not in version.stdout:
|
||||||
raise AssertionError("CLI version mismatch")
|
raise AssertionError("CLI version mismatch")
|
||||||
|
|
||||||
inspect = run_command([exe, model])
|
inspect = run_command([exe, model])
|
||||||
|
|||||||
@@ -19,6 +19,8 @@ def main() -> int:
|
|||||||
solver = SPHLite(args.library)
|
solver = SPHLite(args.library)
|
||||||
if PHASE_SOLID != 4 or STATUS_ACTIVE != 0:
|
if PHASE_SOLID != 4 or STATUS_ACTIVE != 0:
|
||||||
raise AssertionError("Python constants are not locked")
|
raise AssertionError("Python constants are not locked")
|
||||||
|
if solver.version() != (0, 2, 1):
|
||||||
|
raise AssertionError("Python version mismatch")
|
||||||
|
|
||||||
solver.initialize()
|
solver.initialize()
|
||||||
try:
|
try:
|
||||||
|
|||||||
Reference in New Issue
Block a user