KPI Catalog

1. Overview

KPI IDs correspond to output group names produced by building models and optional IAQ modules. The StatsEngine catalog is built at runtime from the facts store, so the exact list depends on the active FMU outputs. This page documents the KPI IDs that are explicitly emitted by the KUB core.

Units are taken from FMU metadata when available. When a unit is missing, KUB applies a fallback mapping:

  • temperature → degC

  • PMV → 1

  • PPD → %

  • qflow / energy → W

  • *_m3s → m3/s

  • *_kg_per_m3 → kg_per_m3

  • solarShadingCoefficients → 1

2. Thermal and Comfort

KPI ID Description Unit Notes

temperature_exterior

Outdoor air temperature at building level.

K (FMU), fallback degC

Values in current datasets are typically in Kelvin.

temperature_interior

Indoor air temperature at building level.

K (FMU), fallback degC

-

temperature_ambiance

Indoor ambient temperature at building level.

K (FMU), fallback degC

-

PMV

Predicted Mean Vote (thermal comfort).

1

Dimensionless.

PPD

Predicted Percentage Dissatisfied.

%

0-100.

3. Energy and Heat Flows

KPI ID Description Unit Notes

QFlowHeating

Heating heat flow.

W

Power-like, can be integrated to kWh.

QFlowCooling

Cooling heat flow.

W

Power-like, can be integrated to kWh.

Qflow_exterior

Exterior heat flow.

W

Name is case-sensitive and comes from FMU outputs.

finalEnergy

Final energy demand.

W

Power-like, can be integrated to kWh.

usefullEnergy

Useful energy demand.

W

Spelling matches FMU output name.

4. Solar Shading

KPI ID Description Unit Notes

solarShadingCoefficients

Mean solar shading coefficient across building elements.

1

Typically in [0, 1].

5. Indoor Air Quality (IAQ) - Flows

KPI ID Description Unit Notes

iaq_ventilation_m3s

Total ventilation airflow.

m3/s

Requires IAQ model.

iaq_infiltration_m3s

Total infiltration airflow.

m3/s

Requires IAQ model.

iaq_recirculation_m3s

Total recirculation airflow.

m3/s

Requires IAQ model.

iaq_exfiltration_m3s

Total exfiltration airflow.

m3/s

Requires IAQ model.

6. Indoor Air Quality (IAQ) - Species

KPI ID Description Unit Notes

iaq_<SPECIES>_kg_per_m3

Mean concentration per species across zones.

kg_per_m3

Species: CO2, NO2, NO, NOx, PM2_5, PM10, CO, O3, SO2, NH3. Present only when the IAQ model tracks the species.

7. Notes

  • KPI IDs are case-sensitive.

  • Additional KPIs can be introduced by FMU output groups or via kpi_catalog.yaml once provided.