HUES data specification

From HUES Platform Wiki


This specification provides a standard way to specify data related to urban energy systems. The four categories of data are technologies, time-resolved (time series), geographic entities (nodes) and interconnections between them (networks), together with the specification of default units.


This page describes the HUES data specification (HUESdata_v1.0), which is intended to facilitate the sharing of input and output data between models on the HUES platform.

The formats are intentionally very broad, to allow many different types of data to be exchanged. The purpose is not to fix formats precisely in order to allow full automation. Rather, the specification is intended to align different datasets into a common format where convenient, making it easier for users to exchange data when necessary.

The formats can contain input or output data (or a combination), allowing flexibility in terms of which properties are specified and which are calculated. For example, network topology could be an input (pre-defined as part of the case) or an output (optimised by the model). The data may be separated for convenience into input files and output files, but because the formats are common these can be easily merged or recombined.

The purpose of the specification is not to rigorously define all required inputs for a given model, but instead to give a convenient, automatable way of exchanging the bulk data that underpins a given case.

Other modelling parameters will be required which are more free-form or descriptive. These should be placed in a text file that accompanies each case. This will not be machine-readable, but will guide the user in setting up a model.

Specification pages

See the pages below for a detailed description of the HUES data specification for different types of data.

Technology data:

Case study data: