Difference between revisions of "Graph Setting Associations"

m (Internal:Graph Setting Associations moved to Graph Setting Associations: Make accessible to beta testers)
(No difference)

Revision as of 02:42, 1 February 2007

Each graph setting has a particular type of association. There are three types of associations. The associations determine how the setting transfers when a graph is pivoted, dimensionality changes, or the view mode changes (e.g., from PDF view to Bands view). The association scheme has been created to allow the default settings to do the right thing in most cases and minimize the need for a user to have to change graph settings every time a simple view or pivot change is enacted. When you Set Default, or define a template, it may be necessary to understand the associations to understand what will be impacted.

Types of Associations

Global Associations

Settings having a global association apply to the graph as a whole. If "Set Default" is used, the setting transfers to all graphs. General appearance characteristics usually fall into this category, such as colors, fonts, effects, etc.

Result Associations

These apply only to the result graph, and do not transfer to other graphs even if "Set Default" is pressed.

Dimension Associations

Range settings are associated with a specific dimension. For example, if you set a manual scaling range for Index I, that range will continue to apply to I, and only to I, as the graph is pivoted. Dimension associations include the manual range settings, and flags for autoscaling, log-scaling, reverse-order, categorical, and include-zero.

When "Set Default" is used, a dimension-association will apply to any graph that uses that particular dimension. If "Apply" is used, the setting will apply onto to that dimension and only within the current result graph.

View Associations

Line style and related chart-type settings have a fairly complex association that depends on the view mode and whether a graph is categorical or continuous.

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 continuouse 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

Descripton Stored as Sys or Att Name Association Type Notes
Graph Template
Graph Template Identifier Attribute Att_graphTemplate Global
Line Style Settings:
Line Style Attribute Att_ContLineStyle & Att_CatLineStyle

0 = dot
1 = line only
4 = symbol only
5 = line & symbol
6 = step
9 = bar

View Att used depends on whether x-axis is cat or continuous
Stacked Bar flag Attribute Att_StackedBar View
Stacked lines flag Attribute Att_stacked_lines View
Area fill flag Attribute Att_AreaFill View
Relative Proportion Flag
(not yet implemented)
Attribute Att_relProportion View
Bar Overlap Percent Attribute Att_barOverlap View In 3.1, was sysVar overlapWidth.
It is an attribute now.
Symmetric Colors flag
(not implemented)
Attribute Att_symmetric_colors Key
Transparency for fills Sys var Graph_fillTransparency Global Scale of 0 to 255
Bar Shape Sys Var Graph_barShape View
3D Effects flag Sys Var Graph_3DEffects Global
Line Thickness Sys Var Graph_LineThickness Global
Use Separate Color / Symbol Keys SysVar Graph_SymbolKey Global
Enable Symbol Size Role Sys Var Graph_SymbolSizeKey Global
Symbol Size Sys Var symbolSize Global For fixed symbol size
Min Symbol Size Sys Var Graph_minSymbolSize Global For variable symbol size
Max Symbol Size Sys Var Graph_maxSymbolSize Global For variable symbol size
Axis Ranges:
Dimension range settings
(for Index values)
Attribute Att_graphIndexRange Dimension For case when Va1 has self-index,
used for the self-index.

ver, cat,auto, includezero, log, reverse, incs, min, max
where:
 ver : Must be 1 (version)
 cat : Categorical flag (1=force categorical interp), opt.
 auto : Full autoscale flag
 includezero : force 0 to be in range flag
 log : log scaling flag
 reverse : reverse order flag
 incs : Number of increments
 min : minimum value for manually scaled axis
 max : maximum value for manually scaled axis

Dimension range settings
(for non-index values)
Attribute Att_graphValueRange Dimension For case when va1 has self-index,
used for the value.
Same format as Att_graphIndexRange
Use Categorical Attribute Att_forceCategorical View Forces categorical X-axis.
Style Settings:
Frame Style Sys Var Frame

0 = None
1 = Bottom Left
2 = All solid
3 = All dashed

Global
Frame Color Sys var Graph_frameColor Global
Grid Style Sys Var Grid

0 = None
1 = Dots
2 = Pluses
3 = Lines
4 = Dots

Global
Grid Color Sys Var Graph_gridColor Global
Tick locations Sys Var Ticks Global
Tick direction Sys Var Graph_tickDir Global 0=outward, 1=inward, 2=both.
Key Position Sys Var ShowKey

0 = None
1 = Bottom
2 = Right
3 = Left

Global
Outline key flag Sys Var Graph_OutlineKey Global
Font:
Axis title font Sys Var Graph_axisTitleFont Global
Axis title color Sys Var Graph_axisTitleColor Global
Axis label font Sys Var Graph_axisLabelFont Global
Axis label color Sys Var Graph_axisLabelColor Global
Key title font Sys Var Graph_keyTitleFont Global
Key title color Sys Var Graph_keyTextColor Global
Key label font Sys Var Graph_keyFont Global
Key label color Sys Var Graph_keyLabelColor Global
Vertical Label Rotation Sys Var Graph_VLabelRotation Global
Horizontal Label Rotation Sys Var Graph_HLabelRotation Global
Patterns:
Page fill Sys Var Graph_PageBrush Global
Plot Area Fill Sys Var Graph_plotAreaBrush Global
Key Area Fill Sys Var Graph_keyAreaBrush Global
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
(not implemented)
Sys Var Graph_LineDashSeq Global
Fill-effects sequence
(not implemented)
Sys Var Graph_FillEffectsSeq Global
Excel Graph:
External graphing engine (Excel Chart) Sys var GraphTool Global Disabled for now.
Role/Pivot state:
X-Axis role Attribute Att_xRole Global
Y-Axis role Attribute Att_yRole Global
Color role Attribute Att_colorRole Global
Symbol shape role Attribute Att_symbolRole Global
Symbol size role Attribute Att_symbolSizeRole Global
Origin role Attribute Att_originRole Global
Other free indexes
(not implemented)
Attribute Att_freeIndexes View For scatter only plots.
Coordinate Index Attribute Att_coordinateIndex Result Contains identifier of index
Exogenous Values Attribute Att_exogenousValues Result List of expressions

The following system variables are used to hold graph settings for special cases:

  • Graph_Primary_Valdim
  • Graph_Stats_Valdim
  • Graph_PDF_Valdim
  • Graph_Prob_Valdim
  • Graph_CDF_Valdim
  • Graph_Cumprob_Valdim
Comments


You are not allowed to post comments.