[Bldg-sim] [ANNOUNCEMENT] Eppy - Open Source scripting language for Energyplus

Santosh Philip santosh_philip at yahoo.com
Thu Apr 17 11:48:11 PDT 2014

Eppy is a scripting language for EnergyPlus idf files, and EnergyPlus output files. Eppy is written in the programming language Python. As a result it takes full advantage of the rich data structure and idioms that are avaliable in python. You can programmatically navigate, search, and modify EnergyPlus idf files using eppy. The power of using a scripting language allows you to do the following:
	* Make a large number of changes in an idf file with a few lines of eppy code.
	* Use conditions and filters when making changes to an idf file
	* Make changes to multiple idf files.
	* Read data from the output files of a EnergyPlus simulation run.
	* Based on the results of a EnergyPlus simulation run, generate the input file for the next simulation run.
So what does this matter? Here are some of the things you can do with eppy:
	* Change construction for all north facing walls.
	* Change the glass type for all windows larger than 2 square meters.
	* Change the number of people in all the interior zones.
	* Change the lighting power in all south facing zones.
	* Change the efficiency and fan power of all rooftop units.
	* Find the energy use of all the models in a folder (or of models that were run after a certain date)
You can install from : https://pypi.python.org/pypi/eppy/0.4.6
The documentation is at: http://pythonhosted.org//eppy/
to get a quick sense of how it feels to use eppy, take a look at http://pythonhosted.org//eppy/Main_Tutorial.html
email me if you run into any issues.
Put "eppy" in the subject line (the spam filter tends to be rather aggressive, and I might have to look in the junk folder)

The code is hosted on github <https://github.com/santoshphilip/eppy>, in case you want to grab the latest code. It is under active development


Some background to the project

Eppy was developed over the last year, for the ASHRAE 1651-RP research project that required modifying large number of files and analyzing the results.
Eppy was partially funded by ASHRAE
The original code was written in 2004 as a text interface for Energyplus and the scripting language was built on it's foundations
The open source license is GPLv3

The code has been heavily used and is very robust and stable
It works for all versions of Energyplus. It is designed to to work without modifications on future versions too.

Santosh Philip
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.onebuilding.org/pipermail/bldg-sim-onebuilding.org/attachments/20140417/63be30b0/attachment.htm>

More information about the Bldg-sim mailing list