rect Coordinate Type (GPL)

Syntax

rect(dim(<numeric>), <function>, <coord>)

<numeric>. One or more numeric values (separated by commas) indicating the graph dimension or dimensions to which the rectangular coordinate system applies. The number of values equals the number of dimensions for the coordinate system's frame, and the values are always in sequential order (for example, dim(1,2,3) and dim(4,5)). See the topic dim Function (GPL) for more information.

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

<coord>. A valid coordinate type or transformation function. This is optional.

Description

Creates a rectangular coordinate system. By default, a rectangular coordinate system is 2-D, which is the equivalent of specifying rect(dim(1,2)). To create a 3-D coordinate system, use rect(dim(1,2,3)). Similarly, use rect(dim(1)) to specify a 1-D coordinate system. Changing the coordinate system also changes which variable in the algebra is summarized for a statistic. The statistic function is calculated on the second crossed variable in a 2-D coordinate system and the third crossed variable in a 3-D coordinate system.

Examples

Figure 1. Example: 2-D bar chart

COORD: rect(dim(1,2))
ELEMENT: interval(position(summary.mean(jobcat*salary)))

Figure 2. Example: 3-D bar chart

COORD: rect(dim(1,2,3))
ELEMENT: interval(position(summary.mean(jobcat*gender*salary)))