AcpStyles

Awp_attrib

AWP offers several options for controlling how the user interface looks and works. You control most of these options by setting flags in AWP_attrib for the main model. You can set a few using AWP_attrib for specific variables or nodes.

To set these in Analytica, in Edit mode select the Attributes... dialog from the Object menu, and add the attribute AWP_attrib for Modules, and also Variables.

You can then add these flags to AWP_attrib in the Object window for the main model. (Show the top diagram and click the Object view, third icon in nav bar.)

To add multiple flags in AWP_attrib, you can separate them with commas or spaces, or whatever you prefer. AWP just looks for the particular text values and doesn't care about the delimiter.

Model level settings

For these options, insert each flag in the Awp_attrib of the object window of the Main Model.  (So far, AWP ignores Awp_attrib in submodules. We may add module-specific options later.)

Navigation styles

  • show_outline:no - By default, AWP shows an expandable outline tree of modules on the left hand side of the window. This makes it easy to navigate around a model with many modules. For small models, and most web apps, you may want to suppress this. You can configure AWP not to show the outline tree by inserting the text show_outline:no into the top models Awp_attrib to prevent AWP from displaying the Outline. (The flag no_outline has the same effect, but it's use has become deprecated.)
  • restrict_navigation:yes - For some models, you might just want to make not make all the diagrams available for playing by the end user. For example, you might want to limit the navigation to one or more diagrams for entering inputs and viewing results. By setting this flag, you can remove the various builtin GUI elements used to navigate the model. This flag will remove:
    • The outline tree for navigating modules
    • The 'Go into Parent' button which usually displays the diagram that contains the module currently being viewed.
    • The navigation tabs i.e. Diagam, object , edit table, result table, and graph tabs. So instead of having these tabs, tables and graphs need to be embedded in the diagram.
    • Right click popup menu for displaying the object view.
  • top_diagram_only:yes - Use this flag if you want to restrict users access to only the top diagram. With this flag, any action that would normally bring up a different diagram will just reload the top diagram. [Why wouldn't it be a no-op rather than a reload?]
  • show_parent_diagram_button:no - Flag to control the display of the 'Go into Parent' button. Currently the button is shown by default. (You can also set this flag to show_parent_diagram_button:yes to explicitly show this button.)
  • parent_diagram_button_coordinates:x,y if you want to change the location of the button 'Go into Parent' you can use this flag. E.g. parent_diagram_button_coordinates:10,100 will change the position of this button to x=10, and y=100. These coordinates are measured from the top left hand corner of the window.
  • show_tabs:no - By default, AWP shows navigation tabs for "Diagram", "Object", "Table", "Chart" along the top.  Use this flag to hide those tabs. If you display the model inputs and outputs on the diagram -- using embedded tables and graphs on the diagram -- your users may not need those tabs. (You can also use show_tabs:yes to explicitly show the tabs.)
  • show_diagram_title:no - You can control whether or not to display the diagram's title at the top of the diagram. Use show_diagram_title:no to suppress the diagram title. You can also explicitly tell AWP to show the diagram title by using show_diagram_title:yes, but this is not really necessary because the currently AWP shows the diagram title by default.

Style for diagram nodes

  • Show_unc_view_in_outputs:no - In Desktop Analytica, each user output node has a little icon on the right-hand side showing the uncertainty view last viewed (e.g. mid, mean, stats...). In AWP, you can suppress these with the flag Show_unc_view_in_outputs:No. We recommend this for AWP since the icon is usually confusing to end users. 

Uncertainty view icons.png

  • Show_logo:no - Hides the Lumina logo at the top of AWP. (Default is "Yes")
  • calc_on_open:yes - By default, AWP, like Analytica, does not compute results when you first view a diagram, leaving any User output nodes showing the "Calc" button. The user must click on each to see its result, as a scalar embedded in the Diagram, or as a separate Result window. Unless some results take a long time to evaluate, it is usually friendlier to compute the values before showing the Diagram. You can make this happen by inserting calc_on_open:yes into Awp_attrib
  • show_hover_highlight:no- Usually, AWP displays a hover highlight -- a contrasting light rectangle behind a node -- when you move the cursor over the node. You can suppress this by including the Show_hover_highlight:no. (The hover highlight is different from the hover balloon described below.)

Hover Balloon

When you move the cursor over a node, AWP usually shows a "balloon" popup next to the node with the title and description of the node (if it has one) to help end users understand what its for, or what to enter for a user input.

  • show_hover_balloon:no - Insert this in flag the AWP_attrib for a node, to suppress display of its balloon.
  • show_id_in_balloon:yes - Use this flag to show each node's identifier below its title in the balloon -- unless the identifier and title are identical (except for spaces which are replaced by underscores).
  • show_definition_in_balloon:yes - Use this flag to show the node's definition in the balloon below the description.
  • hover_balloon_delay - When you mouse over a node, there's a short delay of about half a second before it displays the balloon (to prevent wild balloon appearance when you move the cursor rapidly over a diagram.) You can tweak this delay time measured in milliseconds by inserting this flag. E.g. hover_balloon_delay:200 to reduce the delay to .2 seconds.

The three flags above go in the  awp_attrib of the model and apply to all nodes in the model. You can also modify some aspects of the balloon separately for each node by inserting these flags in AWP_attrib for each node:

  • show_hover_balloon_title:no - Insert this flag in the AWP_attrib for a node, to suppress its title in the balloon.

Enhanced Diagram Graphics

You can control the appearance of each nodes, with bevels, shadows, and highlights, by setting these in the AWP_Attrib for the model. By default (for now) AWP displays nodes without these effects, similar to Desktop Analytica, looking rather flat like this:

Nodes no shadow or bevel.png


Node_drop_shadow:yes -- Setting this flag, displays a drop shadow behind each node, giving a kind of 3-D effect:

Nodes drop shadow.png


Bevel_node_border:yes -- Setting this flag, displays a bevel border for each node, giving another kind of 3-D effect:

Nodes beveled border.png


Glow_hover_highlight:yes - Set this flag to show a "glowing" highlight around each node when you move the cursor over a node.
Glow_hover_highlight:no. Switches off this behavior, which is the default behavior in AWP

Here is the glow hover effect on a node, along with Drop shadow and Beveled border effects.

Nodes all graphic effects.png


These effects are new and are still somewhat experimental, so, they are off by default. You are welcome to try them out, by setting AWP_Attrib for the main model. Eventually, these effects may become the default. Then you'll be able to turn each one off using Node_drop_shadow: No, Bevel_node_border:No, and Glow_hover_highlight: No. 

Node Level Settings

These style flags and options apply to individual nodes (variables), rather than the model as a whole. So, you set these flags on the AWP_attrib for selected objects (nodes).

Input nodes

  • textalways - Usually in AWP and Desktop Analytica, to enter a text value into a user input node you have to enclose it in quotes. Insert this flag into the AWP_Attrib for each Input node if you want it treat the input as text without requiring the user to use quotes.
  • tabindex:n - In AWP and Desktop Analytica, the user can press tab to go to the next input control to enter its input. You can control the tab order -- the sequence followed by tabbing through inputs -- by adding this flag. Put tabindex:1 into the awp_attrib of the first one. Put . The tabindex:2 into the second,  and so on.

Embedded Tables and Graphs

In AWP it is possible to display graphs and tables directly on the diagram. The Awp_attrib can be used to specify the region on the diagram to display these tables or graphs. More on Embedded Tables and Graphs...

Comments


Dpaine

61 months ago
Score 0

Autocalc was a combination of autorecalcresults and calc_on_open. They were in the diagram style section of this page, but I just commented them out since they do not work (yet) in ACP3/suan and I don't think we have any intention of including them, since proactively evaluate can I think replace the functionality. These are still mentioned in the style library wiki page, but I intend to remove it.

I'll put a link to the proactivelyevaluate page though, and I will add it to new DTA features in ACP with a link to its wiki page.
Permalink

You are not allowed to post comments.