77 lines
2.7 KiB
Markdown
77 lines
2.7 KiB
Markdown
# GUIDE Version Run Notes
|
|
|
|
The MATLAB R2022a entry point now launches the GUIDE-compatible UI. GUIDE does not support `uitabgroup` or `uitab`, so this UI uses GUIDE-supported `uipanel` containers plus `popupmenu` selectors to simulate pages.
|
|
|
|
Main files:
|
|
|
|
- `gui_support/app/EDFMSimulatorGuide.fig`
|
|
- `gui_support/app/EDFMSimulatorGuide.m`
|
|
|
|
## Run
|
|
|
|
In MATLAB R2022a:
|
|
|
|
```matlab
|
|
cd('C:\Users\15715\Documents\3D_EDFM_SIM-X')
|
|
startup
|
|
app = launch_edfm_simulator_guide;
|
|
```
|
|
|
|
The generic launcher also starts the GUIDE version:
|
|
|
|
```matlab
|
|
cd('C:\Users\15715\Documents\3D_EDFM_SIM-X')
|
|
startup
|
|
app = launch_edfm_simulator_app;
|
|
```
|
|
|
|
## Edit With GUIDE
|
|
|
|
Open the FIG in GUIDE:
|
|
|
|
```matlab
|
|
guide('C:\Users\15715\Documents\3D_EDFM_SIM-X\gui_support\app\EDFMSimulatorGuide.fig')
|
|
```
|
|
|
|
The top-level page selector is `PageDropDown`. Each page is a stacked `uipanel`, such as `ModelTab`, `GridTab`, `FlowTab`, and `ResultsTab`.
|
|
|
|
Because the page panels overlap, simply setting one panel to `Visible=on` may still leave another visible panel covering it. The most reliable editing workflow is to open GUIDE through the page helper:
|
|
|
|
```matlab
|
|
edit_edfm_guide_page('Model')
|
|
edit_edfm_guide_page('Flow')
|
|
edit_edfm_guide_page('Results')
|
|
```
|
|
|
|
For inner pages:
|
|
|
|
```matlab
|
|
edit_edfm_guide_page('SP')
|
|
edit_edfm_guide_page('DP')
|
|
edit_edfm_guide_page('GasWater')
|
|
edit_edfm_guide_page('OilWater')
|
|
edit_edfm_guide_page('MultiComponent')
|
|
```
|
|
|
|
This helper updates the same `EDFMSimulatorGuide.fig` file before opening GUIDE: it turns the other panels in the same group off, brings the selected panel to the top, saves the FIG, and then opens GUIDE. Save and close an already-open GUIDE editor before switching pages with this command, otherwise GUIDE may keep an older in-memory copy.
|
|
|
|
`show_edfm_guide_page` is lower-level and only works on a normal open figure handle. GUIDE's design window is not always exposed as a normal MATLAB figure, so prefer `edit_edfm_guide_page` for day-to-day editing.
|
|
|
|
The Property Inspector title may show `matlab.ui.container.Panel`. That is the object class, not the page name. Check the `Tag` property to confirm whether the selected panel is `ResultsTab`, `FlowTab`, or another page.
|
|
|
|
Do not freely rename control `Tag` values. `EDFMSimulatorGuide.m` and `EDFMAppController.m` use these tags to find controls and bind callbacks.
|
|
|
|
## Regenerate FIG
|
|
|
|
If the FIG is lost or damaged, regenerate it from the layout script:
|
|
|
|
```matlab
|
|
cd('C:\Users\15715\Documents\3D_EDFM_SIM-X')
|
|
startup
|
|
build_edfm_guide_fig
|
|
```
|
|
|
|
This is only a recovery path. Day-to-day UI maintenance should edit `EDFMSimulatorGuide.fig` in GUIDE.
|
|
|
|
Do not change the page containers back to `uitabgroup`. MATLAB can display `uitabgroup` at runtime, but GUIDE deletes it when opening the FIG.
|