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

9.1 KiB
Raw Blame History

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 至少保存以下通用数组:

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 注入质量、动量和能量源项。

建议状态包括:

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 文件格式和版本号。