# 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` 至少保存以下通用数组: ```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 文件格式和版本号。