168 lines
7.1 KiB
Markdown
168 lines
7.1 KiB
Markdown
# App Designer Binding Guide
|
||
|
||
## Fastest Path
|
||
|
||
按原计划要最快跑通，建议只先做这一条主线：
|
||
|
||
1. 保持真正界面文件为 [EDFM_Simulator_App.mlapp](C:\Users\15715\Documents\code\edfm_gui\gui_support\app\EDFM_Simulator_App.mlapp)。
|
||
2. 不直接改解包后的 `.mlapp` 内容。
|
||
3. 用新加的控制器 [EDFMAppController.m](C:\Users\15715\Documents\code\edfm_gui\gui_support\app\EDFMAppController.m) 负责绑定。
|
||
4. 首先只保证 `case01` 的模板加载、配置导入导出、运行、结果导入导出、基础绘图跑通。
|
||
5. 其他 case 和更细的参数编辑体验留到下一轮。
|
||
|
||
原因很直接：现在仓库里后端已经有统一 `config`、`case01` 模板、`run_case(config)`、MAT 导入导出，缺的主要就是 `.mlapp` 的回调连接和控件同步。
|
||
|
||
## 我已经补了什么
|
||
|
||
新增了 [EDFMAppController.m](C:\Users\15715\Documents\code\edfm_gui\gui_support\app\EDFMAppController.m)，负责：
|
||
|
||
- 启动默认加载 `case01`
|
||
- `New Config`
|
||
- 模板加载
|
||
- config 导入导出
|
||
- result 导入导出
|
||
- 从 UI 回写 `config`
|
||
- 从 `config` 刷新 UI
|
||
- 调用 `run_case(config)`
|
||
- 基础结果摘要和绘图
|
||
- SP/DP 页签切换
|
||
- 三种流动模型页签切换
|
||
|
||
当前重点是让你现有 `.mlapp` 最快可运行，不是一次性把所有参数编辑体验做完。
|
||
|
||
## 你需要在 App Designer 里手动做的事
|
||
|
||
只在 [EDFM_Simulator_App.mlapp](C:\Users\15715\Documents\code\edfm_gui\gui_support\app\EDFM_Simulator_App.mlapp) 里做下面这些操作。
|
||
|
||
### 1. 添加控制器属性
|
||
|
||
在属性区加上：
|
||
|
||
```matlab
|
||
Controller EDFMAppController
|
||
```
|
||
|
||
如果已经有，就保留，不要改名。
|
||
|
||
### 2. 添加 startup 函数
|
||
|
||
在 Code View 里确认有：
|
||
|
||
```matlab
|
||
function startupApp(app)
|
||
app.Controller = EDFMAppController(app);
|
||
app.Controller.startup();
|
||
end
|
||
```
|
||
|
||
并确认构造函数里有：
|
||
|
||
```matlab
|
||
runStartupFcn(app, @(~,~)startupApp(app));
|
||
```
|
||
|
||
### 3. 绑定按钮回调
|
||
|
||
把这些控件分别绑定到这些方法：
|
||
|
||
- `NewConfigButton` -> `onNewConfig`
|
||
- `LoadTemplateButton` -> `onLoadTemplate`
|
||
- `ImportConfigButton` -> `onImportConfig`
|
||
- `ExportConfigButton` -> `onExportConfig`
|
||
- `RunButton` -> `onRun`
|
||
- `RunCurrentConfigButton` -> `onRun`
|
||
- `ImportResultButton` -> `onImportResult`
|
||
- `ExportResultButton` -> `onExportResult`
|
||
- `PlotResultButton` -> `onPlotResult`
|
||
|
||
对应方法：
|
||
|
||
```matlab
|
||
function onNewConfig(app)
|
||
app.Controller.newConfig();
|
||
end
|
||
|
||
function onLoadTemplate(app)
|
||
app.Controller.loadTemplate(app.TemplateDropDown.Value);
|
||
end
|
||
|
||
function onImportConfig(app)
|
||
app.Controller.importConfig();
|
||
end
|
||
|
||
function onExportConfig(app)
|
||
app.Controller.exportConfig();
|
||
end
|
||
|
||
function onRun(app)
|
||
app.Controller.runCurrentConfig();
|
||
end
|
||
|
||
function onImportResult(app)
|
||
app.Controller.importResults();
|
||
end
|
||
|
||
function onExportResult(app)
|
||
app.Controller.exportResults();
|
||
end
|
||
|
||
function onPlotResult(app)
|
||
app.Controller.plotResults();
|
||
end
|
||
```
|
||
|
||
### 4. 绑定模型切换回调
|
||
|
||
给下面两个下拉框绑定 `onModelChanged`：
|
||
|
||
- `ModelFlowModelDropDown`
|
||
- `ModelGridModelDropDown`
|
||
|
||
方法：
|
||
|
||
```matlab
|
||
function onModelChanged(app)
|
||
if ~isempty(app.Controller)
|
||
app.Controller.syncModelTabs();
|
||
end
|
||
end
|
||
```
|
||
|
||
同时把：
|
||
|
||
- `ResultTypeDropDown` 的 `ValueChangedFcn`
|
||
|
||
绑定到 `onPlotResult`。
|
||
|
||
### 5. 保持控件名不变
|
||
|
||
控制器默认依赖这些命名，不要在 App Designer 里随意改：
|
||
|
||
- 顶栏：`TemplateDropDown`、`LoadTemplateButton`、`ImportConfigButton`、`ExportConfigButton`、`RunButton`、`ImportResultButton`、`ExportResultButton`、`StatusLabel`
|
||
- 模型：`ModelFlagDropDown`、`ModelGridModelDropDown`、`ModelFlowModelDropDown`
|
||
- 网格：`GridDxTextArea`、`GridDyTextArea`、`GridDzTextArea`、`GridNTGTextArea`
|
||
- 裂缝：`FractureInputStyleDropDown`、`FractureInputTextArea`、`FractureLinesTextArea`、`FractureHeightsTextArea`、`FractureFlowBarrierFlagsTextArea`
|
||
- SP：`SPBoundaryTextArea`、`SPInvalidLayerTextArea`、`SPMatrixKxTextArea`、`SPMatrixKyTextArea`、`SPMatrixKzTextArea`、`SPMatrixPoriTextArea`、`SPMatrixPrporEditField`、`SPMatrixCporEditField`、`SPRockDensityEditField`、`SPFractureKfTextArea`、`SPFractureWfTextArea`、`SPFracturePorfTextArea`、`SPFracturePrporEditField`、`SPFractureCporfEditField`、`SPStressFractureEditField`、`SPStressMatrixEditField`、`SPStressRefPressureEditField`
|
||
- DP：`DPkxTextArea`、`DPkyTextArea`、`DPkzTextArea`、`DPkx_matrixLayerTextArea`、`DPky_matrixLayerTextArea`、`DPkz_matrixLayerTextArea`、`DPpori_matrixLayerTextArea`、`DPsigmaTextArea`、`DPNTGTextArea`、`DPprporEditField`、`DPcporEditField`、`DPKfTextArea`、`DPWfTextArea`、`DPPorfTextArea`、`DPprporfEditField`、`DPcporfEditField`、`DPstress_factor_fractureEditField`、`DPstress_factor_matrixEditField`、`DPstress_factor_ref_pressureEditField`
|
||
- 初始值和多组分主控件：`InitialPressureEditField`、`InitialSwEditField`、`InitialCsEditField`、`InitialCbEditField`、`InitStatusLabel`、`MCcs_NcTextArea`、`MCkr_nosurfTextArea`、`MCkr_surfTextArea`、`MCPCTextArea`、`MCcs_Nc_fractureTextArea`、`MCkr_nosurf_fractureTextArea`、`MCkr_surf_fractureTextArea`、`MCPC_fractureTextArea`、`MCp_grad_thresholdEditField`、`MCgas_propVLEditField`、`MCgas_propPLEditField`、`MCgas_propKnEditField`、`MCstress_factor_fractureEditField`、`MCstress_factor_matrixEditField`、`MCstress_factor_ref_pressureEditField`、`MCbeta_non_darcy_flowEditField`、`MCdensity_g_scEditField`、`MCgas_modelDropDown`、`MCprgEditField`、`MCBgiEditField`、`MCcgEditField`、`MCvgiEditField`、`MCcvgEditField`、`MCPprTextArea`、`MCBGTextArea`、`MCMUGTextArea`、`MCdensity_w_scEditField`、`MCprwEditField`、`MCBwiEditField`、`MCcwEditField`、`MCvwiEditField`、`MCcvwEditField`
|
||
- 井和排程：`Well1Table`、`FractureWellLocationTable`、`Well2Table`、`ScheduleTable`、`TimeTextArea`、`DtMinTextArea`、`DtMaxTextArea`
|
||
- 求解器：`YitaPEditField`、`YitaSEditField`、`OmegaEditField`、`NmaxEditField`、`EpsAveEditField`、`EpsMaxEditField`
|
||
- 运行和结果：`RunLogTextArea`、`RunProgressLabel`、`CurrentStageLabel`、`CurrentTimeLabel`、`CurrentDtLabel`、`ResultSummaryTextArea`、`ResultTypeDropDown`、`ResultAxes`、`ResultTab`
|
||
- 页签组：`TabGroup2`、`TabGroup3`、`GasWaterTab`、`OilWaterTab`、`MultiComponentTab`、`SPTab`、`DPTab`
|
||
|
||
## 第一轮验证怎么做
|
||
|
||
1. 在 App Designer 打开 [EDFM_Simulator_App.mlapp](C:\Users\15715\Documents\code\edfm_gui\gui_support\app\EDFM_Simulator_App.mlapp)。
|
||
2. 按上面的方式挂好属性、startup 和 callbacks。
|
||
3. 直接运行 app。
|
||
4. 看启动后是否自动加载 `case01`。
|
||
5. 看 `ModelFlowModelDropDown = 3` 时是否自动切到多组分页。
|
||
6. 不改参数直接点 `Run`，先验证统一链路能否起跑。
|
||
|
||
## 当前已知限制
|
||
|
||
- 模板仍然只有 `case01`。
|
||
- 现在是“先跑通”的控制器，不是最终版用户体验。
|
||
- `UITable` 里嵌套 cell 和矩阵的编辑体验还比较原始。
|
||
- [launch_edfm_simulator_app.m](C:\Users\15715\Documents\code\edfm_gui\gui_support\app\launch_edfm_simulator_app.m) 目前仍指向手写 `.m` app，不适合你当前的 `.mlapp` 工作流，所以这一步先直接在 App Designer 里运行 `.mlapp`。
|