> ## Documentation Index
> Fetch the complete documentation index at: https://docs.activeviam.com/llms.txt
> Use this file to discover all available pages before exploring further.

# PropagateAboveReference (experimental)

|                 |                                                                                   |
| --------------- | --------------------------------------------------------------------------------- |
| **Description** | Display aggregated values above the Reference Level choice for specific measures. |
| **Variations**  | [pro\_rata](./pro_rata)                                                           |

**EXPERIMENTAL(!)**

This context value enables the [**SBM Risk Charge Pro-Rata**](./sbm-risk-charge) and the [**Portfolio Risk Charge Pro-Rata**](./portfolio-risk-charge) measures to return aggregated
values above the Reference Level set by the **ReferenceLevel** context value.

This is an **experimental** feature, as the aggregated values are only meaningful for certain choices of the **ReferenceLevel** and **ProRataHierarchy** context values.

By default, the feature is disabled and **PropagateAboveReference (Experimental)** is set to false, in which case the values above the Reference Level are null.
When the context value is set to true, the values above the Reference Level are the sum of the values at the Reference Level.

Consider this example:

<Frame>
  <img src="https://mintcdn.com/activeviam/3WM26kEPUrEWlXvw/solutions/frtb/6.0/images/propagateAboveReference.png?fit=max&auto=format&n=3WM26kEPUrEWlXvw&q=85&s=9646a04a0ed0a32d033d049bf0c07f6e" alt="PropagateAboveReference Example" width="2418" height="726" data-path="solutions/frtb/6.0/images/propagateAboveReference.png" />
</Frame>

* The [Risk Classes](./risk-classes) hierarchy is on the columns and selected as the **ReferenceLevel** context value.
* The [BookHierarchy](./bookhierarchy) hierarchy is on the rows and selected as the **ProRataHierarchy** context value.
* The [SBM Risk Charge Pro-Rata](./sbm-risk-charge) measure is on the columns.
* The [Correlaion Scenario](./correlation-scenario) = "high" filter is added to the widget to ensure all numbers displayed corredpond
  to the same correlation scenario.

Result:

* The first columns displays the new aggregated values of the [SBM Risk Charge Pro-Rata](./sbm-risk-charge) measure at the "Total" level, corresponding to all Risk Classes.
* All other columns, corresponding to a specific Risk Class are unaffected by the context value.
* The Total column shows the sum of all other columns at every row.