PercentOfTotal

The PercentOfTotal function returns the percent of total for an aggregate formula. This function is shorthand for: aggregate / Subtotal(aggregate, mode, parameters).

Syntax

PercentOfTotal(aggregate, [mode], [parameters])

Function arguments:

  • aggregate (required) - The aggregate formula to use

  • mode (optional) - The mode to use when calculating the aggregate formula. Mode determines which dimension(s) to use when performing the calculation.

    • General purpose modes

      • “grand_total” (default for visualizations and pivot tables) - Calculates the percent of grand total for the aggregate formula.
    • Visualization modes

      • “color” - Calculates the aggregate percent of total using only the column specified for COLOR.

      • “x_axis” - Calculates the aggregate percent of total using only the column(s) placed on the X-AXIS.

      • “trellis_column” / “trellis_row” - Calculates the aggregate percent of total using only the dimension specified for the TRELLIS COLUMN or TRELLIS ROW.

    • Pivot table modes 

      • “column” / “row” - Calculates aggregate percent of total for the column or row total.

      • “column_parent” / “row_parent” - Calculates the aggregate percent of total for the column or row total, relative to the subtotal calculation for the parent dimensions.

    • Table modes

      • “parent_grouping” (default for tables) - Calculates the aggregate formula using the grouping keys from a parent grouping. This is equivalent to creating the aggregate calculation in a parent grouping and referencing it from a column in a lower grouping.
  • parameters (optional) - An additional parameter specific to the mode.

    • Only applicable to the following modes: "column_parent", "row_parent" and "parent_grouping". For these modes, this 3rd parameter specifies how many parent dimensions to ignore.

Examples

PercentOfTotal(Sum([Quantity] * [Price]), "row")
  • The numerator of the percentage is the aggregate formula calculated along rows and columns.
  • The denominator of the percentage is the aggregate formula calculated along the rows.
  • The pivot table subtotals calculate the percent of total at the expected granularity.

PercentOfTotal(Sum([Quantity] * [Price]), "x_axis")
  • The numerator of the percentage is the aggregate formula calculated along the x-axis and color.
  • The denominator of the percentage is the aggregate formula calculated along the x-axis.
  • The calculation is shown in the tooltip, but is usable anywhere an aggregate formula is allowed.


Related resources