Scatter Graph

Vvidget Code > Dictionary > Scatter Graph

This section explains how to form a dictionary for scatter graphs such as these:

Single Color	Differentiated Colors (no fill_color key)

A scatter graph is defined by an unordered sequence of x y pairs (points) where each point is shown by another graphic, such as a dot. If the scatter graphic has a stroke associated with it then the stroke attribute is defined as rays to each point from the average, median or zero point, or also simply connected segments from each point. As there is no value order (the sequence is unordered) the connected segments can be random in appearance or in the case where the points are ordered the segments appear as a trajectory.

The scatter graph graphic can be embellished by other graphical attributes to give it the appearance of a different chart type, but irrespective of that all the chart type deviations count as only one chart type.

An example code fragment illustration follows:


/* Start of Illustration Code Fragment */



[constructor VC_append_key:"chart_type" string_value:@"scatter"];

[constructor VC_append_key:"chart_subtype" string_value:@"linear"];

[constructor VC_append_key:"chart_format_type" string_value:@"default"];

[constructor VC_append_key:"title" string_value:@"My Title"];

[constructor VC_append_key:"x_title" string_value:@"My X Title"];

[constructor VC_append_key:"y_title" string_value:@"My Y Title"];

[constructor VC_append_key:"data_1" string_value:@"20.0 2 40.0 3 35.4 4 66.2 5 77.3"];

[constructor VC_append_key:"fill_color" string_value:@"000000"];



/* End of Illustration Code Fragment */

The code fragment above can be inserted into the illustration code section of the Illustration project for an immediate running Cocoa application. For additional information consult the Illustration section.

The following table defines the dictionary key and value pairs:

Chart Specific Entries
Key	Value Description
chart_type¹	The chart type is the string scatter, indicating a scatter graph.
chart_subtype¹	One of the strings {linear , semilog, x-log y-linear, log-log, 2y-linear, polar, r-log} which specifies the graph coordinate type of {X-Linear, Y-Linear}, {X-Linear, Y-Log}, {X-Log, Y-Linear}, {X-Log, Y-Log}, {X-Linear, Y1-Linear, Y2-Linear}, {R-Linear, Theta-Degrees}, {R-Log, Theta-Degrees} respectively.
chart_format_type¹	One of the strings {default, alternate}.
title	The main title of the graph. If this key is not present then the template's title is used.
x_title	The x title of the graph. If this key is not present then the template's x-title is used.
y_title	The y title of the graph. If this key is not present then the template's y-title is used.
data_I	A white space delimited list of values representing the x and y values of points in a sequence for curve index I where I starts at 1. See Data Oriented keys for additional information and keys.
label_I	A string for the I-th x-label value. I starts at 1. NOTE: If any label key is present then the data x-values are assumed unitless and an arbitrary unit must be assigned. The x-axis minimum starts at zero and runs to (N-1), where N is the maximum label index. To place a data point at each label x-value the data x-values should be the sequence {0, 1, 2, ..., (N-1)} but you may also choose to skip locations where a label is, etc.
fill_color	A hex encoded representation of a RGBA color value for the marker fill color. If this key is not present then the color table template is used.
templates	A custom Templates directory.

¹ Do not include this key value pair in the Interface Builder Plugin Inspector input string. It is included for you automatically.

If you incorporate this functionality into your own application then please consult Cocoa Programming. If you incorporate this functionality into CLI scripts then please consult Script Programming.

You can also modify the following Templates:

Template Document Names
Template	Description
PVST_Scatter_Graph	Forms the static attributes for the X-Linear, Y-Linear graph.
PVST_X_Log_Scatter_Graph	Forms the static attributes for the X-Log, Y-Linear graph.
PVST_Y_Log_Scatter_Graph	Forms the static attributes for the X-Linear, Y-Log graph.
PVST_XY_Log_Scatter_Graph	Forms the static attributes for the X-Log, Y-Log graph.
PVST_2Y_Scatter_Graph	Forms the static attributes for a two y-axis graph. The y-axis can be of any type (linear, log, etc.) that can be made in a template.
PVST_Polar_Scatter_Graph	Forms the static attributes for a polar graph.
PVST_R_Log_Scatter_Graph	Forms the static attributes for a log-polar graph (r-log).
PVST_scatter_color_table	Forms the fill colors for odd format type indices.
PVST_scatter_color_table_1	Forms the fill colors for even format type indices.

The following are vvidget name components in the template that can be used to adjust graphical attributes of the respective parts.

Vvidget Names
Name	Description
PVS_graph	The graph. All graphical attributes of the graph can be altered. When queried upon the graph limits will autoscale.
PVS_graphic_prototype	The optional curve prototype (a Function graphic). All graphical attributes of the curve prototype can be altered and will be used to generate the curves for the graph. When queried upon the curve's data will be updated. This graphic prototype must reside on the graph's (foreground) data layer.
PVS_y1_graphic_prototype	If present, used for left-axis related graphics instead of PVS_graphic_prototype. This is only applicable to 2-y-axis graphs.
PVS_y2_graphic_prototype	If present, used for right-axis related graphics instead of PVS_graphic_prototype. This is only applicable to 2-y-axis graphs.

Please help improve this documentation. If a section is hard to understand, there is a typo, you would like a new section added, or you detect any other improvement that can be made then please email support@vvi.com with your information.

© Copyright 1993-2011 by VVimaging, Inc. (VVI); All Rights Reserved. Please email support@vvi.com with any comments you have concerning this documentation. See Legal for trademark and legal information.