Question-and-Answer Resource for the Building Energy Modeling Community
Get started with the Help page
Ask Your Question

Revision history [back]

I don't have a windows machine, so the paths are going to look at bit different, but the same principles applies.

First, prior to v8.4 EnergyPlus uses to be run in command line using an (archaic) batch file. This is no longer the case, and EnergyPlus now has a proper Command Line Interface (or 'cli'), which documentation can be found here.

If the energyplus isn't in your PATH, you'll need to use the full path (on mac that's /Applications/EnergyPlus-8-7-0/energyplus):

Display the help:

energyplus --help

Run a model test.idf in the current directory, with a weather file called weather.epw in the current directory as well, and output to a directory named out-test:

energyplus -w weather.epw -o out-test/ test.idf

By default it picks up the Energy+.idd from the same folder as where the energyplus executable is (so /Applications/EnergyPlus-8-7-0/Energy+.idd in my case). If you need to supply another one, use -i path_to_Energy+.idd (or --idd)

Obviously, all paths above can be made absolute if there aren't in current directory, or can be made relative. Here's a mixed example:

energyplus \
   --idd /Users/julien/Software/Others/EnergyPlus-build/Products/Energy+.idd \ # Absolute path
   -w ../Weather/weather.epw \   # Relative path (one folder up, then inside Weather/)
   -d out-test/ \   # Current directory (relative path too)
   test.idf   # Current directory

I don't have a windows machine, so the paths are going to look at bit different, but the same principles applies.I'm not 100% sure the CLI is available on Windows or not, hopefully it is... Otherwise what I'm saying doesn't apply to you...

First, prior to v8.4 EnergyPlus uses to be run in command line using an (archaic) batch file. file (the one you're using). This is no longer the case, case (on Unix at least), and EnergyPlus now has a proper Command Line Interface (or 'cli'), which documentation can be found here.

If the energyplus isn't in your PATH, you'll need to use the full path (on mac that's /Applications/EnergyPlus-8-7-0/energyplus):

Display the help:

energyplus --help

Run a model test.idf in the current directory, with a weather file called weather.epw in the current directory as well, and output to a directory named out-test:

energyplus -w weather.epw -o out-test/ test.idf

By default it picks up the Energy+.idd from the same folder as where the energyplus executable is (so /Applications/EnergyPlus-8-7-0/Energy+.idd in my case). If you need to supply another one, use -i path_to_Energy+.idd (or --idd)

Obviously, all paths above can be made absolute if there aren't in current directory, or can be made relative. Here's a mixed example:

energyplus \
   --idd /Users/julien/Software/Others/EnergyPlus-build/Products/Energy+.idd \ # Absolute path
   -w ../Weather/weather.epw \   # Relative path (one folder up, then inside Weather/)
   -d out-test/ \   # Current directory (relative path too)
   test.idf   # Current directory

I don't have a windows machine, so I'm not 100% sure the CLI is available on Windows or not, hopefully it is... Otherwise what I'm saying doesn't apply to you...

First, prior to v8.4 EnergyPlus uses to be run in command line using an (archaic) batch file (the one you're using). This is no longer the case (on Unix at least), and EnergyPlus now has a proper Command Line Interface (or 'cli'), which documentation can be found here.

If the energyplus isn't in your PATH, you'll need to use the full path (on mac that's /Applications/EnergyPlus-8-7-0/energyplus):

Display the help:

energyplus --help

Run a model test.idf in the current directory, with a weather file called weather.epw in the current directory as well, and output to a directory named out-test:

energyplus -w weather.epw -o out-test/ test.idf

By default it picks up the Energy+.idd from the same folder as where the energyplus executable is (so /Applications/EnergyPlus-8-7-0/Energy+.idd in my case). If you need to supply another one, use -i path_to_Energy+.idd (or --idd)

Obviously, all paths above can be made absolute if there aren't in current directory, or can be made relative. Here's a mixed example:

energyplus \
   --idd /Users/julien/Software/Others/EnergyPlus-build/Products/Energy+.idd ~Software/Others/EnergyPlus-build/Products/Energy+.idd \ # Absolute path
   -w ../Weather/weather.epw \   # Relative path (one folder up, then inside Weather/)
   -d out-test/ \   # Current directory (relative path too)
   test.idf   # Current directory

I don't have a windows machine, so I'm not 100% sure the CLI is available on Windows or not, hopefully but I don't see any reason it is... Otherwise what I'm saying doesn't apply to you...wouldn't it's coded in C++ like the rest of E+ (CommandLineInterface.cc)

First, prior to v8.4 EnergyPlus uses to be run in command line using an (archaic) a batch file (the one you're using). This is no longer the case (on Unix at least), case, and EnergyPlus now has a proper Command Line Interface (or 'cli'), which documentation can be found here.

If the energyplus isn't in your PATH, you'll need to use the full path (on mac that's /Applications/EnergyPlus-8-7-0/energyplus):) or set your path correctly.

Display the help:

energyplus --help

Run a model test.idf in the current directory, with a weather file called weather.epw in the current directory as well, and output to a directory named out-test:

energyplus -w weather.epw -o out-test/ test.idf

By default it picks up the Energy+.idd from the same folder as where the energyplus executable is (so /Applications/EnergyPlus-8-7-0/Energy+.idd in my case). If you need to supply another one, use -i path_to_Energy+.idd (or --idd)

Obviously, all paths above can be made absolute if there aren't in current directory, or can be made relative. Here's a mixed example:

energyplus \
   --idd ~Software/Others/EnergyPlus-build/Products/Energy+.idd \ # Absolute path
   -w ../Weather/weather.epw \   # Relative path (one folder up, then inside Weather/)
   -d out-test/ \   # Current directory (relative path too)
   test.idf   # Current directory

I don't have a windows machine, so I'm not 100% sure the CLI is available on Windows or not, but I don't see any reason it wouldn't it's coded in C++ like the rest of E+ (CommandLineInterface.cc)

First, prior to v8.4 EnergyPlus uses to be run in command line using a batch file (the one you're using). This is no longer the case, and EnergyPlus now has a proper Command Line Interface (or 'cli'), which documentation can be found here.

If the energyplus isn't in your PATH, you'll need to use the full path (on mac that's /Applications/EnergyPlus-8-7-0/energyplus) or set your path correctly.

Display the help:

energyplus --help

Run a model test.idf in the current directory, with a weather file called weather.epw in the current directory as well, and output to a directory named out-test:

energyplus -w weather.epw -o out-test/ test.idf

By default it picks up the Energy+.idd from the same folder as where the energyplus executable is (so /Applications/EnergyPlus-8-7-0/Energy+.idd in my case). If you need to supply another one, use -i path_to_Energy+.idd (or --idd)

Obviously, all paths above can be made absolute if there aren't in current directory, or can be made relative. Here's a mixed example:

energyplus \
   --idd ~Software/Others/EnergyPlus-build/Products/Energy+.idd \ # Absolute path
   -w ../Weather/weather.epw \   # Relative path (one folder up, then inside Weather/)
   -d out-test/ \   # Current directory (relative path too)
   test.idf   # Current directory

If you really want to run Epl-run.bat, see the parameters its documentation here. If I decompose your query:

c:\>EnergyPlusV8-7-0\Epl-run = Program to run
c:\EnergyyPlusV8-7-0\Energy+.idd = **Don't pass this!**
c:\EnergyPlusV8-7-0\ExampleFiles\5ZoneAirCooled = contains the file with full path and no extensions for input files
c:\EnergyPlusV8-7-0\ExampleFiles\5ZoneAirCooled = contains the file with full path and no extensions for output files
idf = extension of the input file
"C:\EnergyPlusV8-7-0\WeatherData\USA_VA_Sterling-Washington.Dulles.Intl.AP.724030_TMY3.epw" = contains the file with full path and extension for the weather file

EP = a weather file is used
N = no pause
nolimit = no 250 columns limit in readVarsESO
N = Don't call convertESOMTR
N = Don't call csvProc
0 = ??
Y = ??

I don't have a windows machine, so I'm not 100% sure the CLI is available on Windows or not, but I don't see any reason it wouldn't it's coded in C++ like the rest of E+ (CommandLineInterface.cc)

First, prior to v8.4 EnergyPlus uses to be run in command line using a batch file (the one you're using). This is no longer the case, and EnergyPlus now has a proper Command Line Interface (or 'cli'), which documentation can be found here.

If the energyplus isn't in your PATH, you'll need to use the full path (on mac that's /Applications/EnergyPlus-8-7-0/energyplus) or set your path correctly.

Display the help:

energyplus --help

Run a model test.idf in the current directory, with a weather file called weather.epw in the current directory as well, and output to a directory named out-test:

energyplus -w weather.epw -o out-test/ test.idf

By default it picks up the Energy+.idd from the same folder as where the energyplus executable is (so /Applications/EnergyPlus-8-7-0/Energy+.idd in my case). If you need to supply another one, use -i path_to_Energy+.idd (or --idd)

Obviously, all paths above can be made absolute if there aren't in current directory, or can be made relative. Here's a mixed example:

energyplus \
   --idd ~Software/Others/EnergyPlus-build/Products/Energy+.idd \ # Absolute path
   -w ../Weather/weather.epw \   # Relative path (one folder up, then inside Weather/)
   -d out-test/ \   # Current directory (relative path too)
   test.idf   # Current directory

If you really want to run Epl-run.bat, see the parameters its documentation here. If I decompose your query:query, I think the problem is that you're passing the idd as the first argument, when the first argument should be the input file without extension. The batch should will look for the .ini and .idd in the current directory.

c:\>EnergyPlusV8-7-0\Epl-run = Program to run
c:\EnergyyPlusV8-7-0\Energy+.idd = **Don't pass this!**
c:\EnergyPlusV8-7-0\ExampleFiles\5ZoneAirCooled = contains the file with full path and no extensions for input files
c:\EnergyPlusV8-7-0\ExampleFiles\5ZoneAirCooled = contains the file with full path and no extensions for output files
idf = extension of the input file
"C:\EnergyPlusV8-7-0\WeatherData\USA_VA_Sterling-Washington.Dulles.Intl.AP.724030_TMY3.epw" = contains the file with full path and extension for the weather file

EP = a weather file is used
N = no pause
nolimit = no 250 columns limit in readVarsESO
N = Don't call convertESOMTR
N = Don't call csvProc
0 = ??
Y = ??

I don't have a windows machine, so I'm not 100% sure the CLI is available on Windows or not, but I don't see any reason it wouldn't it's coded in C++ like the rest of E+ (CommandLineInterface.cc)

First, prior to v8.4 EnergyPlus uses to be run in command line using a batch file (the one you're using). This is no longer the case, and EnergyPlus now has a proper Command Line Interface (or 'cli'), which documentation can be found here.

If the energyplus isn't in your PATH, you'll need to use the full path (on mac that's /Applications/EnergyPlus-8-7-0/energyplus) or set your path correctly.

Display the help:

energyplus --help

Run a model test.idf in the current directory, with a weather file called weather.epw in the current directory as well, and output to a directory named out-test:

energyplus -w weather.epw -o -d out-test/ test.idf

By default it picks up the Energy+.idd from the same folder as where the energyplus executable is (so /Applications/EnergyPlus-8-7-0/Energy+.idd in my case). If you need to supply another one, use -i path_to_Energy+.idd (or --idd)

Obviously, all paths above can be made absolute if there aren't in current directory, or can be made relative. Here's a mixed example:

energyplus \
   --idd ~Software/Others/EnergyPlus-build/Products/Energy+.idd \ # Absolute path
   -w ../Weather/weather.epw \   # Relative path (one folder up, then inside Weather/)
   -d out-test/ \   # Current directory (relative path too)
   test.idf   # Current directory

If you really want to run Epl-run.bat, see the parameters its documentation here. If I decompose your query, I think the problem is that you're passing the idd as the first argument, when the first argument should be the input file without extension. The batch should will look for the .ini and .idd in the current directory.

c:\>EnergyPlusV8-7-0\Epl-run = Program to run
c:\EnergyyPlusV8-7-0\Energy+.idd = **Don't pass this!**
c:\EnergyPlusV8-7-0\ExampleFiles\5ZoneAirCooled = contains the file with full path and no extensions for input files
c:\EnergyPlusV8-7-0\ExampleFiles\5ZoneAirCooled = contains the file with full path and no extensions for output files
idf = extension of the input file
"C:\EnergyPlusV8-7-0\WeatherData\USA_VA_Sterling-Washington.Dulles.Intl.AP.724030_TMY3.epw" = contains the file with full path and extension for the weather file

EP = a weather file is used
N = no pause
nolimit = no 250 columns limit in readVarsESO
N = Don't call convertESOMTR
N = Don't call csvProc
0 = ??
Y = ??