> ## 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.

# Dimensions and hierarchies

> Reference for the common, simulation, and optional dimensions and their hierarchies shared across all Atoti Enterprise Risk Suite solution cubes.

Common dimensions are shared across all Atoti Enterprise Risk Suite solutions. Each solution builds its own cube on top of these shared dimensions, which provide a consistent analytical structure for trade, counterparty, book, and simulation data. Understanding these dimensions is a prerequisite before reading the dimensions reference for any specific solution.

Dimensions fall into three categories:

* **Common** dimensions are present in every solution cube.
* **Common (simulation)** dimensions drive cube members that are computed at query time, not stored as data.
* **Common (optional)** dimensions are provided by the common layer as reusable building blocks. Each solution decides whether to include them and whether to expose a feature flag for toggling them.

Optional dimensions are marked with an asterisk (\*).

## Dimension reference

| Dimension | Hierarchy | Levels | Category | Description |
| - | - | - | - | - |
| AsOfDate | AsOfDate | AsOfDate | Common | Date of the risk calculation |
| Trade Attributes | Trade Attributes | TradeId, Trader, Sales, TradeDate, TradeMaturityDate | Common | Trade identification and attributes |
| Instrument Attributes | Instrument Attributes | InstrumentId (and additional solution-specific levels) | Common | Instrument reference data |
| Display Currency | Display Currency | DisplayCurrency | Common (simulation) | Currency used to display converted values |
| Confidence Levels | Confidence Levels | ConfidenceLevel | Common (simulation) | Confidence level percentage (e.g. 95.0, 99.0) |
| Scenarios | Scenarios | Scenario | Common (simulation) | Individual scenario names from the P\&L vector |
| Books\* | Book | Configurable depth (default 4 levels) | Common (optional) | Book hierarchy for aggregation |
| Organization\* | Organization | Configurable depth (default 4 levels) | Common (optional) | Organizational hierarchy for aggregation |
| Counterparties\* | Counterparty ID; Counterparty Name; Rating; Sector; Country of Address; Country of Risk; Counterparty Structure | Counterparty ID; Counterparty Name; Rating; Sector; Country of Address; Country of Risk; the structure levels | Common (optional) | Counterparty details and risk attributes |

## Simulation dimensions

Simulation dimensions drive cube members that are not stored as data but are computed on the fly. All solution cubes include the following simulation dimensions.

**Display Currency** provides a set of predefined currencies. Selecting a member converts all monetary values to that currency using the loaded FX rates.

**Confidence Levels** defines the quantile percentages at which measures such as VaR and ES are computed. The active confidence level member is read at query time by risk measures that depend on it.

**Scenarios** expands the aggregated P\&L vector into individual rows, one per scenario. This allows drill-through to individual scenario P\&L values.

## Optional dimensions

The common layer provides the following dimensions as reusable building blocks. Each solution decides independently whether to include them and, if so, whether to expose a feature flag that lets users enable or disable them. The documentation for each solution provides details.

The **Book** dimension represents an internal book hierarchy. Its depth is configurable. The default depth is four levels.

```
Book (default 4 levels)
├── Level 1: Group          (e.g. ActiveBank Group)
│   ├── Level 2: Region     (e.g. ActiveBank International)
│   │   ├── Level 3: Area   (e.g. ActiveBank EMEA)
│   │   │   └── Level 4: Unit (e.g. ActiveBank EU)
```

The **Organization** dimension represents an internal reporting hierarchy. Its depth is configurable. The default depth is four levels.

```
Organization (default 4 levels)
├── Level 1: Group          (e.g. ActiveBank Group)
│   ├── Level 2: Region     (e.g. ActiveBank International)
│   │   ├── Level 3: Area   (e.g. ActiveBank EMEA)
│   │   │   └── Level 4: Unit (e.g. ActiveBank EU)
```

The **Counterparty** dimension groups trades by their external counterparty. Each counterparty attribute is its own single-level hierarchy, supporting regulatory and risk reporting use cases:

```
Counterparty
├── Counterparty ID
├── Counterparty Name
├── Rating            (e.g. AAA, A, B)
├── Sector            (e.g. Financials, Consumer Staples)
├── Country of Address  (e.g. GBR, JPN)
└── Country of Risk     (e.g. GBR, JPN)
```

Counterparties that own one another are additionally arranged into a **Counterparty Structure** hierarchy, built from each counterparty's parent. Its depth is configurable.

Its members are the counterparty identifiers. Where those identifiers are not meaningful to read, such as opaque keys, the hierarchy can display counterparty names instead, through [`structure-display`](./configuration-properties#counterparty-structure-display). That setting changes the caption alone: the members keep their identifiers, so saved coordinates survive it being switched either way.

## Related pages

* [Configuration properties](./configuration-properties)
* [Input file formats](./input-file-formats)