JEPlus – An EnergyPlus shell for parametric studies - pre-2012

jEPlus logo

Return to main page

06/05/2012: jEPlus v1.3Beta is here: http://www.iesd.dmu.ac.uk/~jeplus

30/01/2012: jEPlus has moved to a new home: http://www.iesd.dmu.ac.uk/~jeplus

18/01/2012: We are working on more tutorials and an extended version of jEPlus (jEPlus+Net) for networked computers

10/01/2012: Do you want to see how quickly a jEPlus project can be created? Check out this demo on YouTube

03/01/2012: And finally… jeplus_v1.2_build_05.zip (1.83 MiB, 458 downloads) - Please download it here or from sourceforge.net, or take a look at the updated user manual

15/07/2011: Version 1.1 is here - Please check out the updated user manual and download the software at: sourceforge.net

04/02/2011: Version 1.0 beta is available here: distribution_v10beta_build_02.zip (4.42 MiB, 351 downloads).


Parametric analysis is often needed for exploring design options, especially when a global optimization method is not available, or the optimization result is in doubt. Parametric analysis can also be applied to all design variables simultaneously, which forms an exhaustive search that, providing that the search grid is fine enough, will guarantee a global optimum solution. In order to perform complex parametric analyses on multiple parameters with more than a handful of alternative values each, a tool to generate commands for the simulation model to run, and to collect results afterwards will be needed. jEPlus has been developed as such a parametric tool for EnergyPlus. The main features include:

  • Complete GUI provides utilities for setting up and managing parametric simulations using EnergyPlus
  • Command-line interface for easy coupling your own search algorithms with E+ simulations (since v1.1)
  • You can randomly sample the search space rather than run the full parametric (since v1.0)
  • Parameter tree for defining dependency between parameters
  • Flexible syntax for specifying parameter values (sampling and loading-from-file is supported since v1.0)
  • For a long list of parameters, you can put definitions in a CSV-styled text file and import them in the GUI. A parameter tree will be generated for these parameters. (since v1.2)
  • Supports multi-processor/multi-core systems by threading
  • Supports Windows/Mac/Linux versions of E+
  • In-built IDF editor supports syntax highlighting and text search (improved since v1.1)
  • Support for EP-Macro and HVACTemplate objects (since v0.5)
  • Simulation results are collected and combined into one CSV file for easy process
  • Simple statistics of the simulation results can be obtained through the post-process tab. (since v1.1)


This software is provided by Dr Yi Zhang free of charge for non-commercial use. It is proved on the basis of “as is”. Any express or implied warranties, including, but not limited to, the implied warranties of merchantability and fitness for a particular purpose are disclaimed. In no event shall Dr Yi Zhang, his employer, or the hosting service provider of this webpage be liable for any direct, indirect, incidental, special, exemplary, or consequential damages, (including, but not limited to, procurement of substitute goods or services; loss of use, data, or profits; or business interruption) however caused and on any theory of liability, whether in contract, strict liability, or tort (including negligence or otherwise) arising in any way out of the use of this software.

The use of the software downloaded from this webpage is done at your own discretion and risk and with agreement of the foregoing disclaimer.

Screen shot

How to get it:

To get started, you will need:

  1. A computer supports EnergyPlus and Java J2SE6.0
  2. The latest Java Runtime Environment (JRE, download it from java.sun.com)
  3. EnergyPlus, preferably installed with the default settings
  4. The latest jEPlus package (available at sourceforge.net)

Instructions on how to use jEPlus is bundled in the distribution pack. The users manual is also available online.


Zhang, Y., Korolija, I (2010) “Performing complex parametric simulations with jEPlus”, SET2010 - 9th International Conference on Sustainable Energy Technologies, 24-27 August 2010, Shanghai, China pdf (444.89 KiB, 8 downloads)

Zhang, Y. (2009) “‘Parallel’ EnergyPlus and the development of a parametric analysis tool”, IBPSA BS2009, 27–30 July 2009, Glasgow, UK pdf (195.33 KiB, 11 downloads)

See also:

  • jCFX5 - the Java shell for Ansys CFX (version 5 and above)
  • Psychrometric Calculator - A pocket psychrometric calculator (run on your mobile phone) for HVAC engineers
  • PMV/PPD Calculator - this mobile phone utility calculate ISO7730 PMV/PPD for the given conditions

Return to main page