Files
SPHLite/docs/03_detailed_design.md
T
2026-07-02 18:47:38 +08:00

246 lines
9.1 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 03 详细设计
文档状态:规划确认稿
## 1. 设计原则
SPHLite 核心使用 Fortran 95 实现,详细设计采用集中数组数据库和过程式模块协作方式。核心状态集中存放在 `sph_database` 一类模块中,物理模块围绕数据库读取通用状态、维护自身派生状态,并通过显式求解器推进。
SPHLite 不采用面向对象的粒子类设计。输入文件中的 `*NODE` id 作为 external id 读取,数据库内部统一按 particle 管理。
## 2. 数据库分层
SPHLite 采用集中型数据库,推荐分层如下:
| 层级 | 职责 |
|---|---|
| 通用粒子状态 | id、phase、material、section、位置、速度、加速度、质量、密度、压力、体积 |
| 输入映射 | external node id、external element id、set、section、material 名称和内部 id 映射 |
| 物理状态 | 水相、气相、炸药、实体结构、板壳结构的模块状态 |
| 求解状态 | 当前时间、步数、dt、Velocity-Verlet 中间量和稳定时间步 |
| 诊断状态 | 质量、动量、能量、气泡指标、损伤统计、耦合交换量 |
| restart 状态 | 恢复继续计算所需的所有模块级状态 |
set 来源于输入文件,只表示用户集合,可包含同种或不同种类粒子。region 是运行时区域,由 set、material、section、phase 或扩展关键词解析得到,用于输出、耦合或模块选择。
## 3. 通用粒子状态
第一阶段建议 `sph_database` 至少保存以下通用数组:
```fortran
integer :: npart
integer, allocatable :: particle_id_ext(:)
integer, allocatable :: particle_phase(:)
integer, allocatable :: particle_status(:)
integer, allocatable :: material_id(:)
integer, allocatable :: section_id(:)
real(rk), allocatable :: x0(:,:)
real(rk), allocatable :: x(:,:)
real(rk), allocatable :: v(:,:)
real(rk), allocatable :: a(:,:)
real(rk), allocatable :: vhalf(:,:)
real(rk), allocatable :: mass(:)
real(rk), allocatable :: rho(:)
real(rk), allocatable :: volume(:)
real(rk), allocatable :: pressure(:)
real(rk), allocatable :: internal_energy(:)
real(rk), allocatable :: temperature(:)
real(rk), allocatable :: h(:)
```
数组形状约定:
- `x0(3,npart)`:参考坐标。
- `x(3,npart)`:当前坐标。
- `v(3,npart)`:当前速度。
- `a(3,npart)`:当前加速度。
- `vhalf(3,npart)`:Velocity-Verlet 或等价显式推进所需的半步速度。
- `h(npart)`:每粒子独立光滑长度。
Velocity-Verlet restart 应保存 `v`、`a` 和 `vhalf` 三类速度/加速度相关状态,保证继续计算路径可恢复。
## 4. Phase、Material 和 Section
SPHLite 使用 `phase + material_id + section_id + set/region` 分层识别计算行为:
- `phase` 决定粒子当前由哪个物理模块处理。
- `material_id` 决定 EOS、本构和失效参数。
- `section_id` 决定实体或板壳 section 属性。
- `set` 保留输入集合语义,不参与类型判断。
- `region` 表示运行时计算区域、输出区域或耦合区域。
建议 phase 枚举至少预留:
- `PHASE_WATER`
- `PHASE_GAS`
- `PHASE_EXPLOSIVE`
- `PHASE_SOLID`
- `PHASE_SHELL`
- `PHASE_BOUNDARY`
- `PHASE_COUPLING`
- `PHASE_SOLID_FAILED`
- `PHASE_SHELL_FAILED`
phase 改变是不可逆历史过程。爆炸反应、气体生成、结构失效和板壳撕裂均可通过 phase 和 status 的组合表达。
默认不删除粒子。失效、破裂或不再参与某些模块计算的粒子通过 `particle_status` 和 `particle_phase` 控制。
## 5. 邻域搜索和核函数
第一阶段邻域搜索采用 uniform cell/bin 方法,不引入复杂树结构。数据库或 `Particle` 模块应维护:
- cell 尺寸和空间范围。
- 每粒子所属 cell。
- cell 链表或压缩索引。
- 全局邻域表。
- 搜索半径和每粒子 `h(i)`。
邻域表采用全局搜索,模块内部按 phase、material、section 或 region 过滤相互作用。这样可避免多张邻域表之间不同步。
核函数模块应提供:
- 核函数值。
- 核函数梯度。
- 支持半径。
- 与每粒子 `h(i)` 相关的归一化系数。
## 6. Water 状态
水相通用位置、速度、密度、压力等数据保存在数据库中。`Water` 维护水相计算所需的参数、派生量和临时工作数组。
第一阶段 `Water` 至少需要:
- 水相 EOS 参数。
- 人工黏性或后续 Riemann 通量参数。
- 密度变化率或连续方程临时量。
- 水相压力、加速度和能量贡献诊断。
- 自由面或边界标记的运行时缓存。
水相计算只处理 phase 为水或与水存在相互作用的 region。水和气共享粒子数据库,但计算模块保持独立。
## 7. Gas 状态
`Gas` 负责气体相状态、气体 EOS、气体团簇和气泡诊断。第一批 EOS 为 JWL 和理想气体。
`Gas` 至少维护:
- 气体 EOS 类型和参数。
- 气体内能、温度或等效能量相关派生量。
- 气体团簇 id 和团簇统计。
- 气体总体积、中心、平均压力和最大压力。
- 等效气泡半径、半径变化率、脉动周期和中心迁移指标。
- 来自 `Explosive` 的质量、动量和能量源项累计量。
气泡不是一级模块,而是 `Gas` 在水介质中的现象和诊断分支。
## 8. Explosive 状态
`Explosive` 负责炸药点火、爆轰传播、反应进度和能量释放。第一阶段需要同时预留两条路线:
- 同一粒子从 explosive phase 不可逆迁移到 gas phase。
- 炸药粒子保留自身状态,并向 `Gas` 注入质量、动量和能量源项。
建议状态包括:
```fortran
real(rk), allocatable :: detonation_time(:)
real(rk), allocatable :: reaction_progress(:)
real(rk), allocatable :: gas_mass_source(:)
real(rk), allocatable :: gas_energy_source(:)
real(rk), allocatable :: gas_momentum_source(:,:)
integer, allocatable :: ignition_status(:)
```
其中 `gas_momentum_source(3,npart)` 使用列主序形状。
restart 必须保存爆轰到达状态、反应进度和源项累计量。
## 9. Solid 状态
`Solid` 面向 3D 实体结构粒子,初步目标是 Johnson-Cook 材料模型和 Johnson-Cook 失效模型。基础弹性状态可作为调试和退化路径,但交付目标应面向率相关塑性、损伤和失效。
建议第一阶段保存:
- 参考构型和当前构型。
- 变形梯度或修正梯度相关状态。
- Cauchy 应力或等价应力状态。
- 等效塑性应变。
- 等效塑性应变率。
- 温度或等效温升。
- Johnson-Cook 损伤变量。
- 失效状态。
- 内力和能量诊断。
失效后不删除粒子。结构失效粒子通过 `PHASE_SOLID_FAILED` 和 status 表达,后续可进入碎片、接触或自由面处理。
## 10. Shell 状态
`Shell` 面向板壳粒子,采用 Mindlin-Reissner 板壳理论路线。板壳是 2D 几何,通过 section 识别厚度、积分点和板壳属性。
建议第一阶段保存:
```fortran
real(rk), allocatable :: shell_thickness(:)
real(rk), allocatable :: shell_director(:,:)
real(rk), allocatable :: shell_omega(:,:)
real(rk), allocatable :: shell_membrane_strain(:,:)
real(rk), allocatable :: shell_bending_strain(:,:)
real(rk), allocatable :: shell_shear_strain(:,:)
real(rk), allocatable :: shell_damage(:)
integer, allocatable :: shell_failure_status(:)
```
其中:
- `shell_director(3,npart)` 表示板壳 director 或法向。
- `shell_omega(3,npart)` 表示角速度或转动相关状态。
- 厚度积分点材料状态应预留独立数组或压缩存储。
板壳失效后使用 `PHASE_SHELL_FAILED` 和 status 表达,后续可进入撕裂、穿孔、碎片或接触处理。
## 11. CouplingInterface 状态
SPHLite 内部不实现外部耦合模块,也不依赖 FEMLite。内部只提供 `CouplingInterface`,用于导出和导入中立耦合数据。
`CouplingInterface` 应维护或生成:
- SPHLite 侧 coupling region。
- 耦合粒子 id、坐标、速度、phase、material 和 section。
- 耦合边界面或近似面片的几何、法向和面积。
- 外部导入的节点力、面力、体力、位移/速度约束或连续体交换量。
- 耦合功、动量交换、能量交换和错误诊断。
接触耦合和连续体耦合必须在状态和诊断中区分。外部耦合模块暂称 `CouplingModule`,后续可改名。
## 12. 壳-实体连接占位
壳粒子与实体粒子的连接不作为第一阶段交付能力。数据库和接口可以预留 connection 或 interface region 概念,后续用于:
- 壳-实体结构连接。
- 壳-实体连续体耦合。
- 局部壳模型和实体模型过渡。
第一阶段不要求实现连接算法。
## 13. Diagnostics 和 Restart
诊断状态至少包括:
- 总质量、总动量、总能量。
- 水相压力和冲量指标。
- 气体体积、平均压力和等效气泡半径。
- 炸药反应进度统计。
- `Solid` 损伤和失效数量。
- `Shell` 损伤、撕裂和失效数量。
- 耦合功、动量交换和能量交换。
restart 应保存完整模块级状态。任何影响继续计算路径的状态都不能只作为临时量存在。
## 14. 待讨论问题
- phase 枚举的具体整数值。
- 粒子 status 枚举。
- 第一批 Abaqus `.inp` 粒子 element type 和 section 约定。
- 厚度积分点数量和存储布局。
- restart 文件格式和版本号。