154 lines
7.1 KiB
Markdown
154 lines
7.1 KiB
Markdown
# 02 软件架构设计
|
||
|
||
文档状态:规划确认稿
|
||
|
||
## 1. 架构概览
|
||
|
||
SPHLite 采用与 FEMLite 一致的 Fortran 95 风格过程式模块架构。核心求解器使用 Fortran 编写并遵守 Fortran 95 规范;C API/ABI、C++ 薄包装和 Python API 作为接口层提供,不作为核心求解实现语言。
|
||
|
||
推荐的数据流:
|
||
|
||
```text
|
||
输入层 -> 数据库 -> 粒子/材料/物理模块 -> 显式求解器 -> 输出/API
|
||
```
|
||
|
||
SPHLite 是求解器,不负责几何、网格或粒子生成。测试和示例可以使用 Python 脚本生成 Abaqus 风格 `.inp` 输入文件,但这些脚本属于测试/示例辅助工具,不作为求解器功能。
|
||
|
||
SPHLite 的支持环境、构建方式和工具链要求应与 FEMLite 保持一致。
|
||
|
||
## 2. 主要模块
|
||
|
||
| 模块 | 职责 |
|
||
|---|---|
|
||
| `Core` | 精度、错误、日志、生命周期、控制参数 |
|
||
| `Input` | Abaqus `.inp` 子集解析和 `*SPHLITE ...` 扩展关键词解析 |
|
||
| `Database` | 集中管理粒子、集合、材料、section、phase、时间状态和模块状态 |
|
||
| `Particle` | 粒子状态、粒子族、邻域搜索、核函数 |
|
||
| `Material` | 水、气体、炸药、金属、壳材料和损伤参数 |
|
||
| `Water` | 水体、压力、人工黏性、冲击波和自由界面 |
|
||
| `Gas` | 气体 EOS、气体粒子、气体团簇和气泡诊断 |
|
||
| `Explosive` | 起爆、爆轰到达时间、反应进度和能量释放 |
|
||
| `Solid` | 3D 固体结构、应力更新、塑性、损伤、断裂 |
|
||
| `Shell` | 板壳粒子、厚度、法向/转角、膜弯剪和撕裂 |
|
||
| `CouplingInterface` | 面向外部耦合模块的中立数据交换接口和耦合诊断 |
|
||
| `Solver` | Velocity-Verlet 显式时间推进、子循环、稳定时间步估计 |
|
||
| `Output` | CSV、summary CSV、VTU、PVD、restart、诊断和 benchmark 指标 |
|
||
| `Interface` | Fortran API、C ABI、C++ 薄包装、Python API、CLI |
|
||
|
||
## 3. 模块边界
|
||
|
||
- `Explosive` 只负责炸药反应和能量释放,不直接实现气泡脉动。
|
||
- `Gas` 负责气体相状态、EOS、气体界面和气泡诊断。
|
||
- `Water` 负责水相运动和水中压力传播。
|
||
- `Solid` 和 `Shell` 分别处理实体结构粒子和板壳结构粒子,不互相伪装。
|
||
- `CouplingInterface` 只定义中立耦合数据、边界导出、载荷导入和诊断统计,不依赖 FEMLite,也不依赖外部耦合模块内部实现。
|
||
- 外部耦合模块暂称 `CouplingModule`,后续可能命名为 `CoupleLite`、`CoupledLite` 或 `CouplingLite`。该模块不属于 SPHLite 内部依赖。
|
||
|
||
## 4. 输入与模型识别
|
||
|
||
SPHLite 应解析 Abaqus `.inp` 文件的明确子集,不追求完整 Abaqus 兼容。能复用 Abaqus 关键词时不新增关键词;Abaqus 无法表达的 SPHLite 专有能力统一使用 `*SPHLITE ...` 扩展关键词。
|
||
|
||
输入识别原则:
|
||
|
||
- 水、气、炸药和实体结构均作为 3D 实体粒子处理。
|
||
- 板壳结构为 2D 几何,通过 section 识别板壳属性。
|
||
- 水、气、炸药、实体结构和板壳结构通过 material 识别物理类型和本构/EOS 参数。
|
||
- set 只表示集合,可包含同种或不同种类的粒子,不能作为类型判断依据。
|
||
- 不影响程序运行的未支持关键词应 warning 后跳过。
|
||
- 关键词缺失或不支持导致程序无法运行时应报 error。
|
||
- 单位系统与 FEMLite/Abaqus 风格一致,程序不做内置单位换算,用户负责保持单位一致。
|
||
|
||
## 5. 数据库与粒子状态
|
||
|
||
SPHLite 采用集中型数据库。所有粒子的通用状态由 `Database` 统一管理,包括 id、phase、material、section、位置、速度、加速度、质量、密度、压力、体积和时间状态。
|
||
|
||
水和气有本质区别,计算模块保持独立;但水粒子和气粒子共享同一套粒子通用数据结构。`Water` 和 `Gas` 只维护各自计算所需的派生状态、EOS 状态、诊断量和临时工作数组。
|
||
|
||
phase 允许在计算中改变,例如炸药粒子可逐步转化为气体 phase。`Explosive` 同时预留两种路线:
|
||
|
||
- 同一粒子从 explosive phase 迁移到 gas phase。
|
||
- 炸药粒子保留自身状态,并向 `Gas` 注入质量、动量和能量源项。
|
||
|
||
## 6. 时间推进
|
||
|
||
SPHLite 只支持显式动力学时间推进。求解器采用 Velocity-Verlet 作为唯一主时间积分格式。
|
||
|
||
架构中不保留隐式求解、静力求解、非线性静力求解或隐式-显式混合求解接口。后续如需引入子循环,也应服务于显式动力学主流程。
|
||
|
||
## 7. 外部耦合边界
|
||
|
||
SPHLite 不直接与 FEMLite 耦合,也不引用 FEMLite 模块作为依赖。SPHLite 只通过中立耦合数据契约与外部耦合模块交换数据。外部耦合模块再负责与 FEMLite 或其他求解器通信。
|
||
|
||
SPHLite 侧应提供:
|
||
|
||
- 导出 SPH 侧耦合区域的粒子状态、边界面、法向、面积、速度和材料/phase 信息。
|
||
- 导入外部耦合模块提供的节点力、面力、体力、位移/速度约束或连续体界面交换量。
|
||
- 记录耦合功、动量交换、能量交换和错误诊断。
|
||
- 区分接触耦合和连续体耦合,不将连续体耦合简化为接触。
|
||
|
||
SPHLite 输入文件只定义 SPHLite 侧 coupling region 和交换变量。外部求解器侧区域由外部耦合模块或其配置文件匹配。
|
||
|
||
## 8. Restart 和输出
|
||
|
||
restart 应按完整模块级别设计,能够恢复显式动力学继续计算所需的全部状态。第一版至少应在格式上预留:
|
||
|
||
- 粒子通用状态。
|
||
- 时间控制、步数、输出计数和 Velocity-Verlet 所需的当前/历史加速度或半步状态。
|
||
- 水相状态和气体状态。
|
||
- 炸药反应进度、爆轰到达状态和源项累计量。
|
||
- `Solid` 应力、塑性、损伤和失效状态。
|
||
- `Shell` 厚度、法向/转角、积分点、损伤和撕裂状态。
|
||
- 耦合历史量、功、动量和能量诊断。
|
||
- 邻域搜索重建所需控制参数。
|
||
|
||
输出层当前采用文本 CSV 与 VTK XML 并行策略:粒子结果写入 CSV 和 VTU,时间序列管理文件写入 PVD,summary CSV 保存标量诊断。worker 预研阶段新增的 log、particle report 和 force report 属于 CCLite adapter 诊断,不替代求解输出。
|
||
|
||
## 9. 构建产物和接口层
|
||
|
||
SPHLite 建议采用与 FEMLite 类似的产物分层:
|
||
|
||
- `sphlite_core`:Fortran 核心库。
|
||
- `sphlite_c`:C ABI 薄包装库。
|
||
- `sphlite`:命令行程序。
|
||
- C++ wrapper:薄包装 C ABI。
|
||
- Python API:优先使用 `ctypes` 包装 C ABI。
|
||
|
||
命令行程序作为一等入口,语法风格应与 FEMLite 保持一致,例如读取 `.inp` 文件并执行显式动力学分析。
|
||
|
||
## 10. 建议目录结构
|
||
|
||
```text
|
||
include/
|
||
sphlite_c_api.h
|
||
src/
|
||
core/
|
||
input/
|
||
database/
|
||
particle/
|
||
material/
|
||
water/
|
||
gas/
|
||
explosive/
|
||
solid/
|
||
shell/
|
||
coupling_interface/
|
||
solver/
|
||
output/
|
||
interface/
|
||
Python/
|
||
tests/
|
||
examples/
|
||
tools/
|
||
docs/
|
||
```
|
||
|
||
不设置 `geometry/` 或 `mesh/` 目录。SPHLite 不承担几何建模、网格生成或粒子生成职责。
|
||
|
||
## 11. 待讨论问题
|
||
|
||
- Abaqus 子集的第一批关键词清单。
|
||
- `*SPHLITE ...` 扩展关键词的详细语法。
|
||
- Velocity-Verlet restart 中半步速度和加速度的保存约定。
|
||
- Python inp 生成器的目录组织和示例规范。
|
||
- 外部耦合模块最终命名和配置文件边界。
|