Calibrating the model

To get a good starting point the model needs to be calibrated. The starting point is either energy use per energy product in a given year from temperature corrected statistics or a constructed year based on statistics.

How to calibrate

Calibrating the model is done by changing up to three files.

Kalibreringsark.xlsx
energy_need_behaviour_factor.csv
heating_system_efficiencies.csv

“Kalibreringsark.xlsx” can modify the heating system share where the given factor changes a percentage of one heating system for another. This excel file also makes it quick to see what the result of the calibration changes will be as the model directly modifies the cells while having the excel file open.

“energy_need_behaviour_factor.csv” contains a column called “behaviour_factor”. The factor modifies the corresponding energy purpose in kWh/m² as given by a specific building code and building category. The start year and end year can be specified, in addition to the mathematical function.

The table below shows how the csv file is formatted. When “default” is input all valid possibilites are affected.

Energy need behaviour factor.
building_category	building_code	purpose	behaviour_factor	start_year	end_year
residential	default	default	1.0	2020	2050
house	PRE_TEK49+TEK69 + TEK87+TEK49+TEK97	default	0.85
house	TEK07+TEK10+TEK17	lighting	0.85	2020	2050
non_residential	default	default	1.15
retail	default	electrical_equipment	2.0

It is also possible to modify the factors given in “heating_system_efficiencies.csv” to fine tune the coverage of various heating technologies and their efficiencies.

Assumptions

The calibration is based on the Norwegian energy balance published by Statistics Norway. The energy balance contains yearly consumption statistics per energy product on households and private and public services, including military. Heat production from heat pumps is calibrated on the basis of heat pump sale statistics from the Norwegian Heat Pump Assosciation.

How to run ebm calibration

Make sure the Excel spreadsheet🧾 Kalibreringsark.xlsx is open.

You can run the calibration in two ways:

ebm-calibrate --calibration-year=2024

python -m ebm.cmd.calibrate_excel_com_io --calibration-year=2024

Command line options

 ebm-calibrate --help

usage: ebm-calibrate.exe [-h] [--debug] [--version] [--calibration-year [CALIBRATION_YEAR]]

options:
  -h, --help            show help message and exit
  --debug               Run in debug mode. (Extra information written to stdout)
  --version, -v         show the ebm version number and exit
  --calibration-year [CALIBRATION_YEAR], --ebm-calibration-year [CALIBRATION_YEAR]

Environment variables

Any environment variables will override the default values. Optionally, environment variables can be read from the file 🧾 .env if present in the current working directory.

environment variables supported by ebm-calibrate
name	explanation	default
EBM_CALIBRATION_YEAR	The year used as reference for the calibration	2024
EBM_CALIBRATION_YEAR_CELL	Cell used for writing the calibration year header	`C63`

Note

Command-line options take precedence over environment variables.

Last Updated on 2025-11-25

Version: 1.0.3.