Update README.md

Author: jnettels

README.md

@@ -16,21 +16,32 @@ 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 futureSuN<sup id="a4">[4](#f4)</sup>.
 
-With the configuration setting ``use_demandlib=True`` you may choose to let the
-VDI 4655 profiles be generated by [demandlib](https://github.com/oemof/demandlib).
-These functions are currently being ported over to demandlib, providing improved
-performance for large numbers of buildings.
-
 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       | futuresolar          |
-|                  | Domestic hot water | DOE               | DOE                  |
-|                  | Electricity        | BDEW-typical days | BDEW-typical days    |
+| 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](https://github.com/oemof/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.
 
 Installation
 ============
@@ -128,6 +139,73 @@ At the moment, no dedicated changelog is maintained. However, important
 changes are noted on the
 [release page](https://github.com/jnettels/lpagg/releases).
 
+Reference
+=========
+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
+
+- 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
+
 
 
 Literature