The Control-oriented Building Model (CoBMo) is a building modelling framework catering specifically for the formulation of MPC problems for thermal building systems by keeping all model equations in the linear, i.e., convex, domain. CoBMo provides a mathematical model which expresses the relationship between the electric load of the thermal building systems and the indoor air climate with consideration for interactions of the building with its environment, its occupants and appliances. To this end, CoBMo currently implements models for 1) the thermal comfort of building occupants as well as 2) the indoor air quality.
Please note that the repository is under active development and the interface may change without notice. Create an issue if you have ideas / comments / criticism that may help to make the tool more useful.
The preliminary documentation is located at mesmo-dev.github.io/cobmo.
- Check requirements:
- Python 3.9
- Gurobi Optimizer
- Clone or download repository.
- In your Python environment, run:
pip install -v -e path_to_repository
Please also read docs/getting_started.md.
If you are keen to contribute to this project, please see docs/contributing.md.
Information on citing CoBMo and a list of related publications is available at docs/publications.md.
- This work was financially supported by the Singapore National Research Foundation under its Campus for Research Excellence And Technological Enterprise (CREATE) programme.
- Sebastian Troitzsch developed and implemented the initial version of CoBMo and maintains this repository.
- Sarmad Hanif and Henryk Wolisz initiated and supervised the work on the initial version of CoBMo.
- Anthony Vautrin under supervision of Srikkanth Ramachandran developed the models for indoor air quality and demand controlled ventilation.
- Tommaso Miori developed the models for thermal and battery energy storage.
- Sherif Hashem under supervision of Thomas Licklederer developed the hydronic radiator models.