Files
SPHLite/docs/v3.0_gas_handoff.md
2026-07-03 08:45:16 +08:00

3.3 KiB

SPHLite 0.3.0 Gas 交接入口

文档状态:0.2.2 交接记录

本文档只为 0.3.0 Gas 开发提供入口,不代表 0.2.2 已实现 Gas 生产求解路径。

1. 输入关键词草案入口

0.3.0 应继续使用 Abaqus .inp 明确子集,能复用 Abaqus 关键词时不新增关键词。

建议优先讨论以下输入入口:

  • *MATERIAL, NAME=..., TYPE=GAS
  • *DENSITY
  • *SECTION, ELSET=..., MATERIAL=...
  • *SPHLITE EOS, TYPE=IDEAL_GAS, MATERIAL=..., RHO0=..., GAMMA=..., P0=...
  • *SPHLITE EOS, TYPE=STIFFENED_GAS, MATERIAL=..., RHO0=..., C0=..., GAMMA=..., P0=...
  • *SPHLITE EOS, TYPE=JWL, MATERIAL=..., A=..., B=..., R1=..., R2=..., OMEGA=..., E0=...
  • *SPHLITE PARTICLE CONTROL, H=..., MASS=..., VOLUME=...
  • *SPHLITE BODY FORCE, X=..., Y=..., Z=...
  • *SPHLITE TIME CONTROL, DT=..., TIME=..., STEPS=..., SAFETY=...

若 Gas 需要温度或内能初值,应优先复用通用粒子状态或材料参数,不急于新增生成器式关键词。

2. 状态变量清单入口

Gas 应共享集中型粒子数据库中的通用状态:

  • particle_id_ext
  • particle_phase
  • particle_status
  • material_id
  • section_id
  • x0
  • x
  • v
  • a
  • vhalf
  • mass
  • rho
  • volume
  • pressure
  • internal_energy
  • temperature
  • h

Gas 模块内部可规划以下派生状态或诊断:

  • Gas EOS 参数。
  • Gas 粒子数量、质量、动量、体积和压力范围。
  • 气团或气泡诊断的中心、等效半径、体积和脉动量。
  • JWL 或其他爆轰产物气体所需的能量状态。
  • 与 Explosive 质量/能量注入相关的累计诊断量。

3. EOS 测试命名入口

0.3.0 默认 gate 可从小型单元测试开始,建议命名为:

  • gas_eos_ideal
  • gas_eos_stiffened
  • gas_eos_jwl
  • gas_state
  • gas_summary
  • solver_gas
  • gas_output
  • gas_restart
  • input_gas

这些测试只应验证小规模可重复数值链路,不应提前升级为工程 benchmark。

4. Water 与 Gas 边界

Water 与 Gas 共享基础粒子数据,但计算路径应保持独立:

  • Water 粒子继续由 SPH_PHASE_WATER 和 Water material 识别。
  • Gas 粒子应由 SPH_PHASE_GAS 和 Gas material 识别。
  • Water EOS、密度连续性方程、人工黏性和压力力不应读取 Gas 专属状态。
  • Gas EOS 和气团诊断不应改变 Water 求解路径。
  • phase 改变可以规划,但 0.3.0 初期应先实现稳定的 Gas 单相闭环。

5. Explosive 到 Gas 的长期路线

长期路线应保持“Explosive 作用到 Gas 后形成 Bubble”的设计:

  • Explosive 表示点火、反应进度和能量释放。
  • Gas 表示爆轰产物气体、舱内空气、空泡和混合气体。
  • Explosive 不通过预设球面模型直接制造气泡几何。
  • Explosive 应向 Gas 注入质量、动量或内能,由 Gas EOS 和流动计算形成气泡产生与脉动。
  • Bubble 应作为 Gas 的诊断结果或气团统计结果,而不是独立取代 Gas 的基础模块。

6. 0.3.0 最小启动建议

建议 0.3.0 从以下最小闭环开始:

  1. 解析 TYPE=GAS material 和 Gas EOS。
  2. 建立 Gas 粒子的 phase、压力和内能初始化。
  3. 实现一个最小 Gas EOS 单元测试。
  4. 实现 Gas summary。
  5. 将 Gas 状态写入 CSV 和 restart。
  6. 保持 Water gate 全部通过。