The load profile aggregator combines profiles for heat and power demand of buildings from different sources. Data for households is taken from VDI 46551, while BDEW2 is used for commercial buildings. Both sources provide 24h profiles in resolutions of 15 minutes for defined typical-days, which LPagg combines to construct a selected calendar year. It takes into account input weather data (from DWD3), local holidays and daylight saving time. Moreover, a random time shift derived from a normal distribution can be applied to each building, in order to approximate the effects of simultaneity present in larger groups of buildings. While the sources only represent very generalized load profiles, LPagg still provides a fast and easy method to create reliable input data for annual simulations of district energy systems. All settings have to be provided via a YAML configuration file. LPagg was created as part of the publicly funded project futureSuN4.
The following table contains a summary of the available profiles and their sources:
| lpagg | lpagg + demandlib | ||
|---|---|---|---|
| HH (households) | Heating | VDI 4655 (lpagg) | VDI 4655 (demandlib) |
| Domestic hot water | VDI 4655 (lpagg) | VDI 4655 (demandlib) | |
| Electricity | VDI 4655 (lpagg) | VDI 4655 (demandlib) | |
| GHD (commercial) | Heating | futuresolar | BDEW (demandlib) |
| Domestic hot water | DOE | BDEW (demandlib) | |
| Electricity | BDEW-typical days | BDEW (demandlib) |
With the configuration setting use_demandlib=True you may choose to let the
VDI 4655 profiles be generated by demandlib.
It is an alternative source of load profiles, compared to the built-in sources in
lpagg.
When selected, the demandlib implementation of VDI4655 is used for residential
buildings, and the BDEW profiles from demandlib are used for commercial buildings,
each providing space heating, domestic hot water and electricity profiles.
While those sources have their own APIs in demandlib, lpagg provides a unified
workflow to generate all those profiles from a single input set of buildings.
lpagg also handles holidays, daylight saving time, simultaneity effects and allows
the use of custom weather data, while trying to be memory-efficient by avoiding
duplicate generation of non-unique profiles when buildings share overlapping attributes.
lpagg was used to generate profiles for more then 100000 buildings from a single
prompt.
LPagg is a Python package. The recommended way to install the latest release is by using Anaconda:
conda install lpagg -c jnettels
In case of package conflicts, this might work instead:
conda install lpagg -c jnettels -c conda-forge
- You need Python. The recommended way is to install Python with Anaconda, a package manager that distributes Python with data science packages. During installation, (despite the warning) please set the advanced option:
[x] Add Anaconda to my PATH environment variable
-
You also need to install Git for downloading this repository.
-
Then you can clone this repository to a directory of your choice by opening a
cmdwindow and writing:
git clone https://github.com/jnettels/lpagg.git
- Now you need to change directory into the new folder:
cd lpagg
- From here you can build and install
lpaggwith conda:
conda build conda.recipe
conda install --use-local lpagg -y
When an update to lpagg is available in this repository, you can simply
change to the folder from step 4 and download the latest files with:
git pull
Afterwards, repeat step 5 to build and install the update.
You should be able to start the program from a cmd window:
lpagg
This will bring up a file dialog for choosing a YAML configuration file
that contains all the settings required for the program. To try it,
you can choose the example lpagg\examples\VDI_4655_config_example.yaml.
You can also show a help message:
lpagg --help
Another approach is to place a shortcut where you would like to use it.
Moreover, you can now write you own Python scripts that use lpagg.
Use the script __main__.py in this repository as an example.
One feature of lpagg is creating the effects of a simultaneity factor.
Copies of a given time series are created and, if a standard deviation
sigma is given, a time shift is applied to the copies.
This can also be used as a standalone script, where you have to
provide a file with time series data. In a cmd window, write the
following to learn more:
simultaneity --help
There is a version with a graphical user interface, which can be started with the command:
simlty_GUI
At the moment, no dedicated changelog is maintained. However, important changes are noted on the release page.
Overview of attributes that make each profile unique:
-
VDI4655:
- house_type: Name of VDI4655 profile type
- EFH: Single family home
- MFH: Multi family home
- For more details refer to https://demandlib.readthedocs.io/en/latest/vdi4655.html
- N_Pers: Number of persons / residents per building
- N_WE: Number of 'Wohneinheiten' (flats) per building
- TRY: The test-reference-year region as defined by DWD and used in VDI4655
- summer_temperature_limit: Daily mean temperature to seperate the seasons 'summer' and 'transition' in VDI4655 profiles
- winter_temperature_limit: Daily mean temperature to seperate the seasons 'transition' and 'winter' in VDI4655 profiles
- house_type: Name of VDI4655 profile type
-
BDEW:
- house_type: Names of BDEW profile types
-
Naming convenction:
- Seleted "heating type" and "electrical type" separated by "/".
- E.g. "GHD/G1" creates general profiles for heating and electricity
-
heating type:
- EFH: Einfamilienhaus (single family house)
- MFH: Mehrfamilienhaus (multi family house)
- GMK: Metall und Kfz (metal and automotive)
- GHA: Einzel- und Großhandel (retail and wholesale)
- GKO: Gebietskörperschaften, Kreditinstitute und Versicherungen (Local authorities, credit institutions and insurance companies)
- GBD: sonstige betriebliche Dienstleistung (other operational services)
- GGA: Gaststätten (restaurants)
- GBH: Beherbergung (accommodation)
- GWA: Wäschereien, chemische Reinigungen (laundries, dry cleaning)
- GGB: Gartenbau (horticulture)
- GBA: Backstube (bakery)
- GPD: Papier und Druck (paper and printing)
- GMF: haushaltsähnliche Gewerbebetriebe (household-like business enterprises)
- GHD: Summenlastprofil Gewerbe/Handel/Dienstleistungen (Total load profile Business/Commerce/Services)
-
electrical type:
- G0: General trade/business/commerce
- G1: Business on weekdays 8 a.m. - 6 p.m.
- G2: Businesses with heavy to predominant consumption in the evening hours
- G3: Continuous business
- G4: Shop/barber shop
- G5: Bakery
- G6: Weekend operation
- G7: Mobile phone transmitter station
- L0: General farms
- L1: Farms with dairy farming/part-time livestock farming
- L2: Other farms
- H0: Household
-
For more details refer to https://demandlib.readthedocs.io/en/latest/bdew.html
-
- house_type: Names of BDEW profile types
1 VDI 4655, 2008: Referenzlastprofile von Ein- und Mehrfamilienhäusern für den Einsatz von KWK-Anlagen. ↩
2 BDEW (1999): Repräsentative VDEW-Lastprofile. Unter Mitarbeit von BTU Cottbus. Frankfurt am Main. Online verfügbar unter https://www.bdew.de/media/documents/1999_Repraesentative-VDEW-Lastprofile.pdf ↩
3 Deutscher Wetterdienst (2017): Ortsgenaue Testreferenzjahre von Deutschland für mittlere und extreme Witterungsverhältnisse. Handbuch. Unter Mitarbeit von Bundesamt für Bauwesen und Raumordnung (BBR). Offenbach. Online verfügbar unter http://www.bbsr.bund.de/BBSR/DE/FP/ZB/Auftragsforschung/5EnergieKlimaBauen/2013/testreferenzjahre/try-handbuch.pdf ↩
4 Bonk, Natalie; Juschka, Winfried; Kofler, Philipp; Nettelstroth, Joris; Pröll, Markus; Bestenlehner, Dominik et al. (2020): futureSuN. Analyse, Bewertung und Entwicklung zukunftsfähiger Anlagenkonzepte für solare Nahwärmeanlagen mit saisonaler Wärmespeicherung. SIZ energie+, SIZ EGS, IGTE, ZAE Bayern. Braunschweig, Stuttgart, München. Online verfügbar unter https://siz-energie-plus.de/projekte/futuresun. ↩