View source for Graph Setting Associations

[[Category: Graphs]]

If you change the style, font, or background settings of a graph, that change will apply to any uncertainty view of that variable. But, if you select the line style for a PDF view of a variable, it will usually not apply to the CDF view of that variable. If you change the axis range of a scale, it will still apply to that dimension if you pivot the graph or swap horizontal and vertical scales. 

More generally, each graph setting has an ''association'' that control what different graph views it applies to. Usually, you don't have to think about these associations. Analytica just does what you expect. But, occasionally you may need to understand them so you can predict their effects, especially when saving defaults for a model or defining a template.

There are four types of association, controlling what types of graph a change to a graph setting applies to:

'''Global Associations:''' Appearance settings, such as colors, style, font, and background are ''global'' -- meaning that a change to one graph for a variable will apply to all graph views of that variable; clicking "Set default" button, will apply these settings to all graphs in the model that use defaults for those settings.

'''Result Associations:''' These settings apply only to the specific graph, and no other graphs, even if you click "Set Default".

'''Dimension Associations:''' Settings in the Axis Ranges tab, including range, reverse order, categorical, or log scale, apply to the specified dimension or index. When you pivot the graph, or swap horizontal and vertical, they still apply to that dimension. If you click "Set default" after changing settings for a scale that is an index variable, those settings will become the default for that index in all graphs that use that index. 

'''Uncertainty view Associations:''' The application of Line style and related settings on the Chart Type tab is different for categorical and continuous graphs, and may differ by uncertainty view ([[PDF]], [[CDF]], Confidence Bands, etc.).  

Whether the X-axis dimension is categorical or continuous determines whether a graph is considered categorical or continuous.  (If SwapXY is on, then it is the Y-axis that determines this).  Separate line-styles are maintained for the categorical case and the continuous case.  Therefore, if you pivot a graph, causing the X-axis to change from a continuous dimension to a categorical one, the graph settings can swap from a line-graph to a bar graph, for example.  (only the line-style depends on the categorical / continuous distinction).

