Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/EURAC-EEBgroup/pyBuildingEnergy

python package to simulate the building performance of a building using the ISO 52000
https://github.com/EURAC-EEBgroup/pyBuildingEnergy

Last synced: 3 months ago
JSON representation

python package to simulate the building performance of a building using the ISO 52000

Awesome Lists containing this project

README 

        
================

pyBuildingEnergy

================



.. image:: https://github.com/EURAC-EEBgroup/pyBuildingEnergy/blob/master/src/pybuildingenergy/assets/Logo_pyBuild.png

   :width: 800

   :height: 250



Citation

----------

Please cite us if you use the library



.. image:: https://zenodo.org/badge/761715706.svg

  :target: https://zenodo.org/doi/10.5281/zenodo.10887919



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

----------------



.. list-table:: Building geometry data * general

   :widths: 20 20 40 10 10 

   :header-rows: 1



   * - 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 ` or 'epw' file if using an epw file, to be download from `here `

     - [-] 

     - YES

   

More information about coefficients are available `here `



Documentation

--------------

Check our doc `here `



Example

-------



Here some `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