Table of Contents


This module generates both a heat density and a floor area density map in the form of raster files. The inputs to the module are either a shapefile with required data in its attribute table or a CSV file. The input data should be sufficient for calculating floor area and heat demand densities. For example, X-coordinate and Y-coordinate of the centre of buildings that in case of shapefile, will be automatically calculated; heat demand of buildings or specific heat demand and its floor area. Instead of floor areas, the building footprint and number of floors can be provided.

This module will only be available as a stand-alone module; it will not be integrated into the toolbox.

Inputs and outputs


The module accepts either shapefile or CSV file as input. The following headers are expected in case of any of the input file types (should be available in the attribute table or as the header of the CSV file):

  • hotmaps_ID: provide a unique, integer ID for each feature (polygon)
  • Type: Building type: set to 1 for service sector; other values are considered as residential (optional: can be left empty)
  • Year_Construction: Year of construction (optional: can be left empty)
  • Address: Address of the building (optional: can be left empty)
  • GFA: Gross floor area in m2
  • Footprint: footprint of the building in m2 (required if values for GFA are not provided)
  • NrFloor: number of floors (required if values for GFA are not provided)
  • spec_demand: Specific heat demand of each feature (polygon) in kWh
  • demand: Heat demand of each feature (polygon) in kWh
  • X_3035: The X-Coordinate of the center of the feature (polygon) in EPSG 3035 projection (Mandatory for the CSV file: can be left empty)
  • Y_3035: The Y-Coordinate of the center of the feature (polygon) in EPSG 3035 projection (Mandatory for the CSV file: can be left empty)

Important Note: The headers should be written as stated above. Otherwise, the code will return an error.

To Top


As output, two raster files are generated:

  1. Gross floor area density map with pixel values in m2 per hectare
  2. Heat demand density map with pixel values in MWh per hectare

To Top


To Top

GitHub repository of this calculation module

Here you get the bleeding-edge development for this calculation module.

To Top

How to cite

Mostafa Fallahnejad, in Hotmaps-Wiki, CM-District-heating-potentials (April 2019)

To Top

Authors and reviewers

This page is written by Mostafa Fallahnejad*.

☐ This page was reviewed by Lukas Kranzl*.

* Energy Economics Group - TU Wien

Institute of Energy Systems and Electrical Drives

Gusshausstrasse 27-29/370

1040 Wien

To Top


Copyright © 2016-2019: Mostafa Fallahnejad

Creative Commons Attribution 4.0 International License

This work is licensed under a Creative Commons CC BY 4.0 International License.

SPDX-License-Identifier: CC-BY-4.0


To Top


We would like to convey our deepest appreciation to the Horizon 2020 Hotmaps Project (Grant Agreement number 723677), which provided the funding to carry out the present investigation.

To Top

View in another language:


* machine translated