IDF Version Updater[LINK]
The transition programs have been written as console applications similar to EnergyPlus. However, that may not be the easiest for users who want to transition several versions or several files at one time. Thus the IDF Version Updater GUI application was created.
The IDF Version Updater lives in the folder with the multiple transition programs – see Figure 1. Note that this application is also available from the EP-Launch Utilities tab (utility: IDFVersionUpdater). If you need to convert files from older than V6.0, the transition program set will need to be downloaded before use. Once “IDF Version Updater” is selected from the Utilities pulldown list, click on the “Run IDF Version Updater” box and the single window shown below appears:
Using the program is quite simple. As the window indicates, you press “Choose File to Update” to select a file or list of files (see IDF Version Converter / Transition File Lists) to convert. If doing multiple transitions using a transition file list you also press the “Choose File to Update, a browse window will appear at the bottom of which is a pulldown list for the”Files of Type“. Select the”Text File With List of EnergyPlus Files (*.lst)" (see the section IDF Version Converter / Transition File Lists for format of this .lst file) option. Once a file is found, its version is checked and appears as the “Current Version“. By default, the latest”New Version“ will be selected by the program - you can override this by choosing a different file version as the end version. The “Update File” button will then be able to be selected and the conversion will be done. The audit from the multiple transitions will be able to be viewed once the process is complete. If you are doing multiple transitions (e.g., from V2.2 to V6), you can select the check box “Create Intermediate Files” and after each transition, a file for the resultant version will be created and labeled <filename>)_Vx.idf (where x is an abbreviated version number).
The converted file becomes the new <file>.idf and the original file is saved in the original folder as <file>_original.idf. To delete the original file instead of saving it, check the “Delete Original Files” checkbox.
IDF Version Updater Output Files and Descriptions.
| < filename > _Transition.audit |
This is the contents of what you would see on the screen if you sat and watched the transition process during a console run. If you convert multiple versions, all the messages are shown in this file. |
| < filename > .idf |
Converted results to the latest version or version selected. |
| < filename > _Vxxx.idf |
If you don’t select “create intermediate versions”, this will only be the original version. Otherwise will have each version. |
IDF Version Updater[LINK]
The transition programs have been written as console applications similar to EnergyPlus. However, that may not be the easiest for users who want to transition several versions or several files at one time. Thus the IDF Version Updater GUI application was created.
The IDF Version Updater lives in the folder with the multiple transition programs – see Figure 1. Note that this application is also available from the EP-Launch Utilities tab (utility: IDFVersionUpdater). If you need to convert files from older than V6.0, the transition program set will need to be downloaded before use. Once “IDF Version Updater” is selected from the Utilities pulldown list, click on the “Run IDF Version Updater” box and the single window shown below appears:
Transition GUI screen [fig:transition-gui-screen]
Using the program is quite simple. As the window indicates, you press “Choose File to Update” to select a file or list of files (see IDF Version Converter / Transition File Lists) to convert. If doing multiple transitions using a transition file list you also press the “Choose File to Update, a browse window will appear at the bottom of which is a pulldown list for the”Files of Type“. Select the”Text File With List of EnergyPlus Files (*.lst)" (see the section IDF Version Converter / Transition File Lists for format of this .lst file) option. Once a file is found, its version is checked and appears as the “Current Version“. By default, the latest”New Version“ will be selected by the program - you can override this by choosing a different file version as the end version. The “Update File” button will then be able to be selected and the conversion will be done. The audit from the multiple transitions will be able to be viewed once the process is complete. If you are doing multiple transitions (e.g., from V2.2 to V6), you can select the check box “Create Intermediate Files” and after each transition, a file for the resultant version will be created and labeled <filename>)_Vx.idf (where x is an abbreviated version number).
The converted file becomes the new <file>.idf and the original file is saved in the original folder as <file>_original.idf. To delete the original file instead of saving it, check the “Delete Original Files” checkbox.
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.