A Python package for modelling the thermal behaviour of a building with HVAC installations.
The code is being developed in the Research Group Balanced Energy Systems (BES) at HAN University of Applied Sciences,
The housemodel
package can be used under the conditions of the GPLv3 license.
- Basic classes for thermal network representation of buildings.
- Additional classes for HVAC installations.
- Conductive and convective heat transfer.
- Matrix formalism for dynamic evaluation of temperature distributions.
- Heat rate balance equations including solar irradiance and human presence.
- ODE solver evaluating building dynamics and HVAC control.
To use the package housemodel, install it in a Python environment:
(env) pip install housemodel
or
(env) conda install housemodel
This should
automatically install the dependency packages matplotlib
, scipy
and pandas
, if they haven't been installed already. If you are
installing by hand, ensure that these packages are installed as well.
"""Example Python script using the housemodel package."""
from housemodel.buildings.building import Building
# create Building object
h = Building("MyHouse")
section = param["Building"]
# read nodes attribute from dictionary and create capacity matrix
h.nodes_from_dict(section["nodes"])
h.fill_c_inv()
h.edges_from_dict(section["edges"])
# read FixedNode objects (external nodes);
h.boundaries_from_dict(param["boundaries"]) # function selects "outdoor" as ambient
h.make_k_ext_and_add_ambient() # initialize k_ext_mat and add diagonal elements
b = StratifiedBufferNew.from_dict(param["Buffer"])
b.generate_nodes()
b.fill_c_inv()
b.generate_edges()
b.generate_ambient()
b.make_k_ext_and_add_ambient()
total = TotalSystem("HouseWithBuffervessel", [h, b])
total.sort_parts()
# compose c-1-matrix from parts and merge tag_lists
total.merge_c_inv()
total.merge_tag_lists()
...
- PyPi: housemodel Python package
- Github: housemodel source code
- ReadTheDocs: housemodel documentation
- Author: Paul J.M. van Kan
- Contact: paul.vankan@han.nl
- License: GPLv3
- ...