AcpStyles

<< ACP

Acp_attrib

ACP offers several options for controlling how the user interface looks and works. You control most of these options by setting flags in Acp_attrib for the main model. You can set a few using Acp_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 Acp_attrib for Modules, and also Variables. If you are using Analytica 4.3 or earlier, the attribute will appear as Awp_attrib instead. The attribute was renamed to Acp_attrib in Analytica 4.4.

You can then add these flags to Acp_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 Acp_attrib, you can separate them with commas or spaces, or whatever you prefer. ACP 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 Acp_attrib of the object window of the Main Model.  (So far, ACP does not support Acp_attrib in submodules. We may add module-specific options later.)

Navigation styles

  • show_outline:no - By default, ACP 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 ACP not to show the outline tree by inserting the text show_outline:no into the top models Acp_attrib to prevent ACP 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, ACP 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 ACP to show the diagram title by using show_diagram_title:yes, but this is not really necessary because the currently ACP 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 ACP, you can suppress these with the flag Show_unc_view_in_outputs:No. We recommend this for ACP since the icon is usually confusing to end users. 

Uncertainty view icons.png

  • Show_logo:no - Hides the Lumina logo at the top of ACP. (Default is "Yes")
  • calc_on_open:yes - By default, ACP, 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 Acp_attrib
  • show_hover_highlight:no- Usually, ACP 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.)
  • show_copy_table_icon:no - Usually, ACP displays a copy table icon near the upper right hand corner of a result table (or edit table, but less useful here). Clicking the icon copies the table as displayed so it can be pasted into another place, e.g. Excel. If you don't want hide this icon, this is the flag to use. The Copy Table Icon is the icon shown in the image below.

Copy table icon.png

Hover Balloon

When you move the cursor over a node, ACP 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 Acp_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  Acp_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 Acp_attrib for each node:

  • show_hover_balloon_title:no - Insert this flag in the Acp_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 Acp_attrib for the model. By default (for now) ACP 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 ACP

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 Acp_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 Acp_attrib for selected objects (nodes).

Input nodes

  • textalways - Usually in ACP 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 Acp_attrib for each Input node if you want it treat the input as text without requiring the user to use quotes.
  • tabindex:n - In ACP 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 Acp_attrib of the first one. Put . The tabindex:2 into the second,  and so on.

Embedded Tables and Graphs

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

<< ACP

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.