meta data for this page

jEPlus User's Manual

Version 1.7, © 2016


jEPlus v1.7 (the software) is provided by Dr Yi Zhang free of charge for commercial or non-commercial use. It is provided 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 or his employer 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 software is released under GPLv3 (see link). The use of the software is done at your own discretion and risk and with agreement of the foregoing disclaimer.

New Features

The new features of jEPlus introduced in Version 1.7 include:

  • Python for pre-processing with @python() syntax
  • Sobol sampling function in addition to Latin Hypercube Sampling and Random shuffling methods
  • Added exponential and log-normal distributions to the @sample() syntax
  • New dialog for configuring external programs

Table of Contents

Chapter 1 Introduction – This chapter describes how jEPlus works with diagrams, and explains some of the key concepts and terminologies used in this users guide. Also covered are the things you need to know about installing the software.

Chapter 2 The GUI – Illustrated description of the graphical user interface, including the menu structure, the project tab, the execution tab, the utilities tab, and the output/editor pane. User controls are annotated on the screenshots.

Chapter 3 jEPlus Project – This chapter explains the contents of a jEPlus project, such as the model template files, weather files, the RVI/MVI files (the default method for E+ result collection), and the parameter tree. Also shown are GUI for TRNSYS and INSEL projects.

Chapter 4 Parameter Definition – This chapter is all about the jEPlus parameter definitions, and the various syntax you can use to specify the parameter values to be used in a parametric project.

Chapter 5 Result Extraction – jEPlus v1.7 provides more flexible and customisable ways of extracting results from simulations using the new RVX file. This chapter explains the syntax of the RVX file, and the use of ReadVarsEso, SQLite, CSV and Python scripts in result collection.

Chapter 6 Running Simulations – The simulation execution options jEPlus provides are described in this chapter. You can test and run a jEPlus project in various ways, such as using random sampling. The control of computing resource is explained here, too.

Chapter 7 Utilities – jEPlus includes a few useful tools to help you prepare your project and extract/post-process results. These utilities include an EnergyPlus version updater shell, a Python script tester/executor, and an E+ ReadVars executor.

Chapter 8 Using Python in jEPlus – You can use Python in more ways in jEPlus v1.7 than before. This chapter summarizes how to use Python scripts in pre-processing and post-processing stages, and tips on how to test your scripts in jEPlus.

Chapter 9 Interface with jEPlus – For advanced users, the command-line interface and the programming interface of jEPlus are explained in this chapter. Also covered are the use of the job list files, the parameter file and skeleton project.

Chapter 10 Examples – A few examples are described in this chapter, including the use of EP-Macro, and the different ways to parameterize window size.


I hope you enjoy using jEPlus. Should you have any inquiries or comments, or like to report issues and request new features, please visit the jeplus forum, or contact us at:


Please use the references below for citing jEPlus' works. More publications related to jEPlus can be found here.

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

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