9.3 KiB
03 详细设计
文档状态:规划确认稿
1. 设计原则
SPHLite 算法核心使用 Fortran 95 实现,详细设计采用集中数组数据库和过程式模块协作方式。核心状态集中存放在 sph_database 一类模块中,物理模块围绕数据库读取通用状态、维护自身派生状态,并通过显式求解器推进。求解器、粒子/单元语义、材料和物理模块不得引入 Fortran 2018 语法;worker、CLI、IPC 等外围集成层及其测试/工具性 Fortran 代码允许使用 Fortran 2018。
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 至少保存以下通用数组:
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_WATERPHASE_GASPHASE_EXPLOSIVEPHASE_SOLIDPHASE_SHELLPHASE_BOUNDARYPHASE_COUPLINGPHASE_SOLID_FAILEDPHASE_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注入质量、动量和能量源项。
建议状态包括:
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 识别厚度、积分点和板壳属性。
建议第一阶段保存:
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 文件格式和版本号。