BESOS is a collection of modules for the simulation and optimization of buildings and urban energy systems. BESOS is designed to help researchers and practitioners to design more sustainable, district-integrated buildings. It integrates EnergyPlus and EnergyHub simulation software with optimization and machine learning functionality. this includes lots of help with 'surrogate modelling', where machine learning models are fitted to data generated by parametric runs of detailed simulation models. BESOS facilitates running large-scale parametric analyses of EnergyPlus or EnergyHub models with output in a pandas DataFrame and using this to train machine learning surrogate models with scikit-learn or TensorFlow. We provide access to commonly used optimization algorithms via existing optimization toolboxes.
Ensure that you have Python 3.7+ and the corresponding version of pip.
pip install besos[complete]
(If you do not want to run the example notebooks, you can use pip install besos, which will
install with less dependencies.)
We use third party software to run building models (EnergyPlus), to solve EnergyHub models (a MILP solver), and make use of Rbfopt (via Bonmin). To use this functionality you need to install the software for the corresponding the task. GLPK and Bonmin are optional, it is possible to use Besos without them.
Download EnergyPlus here. (BESOS is currently supporting versions from 8.8-9.3+).
For windows: After downloading the installation file, double click the setup file to start installing.
After setup is complete, navigate to your System Properties and in the Advanced tab, select Environment Variables.
In either your User Variables or System Variables (Depending on your permissions), double click on Path
and add the location of your EnergyPlus folder to the end of it. Ensure the path is C:\EnergyPlusV{version} for proper integration with Besos.
For linux: Run the downloaded script, and accept the prompt to add symlinks. Ensure the path is /usr/local/EnergyPlus-{version} for proper integration with Besos.
TensorFlow is a machine learning library of which we have provided some examples. This package is quite large 300 mb therefore we have not added this to the requirements.
To install TensorFlow use pip install.
pip install tensorflow
EnergyHub modelling requires a linear programming solver that is supported by PuLP, such as GLPK, CPlex, or Gurobi. To learn about how to setup a custom solver please review the readthedocs page on Customizing EnergyHub Solver.
GLPK is free and open source. It can be found here.
If you are using a Debian based operating system, you can install GLPK with sudo apt install glpk-utils
Bonmin is required to use the RBFopt optimizer.
How to install Bonmin can be found here.
Examples of Besos' functionality are provided through example notebooks. The notebooks can be viewed as Python scripts or through a Jupyter notebook.
You can run notebooks from the Besos platform, which has the besos library and all dependencies pre-installed, or you can install Jupyter locally.
To run the notebooks you need Juptyer installed. Jupyter can be installed using: pip install juptyer and launched from the current directory with jupyter notebook.
When creating gitlab issues, please search the existing gitlab issues to see if someone else has already made the same request.
To request a feature open a new issue with your feature request.
If you have found a bug, please open a gitlab issue describing the bug. Make sure to include steps to reproduce the bug. Ideally, include a small bit of code that causes the bug. If the bug causes an error, please include the traceback. If the bug causes the wrong behaviour, please mention what besos should do in this situation.
If you are interested in contributing to the code please review the readthedocs page on contributing to the code.
A good way to start is using the example notebooks. They are described in the examples overview
FAQs
A library for Building and Energy Simulation, Optimization and Surrogate-modelling
We found that besos demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
PyPI confirms no security flaws were exploited in the Ultralytics supply chain attack and highlights improvements for safer package publishing.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
