jmarrec / openstudio_to_energyplusapi

Python: using OpenStudio Bindings, EnergyPlus API, and matplotlib

Python: using OpenStudio Bindings, EnergyPlus API, and matplotlib

Written By Julien Marrec of EffiBEM, circa 2021-01-05.

Purpose

This notebook aims to demonstrate the use of:

• The OpenStudio Python Bindings.

  • This is used to efficiently create and customize a model to be simulated

  • Note: Until a version > 3.1.0 (eg 3.1.1 or 3.2.0) is out on pypi, I recommend using the testpypi version where I made usability adjustments. You can do pip install -i https://test.pypi.org/simple/ openstudio for that one.

• The EnergyPlus Python API, and how to use callbacks to retrieve data

• Updating a live matplotlib plot during E+ simulation via the EnergyPlus Python API callback.

Several options and examples are shown below. I strongly recommend you encapsulate your data inside a class (see section 3.4) instead of relying on python global data, but it does bring a sligthly higher complexity level so for simple stuff you can ommit that and use 3.1 to 3.3 instead (which are also used as an entry point to demonstrate the API)

---

Resources:

• OpenStudio SDK documentation: https://openstudio-sdk-documentation.s3.amazonaws.com/index.html
• EnergyPlus Python API documentation: https://energyplus.readthedocs.io/en/latest/api.html

Demo

openstudio_to_energyplusapi's Issues

Plots not displaying output for EnergyPlus API

Hi,

I don't know what the cause of this issue is, but I have followed instructions on running the notebook. I have tried JupyterLab and Jupyter Notebook, which both result in empty graphs being returned, is there something i'm missing?

I am currently running:

OpenStudio Version 3.2.1
EnergyPlus 9.4.0
IPython version 7.22.0

Running on MACOS Big Sur

this is currently the output of the cells, I believe the date/time format is not being interpreted correctly. Do you have any ideas of what may be causing this? I'm not the most experiences with programming so I may just be missing something small.