pybuildingenergy 1.0.7

Energy Simulation of building usin ISO52016 and more

Citation

Please cite us if you use the library

Features

The new EPBD recast provides an update on building performance assessment through a methodology that must take into account various aspects such as the thermal characteristics of the building, the use of energy from renewable sources, building automation and control systems, ventilation, cooling, energy recovery, etc.

The methodology should represent the actual operating conditions, allow for the use of measured energy for accuracy and comparability purposes, and be based on hourly or sub-hourly intervals that take into account the variable conditions significantly impacting the operation and performance of the system, as well as internal conditions. The energy performance of a building shall be expressed by a numeric indicator of primary energy use per unit of reference floor area per year, in kWh/(m2.y) for the purpose of both energy performance certification and compliance with minimum energy performance requirements. Numeric indicators of final energy use per unit of reference floor area per year, in kWh/(m2.y) and of energy needs according to ISO 52000 in kWh/(m².y) shall be used. The methodology applied for the determination of the energy performance of a building shall be transparent and open to innovation and reflect best practices, in particular from additional indicators. Member States shall describe their national calculation methodology based on Annex A of the key European standards on energy performance of buildings, namely EN ISO 52000-1, EN ISO 52003-1, EN ISO 52010-1,EN ISO 52016-1, EN ISO 52018-1,EN 16798-1, EN 52120-1 and EN 17423 or superseding documents. This provision shall not constitute a legal codification of those standards.

pyBuildingEnergy aims to provide an assessment of building performance both in terms of energy and comfort. In this initial release, it is possible to assess the energy performance of the building using ISO 52106-1:2018. Additional modules will be added for a more comprehensive evaluation of performance, assessing ventilation, renewable energies, systems, etc. The actual calculation methods for the assessment of building performance are the following:

• [x] the (sensible) energy need for heating and cooling, based on hourly or monthly calculations;

• [ ] the latent energy need for (de-)humidification, based on hourly or monthly calculations;

• [x] the internal temperature, based on hourly calculations;

• [x] the sensible heating and cooling load, based on hourly calculations;

• [ ] the moisture and latent heat load for (de-)humidification, based on hourly calculations;

• [ ] the design sensible heating or cooling load and design latent heat load using an hourly calculation interval;

• [ ] the conditions of the supply air to provide the necessary humidification and dehumidification.

The calculation methods can be used for residential or non-residential buildings, or a part of it, referred to as “the building” or the “assessed object”. ISO 52016-1:2018 also contains specifications for the assessment of thermal zones in the building or in the part of a building. The calculations are performed per thermal zone. In the calculations, the thermal zones can be assumed to be thermally coupled or not. ISO 52016-1:2018 is applicable to buildings at the design stage, to new buildings after construction and to existing buildings in the use phase

Weather Data

The tool can use wather data coming from 2 main sources:

