The Input Macros feature increases the flexibility of the
EnergyPlus input files. This feature is intended for advanced
users who are already familiar with EnergyPlus IDF files and
need to prepare input manually. The basic capabilities
are:
Incorporating external files containing pieces of IDF
into the main EnergyPlus input stream.
Selectively accepting or skipping portions of the
input.
Defining a block of input with parameters and later
referencing this block.
Performing arithmetic and logical operations on the
input.
Input macro debugging and listing control.
These capabilities are invoked in the EP-MACRO program by
using macro commands. Macro commands are preceded by ## to
distinguish them from regular EnergyPlus input commands. After
execution by the EP-MACRO processor, macro commands produce
regular lines of EnergyPlus input that are shown in the
resultant IDF file (out.idf) and,
subsequently, in the EnergyPlus echo print
(audit.out). Following are descriptions of
the macro commands associated with the above capabilities. A
detailed example of input macros is given at the end of this
section; you should review it before reading the macro command
descriptions.
Introduction[LINK]
The Input Macros feature increases the flexibility of the EnergyPlus input files. This feature is intended for advanced users who are already familiar with EnergyPlus IDF files and need to prepare input manually. The basic capabilities are:
Incorporating external files containing pieces of IDF into the main EnergyPlus input stream.
Selectively accepting or skipping portions of the input.
Defining a block of input with parameters and later referencing this block.
Performing arithmetic and logical operations on the input.
Input macro debugging and listing control.
These capabilities are invoked in the EP-MACRO program by using macro commands. Macro commands are preceded by ## to distinguish them from regular EnergyPlus input commands. After execution by the EP-MACRO processor, macro commands produce regular lines of EnergyPlus input that are shown in the resultant IDF file (out.idf) and, subsequently, in the EnergyPlus echo print (audit.out). Following are descriptions of the macro commands associated with the above capabilities. A detailed example of input macros is given at the end of this section; you should review it before reading the macro command descriptions.
Documentation content copyright © 1996-2026 The Board of Trustees of the University of Illinois and the Regents of the University of California through the Ernest Orlando Lawrence Berkeley National Laboratory. All rights reserved. EnergyPlus is a trademark of the US Department of Energy.
This documentation is made available under the EnergyPlus Open Source License v1.0.