DELTA_REL

Overview

Description	Calculates the relative difference between consecutive values within the selected dimension. Use this when you need the relative (percentage) change between consecutive values along any dimension, not just time.
Syntax	`DELTA_REL('Node', ["Dimension", ["FirstValueBehavior"]])`
Parameters	Node: Input node, specified using the node name in single quotes (e.g. `'Profit'`) Dimension (optional): The dimension along which consecutive values are compared. Default: `"Time"` at the node's finest level. FirstValueBehavior (optional): How the first value per unique level combination is handled. Default: `"SKIP_FIRST"`. `"SKIP_FIRST"` - The first level combination per group will not be present in the result. `"FIRST_AS_ZERO"` - The value of the first level combination will be set to zero.
Limitations	The growth will always be calculated on the lowest available level of the specified dimension. If the "former value" is zero, the calculation cannot be performed as a division by zero is not possible. The level combination will therefore not be in the result. The function compares only entries that actually exist in the input. Missing values are skipped. To calculate the growth with filled missing values use YOY_REL The function ensures that the links from the levels of the specified dimension match those in the dimension management. Do not use this function if you want the node to have different level links as the dimensions.

Examples

Default: skipping first values

In contrast to YOY_REL and related relative functions, the growth will be calculated by using the absolute former value as relative base: (currentValue - formerValue) / absolute(formerValue).
This means for example:
The relative growth from -2 to -10 is -400% as (-10 - (-2)) / abs(-2) = (-8 / 2) = -4.

Input node: Input node

Year	Month	Product	Value
2025	2025-11	A	1
2025	2025-11	B	2
2026	2026-04	A	20
2026	2026-05	B	-10

Formula: DELTA_REL('Input node') = DELTA_REL('Input node', "Time", "SKIP_FIRST")

Year	Month	Product	→ DELTA_REL Result
2026	2026-04	A	19 (= (20 - 1) / ABS(1) )
2026	2026-05	B	-6 (= (-10 - 2) / ABS(2) )

First values as zero

With FIRST_AS_ZERO, the first entry per group gets a result of 0 instead of being omitted.

Formula: DELTA_REL('Input node', "Time", "FIRST_AS_ZERO")

Year	Month	Product	→ DELTA_REL Result
2025	2025-11	A	0
2025	2025-11	B	0
2026	2026-04	A	19
2026	2026-05	B	-6

Related Functions

Function	When to use instead
DELTA_ABS	When you need the absolute difference instead of a percentage.
YOY_REL	When you need year-over-year relative change with filled missing values.
QOQ_REL	When you need relative change specifically quarter-over-quarter.