acept.demand_profiles

Module for building demand profiles.

Use this module to create demand profiles for the selected area and buildings using UrbanHeatPro.

This module is the interface to the UrbanHeatPro project (https://github.com/VeraKowalczuk/UrbanHeatPro) that is a dependency for the ACEPT project and is integrated to the ACEPT project as a submodule in /deps/UrbanHeatPro.

Module Contents

Functions

run_uhp_for_selected_buildings_year(→ dict[str, ...)

Creates demand profiles for the selected area and buildings using UrbanHeatPro.
acept.demand_profiles.run_uhp_for_selected_buildings_year(plz_or_region: int | str, buildings: geopandas.GeoDataFrame = None, year: int | None = 2011, temperature_profile: str = None, demand_unit: str = 'W') → dict[str, str | pandas.DataFrame][source]

Creates demand profiles for the selected area and buildings using UrbanHeatPro.

Parameters:

  • plz_or_region (int | str) – PLZ or Region for which the demand profile should be created (area ID).

  • buildings (geopandas.GeoDataFrame) – GeoDataFrame of the selected buildings.

  • year (int | None) – Year for which the demand profile should be created. Defaults to 2011. If None, the temperature profile for the typical meterological year (TMY) will be used.

  • temperature_profile (str) – Path to the temperature profile. If None, the temperature profile is expected at the default location according to the year and plz_or_region.

  • demand_unit (str) – Unit of the demand. Defaults to ‘W’. Valid values are ‘W’, ‘Wh’, ‘kW’, ‘kWh’, ‘MW’, and ‘MWh’. As the timeseries have hourly resolution, the values of ‘W’ and ‘Wh’ are equivalent.

Returns:

A dictionary containing the paths to the demand profiles and the dataframes containing the profiles.

Return type:

dict[str, str | pandas.DataFrame]