Difference between revisions of "Frames, Menus, Toolbars"

From Numerus
Jump to navigation Jump to search
Line 8: Line 8:
[[File:mainframe.png|thumb]]
[[File:mainframe.png|thumb]]
;a. Launch Panel: Sets the simulation parameters and launches the model for execution;
;a. Launch Panel: Sets the simulation parameters and launches the model for execution;
;b. Design Tabs: An accordian list<ref name="accordian">An ''accordian list'' is s graphical control element comprising a vertically stacked list of items, such as labels or thumbnails. Each item can be "expanded" or "stretched" to reveal the content associated with that item. There can be zero expanded items, exactly one, or more than one item expanded at a time, depending on the configuration.</ref> of tools for building models; each of these is discussed in detail elsewhere;
;b. Design Tabs: An accordion list<ref name="accordion">An ''accordion list'' is s graphical control element comprising a vertically stacked list of items, such as labels or thumbnails. Each item can be "expanded" or "stretched" to reveal the content associated with that item. There can be zero expanded items, exactly one, or more than one item expanded at a time, depending on the configuration.</ref> of tools for building models; each of these is discussed in detail elsewhere;
;c. Model Canvas: Construction platform for component-based models;
;c. Model Canvas: Construction platform for component-based models;
;e. Property Pane: Shows controls for specifying component properties;
;e. Property Pane: Shows controls for specifying component properties;

Revision as of 20:32, 20 January 2018

In this section we explain each element of the Nova interface.

Frames

Nova has two frames, the Design Frame and the Runtime Frame. As these names suggest, the Design Frame provides tools for creating and building a Numerus model. Once this model is built, the Runtime Frame provides the means to control and view the running simulation, in addition to special analytical tools of particular use with numerical models.

Design Frame

a. Launch Panel
Sets the simulation parameters and launches the model for execution;
b. Design Tabs
An accordion list[1] of tools for building models; each of these is discussed in detail elsewhere;
c. Model Canvas
Construction platform for component-based models;
e. Property Pane
Shows controls for specifying component properties;
f. Parameter Table
Manages sets of parameters used by the model.

Runtime Frame

RuntimeFrame.png
a. Simulation Control Toolbar
Buttons for running the simulation and setting temporary simulation parameters;
b. Console
provides Interactive access to the Numerus runtime interpreter.
c. Analytical Tools
Available when parameters are used for parameter sweep, optimization, etc.
d. Dashboard
Contains controls and visualizing elements for use during simulation execution.
e. Runtime Parameter Table
Facilitates temporary parameter settings


Framesliders.png

The sections of these frames are separated by dividers (shown in black in the picture on the right) that can be shifted to expose more or less of one side or the other. Use these dividers as needed to create additional viewing space when using one of the panels.

Menus

Design Frame

File New Clears the system and creates a new project
Open Select and load project
Recent Files Shows recently opened project for selection
Reload Rereads the current project into Nova
Browse Model Library Opens a browsing window to allow selection of a project from the model library
New Project Window Opens a new empty design frame
Save Saves the current project
Save As Saves the current project, possibly in a new file
Import Capsule(s) Into Project Imports a selected project as a submodel
Export Current Capsule Exports currently viewed capsule (and any dependencies) for import into another project
Open Current Capsule as New Project Opens a new design frame with currently viewed capsule, as main level, and any dependencies
Preferences Opens User Preference dialog
Exit Exits program
Edit Cut Remove the currently selected components and copy to the clipboard
Copy Copy the currently selected components to the clipboard
Paste Paste contents of the clipboard to the model canvas
Delete Remove the currently selected components without copying
Create Phantoms Adds phantom components corresponding to those currently selected
Duplicate Current Capsule(s) Copies and pastes currently selected capsules into the current project
Copy Current Capsule(s) Copies currently selected capsules
Paste Capsules(s) Pastes previously copied capsules into current project
Tools Load Parameters Select and load a parameter set
Edit Equations Opens the Component Equation Panel, which permits editing of all component equations on the current level
Capsule Program Displays a compact description of the model's equations
View Novascript Displays the Novascript implementation of the current project
Snap to Grid Realigns all components with the underlying model canvas grid.
Reset Arrows Recomputes arrows
Documentation Opens the documentation panel.
Arrows On In this mode all arrows are visible.
Arrows Highlight In this mode only those arrows for the component under the mouse are visible.
Arrows Off In this mode no arrows are visible.
Connector Beads Visible Exposes connector beads
Connector Beads Invisible Hides connector beads
Build Website Creates Website for current project (Full version only)
Window Displays all windows associated with current project
Help About Shows version number, etc.

Runtime Frame

File Save Output Saves graph/table data to CSV file and/or image of graph/table to PNG file
Close Closes runtime frame
Tools Reset Zoom Resets dashboard zoom level
View Novascript Displays the Novascript implementation of the current project
Window Displays all windows associated with current project
Help About Shows version number, etc.

Design Tabs

This accordion list[1] contains all of the tools needed to design models. We present a summary below, with links to detailed descriptions.

Capsule List
The list of capsules used in the project, with controls to add and delete capsules, and the ability for reordering the list.
Components
The list of model components. These can be inserted into the model by dragging them onto the model canvas.
Displays & Controls
A similar list of display and control components.
Plugins
A similar list of plugins[2].
Code Chips
The list of code chips used in this model, with controls to add and delete code chips.
Misc Definitions
Reveals a second accordion list with tabs for Prelude, Global Functions, Global Variables/Constants and Local Methods.
Load Files
Reveals a second accordion with tabs for specifying JavaScript, TSV and CSV files to be loaded by the simulation.

Toolbars

Main toolbar

The main toolbar duplicates functionalities found in menu items

400xpx

Pallet toggles and contextual help

The next three buttons toggle (open/closed) the Component, Plugin and Code Chip pallets; these pallets are discussed below; the fourth button enables/disables contextual help.

300xpx

Simulation controls and execution/development modes

  • Simulation controls: Capture, load, etc. for executing simulations
  • Stats Selector: Enables use of R statistical package within Nova
  • Timeline view: Timeline view allows forward/backward simulation execution.
  • Automode: When enabled, cause automatic re-execution of simulation when an input parameter changes.
  • Top-level capture: When checked, capture always occurs at the top level regardless of the current model level in view.

600xpx

Execution toolbar

  • Simulation Runtime: user-specified clock parameters and integration method; displays current model time during execution.
  • Simulation Speed: determines real-time simulation speed.

600xpx

Pallets

  • Component Pallet: Select component for insertion onto model canvas. Components are described in Component Guide
  • Plugin Pallet: Select plugin for insertion onto model canvas and/or dashboard. Plugins are described in Plugins
  • Code Chip Pallet: Shows currently defined code chips for insertion onto model canvas. Code chips are described in Code Chips
300xpx 300xpx 150xpx

References

  1. 1.0 1.1 An accordion list is s graphical control element comprising a vertically stacked list of items, such as labels or thumbnails. Each item can be "expanded" or "stretched" to reveal the content associated with that item. There can be zero expanded items, exactly one, or more than one item expanded at a time, depending on the configuration.
  2. A plugin is a special component that can be included with a particular configuration of the software.