Embed table or graph with ACP
Initially AWP was developed with a tabbed user interface where graphs and tables would appears by clicking on their respective tabs at the top of AWP. From doing some AWP web applications, we found it was very nice to have diagrams and tables to appear directly diagram.
We have implemented two ways for tables and graphs to be displayed on the diagram. One is by making input or output nodes large and AWP will then then display the table or graph in the input/output node. The other approach for embedding tables and graphs is to create a "frame node(s)" which will be displaying the tables and graphs.
Tall input or output nodes
To show a table or graph embedded in a diagram in AWP, you simply make its input node for an edit table -- or output node for result table or graph -- tall: In Analytica, drag a corner of the node so that its height is more than four times its initial default height. (The default height of an input or output node is 26 pixels -- if it uses the default 11-point font size. So, "tall" in this case, means more than 104 pixes -- more for a larger font.)
AWP uses the table or graph format last used in the last version of the model you saved in DTA. So, if you want AWP to show a graph (not result table), you should view it that way -- and set any graph style options you want -- before you save the model. Similarly, for an Edit table, choose the pivot (which index is rows and which columns) before you save the model. Similarly, AWP uses the uncertainty view -- mid, mean, statistics, pdf, cdf, or sample -- that you last viewed in DTA. (This information is stored in the Valuestate attribute for the original node.)
AWP automatically sizes a graph to fit the frame (node size) you have specified. This usually works well if you make the frame large enough. If an edit table or result table is larger than frame, it shows whatever fits, along with scroll bars to let the user see other parts of the table.
Example usage
Here's how the modeler creates the output node in DTA:
Here's the result displayed on the diagram in AWP:
Text Area Input Node
If you make a input node that contains a single (atomic) text value tall (in DTA), AWP will insert a multi-line text box. This let users enter multi-line input -- e.g. from copying and pasting multiple lines of text. (A standard single line text box will not support multiline text input.)
Designate a frame node
A Frame node specifies an area of a diagram in which AWP displays the edit table, result table or graph for any variable that the user selects in the diagram. It also (optionally) displays the title and description of the selected variable at the top of the frame and highlights the displayed node, to remind you what variable you are looking at. This scheme turns out to be very convenient, since the author needs specify a single area, and the end user can quickly see the table or result of any node selected in a diagram or form containing inputs and outputs. It is especially handy in AWP where the user is viewing the model via a Web browser, and cannot easily position multiple windows to view diagrams and results at the same time, as they can in Desktop Analytica.
You can display multiple tables and graph by specifying multiple frame nodes. This lets the user see multiple input or output tables or graphs at the same time for comparison. When you click on a node in the diagram, it shows its table or graph by replacing the earliest one previously displayed. For example, if you have two frames F1 and F2, in which you have show A in F1 and then B in F2. When you click on C, it shows the table or graph for C in F1, replacing A. If you then click D, it shows the table or graph for D in F2. And so on.
Or you can control which frame node to show which variable in, as follows:
Instructions for using frame nodes to embed graphs and tables in the diagram
If you want to display edit tables, or results in multiple frames, AWP needs to know which frame to use for which node. This is done by specifying an AWP_attrib for each node and/or specifying an Awp_attrib for the module, containing FrameNode:Textnode1 to specify that it use Textnode1 as the frame.
Example 1: Use one frame node to display tables and graphs on the diagram
Module M Awp_Attrib: FrameNode:TextNode1
Example 2: Using two frame nodes, one for inputs and one for outputs
In this example let's say you have a diagram with two node's that are defined as edit tables with identifiers Inputdata1 and Inputdata2. And you have two nodes which display the graphical results of evaluating the model called Result1 and Result2.
You might one to have one frame node for handling the input data for the two edit tables and another input node for displaying the result graph one at a time.
So in this case you would have two frame nodes. You can specify which node is to use as follows:
Variable Inputdata1 Awp_Attrib: FrameNode:TextNode1
Variable Inputdata2 Awp_Attrib: FrameNode:TextNode1
Variable Result1 Awp_Attrib: FrameNode:TextNode2
Example 3: Using two frame nodes, where one is a module level framenode
Suppose your diagram has two input tables and five output nodes to show results. In this case, you decide you want to use one frame to display the edit tables and another frame for results. In this case, you could set the Awp_attrib for the two input tables, and set a module level Awp_attrib which will be used by all the output nodes.
Variable Inputdata1 Awp_Attrib: FrameNode:TextNode1
Variable Inputdata2 Awp_Attrib: FrameNode:TextNode1
Module M Awp_Attrib: FrameNode:TextNode2
Since the output nodes do not have an Awp_attrib specifying a frame, they use the frame specified in the module's Awp_attrib.
Example 4: Using two frame nodes, both specified at the module level
Another option is to cycle through any available frames -- the first node
clicked would use the first frame. The second uses the second frame. If there are only
two frames in the diagram, the third node will reuse the first frame. And so on.
Normally, the author would lay out two or more frames of the same size.
The following settings will result in tables and graphs being displayed in Textnode1 and Textnode2:
Module M Awp_Attrib: FrameNode:TextNode1&TextNode2
What is displayed?
Title and description: Normally AWP shows the node's title in bold at the top of the frame followed by its description. But, if the Description contains more text than will fit in the top third of the frame, it shows only what will fit in the top third, with a scrollbar to see more.
When a Diagram first opens in AWP (and no node has been selected), each frame node shows its own title and description (if any). This is a useful place to put a introductory explanation of this diagram and how to use it.
Font size: It uses the font style and size specified for the frame node with the title in bold -- initially the title and description specified for the frame, and then the title and description for the selected variable.
It should allow web links (as in other descriptions) to appear in the description text.
FrameOptions:
- Show_title: Set Show_title:no to stop showing the Title of a selected variable.
- Show_description:nn : Where nn is a number between 0 and 100, where it uses up to nn% of the vertical space available to show the description, showing vertical scroller if that isn't enough to show the entire description. Set nn=0, if you don't want to show the description at all (and no scroller). Default if not mentioned, is one third, i.e. Show_description:33
- Graph: Shows graph (even if model author last saved result as a table)
- Table: Shows table (if if model author last saved result as a graph)
- Graph_over_table: Show graph above table in the same Frame.
- Table_over_graph: Table above graph in the same Frame.
Example, to have the result graph show over the result table, and to allow the description to use up to 50% of the frame node area you would specify the following:
Text Textnode1 Awp_attrib: Show_description:50 Graph_over_table
Enable comment auto-refresher