# 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 全部通过。