enerhabitat 0.1.2

Paquete instalable para EnerHabitat

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 : Sol-air temperature
• Ti : Interior temperature
• Ig : Global horizontal irradiance
• Ib : Direct normal irradiance
• Id : Diffuse horizontal 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

pip install enerhabitat

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

$ uv add enerhabitat

Folder structure

The following shows the basic folder structure recommended

├── main.py
├── materials.ini   # Materials properties
└── epw
    ├── ...
    └── example_file.epw

Main functions

Load the EnerHabitat package for use

import enerhabitat as eh

meanDay

Calculates the ambient temperature, global, beam and diffuse irradiance per second for the average day based on EPW file

dia_promedio = eh.meanDay(epw_file = "epw/example_file.epw")

The output data frame should have the following structure

time	zenith	elevation	azimuth	equation_of_time	Ta	Ig	Ib	Id	Tn	DeltaTn
...	...	...	...	...	...	...	...	...	...	...

Tsa

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

Tsa = eh.Tsa(
    dia_promedio,           # DataFrame with Ib, Ig, Id
    solar_absortance = 0.8, # Surface color
    surface_tilt = 90,      # 90 = vertical
    surface_azimuth = 90    # 0 = North, 90 = East
)

solveCS

Solves the constructive system heat transfer to calculate inside temperature for a Tsa simulation

# list of tuples from outside to inside with material and width
constructive_system = [
    ("material_1" , L_1),
    ("material_n", L_n)
]

interior = eh.solveCS(
    constructive_system,  
    Tsa      # 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

[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

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

>>> "./config/new_materials.ini"

Other parameters

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

eh.La = 2.5    # Length of the fictional room
eh.Nx = 100     # Number of elements to discretize the construction system
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.