Files
3D_EDFM_SIM-X/docs/参数注册表_中文.md
T
2026-03-23 14:38:09 +08:00

353 lines
23 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 参数注册表(中文)
本注册表用于将当前代码中硬编码的参数,映射到统一的 `config` 结构中。
它采用“字段导向”的组织方式,目的是让后续 GUI 能围绕稳定的数据 schema 来构建。
## 约定说明
- `Config Path`:统一 `config` 中的目标字段路径
- `Source Variable`:当前代码中的变量名
- `Source File`:当前 MATLAB 中定义该参数的文件
- `Cases`:当前哪些算例目录使用了该字段
- `Editable`GUI 是否应向用户暴露该字段
- `Notes`:行为说明、枚举含义或数据形状说明
## Meta
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `meta.case_name` | 无 | 模板层 | 全部 | 是 | 显示名称 |
| `meta.case_id` | 无 | 模板层 | 全部 | 是 | 稳定的预设 ID |
| `meta.description` | 无 | 模板层 | 全部 | 是 | 自由文本描述 |
| `meta.source_case_folder` | 文件夹名 | 模板层 | 全部 | 否 | 用于追踪来源 |
| `meta.created_from_template` | 无 | 模板层 | 全部 | 否 | 预设来源 |
| `meta.version` | 无 | 配置系统 | 全部 | 否 | Schema 版本 |
## Model
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `model.modelflag` | `modelflag` | `main1.m` | 1-7 | 是 | 当前算例均使用 `1` |
| `model.grid_model` | `grid_model` | `main1.m` | 1-7 | 是 | `1` 为 SP`2` 为 DP |
| `model.flow_model` | `flow_model` | `main1.m` | 1-7 | 是 | `1` 气水,`2` 油水,`3` 组分流 |
## Grid Geometry
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `grid.dx` | `dx` | `main1.m` | 1-7 | 是 | 向量 |
| `grid.dy` | `dy` | `main1.m` | 1-7 | 是 | 向量 |
| `grid.dz` | `dz` | `main1.m` | 1-7 | 是 | 向量 |
| `grid.nx` | `nx` | `main1.m` | 1-7 | 否 | 由 `dx` 推导 |
| `grid.ny` | `ny` | `main1.m` | 1-7 | 否 | 由 `dy` 推导 |
| `grid.nz` | `nz` | `main1.m` | 1-7 | 否 | 由 `dz` 推导 |
| `grid.NTG` | `NTG` | `main1.m` | 1-7 | 否 | 大小为 `nx*ny*nz` 的数组 |
`GridProp_pre.m` 生成的派生字段:
- `grid.coordinates`
- `grid.nodes`
- `grid.nP`
- `grid.nmc`
- `grid.dxv`
- `grid.dyv`
- `grid.dzv`
- `grid.zm`
- `grid.vm`
- `grid.xrao`
- `grid.yrao`
- `grid.zrao`
- `grid.cell_mid_coords`
## Fracture Input
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `fracture.input_style` | `input_style` | `main1.m` | 1-7 | 是 | 1 工程输入,2 向量输入,3 二维线段输入,4 fab 预留 |
| `fracture.input_content` | `input_content` | `main1.m` | 1-7 | 是 | 工程裂缝表 |
| `fracture.f` | `f` | `main1.m` / helper 输出 | 1-7 | 高级 | 裂缝向量表示 |
| `fracture.fellip` | `fellip` | `main1.m` / helper 输出 | 1-7 | 高级 | 椭圆裂缝 |
| `fracture.fractureLines` | `fractureLines` | `main1.m` | 1-7 | 是 | 在模式 3 下使用 |
| `fracture.fractureHeights` | `fractureHeights` | `main1.m` | 1-7 | 是 | 在模式 3 下使用 |
| `fracture.flowBarrierFlags` | `flowBarrierFlags` | `main1.m` | 1-7 | 是 | 可选 |
| `fracture.frac_information` | `frac_information` | helper 输出 | 1-7 | 否 | 由辅助函数生成 |
| `fracture.nf` | `nf` | `main1.m` | 1-7 | 否 | 裂缝数量派生值 |
## Discretization Selection
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `discretization.mode` | `grid_model` | `main1.m` | 1-7 | 是 | 与 `model.grid_model` 对应 |
| `discretization.use_operator` | 隐式 | `main1.m` | 1-7 | 否 | 当前始终调用 `OperatorRS` |
## SP Rock And Boundary Parameters
这些字段是关键的可编辑参数,之前统计时偏少。
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `discretization.sp.boundary_polygon` | `boundary` | `grid_discretization_SP_model.m` | 1 | 是 | 不规则计算域边界多边形 |
| `discretization.sp.invalid_layer` | `invalid_layer` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 在模拟中禁用的层号 |
| `discretization.sp.valid_grids` | `valid_grids` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 否 | 由边界和层信息推导 |
| `discretization.sp.matrix.kx` | `kx` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 数组或生成场 |
| `discretization.sp.matrix.ky` | `ky` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 数组或生成场 |
| `discretization.sp.matrix.kz` | `kz` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 数组或生成场 |
| `discretization.sp.matrix.pori` | `pori` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 数组或生成场 |
| `discretization.sp.matrix.prpor` | `prpor` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 基质参考压力 |
| `discretization.sp.matrix.cpor` | `cpor` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 基质压缩系数 |
| `discretization.sp.matrix.rock_density` | `rock_density` / `density_rock` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 各算例命名不一致 |
| `discretization.sp.fracture.Kf` | `Kf` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 裂缝渗透率 |
| `discretization.sp.fracture.Wf` | `Wf` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 裂缝缝宽 |
| `discretization.sp.fracture.Porf` | `Porf` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 裂缝孔隙度 |
| `discretization.sp.fracture.prporf` | `prporf` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 裂缝参考压力 |
| `discretization.sp.fracture.cporf` | `cporf` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 裂缝压缩系数 |
| `discretization.sp.stress.fracture_factor` | `stress_factor_fracture` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 应力敏感系数 |
| `discretization.sp.stress.matrix_factor` | `stress_factor_matrix` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 应力敏感系数 |
| `discretization.sp.stress.ref_pressure` | `stress_factor_ref_pressure` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 参考压力 |
| `discretization.sp.stress.Rpt` | `Rpt` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 含义待进一步确认 |
| `discretization.sp.stress.cf` | `cf` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 含义待进一步确认 |
| `discretization.sp.stress.ca` | `ca` | `grid_discretization_SP_model.m` | 1,2,4,5,6,7 | 是 | 含义待进一步确认 |
各算例补充说明:
- 算例 1 使用空间函数和不规则多边形边界。
- 算例 2 和 4 在适用时使用 `invalid_layer` 关闭第二层。
- 算例 5 和 7 的常数基质参数与算例 2、4、6 不同。
## DP Rock Parameters
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `discretization.dp.fracture_layer.kx` | `kx` | `grid_discretization_DP_model.m` | 3 | 是 | 双重介质中的裂缝层 |
| `discretization.dp.fracture_layer.ky` | `ky` | `grid_discretization_DP_model.m` | 3 | 是 | 双重介质中的裂缝层 |
| `discretization.dp.fracture_layer.kz` | `kz` | `grid_discretization_DP_model.m` | 3 | 是 | 双重介质中的裂缝层 |
| `discretization.dp.fracture_layer.pori` | `pori` | `grid_discretization_DP_model.m` | 3 | 否 | 裂缝层孔隙度 |
| `discretization.dp.matrix_layer.kx` | `kx_matrixLayer` | `grid_discretization_DP_model.m` | 3 | 是 | 基质层渗透率 |
| `discretization.dp.matrix_layer.ky` | `ky_matrixLayer` | `grid_discretization_DP_model.m` | 3 | 是 | 基质层渗透率 |
| `discretization.dp.matrix_layer.kz` | `kz_matrixLayer` | `grid_discretization_DP_model.m` | 3 | 是 | 基质层渗透率 |
| `discretization.dp.matrix_layer.pori` | `pori_matrixLayer` | `grid_discretization_DP_model.m` | 3 | 是 | 基质层孔隙度 |
| `discretization.dp.shape_factor` | `sigma` | `grid_discretization_DP_model.m` | 3 | 是 | 孔隙间形状因子 |
| `discretization.dp.valid_grids` | `valid_grids` | `grid_discretization_DP_model.m` | 3 | 否 | 当前算例中全为 1 |
| `discretization.dp.NTG` | `NTG` | `grid_discretization_DP_model.m` | 3 | 是 | 在文件中被重新赋值 |
| `discretization.dp.prpor` | `prpor` | `grid_discretization_DP_model.m` | 3 | 是 | 参考压力 |
| `discretization.dp.cpor` | `cpor` | `grid_discretization_DP_model.m` | 3 | 是 | 压缩系数 |
| `discretization.dp.fracture.Kf` | `Kf` | `grid_discretization_DP_model.m` | 3 | 是 | 裂缝渗透率 |
| `discretization.dp.fracture.Wf` | `Wf` | `grid_discretization_DP_model.m` | 3 | 是 | 裂缝缝宽 |
| `discretization.dp.fracture.Porf` | `Porf` | `grid_discretization_DP_model.m` | 3 | 是 | 裂缝孔隙度 |
| `discretization.dp.fracture.prporf` | `prporf` | `grid_discretization_DP_model.m` | 3 | 是 | 裂缝参考压力 |
| `discretization.dp.fracture.cporf` | `cporf` | `grid_discretization_DP_model.m` | 3 | 是 | 裂缝压缩系数 |
| `discretization.dp.stress.fracture_factor` | `stress_factor_fracture` | `grid_discretization_DP_model.m` | 3 | 是 | 应力敏感 |
| `discretization.dp.stress.matrix_factor` | `stress_factor_matrix` | `grid_discretization_DP_model.m` | 3 | 是 | 应力敏感 |
| `discretization.dp.stress.ref_pressure` | `stress_factor_ref_pressure` | `grid_discretization_DP_model.m` | 3 | 是 | 参考压力 |
| `discretization.dp.rock_density` | `rock_density` | `grid_discretization_DP_model.m` | 3 | 是 | 岩石密度 |
| `discretization.dp.Rpt` | `Rpt` | `grid_discretization_DP_model.m` | 3 | 是 | 含义待进一步确认 |
| `discretization.dp.cf` | `cf` | `grid_discretization_DP_model.m` | 3 | 是 | 含义待进一步确认 |
| `discretization.dp.ca` | `ca` | `grid_discretization_DP_model.m` | 3 | 是 | 含义待进一步确认 |
## Flow: Gas-Water
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `flow.gas_water.gas_prop.VL` | `gas_prop.VL` | `gas_water_flow.m` | 4 | 是 | Langmuir 体积 |
| `flow.gas_water.gas_prop.PL` | `gas_prop.PL` | `gas_water_flow.m` | 4 | 是 | Langmuir 压力 |
| `flow.gas_water.gas_prop.Kn` | `gas_prop.Kn` | `gas_water_flow.m` | 4 | 是 | Knudsen 数 |
| `flow.gas_water.gas_prop.Kn_modified_factor` | `gas_prop.Kn_modified_factor` | `gas_water_flow.m` | 4 | 否 | 派生值 |
| `flow.gas_water.gas_prop.beta_non_darcy_flow` | `gas_prop.beta_non_Darcy_flow` | `gas_water_flow.m` | 4 | 是 | 高速流修正项 |
| `flow.gas_water.p_grad_threshold` | `p_grad_threshold` | `gas_water_flow.m` | 4 | 是 | 启动压力梯度 |
| `flow.gas_water.density_g_sc` | `density_g_sc` | `gas_water_flow.m` | 4 | 是 | 标况气体密度 |
| `flow.gas_water.density_w_sc` | `density_w_sc` | `gas_water_flow.m` | 4 | 是 | 标况水密度 |
| `flow.gas_water.gas_model` | `gas_model` | `gas_water_flow.m` | 4 | 是 | 1 生成型 PVT2 表格型 PVT |
| `flow.gas_water.prg` | `prg` | `gas_water_flow.m` | 4 | 是 | 仅在模型 1 中使用 |
| `flow.gas_water.Bgi` | `Bgi` | `gas_water_flow.m` | 4 | 是 | 仅在模型 1 中使用 |
| `flow.gas_water.cg` | `cg` | `gas_water_flow.m` | 4 | 是 | 仅在模型 1 中使用 |
| `flow.gas_water.vgi` | `vgi` | `gas_water_flow.m` | 4 | 是 | 仅在模型 1 中使用 |
| `flow.gas_water.cvg` | `cvg` | `gas_water_flow.m` | 4 | 是 | 仅在模型 1 中使用 |
| `flow.gas_water.Ppr` | `Ppr` | `gas_water_flow.m` | 4 | 是 | 表格或生成值 |
| `flow.gas_water.BG` | `BG` | `gas_water_flow.m` | 4 | 是 | 表格或生成值 |
| `flow.gas_water.MUG` | `MUG` | `gas_water_flow.m` | 4 | 是 | 表格或生成值 |
| `flow.gas_water.prw` | `prw` | `gas_water_flow.m` | 4 | 是 | 水参考压力 |
| `flow.gas_water.Bwi` | `Bwi` | `gas_water_flow.m` | 4 | 是 | 水体积系数 |
| `flow.gas_water.cw` | `cw` | `gas_water_flow.m` | 4 | 是 | 水压缩系数 |
| `flow.gas_water.vwi` | `vwi` | `gas_water_flow.m` | 4 | 是 | 水黏度 |
| `flow.gas_water.cvw` | `cvw` | `gas_water_flow.m` | 4 | 是 | 水黏压系数 |
| `flow.gas_water.ifpcgl` | `ifpcgl` | `gas_water_flow.m` | 4 | 是 | 毛管压开关 |
| `flow.gas_water.matrix_relperm_table` | `RPGW` | `gas_water_flow.m` | 4 | 是 | 基质相对渗透率表 |
| `flow.gas_water.fracture_relperm_table` | `PRF` | `gas_water_flow.m` | 4 | 是 | 裂缝相对渗透率表 |
## Flow: Oil-Water
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `flow.oil_water.density_o_sc` | `density_o_sc` | `oil_water_flow.m` | 5,6,7 | 是 | 原油密度 |
| `flow.oil_water.density_w_sc` | `density_w_sc` | `oil_water_flow.m` | 5,6,7 | 是 | 水密度 |
| `flow.oil_water.oil_model` | `oil_model` | `oil_water_flow.m` | 5,6,7 | 是 | 1 生成型 PVT2 表格型 |
| `flow.oil_water.pro` | `pro` | `oil_water_flow.m` | 5,6,7 | 是 | 原油参考压力 |
| `flow.oil_water.Boi` | `Boi` | `oil_water_flow.m` | 5,6,7 | 是 | 原油体积系数 |
| `flow.oil_water.co` | `co` | `oil_water_flow.m` | 5,6,7 | 是 | 原油压缩系数 |
| `flow.oil_water.voi` | `voi` | `oil_water_flow.m` | 5,6,7 | 是 | 原油黏度 |
| `flow.oil_water.cvo` | `cvo` | `oil_water_flow.m` | 5,6,7 | 是 | 原油黏压系数 |
| `flow.oil_water.Ppr` | `Ppr` | `oil_water_flow.m` | 5,6,7 | 是 | 表格或生成值 |
| `flow.oil_water.BO` | `BO` | `oil_water_flow.m` | 5,6,7 | 是 | 表格或生成值 |
| `flow.oil_water.MUO` | `MUO` | `oil_water_flow.m` | 5,6,7 | 是 | 表格或生成值 |
| `flow.oil_water.prw` | `prw` | `oil_water_flow.m` | 5,6,7 | 是 | 水参考压力 |
| `flow.oil_water.Bwi` | `Bwi` | `oil_water_flow.m` | 5,6,7 | 是 | 水体积系数 |
| `flow.oil_water.cw` | `cw` | `oil_water_flow.m` | 5,6,7 | 是 | 水压缩系数 |
| `flow.oil_water.vwi` | `vwi` | `oil_water_flow.m` | 5,6,7 | 是 | 水黏度 |
| `flow.oil_water.cvw` | `cvw` | `oil_water_flow.m` | 5,6,7 | 是 | 水黏压系数 |
| `flow.oil_water.ifpcow` | `ifpcow` | `oil_water_flow.m` | 5,6,7 | 是 | 毛管压开关 |
| `flow.oil_water.matrix_relperm_table` | `PRM` | `oil_water_flow.m` | 5,6,7 | 是 | 基质表 |
| `flow.oil_water.fracture_relperm_table` | `PRF` | `oil_water_flow.m` | 5,6,7 | 是 | 裂缝表 |
| `flow.oil_water.beta_non_darcy_flow` | `beta_non_Darcy_flow` | `oil_water_flow.m` | 5,6,7 | 是 | 非达西系数 |
| `flow.oil_water.p_grad_threshold` | `p_grad_threshold` | `oil_water_flow.m` | 5,6,7 | 是 | 启动梯度 |
## Flow: Multi-Component
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `flow.multi_component.Ds` | `Ds` | `multi_component_flow.m` | 1,2,3 | 是 | 表活扩散系数 |
| `flow.multi_component.Db` | `Db` | `multi_component_flow.m` | 1,2,3 | 是 | 盐扩散系数 |
| `flow.multi_component.c_ca_table` | `c_ca_table` | `multi_component_flow.m` | 1,2,3 | 是 | 吸附表 |
| `flow.multi_component.cs_data` | `cs_data` | `multi_component_flow.m` | 1,2,3 | 否 | 由表派生 |
| `flow.multi_component.cb_data` | `cb_data` | `multi_component_flow.m` | 1,2,3 | 否 | 由表派生 |
| `flow.multi_component.csa_data` | `csa_data` | `multi_component_flow.m` | 1,2,3 | 否 | 由表派生 |
| `flow.multi_component.cba_data` | `cba_data` | `multi_component_flow.m` | 1,2,3 | 否 | 由表派生 |
| `flow.multi_component.R` | `R` | `multi_component_flow.m` | 1,2,3 | 是 | 化学常数 |
| `flow.multi_component.Vm` | `Vm` | `multi_component_flow.m` | 1,2,3 | 是 | 摩尔体积 |
| `flow.multi_component.Temperature` | `Temperature` | `multi_component_flow.m` | 1,2,3 | 是 | 温度 |
| `flow.multi_component.chemistry_cof` | `chemistry_cof` | `multi_component_flow.m` | 1,2,3 | 否 | 派生值 |
| `flow.multi_component.x_matrix!!!!` | `xm` | `multi_component_flow.m` | 1,2,3 | 是 | 基质单元化学活度因子 |
| `flow.multi_component.x_fracture!!!` | `xf` | `multi_component_flow.m` | 1,2,3 | 是 | 裂缝单元化学活度因子 |
| `flow.multi_component.cs_Nc` | `cs_Nc` | `multi_component_flow.m` | 1,2,3 | 是 | 动态相对渗透率映射 |
| `flow.multi_component.Nc_nosurf` | `Nc_nosurf` | `multi_component_flow.m` | 1,2,3 | 否 | 派生值 |
| `flow.multi_component.Nc_surf` | `Nc_surf` | `multi_component_flow.m` | 1,2,3 | 否 | 派生值 |
| `flow.multi_component.kr_nosurf` | `kr_nosurf` | `multi_component_flow.m` | 1,2,3 | 是 | 相对渗透率表 |
| `flow.multi_component.kr_surf` | `kr_surf` | `multi_component_flow.m` | 1,2,3 | 是 | 相对渗透率表 |
| `flow.multi_component.PC` | `PC` | `multi_component_flow.m` | 1,2,3 | 是 | 毛管压表 |
| `flow.multi_component.cs_Nc_fracture` | `cs_Nc_fracture` | `multi_component_flow.m` | 1,2,3 | 是 | 裂缝表 |
| `flow.multi_component.kr_nosurf_fracture` | `kr_nosurf_fracture` | `multi_component_flow.m` | 1,2,3 | 是 | 裂缝表 |
| `flow.multi_component.kr_surf_fracture` | `kr_surf_fracture` | `multi_component_flow.m` | 1,2,3 | 是 | 裂缝表 |
| `flow.multi_component.PC_fracture` | `PC_fracture` | `multi_component_flow.m` | 1,2,3 | 是 | 裂缝毛管压表 |
| `flow.multi_component.ifpcgl` | `ifpcgl` | `multi_component_flow.m` | 1,2,3 | 是 | 毛管压开关 |
| `flow.multi_component.p_grad_threshold` | `p_grad_threshold` | `multi_component_flow.m` | 1,2,3 | 是 | 启动梯度 |
| `flow.multi_component.gas_prop.VL` | `gas_prop.VL` | `multi_component_flow.m` | 1,2,3 | 是 | 类油场景中通常为 0 |
| `flow.multi_component.gas_prop.PL` | `gas_prop.PL` | `multi_component_flow.m` | 1,2,3 | 是 | Langmuir 压力 |
| `flow.multi_component.gas_prop.Kn` | `gas_prop.Kn` | `multi_component_flow.m` | 1,2,3 | 是 | Knudsen 数 |
| `flow.multi_component.gas_prop.Kn_modified_factor` | `gas_prop.Kn_modified_factor` | `multi_component_flow.m` | 1,2,3 | 否 | 派生值 |
| `flow.multi_component.gas_prop.stress_factor_fracture` | `gas_prop.stress_factor_fracture` | `multi_component_flow.m` | 1,2,3 | 是 | 在算例流体文件中出现 |
| `flow.multi_component.gas_prop.stress_factor_matrix` | `gas_prop.stress_factor_matrix` | `multi_component_flow.m` | 1,2,3 | 是 | 在算例流体文件中出现 |
| `flow.multi_component.gas_prop.stress_factor_ref_pressure` | `gas_prop.stress_factor_ref_pressure` | `multi_component_flow.m` | 1,2,3 | 是 | 在算例流体文件中出现 |
| `flow.multi_component.gas_prop.beta_non_darcy_flow` | `gas_prop.beta_non_Darcy_flow` | `multi_component_flow.m` | 1,2,3 | 是 | 非达西系数 |
| `flow.multi_component.density_g_sc` | `density_g_sc` | `multi_component_flow.m` | 1,2,3 | 是 | 标况密度 |
| `flow.multi_component.gas_model` | `gas_model` | `multi_component_flow.m` | 1,2,3 | 是 | 1 生成型,2 表格型 |
| `flow.multi_component.prg` | `prg` | `multi_component_flow.m` | 1,2,3 | 是 | 参考压力 |
| `flow.multi_component.Bgi` | `Bgi` | `multi_component_flow.m` | 1,2,3 | 是 | 体积系数 |
| `flow.multi_component.cg` | `cg` | `multi_component_flow.m` | 1,2,3 | 是 | 压缩系数 |
| `flow.multi_component.vgi` | `vgi` | `multi_component_flow.m` | 1,2,3 | 是 | 黏度 |
| `flow.multi_component.cvg` | `cvg` | `multi_component_flow.m` | 1,2,3 | 是 | 黏压系数 |
| `flow.multi_component.Ppr` | `Ppr` | `multi_component_flow.m` | 1,2,3 | 是 | 表格或生成值 |
| `flow.multi_component.BG` | `BG` | `multi_component_flow.m` | 1,2,3 | 是 | 表格或生成值 |
| `flow.multi_component.MUG` | `MUG` | `multi_component_flow.m` | 1,2,3 | 是 | 表格或生成值 |
| `flow.multi_component.density_w_sc` | `density_w_sc` | `multi_component_flow.m` | 1,2,3 | 是 | 水密度 |
| `flow.multi_component.prw` | `prw` | `multi_component_flow.m` | 1,2,3 | 是 | 水参考压力 |
| `flow.multi_component.Bwi` | `Bwi` | `multi_component_flow.m` | 1,2,3 | 是 | 水体积系数 |
| `flow.multi_component.cw` | `cw` | `multi_component_flow.m` | 1,2,3 | 是 | 水压缩系数 |
| `flow.multi_component.vwi` | `vwi` | `multi_component_flow.m` | 1,2,3 | 是 | 水黏度 |
| `flow.multi_component.cvw` | `cvw` | `multi_component_flow.m` | 1,2,3 | 是 | 水黏压系数 |
| `flow.multi_component.number_state_variables` | `number_state_variables` | `multi_component_flow.m` | 1,2,3 | 否 | 当前代码固定为 4 |
## Initial Conditions
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `initial.pressure` | `P` | flow files | 1-7 | 是 | 初始压力数组 |
| `initial.sw` | `Sw` | flow files | 1-7 | 是 | 初始含水饱和度数组 |
| `initial.cs` | `Cs` | `multi_component_flow.m` | 1,2,3 | 是 | 初始表活浓度 |
| `initial.cb` | `Cb` | `multi_component_flow.m` | 1,2,3 | 是 | 初始盐浓度 |
## Wells
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `wells.well1` | `well1` | `main1.m` | 1-7 | 是 | 常规井表 |
| `wells.num_fracture_wells` | `num_fracture_wells` | `main1.m` | 1-7 | 是 | 数量 |
| `wells.welloc` | `welloc` | `main1.m` | 1-7 | 是 | 压裂井坐标 |
| `wells.perfnum` | `perfnum` | helper 输出 | 1-7 | 否 | 由 `findWelloc` 推导 |
| `wells.well2` | `well2` | `main1.m` | 1-7 | 是 | 压裂井表 |
| `wells.Wellc` | `Wellc` | helper 输出 | 1-7 | 否 | 运行期组合结构 |
常规井单行结构:
- 井名
- 射孔数
- 射孔网格索引矩阵
- 井筒半径
- skin
- 井类型
压裂井单行结构:
- 井名
- 射孔数
- 射孔索引
- 井筒半径
- skin
- 井类型
## Schedule
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `schedule.number_phases` | `number_phases` | `main1.m` | 1-7 | 是 | 阶段数 |
| `schedule.well_schedules` | `well_schedules` | `main1.m` | 1-7 | 是 | 每个阶段的控制行 |
| `schedule.time` | `time` | `main1.m` | 1-7 | 是 | 阶段时长向量 |
| `schedule.dtmax` | `dtmax` | `main1.m` | 1-7 | 是 | 各阶段最大时间步 |
| `schedule.dtmin` | `dtmin` | `main1.m` | 1-7 | 是 | 各阶段最小时间步 |
观察到的 schedule 单行字段:
- 井名
- 井状态
- 井角色
- 控制模式
- 目标值 1
- 目标值 2
- 可选的 `Cs_inj`
- 可选的 `Cb_inj`
## Solver
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `solver.yitap` | `yitap` | `main1.m` | 1-7 | 是 | 自适应时间步控制 |
| `solver.yitas` | `yitas` | `main1.m` | 1-7 | 是 | 自适应时间步控制 |
| `solver.omega` | `omega` | `main1.m` | 1-7 | 是 | 自适应时间步控制 |
| `solver.Nmax` | `Nmax` | `main1.m` | 1-7 | 是 | 牛顿最大迭代次数 |
| `solver.epsave` | `epsave` | `main1.m` | 1-7 | 是 | 平均残差容限 |
| `solver.epsmax` | `epsmax` | `main1.m` | 1-7 | 是 | 最大残差容限 |
## Runtime / Output
| Config Path | Source Variable | Source File | Cases | Editable | Notes |
| --- | --- | --- | --- | --- | --- |
| `output.result_name` | 无 | 未来 GUI | 全部 | 是 | 结果标签 |
| `output.save_input_path` | 无 | 未来 GUI | 全部 | 是 | 输入保存位置 |
| `output.save_result_path` | 无 | 未来 GUI | 全部 | 是 | 结果保存位置 |
| `output.plot_requests` | 无 | 未来 GUI | 全部 | 是 | 用户请求的绘图动作 |
仅运行期输出:
- `Times`
- `OutputRs`
- `Wellpara`
- `trun`
## 已知需要统一的地方
- `rock_density``density_rock` 在 SP 离散化文件中都出现过。
- 有些字段在某个算例里是可编辑表达式,在另一个算例里是常量数组,尤其是 `kx``ky``kz``pori`
- `boundary` 只出现在算例 1,其他 SP 算例没有。
- DP 模式引入了 SP 模式中不存在的一组额外字段。
这些不一致,正是为什么 GUI 必须建立在规范化 `config` 上,而不能直接建立在原始脚本变量之上。