meta data for this page

jEPlus User's Manual

Version 1.6, © 2015


jEPlus v1.6 (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.6 include:

  • Project files now use relative paths by default
  • Import/export project in JSON format
  • jEPlus command-line executes JSON project directly
  • Jython is used as the script engine to handle in-line calculations (e.g. in the @calc syntax and RVX)
  • RVX enhancements - specify report frequency in RVI objects and option to include extracted CSV table in the combined table or not
  • RVX enhancements - read E+ tabular reports in CSV format, partially replaces the need for SQLite output
  • RVX enhancements - changes in Python script arguments
  • Improved Run Python utility for testing scripts and post-processing
  • Jython supports updated to 2.7
  • Menu commands for launching JESS Client and jEPlus+EA with the current project
  • Importing parameter definitions from CSV now handles ',' in value definitions correctly
  • Various bug fixes

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.6 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 Run 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 by 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 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 9 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