The requested page is not available for the requested platform. You are viewing the content for Default platform.

Creating Window Calculations

  • 6 min to read

The Dashboard Designer allows you to add a window calculation for numeric measures. To do this, invoke the data item menu and select the required calculation type.

Measure_CalculationMenu

The image above shows a calculation menu of the Pivot dashboard item. The following items are available.

  • Percent of Column Grand Total - Calculates a contribution of individual measure values to a column grand total.
  • Percent of Row Grand Total - Calculates a contribution of individual measure values to a row grand total.
  • Percent of Grand Total - Calculates a contribution of individual measure values to a grand total.
  • Running Summary along Columns - Calculates a cumulative total for measure values along columns (horizontally).
  • Running Summary along Rows - Calculates a cumulative total for measure values along rows (vertically).
  • Difference along Columns - Calculates differences between measure values along columns (horizontally).
  • Difference along Rows - Calculates differences between measure values along rows (vertically).
  • Percentage Difference along Columns - Calculates percent differences between measure values along columns (horizontally).
  • Percentage Difference along Rows - Calculates percent differences between measure values along rows (vertically).
  • Rank along Columns - Ranks measure values along columns (horizontally).
  • Rank along Rows - Ranks measure values along rows (vertically).
  • Rank along Cells - Ranks measure values along cells (throughout the entire pivot table).
  • Custom... - Allows you to create a custom calculation by specifying various settings. Clicking this item invokes the Customize Calculation dialog that allows you to add additional customizations to calculations.

    CustomizeCalculationDialog_None

    To learn more, see descriptions of the available calculations below.

Note

Note that the list of available items in this menu can be changed by the Dashboard Designer dynamically. For instance, if the Pivot dashboard item does not contain dimensions in the Rows section, menu items related to rows will be disabled.

Running Total

The Running Total calculation can be used to compute a cumulative total for the specified measure across a window. For example, the Grid below displays cumulative sales across all quarters.

CreatingCalculations_ExampleRunningTotal

The Customize Calculation dialog provides the following settings for the Running Total calculation.

CustomizeCalculationDialog_RunningTotal

  • Running along - Specifies a window and direction used to calculate running totals.
  • Summary function - Specifies a summary function used to apply calculation. To learn more about the available summary functions, see Summary Function Types in the summary function topic.

Moving Calculation

The Moving calculation uses neighboring values to calculate a total. For example, the Grid below shows a moving average across all quarters.

CreatingCalculations_ExampleMovingCalculation

The Customize Calculation dialog provides the following settings for the Moving calculation.

CustomizeCalculationDialog_MovingCalculation

  • Moving along - Specifies a window and direction used to apply a calculation.
  • Summary function - Specifies a summary function used to apply a calculation. To learn more about the available summary functions, see Summary Function Types in the summary function topic.
  • Start offset / End offset - Specify start/end offsets from the currently processed value. For instance, if you specified offsets as 1/1, the previous and next values will be used along with the current value to apply the Moving calculation.

Difference

The Difference calculation can be used to compute the difference between measure values across a window. For example, the Grid below shows absolute differences between quarterly sales.

CreatingCalculations_ExampleDifference

The Customize Calculation dialog provides the following settings for the Difference calculation.

CustomizeCalculationDialog_Difference

  • Calculate along - Specifies a window and direction used to calculate differences.
  • Difference from - Specifies the value used to calculate the difference. The following values are available: Previous, Next, First and Last.

    You can also use the Percentage Difference option to specify whether the absolute or percentage difference is displayed.

Percent of Total

A calculation is used to compute a percentage of the total for the specified measure across a window. For example, the Grid below shows a contribution of individual quarterly sales to total sales.

CreatingCalculations_ExamplePercentOfTotal

The Customize Calculation dialog provides the following settings for the Percent of Total calculation.

CustomizeCalculationDialog_PercentOfTotal

Rank

Use the Rank calculation to compute rankings for the specified measure across a window. For example, the Grid below shows a ranking of sales for individual quarters.

CreatingCalculations_ExampleRank

The Customize Calculation dialog provides the following settings for the Rank calculation.

CustomizeCalculationDialog_Rank

  • Rank along - Specifies a window and direction used to rank values.
  • Rank type - Specifies the type of ranking. The following rank types are available: Unique, Competition, Dense, Modified and Percentile.
  • Order - Specifies the order of ranking. You can select Ascending or Descending.

Expression

Use Expression to specify a custom calculation by adding the required calculation functions inside the measure expression.

CustomizeCalculationDialog_Expression

Click the Edit in Expression Editor button to invoke the Expression Editor and specify the required expression.

CustomizeCalculation_ExpressionDialog

The Expression type provides the Calculate along option that specifies a window and direction used to calculate differences. Note that this option is in effect if the expression contains a calculation function.

Creating Calculations in Code

To apply a calculation to values of the required measure, perform the following steps.

The code snippet adds a new measure to the Pivot dashboard item and specifies a window calculation to compute the difference between measure values across a window. The calculation is performed along columns of the Pivot dashboard item.

using DevExpress.DashboardCommon;
using DevExpress.DashboardWin;
// ...
PivotDashboardItem pivotItem = dashboardViewer1.Dashboard.Items[pivotItemName] as PivotDashboardItem;
if (pivotItem != null)
{
    Measure extendedPrice = new Measure("Extended Price")
    {
        Name = "Diff",
        ShowGrandTotals = false
    };
    PivotWindowDefinition pivotWindowDefinition = new PivotWindowDefinition();
    pivotWindowDefinition.DefinitionMode = PivotWindowDefinitionMode.Columns;
    extendedPrice.WindowDefinition = pivotWindowDefinition;
    extendedPrice.Calculation = new DifferenceCalculation() { DifferenceType = DifferenceType.Absolute };
    pivotItem.Values.Add(extendedPrice);
}