Interface, Settings, and Daily Use¶
简体中文 · Previous: Quickstart · Next: Projects and lattices
Application anatomy¶
The top Ribbon groups actions by task:
| Page | Common actions |
|---|---|
| Project | Welcome, new/open/save, JSON export, undo/redo, revision review |
| Design | Lattice, physics inputs, circular view, element/Family/Cell operations |
| Calculate | Screening Study, nonlinear, orbit correction, optics, equilibrium, matched distribution, LMA, tracking |
| Results | Result pages, Screening Results, tasks |
| History | Catalog, source mapping, verification, evidence attachment, Composer handoff |
| View | Show or hide Project, Properties, and Output panels |
The central workspace shows one main page. Dockable side and bottom panels are:
- Project for object structure;
- Properties for selected-occurrence SI values;
- Tasks for durable tracking jobs, reconnect, refresh, and cancellation;
- Output for Studio, SSH, and Engine diagnostics.
The Welcome page initially hides these panels; restore them from View after entering a project.
Welcome also provides New, Open, Browse Screening Results, historical-catalog opening, return to the current project, and a recent-project list. Recents store local paths only, not project contents, and unavailable paths are labeled explicitly. The page permanently distinguishes Design model, Qualified calculation, and Machine prediction.
Language, theme, and network policy¶
Open Settings to select System/Light/Dark, System language/English/Simplified Chinese, and to manage execution targets. Preferences apply immediately and are stored locally.
Localization changes presentation only. Canonical JSON, units, formulas, schema names, hashes,
and Engine evidence retain their exact representation. Seeing values such as SCREENING or raw
evidence field names in an otherwise Chinese UI is therefore expected.
--offline disables startup recovery and automatic remote reconciliation. It does not remove
targets or disable local authoring and result verification. To guarantee no remote contact, also
avoid explicit Test, Evaluate, Run, Reconnect, or remote-refresh actions.
Status and identity labels¶
The status bar shows the current document and latest execution state. Calculation pages also show
project ID, content and physics identities, selected local target route, result relationship such
as CURRENT/STALE/INCOMPATIBLE, and stage states such as Ready/Running/Blocked/Failed.
A Target ID is local Studio route metadata, not signed Engine identity. Check Engine version, build, and source revision in Evidence.
Useful shortcuts¶
| Action | Shortcut |
|---|---|
| New / Open / Save | Ctrl/Cmd+N, Ctrl/Cmd+O, Ctrl/Cmd+S |
| Save As | Platform-standard Save As shortcut |
| Undo / Redo | Ctrl/Cmd+Z, platform-standard Redo |
| Add element | Ctrl+Shift+A |
| Duplicate element | Ctrl+D |
| Delete element | Delete |
| Evaluate optics | Ctrl+R |
| Open Screening Results | Ctrl+Shift+L |
Recommended daily habits¶
- Confirm the project and physics revision before editing.
- Use Review Current Revision after a meaningful group of physical edits.
- Save working state as
.vmaproj; use JSON for interchange. - Check the selected target before running; results from different routes are never silently mixed.
- Read warnings and applicability before headline numbers.
- Do not edit the managed local result stores by hand; reverify and export from Studio.