deddiag-loader

Dataloader for DEDDIAG, a Domestic Energy Demand Dataset of Individual Appliances Germany.

The dataset contains recordings of 15 homes over a period of up to 3.5 years, wherein total 50 appliances have been recorded at a frequency of 1 Hz. Recorded appliances are of significance for load-shifting purposes such as dishwashers, washing machines and refrigerators. One home also includes three-phase mains readings that can be used for disaggregation tasks. Additionally, DEDDIAG contains manual ground truth event annotations for 14 appliances, that provide precise start and stop timestamps.

The dataset is available for download on Figshare: 10.6084/m9.figshare.13615073.v1. For a detailed description of the dataset please see this publication.

Install

The deddiag-loader is available on pypi

pip install deddiag-loader

Install from source (alternative)

python setup.py install

CLI Usage

Show Dataset overview

python -m deddiag_loader stats --host=localhost --password=<password>

Save measurements with labels to numpy array

python -m deddiag_loader save --host=localhost --password=<password>

The database options can also be provided using environment variables:

DEDDIAG_DB_PW=
DEDDIAG_DB_USER=
DEDDIAG_DB_HOST=
DEDDIAG_DB_NAME=

Code Example

from deddiag_loader import Connection, Annotations, MeasurementsExpandedWithLabels
con = Connection(password="password")
item_id = 10

start_date = "2016-11-30T20:24:05"
stop_date = "2019-06-02T17:56:17"

annotations = Annotations(item_id, start_date=start_date, stop_date=stop_date).request(con)
first_annotation = annotations.iloc[0]

# Get Expanded Measurements for first annotation
measurements = MeasurementsExpandedWithLabels(item_id, first_annotation['label_id'], first_annotation['start_date'], first_annotation['stop_date']).request(con)

Citation

When using the dataset in academic work please cite this paper as the reference.

@article{DEDDIAG_2021,
  author = {Marc Wenninger and Andreas Maier and Jochen Schmidt},
  title = {{DEDDIAG}, a domestic electricity demand dataset of individual appliances in Germany},
  year = {2021},
  month = jul,
  publisher = {Springer Science and Business Media {LLC}},
  volume = {8},
  number = {1},
  journal = {Scientific Data},
  doi = {https://doi.org/10.1038/s41597-021-00963-2},
  url = {https://rdcu.be/coGqL},
}

Acknowledgements

The monitoring system and dataset were created as part of a research project of the Technical University of Applied Sciences Rosenheim.

The project was funded by the German Federal Ministry of Education and Research (BMBF), grant 01LY1506, and supported by the Bayerische Wissenschaftsforum (BayWISS).

License

MIT licensed as found in the LICENSE file.