Macro Debugging and Listing Control[LINK]
##list
Turn on listing; echo of input lines on the OUTPUT file is enabled. This is the default condition.
##nolist
Turn off listing; echo of input lines on the output file is disabled.
##show
Start printing expanded line on output file. After this command, if a macro expansion was done, the expanded line is printed on the output file. In this way you can see the end result of macro expansions, which is the input as seen by the EnergyPlus Input processor.
##noshow
Stop printing expanded line on output file. This is the default condition.
##showdetail
Start printing each macro expansion. After this command, every time a macro expansion is done the result of the expansion is printed. This can produce lots of output.
##noshowdetail
Stop printing each macro expansion. This is the default condition.
##expandcomment
Comment fields may contain macro expansion directions. Following this command, the macros will be expanded in comments.
For example, you might have:
##set1 Location = “Colorado Springs, CO”
! Simulation run for Location[]
If ##expandcomment preceded the set1 command, then the output would look like:
! Simulation run for Colorado Springs, CO
##noexpandcomment
This does not expand macros in comment fields. This is the default condition.
##traceback
Give full traceback when printing an error message. After this command, if there is a EP-MACRO error, a full traceback of the macro expansions in progress is printed. This is the default condition.
##notraceback
Don’t give full traceback when printing an error message.
##write
Start writing expanded text into file 22. This is similar to ##show except that the expanded lines are written into file 22. Therefore, file 22 will contain only the text that will be seen by the EnergyPlus processor. This file is used only for debugging purposes. It allows you to see what the macro-processed input file looks like.
##nowrite
Stop writing expanded text into file 22. This is the default condition.
##symboltable
Prints table of current macro names. All of the macro names that are defined will be printed.
##clear
Clear all macro definitions. All the macro names defined up to this point will be deleted.
##reserve TEXT k NAMES l STACK m
Allocates memory.
Reserves k words of space in AA array for macro definition storage.
Reserves l positions in macro definition names table.
Reserves m words of stack space.
If used, the ##reserve command must precede all other macro commands in the EP-MACRO input. This command should be used only if one or more of the following error messages is received:
“Need more memory for storing macro definitions”
Use “##reserve TEXT nnnnnn” command to get more memory. Current value of nnnnnn is: _ _ _
“Macro table capacity exceeded”
Use “##reserve NAMES nnnnnn” command to get more memory. Current value of nnnnnn is: _ _ _
“Macro stack overflow”
Use “##reserve STACK nnnnnn” command to get more memory. Current value of nnnnnn is: _ _ _
##! <comment>
Allows you to enter comment lines inside a macro. <comment> is printed in the EP-MACRO echo but is not acted on by the macro processor.
Example:
This example shows the use of the ##set, ##include, ##eval and ##if commands. Let an external file called cities.idf contain the following text:
** ##if #*[ city[ ] EQS CHICAGO ]
Location,Chicago IL, !- Location Name
41.880, !- Latitude
-87.63, !- Longitude
-6.0, !- Time Zone
2.; !- Elevation {m}
##elseif #[ city[ ] EQS WASHINGTON ]
Location,Washington DC, !- Location Name
38.9, !- Latitude
-77.0, !- Longitude
-5.0, !- Time Zone
15.; !- Elevation {m}
##else
** ** ERROR — City Undefined
##endif
Then the EnergyPlus input
##set1 city[ ] CHICAGO
##include cities.idf
will be converted, after macro processing, to:
Location,Chicago IL, !- Location Name
41.880, !- Latitude
-87.63, !- Longitude
-6.0, !- Time Zone
2.; !- Elevation {m}
Macro Debugging and Listing Control[LINK]
##list
Turn on listing; echo of input lines on the OUTPUT file is enabled. This is the default condition.
##nolist
Turn off listing; echo of input lines on the output file is disabled.
##show
Start printing expanded line on output file. After this command, if a macro expansion was done, the expanded line is printed on the output file. In this way you can see the end result of macro expansions, which is the input as seen by the EnergyPlus Input processor.
##noshow
Stop printing expanded line on output file. This is the default condition.
##showdetail
Start printing each macro expansion. After this command, every time a macro expansion is done the result of the expansion is printed. This can produce lots of output.
##noshowdetail
Stop printing each macro expansion. This is the default condition.
##expandcomment
Comment fields may contain macro expansion directions. Following this command, the macros will be expanded in comments.
For example, you might have:
##set1 Location = “Colorado Springs, CO”
! Simulation run for Location[]
If ##expandcomment preceded the set1 command, then the output would look like:
! Simulation run for Colorado Springs, CO
##noexpandcomment
This does not expand macros in comment fields. This is the default condition.
##traceback
Give full traceback when printing an error message. After this command, if there is a EP-MACRO error, a full traceback of the macro expansions in progress is printed. This is the default condition.
##notraceback
Don’t give full traceback when printing an error message.
##write
Start writing expanded text into file 22. This is similar to ##show except that the expanded lines are written into file 22. Therefore, file 22 will contain only the text that will be seen by the EnergyPlus processor. This file is used only for debugging purposes. It allows you to see what the macro-processed input file looks like.
##nowrite
Stop writing expanded text into file 22. This is the default condition.
##symboltable
Prints table of current macro names. All of the macro names that are defined will be printed.
##clear
Clear all macro definitions. All the macro names defined up to this point will be deleted.
##reserve TEXT k NAMES l STACK m
Allocates memory.
Reserves k words of space in AA array for macro definition storage.
Reserves l positions in macro definition names table.
Reserves m words of stack space.
If used, the ##reserve command must precede all other macro commands in the EP-MACRO input. This command should be used only if one or more of the following error messages is received:
“Need more memory for storing macro definitions”
Use “##reserve TEXT nnnnnn” command to get more memory. Current value of nnnnnn is: _ _ _
“Macro table capacity exceeded”
Use “##reserve NAMES nnnnnn” command to get more memory. Current value of nnnnnn is: _ _ _
“Macro stack overflow”
Use “##reserve STACK nnnnnn” command to get more memory. Current value of nnnnnn is: _ _ _
##! <comment>
Allows you to enter comment lines inside a macro. <comment> is printed in the EP-MACRO echo but is not acted on by the macro processor.
Example:
This example shows the use of the ##set, ##include, ##eval and ##if commands. Let an external file called cities.idf contain the following text:
** ##if #*[ city[ ] EQS CHICAGO ]
Location,Chicago IL, !- Location Name
41.880, !- Latitude
-87.63, !- Longitude
-6.0, !- Time Zone
2.; !- Elevation {m}
##elseif #[ city[ ] EQS WASHINGTON ]
Location,Washington DC, !- Location Name
38.9, !- Latitude
-77.0, !- Longitude
-5.0, !- Time Zone
15.; !- Elevation {m}
##else
** ** ERROR — City Undefined
##endif
Then the EnergyPlus input
##set1 city[ ] CHICAGO
##include cities.idf
will be converted, after macro processing, to:
Location,Chicago IL, !- Location Name
41.880, !- Latitude
-87.63, !- Longitude
-6.0, !- Time Zone
2.; !- Elevation {m}
Documentation content copyright © 1996-2023 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.