CoBMo - Control-oriented Building Model

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.

Work in Progress

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.

Contents

• Getting started
  • Installation
  • Examples
  • Configuration with config.yml
  • Contributing
• Data reference
  • Scenario data
  • Building data
  • Zone data
  • Surface data
• API reference
  • cobmo.building_model
  • cobmo.data_interface
  • cobmo.plots
  • cobmo.utils
  • cobmo.config
• Technical documentation
• Contributing
  • Git branches
  • Release versioning
  • Style guide
  • Release checklist
  • Updating environment.yml
• Change log
  • 0.3.0
  • 0.2.0
  • 0.1.0
• Publications
  • Citing CoBMo
  • CoBMo-enabled papers
• GitHub repository 🡕

Acknowledgements

• 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.