This is the development site for the Modelica Buildings library and its user guide.
Stable releases including all previous releases are available from the main project site at http://simulationresearch.lbl.gov/modelica.
Instructions for developers are available on the wiki.
The Modelica Buildings library is a free open-source library with dynamic simulation models for building energy and control systems. The library contains models for
The main project site is http://simulationresearch.lbl.gov/modelica.
Download Buildings Library 11.0.0 (2024-04-09)
The Modelica Buildings Library is available under a 3-clause BSD-license. See Modelica Buildings Library license.
Python modules are available under a 3-clause BSD-license. See BuildingsPy license.
You may report any issues with using the Issues button.
Contributions in the form of Pull Requests are always welcome. Prior to issuing a pull request, make sure your code follows the style guide and coding conventions.
The distribution at https://simulationresearch.lbl.gov/modelica/download.html contains all binaries.
Developers may build the binaries as follows.
The Buildings library already contains the compiled binaries that are needed to link to EnergyPlus.
To rebuild the Spawn of EnergyPlus binaries, CMake is required. The binaries consist of the fmi-library, and a library that connects Modelica to EnergyPlus.
To build the fmi-library, which is only needed if https://github.com/modelon-community/fmi-library is updated, run
cd Buildings/Resources/src/fmi-library
rm -rf build && mkdir build && \
cd build && cmake .. && cmake --build . && \
cd .. && rm -rf build
To build the Modelica to EnergyPlus library, run
cd modelica-buildings
rm -rf build && mkdir build && cd build && \
cmake ../ && cmake --build . --target install && \
cd .. && rm -rf build
To install the EnergyPlus binaries for the Spawn interface for the current operating system, run
Buildings/Resources/src/ThermalZones/install.py --binaries-for-os-only
To install the binaries for all operating systems, omit the flag --binaries-for-os-only
To cite the library, use
Michael Wetter, Wangda Zuo, Thierry S. Nouidui and Xiufeng Pang. Modelica Buildings library. Journal of Building Performance Simulation, 7(4):253-270, 2014.
@Article{WetterZuoNouiduiPang2014,
author = {Michael Wetter and Wangda Zuo and Thierry S. Nouidui and Xiufeng Pang},
title = {Modelica {Buildings} library},
journal = {Journal of Building Performance Simulation},
volume = {7},
number = {4},
pages = {253--270},
year = {2014},
doi = {10.1080/19401493.2013.765506},
url = "https://doi.org/10.1080/19401493.2013.765506"
}