bin.dot Function (GPL)

Syntax

bin.dot.<position>(<algebra>, dim(<numeric>), <function>)

or 

bin.dot.<position>(<binning function>, dim(<numeric>), <function>)

or 

bin.dot.<position>(<statistic function>, dim(<numeric>), <function>)

<position>. The position at which a graphic element representing the bins is drawn. center is the graphical middle of the bin and makes it less likely that the graphic elements will overlap. centroid positions the graphic element at the centroid location of the values it represents. The coordinates of the centroid are the weighted means for each dimension. Specifying the position is optional. If none is specified, center is used.

<algebra>. Graph algebra, such as x*y. Refer to Brief Overview of GPL Algebra for an introduction to graph algebra.

<numeric>. One or more numeric values (separated by commas) indicating the graph dimension or dimensions in which to bin the data. Using dim() is optional. Specifying the dimensions is necessary only when you want to bin a specific non-default dimension or multiple dimensions, for example when binning a 2-D scatterplot. See the topic dim Function (GPL) for more information.

<function>. One or more valid functions. These are optional.

<binning function>. A binning function.

<statistic function>. A statistic function.

Description

Creates irregularly spaced bins of graphic elements that have nearly identical values. When data are sparse, bin.dot centers the bins on the data. This function is typically used to create a dot plot.

Examples

Figure 1. Example: Creating a 1-D dot plot
ELEMENT: point.stack.asymmetric(position(bin.dot(salary)))

Statistic Functions

See GPL Functions .