summary.proportion.sum.cumulative Function (GPL)

summary.proportion.sum.cumulative(<algebra>, <base function>)

summary.proportion.sum.cumulative(<binning function>, <base function>)

summary.proportion.sum.cumulative(<statistic function>, <base function>)

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

<base function>. A function that specifies the percentage base for summary.proportion.sum.cumulative. This is optional. The default is base.all().

<binning function>. A binning function.

<statistic function>. Another statistic function. The result of the embedded statistic is used to calculate summary.proportion.sum.cumulative.

Description

Calculates the cumulative proportion within each subgroup based on a summed variable compared to the sum across all groups. summary.proportion.cumulative is an alias for this function. summary.proportion.sum.cumulative is similar to summary.percent.sum.cumulative except it reports a value between 0 and 1 instead of 0 and 100.

To obtain cumulative proportions of counts, use the summary.proportion.count.cumulative function. See the topic summary.proportion.count.cumulative Function (GPL) for more information.

Note: If there are multiple ELEMENT statements, you cannot use cumulative statistics for some graphic elements but not for others. This behavior is prohibited because the results of each statistic function would be blended on the same scale. The units for cumulative statistics do not match the units for non-cumulative statistics, so blending these results is impossible.

Examples

Figure 1. Example: Calculating cumulative proportions of a summed variable

ELEMENT: interval(position(summary.proportion.sum.cumulative(jobcat*salary)))

Statistic Functions

See GPL Functions .