Skip to content

EnergyPlus Version Change

Jump to bottom
Kyle Benne edited this page Feb 26, 2016 · 38 revisions

Wiki ▸ EnergyPlus Version Change

EnergyPlus Migration

Procedure:

  • Create new ProposedEnergy+.idd. I do this by diffing previous version idd and new version idd and copying over changes.

  • Analyze diffs in idd versions and adjust the energyplus translator as needed to write valid idf files in the new version. Changes may also be made to the OpenStudio Model classes but they must not break the existing api.

  • Version translate idf files located in openstudiocore/resources/ using the EnergyPlus version translator.

  • Update various example files in openstudiocore/ruby/openstudio/examples which use find_energyplus.

  • Update various test files in openstudiocore/ruby/openstudio/examples/test which use find_energyplus.

  • Run unit tests and fix things that are broken.

  • Run regression tests in openstudio-resources, especially model simulation tests.

  • In openstudiocore/ruby/openstudio/sketchup_plugin/lib/CommandManager.rb, update the IDF import failure message instructing the user to upgrade the idf to the latest version.

  • In openstudiocore/ruby/openstudio/sketchup_plugin/lib/PluginManager.rb, update the energyplus_version method to return the latest version.

  • In top level CMakeLists.txt update ENERGYPLUS_VERSION.

  • In openstudiocore/CMakeLists.txt update E+ version

  • Update IddFile_GTest.cpp version strings.

  • Update RunManagerHelpers.rb version strings.

  • Update AdvancedRubyWorkflow1_Test.rb version strings.

  • Update AdvancedRubyWorkflow3_Test.rb version strings.

  • Update ParallelEnergyPlus_Test.rb version strings.

  • Update RunManagerWatcher_Test.rb version strings.

  • Version translate openstudiocore/resources/runmanager/5ZoneWarmest.idf

  • When field names change leave the field name unmodified in the Model API, but add a comment indicating the new name of the field in EnergyPlus. See here for example.

  • Update resource files in openstudiocore\resources\utilities\SqlFile, update SqlFileFixture.Regressions regression test.

Utilities

The following script can be helpful to apply the E+ transition program in a non interactive script.

#!/bin/bash

set +e

printf "full\nyes\nno\n $1 \n" | ./Transition-V8-4-0-to-V8-5-0

mv "`echo $1 | sed 's/\.idf/\.idfnew/'`" "$1"
rm "`echo $1 | sed 's/\.idf/\.VCpErr/'`"
Clone this wiki locally