Document Tait strategy and density viscosity edges

This commit is contained in:
Codex
2026-07-02 23:15:17 +08:00
parent 45d292a100
commit 86259eb8f0
4 changed files with 111 additions and 22 deletions
@@ -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 得到的拉伸负压,不做压力截断或空化修正,该策略只用于小规模数值链路加固,后续如需拉伸稳定控制应单独规划。
水相动量方程包含:
- 压力梯度项。
+52 -2
View File
@@ -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
+35
View File
@@ -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
+20 -20
View File
@@ -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` 错误路径。