
# Dataset Card for Electricity Load Diagrams

## Table of Contents
- [Table of Contents](#table-of-contents)
- [Dataset Description](#dataset-description)
  - [Dataset Summary](#dataset-summary)
  - [Supported Tasks and Leaderboards](#supported-tasks-and-leaderboards)
  - [Languages](#languages)
- [Dataset Structure](#dataset-structure)
  - [Data Instances](#data-instances)
  - [Data Fields](#data-fields)
  - [Data Splits](#data-splits)
- [Dataset Creation](#dataset-creation)
  - [Curation Rationale](#curation-rationale)
  - [Source Data](#source-data)
  - [Annotations](#annotations)
  - [Personal and Sensitive Information](#personal-and-sensitive-information)
- [Considerations for Using the Data](#considerations-for-using-the-data)
  - [Social Impact of Dataset](#social-impact-of-dataset)
  - [Discussion of Biases](#discussion-of-biases)
  - [Other Known Limitations](#other-known-limitations)
- [Additional Information](#additional-information)
  - [Dataset Curators](#dataset-curators)
  - [Licensing Information](#licensing-information)
  - [Citation Information](#citation-information)
  - [Contributions](#contributions)

## Dataset Description

- **Homepage:** [Electricity Load Diagrams 2011-2014](https://archive.ics.uci.edu/ml/datasets/ElectricityLoadDiagrams20112014)
- **Paper:** [Modeling Long- and Short-Term Temporal Patterns with Deep Neural Networks
](https://dl.acm.org/doi/10.1145/3209978.3210006)
- **Point of Contact:** [Artur Trindade](mailto:artur.trindade@elergone.pt)

### Dataset Summary

This dataset contains hourly kW electricity consumption time series of 370 Portuguese clients from 2011 to 2014.

### Dataset Usage

The dataset has the following configuration parameters:

- `freq` is the time series frequency at which we resample (default: `"1H"`)
- `prediction_length` is the forecast horizon for this task which is used to make the validation and test splits (default: `24`)
- `rolling_evaluations` is the number of rolling window time series in the test split for evaluation purposes (default: `7`)

For example, you can specify your own configuration different from those used in the papers as follows:

```python
load_dataset("electricity_load_diagrams", "uci", rolling_evaluations=10)
```

> Notes:
> - Data set has no missing values.
> - Values are in kW of each 15 min rescaled to hourly. To convert values in kWh values must be divided by 4.
> - All time labels report to Portuguese hour, however all days present 96 measures (24*4). 
> - Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points. 
> - Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours.

### Supported Tasks and Leaderboards

- `univariate-time-series-forecasting`: The time series forecasting tasks involves learning the future `target` values of time series in a dataset for the `prediction_length` time steps. The results of the forecasts can then be validated via the ground truth in the `validation` split and tested via the `test` split.

### Languages

## Dataset Structure

Data set has no missing values. The raw values are in kW of each 15 min interval and are resampled to hourly frequency. 
Each time series represent one client. Some clients were created after 2011. In these cases consumption were considered zero. All time labels report to Portuguese hour, however all days contain 96 measurements (24*4). Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points. Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours.

### Data Instances

A sample from the training set is provided below:

```
{
  'start': datetime.datetime(2012, 1, 1, 0, 0),
  'target': [14.0, 18.0, 21.0, 20.0, 22.0, 20.0, 20.0, 20.0, 13.0, 11.0], # <= this target array is a concatenated sample
  'feat_static_cat': [0], 
  'item_id': '0'
}
```

We have two configurations `uci` and `lstnet`, which are specified as follows. 

The time series are resampled to hourly frequency. We test on 7 rolling windows of prediction length of 24. 

The `uci` validation therefore ends 24*7 time steps before the end of each time series. The training split ends 24 time steps before the end of the validation split. 

For the `lsnet` configuration we split the training window so that it is 0.6-th of the full time series and the validation is  0.8-th of the full time series and the last 0.2-th length time windows is used as the test set of 7 rolling windows of the 24 time steps each. Finally, as in the LSTNet paper, we only consider time series that are active in the year 2012--2014, which leaves us with 320 time series.

### Data Fields

For this univariate regular time series we have:

- `start`: a `datetime` of the first entry of each time series in the dataset
- `target`: an `array[float32]` of the actual target values
- `feat_static_cat`: an `array[uint64]` which contains a categorical identifier of each time series in the dataset
- `item_id`: a string identifier of each time series in a dataset for reference

Given the `freq` and the `start` datetime, we can assign a datetime to each entry in the target array.

### Data Splits

|   name   |train|unsupervised|test |
|----------|----:|-----------:|----:|
|uci|370|       2590|370|
|lstnet|320|       2240|320|

## Dataset Creation

The Electricity Load Diagrams 2011–2014 Dataset was developed by Artur Trindade and shared in UCI Machine Learning Repository. This dataset covers the electricity load of 370 substations in Portugal from the start of 2011 to the end of 2014 with a sampling period of 15 min. We will resample this to hourly time series.

### Curation Rationale

Research and development of load forecasting methods. In particular short-term electricity forecasting.

### Source Data

This dataset covers the electricity load of 370 sub-stations in Portugal from the start of 2011 to the end of 2014 with a sampling period of 15 min.

#### Initial Data Collection and Normalization

[More Information Needed]

#### Who are the source language producers?

[More Information Needed]

### Annotations

#### Annotation process

[More Information Needed]

#### Who are the annotators?

[More Information Needed]

### Personal and Sensitive Information

[More Information Needed]

## Considerations for Using the Data

### Social Impact of Dataset

[More Information Needed]

### Discussion of Biases

[More Information Needed]

### Other Known Limitations

[More Information Needed]

## Additional Information

### Dataset Curators

[More Information Needed]

### Licensing Information

[More Information Needed]

### Citation Information

```bibtex
@inproceedings{10.1145/3209978.3210006,
    author = {Lai, Guokun and Chang, Wei-Cheng and Yang, Yiming and Liu, Hanxiao},
    title = {Modeling Long- and Short-Term Temporal Patterns with Deep Neural Networks},
    year = {2018},
    isbn = {9781450356572},
    publisher = {Association for Computing Machinery},
    address = {New York, NY, USA},
    url = {https://doi.org/10.1145/3209978.3210006},
    doi = {10.1145/3209978.3210006},
    booktitle = {The 41st International ACM SIGIR Conference on Research & Development in Information Retrieval},
    pages = {95--104},
    numpages = {10},
    location = {Ann Arbor, MI, USA},
    series = {SIGIR '18}
}
```

### Contributions

Thanks to [@kashif](https://github.com/kashif) for adding this dataset.
task_categories:time-series-forecasting task_ids:univariate-time-series-forecasting annotations_creators:no-annotation language_creators:found multilinguality:monolingual size_categories:1K<n<10K source_datasets:original license:unknown region:us
{"annotations_creators": ["no-annotation"], "language_creators": ["found"], "language": [], "license": ["unknown"], "multilinguality": ["monolingual"], "size_categories": ["1K<n<10K"], "source_datasets": ["original"], "task_categories": ["time-series-forecasting"], "task_ids": ["univariate-time-series-forecasting"], "pretty_name": "Electricity Load Diagrams", "dataset_info": [{"config_name": "uci", "features": [{"name": "start", "dtype": "timestamp[s]"}, {"name": "target", "sequence": "float32"}, {"name": "feat_static_cat", "sequence": "uint64"}, {"name": "item_id", "dtype": "string"}], "splits": [{"name": "train", "num_bytes": 42968147, "num_examples": 370}, {"name": "test", "num_bytes": 302059069, "num_examples": 2590}, {"name": "validation", "num_bytes": 43004777, "num_examples": 370}], "download_size": 261335609, "dataset_size": 388031993}, {"config_name": "lstnet", "features": [{"name": "start", "dtype": "timestamp[s]"}, {"name": "target", "sequence": "float32"}, {"name": "feat_static_cat", "sequence": "uint64"}, {"name": "item_id", "dtype": "string"}], "splits": [{"name": "train", "num_bytes": 20843200, "num_examples": 320}, {"name": "test", "num_bytes": 195401080, "num_examples": 2240}, {"name": "validation", "num_bytes": 27787720, "num_examples": 320}], "download_size": 261335609, "dataset_size": 244032000}]}
TAGS
#task_categories-time-series-forecasting #task_ids-univariate-time-series-forecasting #annotations_creators-no-annotation #language_creators-found #multilinguality-monolingual #size_categories-1K<n<10K #source_datasets-original #license-unknown #region-us 

Dataset Card for Electricity Load Diagrams
==========================================


Table of Contents
-----------------


* Table of Contents
* Dataset Description
	+ Dataset Summary
	+ Supported Tasks and Leaderboards
	+ Languages
* Dataset Structure
	+ Data Instances
	+ Data Fields
	+ Data Splits
* Dataset Creation
	+ Curation Rationale
	+ Source Data
	+ Annotations
	+ Personal and Sensitive Information
* Considerations for Using the Data
	+ Social Impact of Dataset
	+ Discussion of Biases
	+ Other Known Limitations
* Additional Information
	+ Dataset Curators
	+ Licensing Information
	+ Citation Information
	+ Contributions


Dataset Description
-------------------


* Homepage: Electricity Load Diagrams 2011-2014
* Paper: Modeling Long- and Short-Term Temporal Patterns with Deep Neural Networks
* Point of Contact: Artur Trindade


### Dataset Summary


This dataset contains hourly kW electricity consumption time series of 370 Portuguese clients from 2011 to 2014.


### Dataset Usage


The dataset has the following configuration parameters:


* 'freq' is the time series frequency at which we resample (default: '"1H"')
* 'prediction\_length' is the forecast horizon for this task which is used to make the validation and test splits (default: '24')
* 'rolling\_evaluations' is the number of rolling window time series in the test split for evaluation purposes (default: '7')


For example, you can specify your own configuration different from those used in the papers as follows:



> 
> Notes:
> 
> 
> * Data set has no missing values.
> * Values are in kW of each 15 min rescaled to hourly. To convert values in kWh values must be divided by 4.
> * All time labels report to Portuguese hour, however all days present 96 measures (24\*4).
> * Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points.
> * Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours.
> 
> 
> 


### Supported Tasks and Leaderboards


* 'univariate-time-series-forecasting': The time series forecasting tasks involves learning the future 'target' values of time series in a dataset for the 'prediction\_length' time steps. The results of the forecasts can then be validated via the ground truth in the 'validation' split and tested via the 'test' split.


### Languages


Dataset Structure
-----------------


Data set has no missing values. The raw values are in kW of each 15 min interval and are resampled to hourly frequency.
Each time series represent one client. Some clients were created after 2011. In these cases consumption were considered zero. All time labels report to Portuguese hour, however all days contain 96 measurements (24\*4). Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points. Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours.


### Data Instances


A sample from the training set is provided below:


We have two configurations 'uci' and 'lstnet', which are specified as follows.


The time series are resampled to hourly frequency. We test on 7 rolling windows of prediction length of 24.


The 'uci' validation therefore ends 24\*7 time steps before the end of each time series. The training split ends 24 time steps before the end of the validation split.


For the 'lsnet' configuration we split the training window so that it is 0.6-th of the full time series and the validation is 0.8-th of the full time series and the last 0.2-th length time windows is used as the test set of 7 rolling windows of the 24 time steps each. Finally, as in the LSTNet paper, we only consider time series that are active in the year 2012--2014, which leaves us with 320 time series.


### Data Fields


For this univariate regular time series we have:


* 'start': a 'datetime' of the first entry of each time series in the dataset
* 'target': an 'array[float32]' of the actual target values
* 'feat\_static\_cat': an 'array[uint64]' which contains a categorical identifier of each time series in the dataset
* 'item\_id': a string identifier of each time series in a dataset for reference


Given the 'freq' and the 'start' datetime, we can assign a datetime to each entry in the target array.


### Data Splits



Dataset Creation
----------------


The Electricity Load Diagrams 2011–2014 Dataset was developed by Artur Trindade and shared in UCI Machine Learning Repository. This dataset covers the electricity load of 370 substations in Portugal from the start of 2011 to the end of 2014 with a sampling period of 15 min. We will resample this to hourly time series.


### Curation Rationale


Research and development of load forecasting methods. In particular short-term electricity forecasting.


### Source Data


This dataset covers the electricity load of 370 sub-stations in Portugal from the start of 2011 to the end of 2014 with a sampling period of 15 min.


#### Initial Data Collection and Normalization


#### Who are the source language producers?


### Annotations


#### Annotation process


#### Who are the annotators?


### Personal and Sensitive Information


Considerations for Using the Data
---------------------------------


### Social Impact of Dataset


### Discussion of Biases


### Other Known Limitations


Additional Information
----------------------


### Dataset Curators


### Licensing Information


### Contributions


Thanks to @kashif for adding this dataset.



### Dataset Summary


This dataset contains hourly kW electricity consumption time series of 370 Portuguese clients from 2011 to 2014. ### Dataset Usage


The dataset has the following configuration parameters:


* 'freq' is the time series frequency at which we resample (default: '"1H"')
* 'prediction\_length' is the forecast horizon for this task which is used to make the validation and test splits (default: '24')
* 'rolling\_evaluations' is the number of rolling window time series in the test split for evaluation purposes (default: '7')


For example, you can specify your own configuration different from those used in the papers as follows:



> 
> Notes:
> 
> 
> * Data set has no missing values.
> * Values are in kW of each 15 min rescaled to hourly. To convert values in kWh values must be divided by 4.
> * All time labels report to Portuguese hour, however all days present 96 measures (24\*4).
> * Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points.
> * Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours.
> 
> 
> ### Supported Tasks and Leaderboards


* 'univariate-time-series-forecasting': The time series forecasting tasks involves learning the future 'target' values of time series in a dataset for the 'prediction\_length' time steps. The results of the forecasts can then be validated via the ground truth in the 'validation' split and tested via the 'test' split. ### Languages


Dataset Structure
-----------------


Data set has no missing values. The raw values are in kW of each 15 min interval and are resampled to hourly frequency.
Each time series represent one client. Some clients were created after 2011. In these cases consumption were considered zero. All time labels report to Portuguese hour, however all days contain 96 measurements (24\*4). Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points. Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours. ### Data Instances


A sample from the training set is provided below:


We have two configurations 'uci' and 'lstnet', which are specified as follows.


The time series are resampled to hourly frequency. We test on 7 rolling windows of prediction length of 24.


The 'uci' validation therefore ends 24\*7 time steps before the end of each time series. The training split ends 24 time steps before the end of the validation split.


For the 'lsnet' configuration we split the training window so that it is 0.6-th of the full time series and the validation is 0.8-th of the full time series and the last 0.2-th length time windows is used as the test set of 7 rolling windows of the 24 time steps each. Finally, as in the LSTNet paper, we only consider time series that are active in the year 2012--2014, which leaves us with 320 time series. ### Data Fields


For this univariate regular time series we have:


* 'start': a 'datetime' of the first entry of each time series in the dataset
* 'target': an 'array[float32]' of the actual target values
* 'feat\_static\_cat': an 'array[uint64]' which contains a categorical identifier of each time series in the dataset
* 'item\_id': a string identifier of each time series in a dataset for reference


Given the 'freq' and the 'start' datetime, we can assign a datetime to each entry in the target array. ### Data Splits



Dataset Creation
----------------


The Electricity Load Diagrams 2011–2014 Dataset was developed by Artur Trindade and shared in UCI Machine Learning Repository. This dataset covers the electricity load of 370 substations in Portugal from the start of 2011 to the end of 2014 with a sampling period of 15 min. We will resample this to hourly time series. ### Curation Rationale


Research and development of load forecasting methods. In particular short-term electricity forecasting. ### Source Data


This dataset covers the electricity load of 370 sub-stations in Portugal from the start of 2011 to the end of 2014 with a sampling period of 15 min. #### Initial Data Collection and Normalization #### Who are the source language producers? ### Annotations #### Annotation process #### Who are the annotators? ### Personal and Sensitive Information


Considerations for Using the Data
--------------------------------- ### Social Impact of Dataset ### Discussion of Biases ### Other Known Limitations


Additional Information
---------------------- ### Dataset Curators ### Licensing Information ### Contributions


Thanks to @kashif for adding this dataset.
TAGS
#task_categories-time-series-forecasting #task_ids-univariate-time-series-forecasting #annotations_creators-no-annotation #language_creators-found #multilinguality-monolingual #size_categories-1K<n<10K #source_datasets-original #license-unknown #region-us 
 ### Dataset Summary


This dataset contains hourly kW electricity consumption time series of 370 Portuguese clients from 2011 to 2014. ### Dataset Usage


The dataset has the following configuration parameters:


* 'freq' is the time series frequency at which we resample (default: '"1H"')
* 'prediction\_length' is the forecast horizon for this task which is used to make the validation and test splits (default: '24')
* 'rolling\_evaluations' is the number of rolling window time series in the test split for evaluation purposes (default: '7')


For example, you can specify your own configuration different from those used in the papers as follows:



> 
> Notes:
> 
> 
> * Data set has no missing values.
> * Values are in kW of each 15 min rescaled to hourly. To convert values in kWh values must be divided by 4.
> * All time labels report to Portuguese hour, however all days present 96 measures (24\*4).
> * Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points.
> * Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours.
> 
> 
> ### Supported Tasks and Leaderboards


* 'univariate-time-series-forecasting': The time series forecasting tasks involves learning the future 'target' values of time series in a dataset for the 'prediction\_length' time steps. The results of the forecasts can then be validated via the ground truth in the 'validation' split and tested via the 'test' split. ### Languages


Dataset Structure
-----------------


Data set has no missing values. The raw values are in kW of each 15 min interval and are resampled to hourly frequency.
Each time series represent one client. Some clients were created after 2011. In these cases consumption were considered zero. All time labels report to Portuguese hour, however all days contain 96 measurements (24\*4). Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points. Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours. ### Data Instances


A sample from the training set is provided below:


We have two configurations 'uci' and 'lstnet', which are specified as follows.


The time series are resampled to hourly frequency. We test on 7 rolling windows of prediction length of 24.


The 'uci' validation therefore ends 24\*7 time steps before the end of each time series. The training split ends 24 time steps before the end of the validation split.


For the 'lsnet' configuration we split the training window so that it is 0.6-th of the full time series and the validation is 0.8-th of the full time series and the last 0.2-th length time windows is used as the test set of 7 rolling windows of the 24 time steps each. Finally, as in the LSTNet paper, we only consider time series that are active in the year 2012--2014, which leaves us with 320 time series. ### Data Fields


For this univariate regular time series we have:


* 'start': a 'datetime' of the first entry of each time series in the dataset
* 'target': an 'array[float32]' of the actual target values
* 'feat\_static\_cat': an 'array[uint64]' which contains a categorical identifier of each time series in the dataset
* 'item\_id': a string identifier of each time series in a dataset for reference


Given the 'freq' and the 'start' datetime, we can assign a datetime to each entry in the target array. ### Data Splits



Dataset Creation
----------------


The Electricity Load Diagrams 2011–2014 Dataset was developed by Artur Trindade and shared in UCI Machine Learning Repository. This dataset covers the electricity load of 370 substations in Portugal from the start of 2011 to the end of 2014 with a sampling period of 15 min. We will resample this to hourly time series. ### Curation Rationale


Research and development of load forecasting methods. In particular short-term electricity forecasting. ### Source Data


This dataset covers the electricity load of 370 sub-stations in Portugal from the start of 2011 to the end of 2014 with a sampling period of 15 min. #### Initial Data Collection and Normalization #### Who are the source language producers? ### Annotations #### Annotation process #### Who are the annotators? ### Personal and Sensitive Information


Considerations for Using the Data
--------------------------------- ### Social Impact of Dataset ### Discussion of Biases ### Other Known Limitations


Additional Information
---------------------- ### Dataset Curators ### Licensing Information ### Contributions


Thanks to @kashif for adding this dataset.
passage: TAGS
#task_categories-time-series-forecasting #task_ids-univariate-time-series-forecasting #annotations_creators-no-annotation #language_creators-found #multilinguality-monolingual #size_categories-1K<n<10K #source_datasets-original #license-unknown #region-us 
### Dataset Summary


This dataset contains hourly kW electricity consumption time series of 370 Portuguese clients from 2011 to 2014.### Dataset Usage


The dataset has the following configuration parameters:


* 'freq' is the time series frequency at which we resample (default: '"1H"')
* 'prediction\_length' is the forecast horizon for this task which is used to make the validation and test splits (default: '24')
* 'rolling\_evaluations' is the number of rolling window time series in the test split for evaluation purposes (default: '7')


For example, you can specify your own configuration different from those used in the papers as follows:



> 
> Notes:
> 
> 
> * Data set has no missing values.
> * Values are in kW of each 15 min rescaled to hourly. To convert values in kWh values must be divided by 4.
> * All time labels report to Portuguese hour, however all days present 96 measures (24\*4).
> * Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points.
> * Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours.
> 
> 
>### Supported Tasks and Leaderboards


* 'univariate-time-series-forecasting': The time series forecasting tasks involves learning the future 'target' values of time series in a dataset for the 'prediction\_length' time steps. The results of the forecasts can then be validated via the ground truth in the 'validation' split and tested via the 'test' split. passage: ### Languages


Dataset Structure
-----------------


Data set has no missing values. The raw values are in kW of each 15 min interval and are resampled to hourly frequency.
Each time series represent one client. Some clients were created after 2011. In these cases consumption were considered zero. All time labels report to Portuguese hour, however all days contain 96 measurements (24\*4). Every year in March time change day (which has only 23 hours) the values between 1:00 am and 2:00 am are zero for all points. Every year in October time change day (which has 25 hours) the values between 1:00 am and 2:00 am aggregate the consumption of two hours.### Data Instances


A sample from the training set is provided below:


We have two configurations 'uci' and 'lstnet', which are specified as follows.


The time series are resampled to hourly frequency. We test on 7 rolling windows of prediction length of 24.


The 'uci' validation therefore ends 24\*7 time steps before the end of each time series. The training split ends 24 time steps before the end of the validation split.


For the 'lsnet' configuration we split the training window so that it is 0.6-th of the full time series and the validation is 0.8-th of the full time series and the last 0.2-th length time windows is used as the test set of 7 rolling windows of the 24 time steps each. Finally, as in the LSTNet paper, we only consider time series that are active in the year 2012--2014, which leaves us with 320 time series.### Data Fields


For this univariate regular time series we have:


* 'start': a 'datetime' of the first entry of each time series in the dataset
* 'target': an 'array[float32]' of the actual target values
* 'feat\_static\_cat': an 'array[uint64]' which contains a categorical identifier of each time series in the dataset
* 'item\_id': a string identifier of each time series in a dataset for reference


Given the 'freq' and the 'start' datetime, we can assign a datetime to each entry in the target array.### Data Splits



Dataset Creation
----------------


The Electricity Load Diagrams 2011–2014 Dataset was developed by Artur Trindade and shared in UCI Machine Learning Repository. This dataset covers the electricity load of 370 substations in Portugal from the start of 2011 to the end of 2014 with a sampling period of 15 min. We will resample this to hourly time series.### Curation Rationale


Research and development of load forecasting methods. In particular short-term electricity forecasting.