• pvgis api (https://re.jrc.ec.europa.eu/pvg_tools/en/) - PHOTOVOLTAIC GEOGRAPHICAL INFORMATION SYSTEM

• .epw file from https://www.ladybug.tools/epwmap/

More details in the example folder

Domestic Hot Water - DHW

• [x] Calculation of volume and energy need for domestic hot water according to ISO 12831-3.

• [] Assessment of thermal load based on the type of DHW system

Limitations

The library is developed with the intent of demonstrating specific elements of calculation procedures in the relevant standards. It is not intended to replace the regulations but to complement them, as the latter are essential for understanding the calculation. This library is meant to be used for demonstration and testing purposes and is therefore provided as open source, without protection against misuse or inappropriate use.

The information and views set out in this document are those of the authors and do not necessarily reflect the official opinion of the European Union. Neither the European Union institutions and bodies nor any person acting on their behalf may be held responsible for the use that may be made of the information contained herein.

The calculation is currently aimed at single-zone buildings with ground floor. The evaluation of multi-zone buildings is under evaluation.

Getting Started

The following command will install the latest pyBuildinEnergy library

pip install pybuildingenergy

The tool allows you to evaluate the performance of buildings in different ways:

• by running simulations of buildings (archetypes) already preloaded in the archetypes.pickle file for different nations according to Tabula dataset (currently only Italian buildings are available, but buildings from different nations will be loaded),

  python3 pybuildingenergy --archetype

Here it is possible, to select two options:

. Selection of archetype by providing

• information on building type: single_family_house

• period of construction: before 1900, 1901-1920,1921-1945,1946-1960,1961-1875,1976-1990,1991-2005,2006-today

• location:

  latitude and longitude

. Demo Building having these features:

• single_family_house

• before 1900,

• city: Turin

• lat: 45.071321703968124

• long: 7.642963669564985

• by running best_test600 demo:

  python3 pybuildingenergy --best_test

• your own building. For the latter, you can either upload the information from scratch or preload the information from a building archetype and then edit only the information you know.

  See Examples folder

Building Inputs

Building geometry data * general

Parameter	Key	Description	Unit	Mandatory
Latitude	latitude	latitude of the building in [decimal]	[-]	YES
Longitude	longitude	longitude of the building location [decimal]	[-].	YES
Coldest month	coldest_month	Define the coldest month of the building location. Value from 1 (January) to 12 (December)	[-].	YES. Default: 1
Gross building area	a_use	gross floor area of the building	[m2]	YES
Slab on ground area	slab_on_ground_area	Ground floor gross area	[m2]	If not provided, the slab on ground are is calculated as useful area / number of floors
Number of floors	number_of_floor	Number of building floors	[-]	YES/NO if number of floors is provided
Building perimeter	exposed_perimeter	perimeter of the building	[m]	YES/NO iIf not provided, the perimeter is calculated as if the building were rectangular with one side being 10 meters
Building height	height	external height of the building	[m]	YES
Average thickness of wall	wall_thickness	average thickness of building walls	[m]	YES
Surface of envelope	surface_envelope	gross volume of the building	[m3]	If not provided the volume is calcuated as the slab on ground area * building height
Volume	volume	gross volume of the building	[m3]	If not provided the volume is calcuated as the slab on ground area * building height
Annual mean internal temperature	annual_mean_internal_temperature	the annual mean internal temperature is the average between Heating and Cooling setpoints	[°C]	NO: if not provided, it is calculated.
Annual mean external temperature	annual_mean_external_temperature	Annual mean axternal temperature of the building location	[°C]	NO: if not provided, it is calculated.
Heating system	heating_mode	True if heating system is installed, False if not.	[True or False]	YES
Cooling system	cooling-mode	True if heating system is installed, False if not.	[True or False]	YES
Heating setpoint	heating_setpoint	Temperature set-point of the heating system	[°C]	YES. If heating_mode is True
Cooling setpoint	cooling_setpoint	Temperature set-point of the cooling system	[°C]	YES. If cooling_mode is True
Heating setback	heating_setback	Temperature set-back of the heating system	[°C]	YES. If heating_mode is True
Cooling setback	cooling_setback	Temperature set-back of the cooling system	[°C]	YES. If cooling_mode is True
Max power of heating generator	power_heating_max	max power of heating generator	[W]	YES. If heating_mode is True
Max power of cooling generator	power_cooling_max	max power of cooling generator	[W]	YES. If cooling_mode is True
Air change rate	air_change_rate_base_value	value of air chnage rate	[m3/h*m2]	Yes
Air change rate extra	air_change_rate_extra	extra value of air change rate, in specific period according to the occupancy profile	[m3/h*m2]	Yes
Internal Gains	internal_gains_base_value	power of internal gains	[W/m2]	YES
Extra Internal Gains	internal_gains_base_value	extra value of internal gains, in specific period according to the occupancy profile	[W/m2]	YES
Thermal bridges	thermal_bridge_heat	Overall heat transfer coefficient for thermal bridges (without groud floor)	[W/K]	YES
Thermal resistance of floor	thermal_resistance_floor	Average thermal resistance of internal floors	[m2K/W]	YES
Facade elements type	typology_elements	List of all facade elements (Walls, Roof, Ground Floor, Windows).For: Wall, Roof use: “OP” (Opaque elements) Ground Floor: use “GF” (Ground Floor) Windows: use “W” (Windows)	[-]	YES
Orienation of facade elements	orientation_elements	For each elements of the facade provide the orientation, according to the following abbreviations: NV: North Vertical SV: South Vertical EV: East Vertical WV: West Vertical HOR: Horizontal/Slope (for roof and ground floor)	[-]	YES
Solar absorption coefficients	solar_abs_elements	Solar absorption coefficient of external (Opaque) facade elements (e.g. walls)	[-]	YES
Area of facade elements	area_elements	Area of each facade element (e.g. Wall, Window, etc.)	[m2]	YES
Transmittance - U	transmittance_U_elements	Transmiattance of each facade element.	[W/m2K]	YES
Resistance - U	thermal_resistance_R_elements	Theraml Resistance of each facade element.	[W/m2K]	YES
Thermal capacity - k	thermal_resistance_R_elements	Addition of the heat capacity of each layer (i.e. calculated by multiplying the density times its thickness times the SHC of the material)	[J/m2K]	YES
g-value	g_factor_windows	solar energy transmittance of windows	[-]	YES
Heat radiative transfer coefficient - internal	heat_convective_elements_internal	convective heat transfer coefficient internal surface for each element	[W/m2K]	YES
Heat convective transfer coefficient - external	heat_convective_elements_external	convective heat transfer coefficient external surface for each element	[W/m2K]	YES
Heat radiative transfer coefficient - internal	heat_radiative_elements_internal	radiative heat transfer coefficient internal surface for each element	[W/m2K]	YES
Heat radiative transfer coefficient - external	heat_radiative_elements_external	radiative heat transfer coefficient external surface for each element	[W/m2K]	YES
View factor	sky_factor_elements	View factor between building element and the sky	[-]	YES
Occupancy profile workdays - internal_gains rate	comf_level_we	Occupancy profile for workdays to evalaute the utilization of extra internal gains	[-]	YES
Occupancy profile weekends - internal_gains rate	comf_level_we	Occupancy profile for weekdays to evalaute the utilization of extra internal gains	[-]	YES
Occupancy profile workdays - airflow rate	comf_level_we	Occupancy profile for workdays to evalaute the utilization of extra air change rate	[-]	YES
Occupancy profile weekend - airflow rate	comf_level_we	Occupancy profile for weekend to evalaute the utilization of extra air change rate	[-]	YES
Class of buidling construction	construction_class	Distribution of the mass for opaque elements (vertical - walls and horizontal - floor/roof) as described in Table B.13 of ISO52016. Possible choices: class_i, class_e, class_ie, class_d	[-]	YES
Weather source	weather_source	In English, it would be: “Select which type of source to use for weather data. Choose ‘pvgis’ for connecting to the pvgis <https://re.jrc.ec.europa.eu/pvg_tools/en/> or ‘epw’ file if using an epw file, to be download from here <https://www.ladybug.tools/epwmap/>	[-]	YES

More information about coefficients are available here <https://github.com/EURAC-EEBgroup/pyBuildingEnergy/tree/master/src/pybuildingenergy/data>

Documentation

Check our doc here <https://pybuildingenergy.readthedocs.io/en/latest/>

Example

Here some Examples <https://github.com/EURAC-EEBgroup/pyBuildingEnergy/tree/master/examples> on pybuildingenergy application. For more information …..

Contributing and Support

Bug reports/Questions If you encounter a bug, kindly create a GitLab issue detailing the bug. Please provide steps to reproduce the issue and ideally, include a snippet of code that triggers the bug. If the bug results in an error, include the traceback. If it leads to unexpected behavior, specify the expected behavior.

Code contributions We welcome and deeply appreciate contributions! Every contribution, no matter how small, makes a difference. Click here to find out more about contributing to the project.

License

• Free software: MIT license

• Documentation: https://pybuildingenergy.readthedocs.io.

Acknowledgment

This work was carried out within European projects: Infinite - This project has received funding from the European Union’s Horizon 2020 research and innovation programme under grant agreement No 958397, Moderate - Horizon Europe research and innovation programme under grant agreement No 101069834, with the aim of contributing to the development of open products useful for defining plausible scenarios for the decarbonization of the built environment

Reagrding the DHW Calculation: The work was developed using the regulations and results obtained from the spreadsheet created by the EPBCenter.

Reference

• EN ISO 52010-1:2018 Energy performance of buildings - External climatic conditions - Part 1: Conversion of climatic data for energy calculations

• EN ISO 52016-1:2018 Energy performance of buildings - Energy needs for heating and cooling, internal temperatures and sensible and latent heat loads

• EN ISO 12831-3:2018 Energy performance of buildings - Method for calculation of the design heat load - Part 3: Domestic hot water systems heat load and characterisation of needs, Module M8-2, M8-3