BESMod

This library contains Modules for the domain-coupled simulation of Building Energy Systems . It was presented at the American Modelica Conference 2022. Check out the proceedings here: https://2022.american.conference.modelica.org/documents/01_papers/02_full/1_Wullhorst.pdf

Moreover, BESMod won the best paper award.

Tutorial

We held a tutorial at our institute to teach the motivation and usage of BESMod. The recordings are available on YouTube:

1. Motivation: https://www.youtube.com/watch?v=s6ufqhITJh8
2. Installation: https://www.youtube.com/watch?v=bwkI_ZqXlx0&t=196s
3. Basics on modelling: https://www.youtube.com/watch?v=1FIX1WUTrf4
4. Model aggregation and simulation: https://www.youtube.com/watch?v=yVMQ63bn5MA
5. Adding own modules: https://www.youtube.com/watch?v=Am1rIv6zmVk&t=4s

Installation

Clone repository

To clone the repository for the first time run:

git clone https://github.com/RWTH-EBC/BESMod.git

Install dependencies

To install all dependencies, you need python installed (>= 3.7). If you don't have python or don't want to install it, just clone the required libraries manually. You can extract the relevant information from the dependencies.cfg script.

To install, open a command line interface in the folder of BESMod and run:

python install_dependencies.py full

to install all dependencies or specify the list of optional dependencies you want to use:

python install_dependencies.py AixLib Buildings

To change the default directories of installation and working directory, you have the following options:

--install_dir=/path_to_a_install_dir
--working_dir=/path_to_a_working_dir

Example:

python install_dependencies.py AixLib Buildings --install_dir=D:\BESMod_install --working_dir=D:\BESMod_cwd

After installing all libraries, a script startup.mos will be created in your BESMod repo. Execute this script to load all dependencies and start modelling.

Updating dependencies

If you have BESMod already installed, run

python install_dependencies.py full --update

to update the existing repos and avoid a second download.

How to contribute to the development of BESMod

You are invited to contribute to the development of BESMod. Issues can be reported using this site's Issues section. Furthermore, you are welcome to contribute via Pull Requests.

If you want to update the CI templates, get MoCITempGen locally, change the tomls under ci-tests\config and run:

python path_to_\MoCITempGen\ci_templates_build.py --update-templates --templates-toml-file path_to_BESMod\ci-tests\config\templates_generator_config.toml --ci-toml-file path_to_BESMod\ci-tests\config\modelica_py_ci_config.toml

How to cite BESMod

Paper about BESMod at the Modelica Conference 2022 DOI: 10.3384/ECP211869

@inproceedings{wuellhorst2022besmod,
  title = {{BESMod} - {A} {Modelica} {Library} providing {Building} {Energy} {System} {Modules}},
  author = {W{\"u}llhorst, Fabian and Maier, Laura and Jansen, David and K{\"u}hn, Larissa and Hering, Dominik and M{\"u}ller, Dirk}},
  year = {2022},
  booktitle={Proceedings of the American Modelica Conference 2022, Dallas, Texas, USA, October 26-28},
  pages={9--18},
  year={2022},
  doi={10.3384/ecp211869}
}

License

The BESMod Library is released by RWTH Aachen University, E.ON Energy Research Center, Institute for Energy Efficient Buildings and Indoor Climate and is available under a 3-clause BSD-license. See BESMod Library license.

Acknowledgements

We gratefully acknowledge the financial support by the Federal Ministry for Economic Affairs and Climate Action (BMWK), promotional reference 03ET1495A.

This work emerged from the IBPSA Project 1, an international project conducted under the umbrella of the International Building Performance Simulation Association (IBPSA). Project 1 will develop and demonstrate a BIM/GIS and Modelica Framework for building and community energy system design and operation.