Settings in this category are associated with a view mode.  [[Mid]], [[Mean]] and Bands all share the same association, so a setting for Mid will transfer to a graph of Mean.  Separate settings exist for stats view, continuous [[PDF]], continuous [[CDF]], discrete prob mass, discrete cum prob, and sample.   There is a separate line style for the continuous and categorical case for each of these views.  But all other settings in this category, such as Area fill, change only with the view mode.  (so you can't have a filled line for continuous mean and unfilled line for categorical mean, but you could have an unfilled line for mean and a filled line for PDF).

Finally, when a line style is set to Bar, the graph is required to be categorical.  A flag indicates whether the continuous style setting has been set to bar, and if so, a continuous X-axis is forced to categorical when the graph is rendered.  

== Graph Settings and their Association Type ==

{|class="wikitable" valign="top"
!Descripton !! Stored as !! Sys or Att Name !! Association Type !! Notes
|-
!colspan="5" align="left" | Graph Template
|-
| Graph Template Identifier || Attribute || <code>Att_graphTemplate</code> || Global
|-
!colspan="5" align="left" | Line Style Settings:
|-
| Line Style || Attribute 
| <code>Att_ContLineStyle</code> &amp; <code>Att_CatLineStyle</code> <br>
0 = dot<br>
1 = line only<br>
4 = symbol only<br>
5 = line &amp; symbol<br>
6 = step<br>
9 = bar
| View
| Att used depends on whether x-axis is cat or continuous
|-
| Stacked Bar flag || Attribute || <code>Att_StackedBar</code> || View
|-
| Stacked lines flag || Attribute || <code>Att_stacked_lines</code> || View
|-
| Area fill flag  || Attribute || <code>Att_AreaFill</code> || View
|-
| Relative Proportion Flag<br>(not yet implemented)
| Attribute || <code>Att_relProportion</code> || View
|-
| Bar Overlap Percent || Attribute || <code>Att_barOverlap</code> || View
| In 3.1, was sysVar overlapWidth.<br>It is an attribute now.
|-
| Symmetric Colors flag<br>(not implemented) || Attribute || <code>Att_symmetric_colors</code> || Key
|-
| Transparency for fills || Sys var || <code>Graph_fillTransparency</code> || Global || Scale of 0 to 255
|-
| Bar Shape || Sys Var || <code>Graph_barShape</code> || View
|-
| 3D Effects flag || Sys Var || <code>Graph_3DEffects</code> || Global
|-
| Line Thickness || Sys Var || <code>Graph_LineThickness</code> || Global
|-
| Use Separate Color / Symbol Keys || SysVar || <code>Graph_SymbolKey</code> || Global
|-
| Enable Symbol Size Role || Sys Var || <code>Graph_SymbolSizeKey</code> || Global
|-
| Symbol Size || Sys Var || <code>symbolSize</code> || Global || For fixed symbol size 
|-
| Min Symbol Size || Sys Var || <code>Graph_minSymbolSize</code> || Global || For variable symbol size 
|-
| Max Symbol Size || Sys Var || <code>Graph_maxSymbolSize</code> || Global || For variable symbol size
|-
!colspan="5" align="left" | Axis Ranges:
|-
| Dimension range settings<br>(for Index values) || Attribute || <code>Att_graphIndexRange</code> 
| Dimension
| For case when Va1 has self-index,<br>used for the self-index.<br>
ver, cat,auto, includezero, log, reverse, incs, min, max<br>
where:<br>
&nbsp;ver : Must be 1 (version)<br>
&nbsp;cat : Categorical flag (1=force categorical interp), opt.<br>
&nbsp;auto : Full autoscale flag <br>
&nbsp;includezero : force 0 to be in range flag <br>
&nbsp;log : log scaling flag<br>
&nbsp;reverse : reverse order flag<br>
&nbsp;incs : Number of increments<br>
&nbsp;min : minimum value for manually scaled axis<br>
&nbsp;max : maximum value for manually scaled axis<br>
|-
| Dimension range settings<br>(for non-index values) || Attribute || <code>Att_graphValueRange</code>
| Dimension
| For case when va1 has self-index,<br>used for the value.<br>Same format as Att_graphIndexRange
|-
| Use Categorical || Attribute || <code>Att_forceCategorical</code> || View
| Forces categorical X-axis. 
|-
!colspan="5" align="left" | Style Settings:
|- 
| Frame Style || Sys Var 
| Frame<br>
0 = None<br>
1 = Bottom Left<br>
2 = All solid<br>
3 = All dashed 
| Global
|-
| Frame Color || Sys var || <code>Graph_frameColor</code> || Global
|-
| Grid Style || Sys Var 
|Grid<br>
0 = None<br>
1 = Dots<br>
2 = Pluses<br>
3 = Lines<br>
4 = Dots
| Global ||
|-
| Grid Color || Sys Var || <code>Graph_gridColor</code> || Global ||
|-
| Tick locations || Sys Var || <code>Ticks</code> || Global ||
|-
| Tick direction || Sys Var || <code>Graph_tickDir</code> || Global || 0=outward, 1=inward, 2=both.
|-
| Key Position || Sys Var 
| ShowKey<br>
0 = None<br>
1 = Bottom<br>
2 = Right<br>
3 = Left
| Global ||
|-
| Outline key flag || Sys Var || <code>Graph_OutlineKey</code> || Global ||
|-
!colspan="5" align="left" | Font:
|-
| Axis title font || Sys Var || <code>Graph_axisTitleFont</code> || Global
|-
| Axis title color || Sys Var || <code>Graph_axisTitleColor</code> || Global
|-
| Axis label font || Sys Var || <code>Graph_axisLabelFont</code> || Global 
|-
| Axis label color || Sys Var || <code>Graph_axisLabelColor</code> || Global 
|-
| Key title font || Sys Var || <code>Graph_keyTitleFont</code> || Global 
|-
| Key title color || Sys Var || <code>Graph_keyTextColor</code> || Global
|-
| Key label font || Sys Var || <code>Graph_keyFont</code> || Global
|-
| Key label color || Sys Var || <code>Graph_keyLabelColor</code> || Global
|-
| Vertical Label Rotation || Sys Var || <code>Graph_VLabelRotation</code> || Global
|-
| Horizontal Label Rotation || Sys Var || <code>Graph_HLabelRotation</code> || Global
|-
!colspan="5" align="left" | Patterns:
|-
| Page fill || Sys Var || <code>Graph_PageBrush</code> || Global
|-
| Plot Area Fill || Sys Var || <code>Graph_plotAreaBrush</code> || Global
|-
| Key Area Fill || Sys Var || <code>Graph_keyAreaBrush</code> || Global 
|-
!colspan="5" align="left" | Key Sequences:
|-
| Symbol sequence || Sys Var || [[Graph_SymbolSeq]] || Global || Order of symbols used in keys
|-
| Color sequence || Sys Var || [[Graph_ColorSeq]] || Global || List of colors used for curves
|-
| Line-dash sequence<br>(not implemented) || Sys Var || <code>Graph_LineDashSeq</code> || Global || 
|-
| Fill-effects sequence<br>(not implemented) || Sys Var || <code>Graph_FillEffectsSeq</code> || Global ||
|-
!colspan="5" align="left" | Excel Graph:
|-
| External graphing engine (Excel Chart) || Sys var || <code>GraphTool</code> || Global || Disabled for now.
|-
!colspan="5" align="left" | Role/Pivot state:
|-
| X-Axis role || Attribute || <code>Att_xRole</code> || Global
|-
| Y-Axis role || Attribute || <code>Att_yRole</code> || Global
|-
| Color role || Attribute || <code>Att_colorRole</code> || Global
|-
| Symbol shape role || Attribute || <code>Att_symbolRole</code> || Global
|-
| Symbol size role || Attribute || <code>Att_symbolSizeRole</code> || Global
|-
| Origin role || Attribute || <code>Att_originRole</code> || Global 
|- 
| Other free indexes<br>(not implemented) || Attribute || <code>Att_freeIndexes</code> || View
| For scatter only plots.
|-
| Coordinate Index || Attribute || <code>Att_coordinateIndex</code> || Result || Contains identifier of index
|-
| Exogenous Values || Attribute || <code>Att_exogenousValues</code> || Result || List of expressions
|}

The following system variables are used to hold graph settings for special cases:
* <code>Graph_Primary_Valdim</code>
* <code>Graph_Stats_Valdim</code>
* <code>Graph_PDF_Valdim</code>
* <code>Graph_Prob_Valdim</code>
* <code>Graph_CDF_Valdim</code>
* <code>Graph_Cumprob_Valdim</code>

==See Also==
* [[Graph Style Templates]]