Workspace - zward/Amua GitHub Wiki

Workspace Layout
Building a Model
Running a Model
Display Options

Workspace Layout

The workspace is comprised of 3 resizable components:

Workspace

  1. Canvas: The model is displayed on the main canvas which can be edited by using the toolbar or by right-clicking on model nodes.
  2. Object Sidebar: The sidebar displays model objects. The sidebar can be collapsed/expanded by pressing the small triangle buttons on the sidebar.
  3. Bottom Pane: The bottom area of the screen displays information about the current model.
    • Console: Displays model output and messages. Model objects are color-coded for visual ease and display more information if hovered over
    • Notes Notes: Interactive notes pane to display information about model nodes
    • Parameter sets Parameter Sets: Models can be run with different sets of parameters to explore uncertainty

Building a Model

Adding Nodes

Child nodes can be added to a selected parent node in a few ways:

  • Double-click: This will add 2 child nodes to the selected node if it has no children - otherwise only 1 node will be added
  • Toolbar: Click the appropriate node type on the toolbar to add it to the tree
  • Right-click: Right-click on the parent node to show the pop-up menu, then choose Add -> and select the node type
  • Copy/Paste: Existing sub-trees can be copied and pasted elsewhere in the tree using the Edit menu, pop-up menu, or keyboard shortcuts (Windows: Ctrl+C, Ctrl+V or Mac: Cmd+C, Cmd+V)

Note attributes can be edited on the canvas or in the formula bar at the top. The entries will be evaluated when the field/formula bar loses focus and the text will turn red in the event of an error.

Node attributes can also be changed using Find/Replace Find under the Edit menu. The scope of the find/replace operation can be made global or field-specific (e.g. only search payoffs, etc.)

Changing Node Types

Change type Chance and terminal/transition nodes can be switched back and forth via the toolbar or the pop-up menu.

Removing Nodes

Nodes and sub-trees can be removed by selecting the node/root of the sub-tree and pressing Delete on the keyboard, or by clicking 'Delete' on the pop-up menu.

Nodes/sub-trees can also be cut and pasted elsewhere using the Edit menu, pop-up menu, or keyboard shortcuts (Windows: Ctrl+X, Ctrl+V or Mac: Cmd+X, Cmd+V).

Alternatively, you can always Undo or Redo actions using the Edit menu or keyboard shortcuts (Windows: Ctrl+Z, Ctrl+Y or Mac: Cmd+Z, Cmd+Y).

Running a Model

Check Model

You can click the check model button Check tree to ensure that there are no errors before running the model. Any errors found (such as probabilities that don't sum to 1.0) will be highlighted in yellow and must be addressed before the model can be run. A list of errors (if any) will also be displayed on the console.

Run Model

Click the run button Run tree to run the model. It is not necessary to check the model first as this will be done automatically. For Markov models, a single Markov Chain can be run by first selecting the chain root and running the model. If no chain is selected all chains will be run.

After the model has run strategy results will appear on the canvas and summary output will be displayed in the console.

Display Options

Clear

The clear button Clear removes any annotations (such as expected values and highlighting) from the canvas and clears the console.

Tree Alignment

There are a number of features to help customize your visualization of the tree:

  • OCD (Optimize Current Display): Aligns all nodes horizontally (by level) and ensures adequate vertical spacing
  • Vertical spacing Vertical Spacing: Equalizes the vertical distance between children of the selected node
  • Collapse Collapse/Expand: Collapses or expands the sub-tree beginning at the selected node
  • Align Left Align Left: Aligns terminal/transition nodes left - nested one level to the right of their parents
  • Align Right Align Right: Aligns all terminal/transition nodes to the far right

Zoom

The zoom slider and +/- buttons allow you to zoom in and out on the canvas

Screenshot

The screenshot button Screenshot copies a snapshot of the canvas to the clipboard that can be pasted in other applications. You can also save an image of the canvas as a PNG, GIF, or JPEG by going to Model -> Save As...

⚠️ **GitHub.com Fallback** ⚠️