EnerHabitat

Tools for evaluating the thermal performance of structures based on EPW files

Table of contents

• Getting started
  • Installation
  • Folder structure
• Main functions
  • meanDay
  • Tsa
  • solveCS
• Materials
• Other parameters
• Dependencies
• License

Getting started

enerhabitat is a Python package for thermal simulation of constructive systems based on meteorological data from EPW files. The values that are calculated include:

• Ta : Ambient temperature
• Tsa : Sun-Air temperature
• Ti : Interior temperature
• Ig : Global irradiance
• Ib : Beam irradiance
• Id : Diffuse irradiance
• Is : Surface irradiance

Installation

The source code is currently hosted on GitHub at eh_development

Binary installers for the latest released version are available at the Test Python Package Index TestPyPI

bash pip install -i https://test.pypi.org/simple/ enerhabitat

If you're working with the uv Python package manager you can use the following

bash $ uv pip install --index-url https://test.pypi.org/simple/ enerhabitat

Folder structure

The following shows basic folder structure ├── main.py ├── materials.ini # Materials properties └── epw ├── ... └── example_file.epw

Main functions

meanDay

Calculates the ambient temperature, global, beam and diffuse irradiance per second for the average day based on EPW file ```python import enerhabitat as eh

diapromedio = eh.meanDay(epwfile = "epw/example_file.epw") ```

The output data frame should have the following structure

time | zenith | elevation | azimuth | equationoftime | Ta | Ig | Ib | Id |Tn | DeltaTn :---: | :---: | :---: | :---: | :---: |:---: | :---: | :---: | :---: | :---: | :---: ... | ... | ... | ... | ... | ... | ... | ... | ... | ... | ...

Tsa

Calculates the sun-air temperature and solar irradiance per second for the average day

```python import enerhabitat as eh

sunair = eh.Tsa( diapromedio, # DataFrame with Ib, Ig, Id solarabsortance = 0.8, # Surface color surfacetilt = 90, # 90 = vertical surface_azimuth = 90 # 0 = North, 90 = East )

```

solveCS

Solves the constructive system's inside temperature for a Tsa simulation dataframe

```python import enerhabitat as eh

list of tuples from outside to inside with material and width

constructivesystem = [ ("material1" , L1), ("materialn", L_n) ]

interior = eh.solveCS( constructivesystem,
sunair_df # DataFrame with Tn, Ta, Tsa )

```

Materials

The materials and their properties are specified in the materials.ini configuration file, specifying the material name as the key and its values ​​for k, rho and c

```ini [concrete] k = 1.35 # Overall heat transfer coefficient rho = 1800 # Density c = 1000 # Specific heat

[adobe] k = 0.58 rho = 1500 c = 1480 ```

To set a configuration file, use the materials() function and specify the path

```python import enerhabitat as eh

eh.materials("./config/new_materials.ini") shell

"./config/new_materials.ini" ```

Other parameters

You can set various configuration values ​​to modify the behavior of the calculations

```python import enerhabitat as eh

eh.La = 2.5 # Length of the fictional room eh.Nx = 20 # Number of elements to discretize eh.ho = 13 # Outside convection heat transfer eh.hi = 8.6 # Inside convection heat transfer eh.dt = 60 # Time step in seconds ```

Dependencies

• numba
• pvlib
• numpy
• pandas
• pytz

License

Code released under the MIT license.