Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page
Ask Your Question

Running EnergyPlus through an API

asked 2020-01-30 18:06:46 -0600

updated 2020-01-30 19:17:41 -0600


I'm new to EnergyPlus and was wondering if it would be possible to access it via an API?

The idea is to have the building modeled in EnergyPlus, and then to have our application ( access it by passing in weather data and then getting in return modeled energy use. We would then calculate the energy savings against actual meter readings, value those energy savings, and distribute payments between different groups (building owner, tenants, investor, etc.)

Do you currently have an API access? If not do you think it would make sense for us to make one for EnergyPlus?

edit retag flag offensive close merge delete

1 Answer

Sort by ยป oldest newest most voted

answered 2020-01-31 09:53:58 -0600

Nearly everyone who uses EnergyPlus interacts with it through an API.

OpenStudio is the primary API for EnergyPlus. EnergyPlus and OpenStudio are maintained by NREL. jEPlus, eppy (python), and params are other APIs for EnergyPlus that other forum users have made work.

I strongly recommend using one of the above APIs instead of making your own. It's a lot of work to just maintain an API to stay up to date with recent versions of EnergyPlus, let alone build one.

edit flag offensive delete link more


Absolutely! We'd certainly use an existing API instead of trying to develop one ourselves!

I had read about OpenStudio before but thought it was more for visually modeling buildings, rather than running weather data through an existing building model to calculate the energy use. Maybe I missed something there?

Also I thought that ModelKit (params) seems to have a lot of what we're looking for. I liked that they have some prototype commercial buildings models. Has anybody had any experience working with ModelKit/Params?

sichen1234 gravatar image sichen1234  ( 2020-02-04 16:49:15 -0600 )edit

The devs will mostly agree that OpenStudio is better suited for parametric modeling, instead of a single "proposed building" case. Take a look at the example files for the Parametric Analysis Tool. I have set up scenarios similar to what you describe, but to run sensitivity studies. Regarding the prototype commercial buildings, you can take a look at the 'openstudio-standards' gem.

Luis Lara gravatar image Luis Lara  ( 2020-02-05 14:59:47 -0600 )edit

Thanks, Luis. That is very interesting. Actually I'm going to start a separate topic on this:

sichen1234 gravatar image sichen1234  ( 2020-02-05 17:25:55 -0600 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer

Training Workshops

Question Tools

1 follower


Asked: 2020-01-30 18:06:46 -0600

Seen: 322 times

Last updated: Jan 31 '20