From 86259eb8f0d495546f6fdf4790de13b52602a60e Mon Sep 17 00:00:00 2001 From: Codex Date: Thu, 2 Jul 2026 23:15:17 +0800 Subject: [PATCH] Document Tait strategy and density viscosity edges --- docs/04_mathematical_model_and_algorithms.md | 4 ++ tests/module/test_water_density.f90 | 54 +++++++++++++++++++- tests/module/test_water_viscosity.f90 | 35 +++++++++++++ todo.md | 40 +++++++-------- 4 files changed, 111 insertions(+), 22 deletions(-) diff --git a/docs/04_mathematical_model_and_algorithms.md b/docs/04_mathematical_model_and_algorithms.md index fd445aa..3ff64ee 100644 --- a/docs/04_mathematical_model_and_algorithms.md +++ b/docs/04_mathematical_model_and_algorithms.md @@ -35,8 +35,12 @@ Riemann-SPH 或其他可压缩强冲击格式作为后续近场冲击升级方 水相采用弱可压 SPH。密度演化采用连续性方程,不保留 summation density 作为主流程或辅助校正工具。 +0.2.1 默认流程只更新连续性方程形式的 `drho_dt`。summation density 仍可作为后续 checker 或对比诊断的规划入口,但不进入生产推进链路,也不改变主状态。 + 第一阶段水体 EOS 为 Tait EOS。水相压力由密度和参考声速等参数计算。具体参数和单位由输入文件给定,SPHLite 不做内置单位换算。 +0.2.1 阶段继续采用 Tait EOS 作为 `Water` 的唯一生产 EOS。`B` 未显式给定时按 `rho0*c0*c0/gamma` 推导,显式给定时要求为正值;`P0` 为可选项,未给定时取 0。当前版本保留 `rho < rho0` 时由 Tait EOS 得到的拉伸负压,不做压力截断或空化修正,该策略只用于小规模数值链路加固,后续如需拉伸稳定控制应单独规划。 + 水相动量方程包含: - 压力梯度项。 diff --git a/tests/module/test_water_density.f90 b/tests/module/test_water_density.f90 index 5bcf0b3..c3dd385 100644 --- a/tests/module/test_water_density.f90 +++ b/tests/module/test_water_density.f90 @@ -3,10 +3,10 @@ program test_water_density use sph_error, only: SPH_SUCCESS use sph_database, only: sph_db_allocate, sph_db_free, x, v, h, mass, rho, & drho_dt, particle_phase, particle_status, SPH_PHASE_WATER, SPH_PHASE_SOLID, & - SPH_STATUS_ACTIVE, SPH_STATUS_INACTIVE + SPH_STATUS_ACTIVE, SPH_STATUS_INACTIVE, SPH_STATUS_FAILED use sph_neighbor, only: sph_neighbor_rebuild use sph_water, only: sph_water_initialize, sph_water_reset, & - sph_water_compute_density_rate + sph_water_compute_density_rate, sph_water_tait_pressure implicit none integer :: ierr @@ -16,6 +16,9 @@ program test_water_density call check_static_particles() call check_nonwater_skip() call check_inactive_skip() + call check_failed_skip() + call check_empty_neighbor_density() + call check_low_density_error() call sph_water_reset() contains @@ -41,6 +44,7 @@ contains call sph_water_compute_density_rate(ierr) call assert_ok(ierr, 'compression density failed') if (drho_dt(1) <= 0.0_rk .or. drho_dt(2) <= 0.0_rk) call fail('compression sign mismatch') + if (.not. is_finite_vector(drho_dt)) call fail('compression density is not finite') call sph_db_free() end subroutine check_pair_compression @@ -53,6 +57,7 @@ contains call sph_water_compute_density_rate(ierr) call assert_ok(ierr, 'extension density failed') if (drho_dt(1) >= 0.0_rk .or. drho_dt(2) >= 0.0_rk) call fail('extension sign mismatch') + if (.not. is_finite_vector(drho_dt)) call fail('extension density is not finite') call sph_db_free() end subroutine check_pair_extension @@ -99,6 +104,44 @@ contains call sph_db_free() end subroutine check_inactive_skip + subroutine check_failed_skip() + call setup_pair() + particle_status(2) = SPH_STATUS_FAILED + v(:,1) = (/1.0_rk, 0.0_rk, 0.0_rk/) + v(:,2) = (/-1.0_rk, 0.0_rk, 0.0_rk/) + drho_dt = 5.0_rk + call sph_neighbor_rebuild(ierr) + call assert_ok(ierr, 'failed neighbor failed') + call sph_water_compute_density_rate(ierr) + call assert_ok(ierr, 'failed density failed') + if (maxval(abs(drho_dt)) > 1.0e-12_rk) call fail('failed particle was not skipped') + call sph_db_free() + end subroutine check_failed_skip + + subroutine check_empty_neighbor_density() + call sph_db_allocate(1, ierr) + call assert_ok(ierr, 'empty-neighbor allocation failed') + particle_phase = SPH_PHASE_WATER + particle_status = SPH_STATUS_ACTIVE + h = 1.0_rk + mass = 1.0_rk + rho = 1000.0_rk + drho_dt = 3.0_rk + call sph_neighbor_rebuild(ierr) + call assert_ok(ierr, 'empty-neighbor rebuild failed') + call sph_water_compute_density_rate(ierr) + call assert_ok(ierr, 'empty-neighbor density failed') + if (maxval(abs(drho_dt)) > 1.0e-12_rk) call fail('empty-neighbor density mismatch') + call sph_db_free() + end subroutine check_empty_neighbor_density + + subroutine check_low_density_error() + real(rk) :: pressure_value + + call sph_water_tait_pressure(0.0_rk, pressure_value, ierr) + if (ierr == SPH_SUCCESS) call fail('low density did not fail') + end subroutine check_low_density_error + subroutine assert_ok(ierr_value, message) integer, intent(in) :: ierr_value character(len=*), intent(in) :: message @@ -106,6 +149,13 @@ contains if (ierr_value /= SPH_SUCCESS) call fail(message) end subroutine assert_ok + logical function is_finite_vector(value_in) + real(rk), intent(in) :: value_in(:) + + is_finite_vector = all(value_in == value_in) .and. & + maxval(abs(value_in)) < huge(value_in(1)) + end function is_finite_vector + subroutine fail(message) character(len=*), intent(in) :: message diff --git a/tests/module/test_water_viscosity.f90 b/tests/module/test_water_viscosity.f90 index d01cc1a..f2fa741 100644 --- a/tests/module/test_water_viscosity.f90 +++ b/tests/module/test_water_viscosity.f90 @@ -17,6 +17,8 @@ program test_water_viscosity call assert_ok(ierr, 'set viscosity failed') call check_approaching_pair() call check_separating_pair() + call check_zero_distance_pair() + call check_near_distance_pair() call sph_water_reset() contains @@ -62,6 +64,32 @@ contains call sph_db_free() end subroutine check_separating_pair + subroutine check_zero_distance_pair() + call setup_pair() + x(:,2) = x(:,1) + v(:,1) = (/1.0_rk, 0.0_rk, 0.0_rk/) + v(:,2) = (/-1.0_rk, 0.0_rk, 0.0_rk/) + call sph_neighbor_rebuild(ierr) + call assert_ok(ierr, 'zero-distance neighbor failed') + call sph_water_compute_viscosity_acceleration(ierr) + call assert_ok(ierr, 'zero-distance viscosity failed') + if (.not. is_finite_vector(acc_viscosity(:,1))) call fail('zero-distance viscosity is not finite') + call sph_db_free() + end subroutine check_zero_distance_pair + + subroutine check_near_distance_pair() + call setup_pair() + x(:,2) = (/1.0e-12_rk, 0.0_rk, 0.0_rk/) + v(:,1) = (/1.0_rk, 0.0_rk, 0.0_rk/) + v(:,2) = (/-1.0_rk, 0.0_rk, 0.0_rk/) + call sph_neighbor_rebuild(ierr) + call assert_ok(ierr, 'near-distance neighbor failed') + call sph_water_compute_viscosity_acceleration(ierr) + call assert_ok(ierr, 'near-distance viscosity failed') + if (.not. is_finite_vector(acc_viscosity(:,1))) call fail('near-distance viscosity is not finite') + call sph_db_free() + end subroutine check_near_distance_pair + subroutine assert_ok(ierr_value, message) integer, intent(in) :: ierr_value character(len=*), intent(in) :: message @@ -69,6 +97,13 @@ contains if (ierr_value /= SPH_SUCCESS) call fail(message) end subroutine assert_ok + logical function is_finite_vector(value_in) + real(rk), intent(in) :: value_in(:) + + is_finite_vector = all(value_in == value_in) .and. & + maxval(abs(value_in)) < huge(value_in(1)) + end function is_finite_vector + subroutine fail(message) character(len=*), intent(in) :: message diff --git a/todo.md b/todo.md index 90cca92..5552913 100644 --- a/todo.md +++ b/todo.md @@ -164,32 +164,32 @@ - [x] 加固 `B <= 0` 错误路径。 - [x] 加固声速诊断保持正值。 - [x] 加固压力计算结果有限。 -- [ ] 加固 `B` 自动推导结果。 -- [ ] 加固显式给定 `B` 的结果。 -- [ ] 加固 Water summary 中最大压力诊断。 -- [ ] 在文档中记录 0.2.1 Tait EOS 当前策略。 +- [x] 加固 `B` 自动推导结果。 +- [x] 加固显式给定 `B` 的结果。 +- [x] 加固 Water summary 中最大压力诊断。 +- [x] 在文档中记录 0.2.1 Tait EOS 当前策略。 ## 阶段 H:连续性方程加固 -- [ ] 加固双粒子压缩时 `drho_dt` 符号。 -- [ ] 加固双粒子拉伸时 `drho_dt` 符号。 -- [ ] 加固静止均匀粒子组密度变化接近零。 -- [ ] 加固非 Water 粒子跳过密度贡献。 -- [ ] 加固 inactive 粒子跳过密度贡献。 -- [ ] 加固 failed 粒子跳过密度贡献。 -- [ ] 加固 `drho_dt` 每步重置。 -- [ ] 加固密度更新结果有限。 -- [ ] 加固低密度输入的错误路径。 -- [ ] 加固邻域为空时密度变化处理。 -- [ ] 确认 summation density 不进入主流程。 -- [ ] 保留 summation density 后续 checker 入口说明。 +- [x] 加固双粒子压缩时 `drho_dt` 符号。 +- [x] 加固双粒子拉伸时 `drho_dt` 符号。 +- [x] 加固静止均匀粒子组密度变化接近零。 +- [x] 加固非 Water 粒子跳过密度贡献。 +- [x] 加固 inactive 粒子跳过密度贡献。 +- [x] 加固 failed 粒子跳过密度贡献。 +- [x] 加固 `drho_dt` 每步重置。 +- [x] 加固密度更新结果有限。 +- [x] 加固低密度输入的错误路径。 +- [x] 加固邻域为空时密度变化处理。 +- [x] 确认 summation density 不进入主流程。 +- [x] 保留 summation density 后续 checker 入口说明。 ## 阶段 I:人工黏性加固 -- [ ] 加固接近粒子产生人工黏性贡献。 -- [ ] 加固远离粒子不产生压缩型人工黏性贡献。 -- [ ] 加固零距离粒子人工黏性有限。 -- [ ] 加固极小距离粒子人工黏性有限。 +- [x] 加固接近粒子产生人工黏性贡献。 +- [x] 加固远离粒子不产生压缩型人工黏性贡献。 +- [x] 加固零距离粒子人工黏性有限。 +- [x] 加固极小距离粒子人工黏性有限。 - [ ] 加固 `alpha < 0` 错误路径。 - [ ] 加固 `beta < 0` 错误路径。 - [ ] 加固 `eta2 <= 0` 错误路径。