You are on page 1of 3

CautionaryREADMEonVariableNameChanges.

BeginningwithV8.0.0.004EnergyPlusBetaversion,therehasbeenaMASSIVE(2800+)renamingof
outputvariablenames.ThisiseasilyhandledbytheTransitionprogram(Butremembertokeeptheold
V7.2idffilesforlaterbetareleasesastheserenamingchangesarethemselvessubjecttofinalreview
andfurtherchangeaswellasotherobjectsmaybeincludedintransitionforlaterbetas)BUTthereare
severalcaveatstonote:
1. Chiller/ChillerHeatervariableshavebeenforked.Thatis,ChillerHeatermodels(i.e.
ChillerHeater:Absorption:DirectFiredandChillerHeater:Absorption:DoubleEffectwillnowhave
outputvariablesbeginningwithChillerHeaterwhereasthechillerswillretaintheChillerprefix).
2. CondenseroutputvariablesnolongerretaintheirCondLoopidentitythesearenowPlant
SupplySideandPlantDemandSideprefixwhichmaybeabitconfusingassomeinputfiles
whichwereonlyreportingPlantLoopwillnowhaveadditionalvariablesreporting.
3. Allcoilvariableshavebeencollapsed.Thus,coilnamesmustnowbeuniqueacrosscoilsthis
checkhasbeenimplemented.
4. PlantLoop/CondenserLoopnowshowupasPlantSupplySideetc.
5. Enumeratedoutputswhichwerepreviouslynumberedbyappendingtothekeynamenowuse
numberedoutputvariablenames(seeCondFDNodalTemperaturesexamplebelow).Other
outputsofthistypealreadyfollowedthisrule.
6. Postprocessorcommandfiles(rvi)willbetransitionedasmuchaspossible,butyoumayneedto
manuallyeditthervifileduetovariableforkingandcollapsingandanywildcardingthatwas
usedinthervifile.
7. Althoughthenewnamesapplytotimeseriesoutputs,somepredefinedtableoutputsarebased
onthemandwillalsohavenewnamesforcolumnand/orrowtitles.
8. Seethefile"ReportVariablesV720toV800.csv"foracompletelistingofthechanges.The
filecontainsthenumberofvariablerenames,andtheneachlinehasoldname,newname
andsometimesathirdcolumn(whichcontainsspecialcommentsordirectionstothetransition
program).
Someexamplesfollow:
1. Forkedrenames.SomeofthelinesintheReportVariablesV720toV800.csvfilehavethree
columns,the3
rd
columnstartingwithForkeq.TheserepresenttheforkoftheChiller/Chiller
Heatervariables.Forexample,the3
rd
column:
Forkeq:Chiller:*
Forkeq:ChillerHeater:*
Withcontents:
OldName NewName
ChillerCondHeatTrans ChillerCondenserHeatTransferEnergy
ChillerCondHeatTrans ChillerHeaterCondenserHeatTransferEnergy
ChillerCondHeatTransRate ChillerCondenserHeatTransferRate
ChillerCondHeatTransRate ChillerHeaterCondenserHeatTransferRate
ChillerCondWaterInletTemp ChillerCondenserInletTemperature
ChillerCondWaterInletTemp ChillerHeaterCondenserInletTemperature

Here,tworowshavethesameoldnamebuttheforkcomesifthereareanyChillerHeater
objectsintheinputfile.Iftherearenochillers,thefirstrowrenamedoesnotneedtobedone.
Iftherearenochillerheaters,thesecondrowrenamedoesnotneedtobedone.Ifthereare
both,thenbothrenamesaredone.

2. CondFDNodalTemperatures.TheschemeforreportingCondFDnodaltemperatureschanged.
Previously,thekeyvalueoftheoutputvariabletoldwhichnodetoreport.Thishasnowchanged
sothateachtemperaturenodeistheoutputvariablename.Thetransitionprogramwillchange
any:
Output:Variable,*,CondFDNodalTemperature,hourly;
Intothenewformatusing10nodes.10nodesmayormaynotbeenough,youwillneedtolook
atthat.Thetransitionfortheabovewouldlooklike:
Output:Variable,*,CondFDSurfaceTemperatureNode1,hourly;
Output:Variable,*,CondFDSurfaceTemperatureNode2,hourly;
Output:Variable,*,CondFDSurfaceTemperatureNode3,hourly;
Output:Variable,*,CondFDSurfaceTemperatureNode4,hourly;
Output:Variable,*,CondFDSurfaceTemperatureNode5,hourly;
Output:Variable,*,CondFDSurfaceTemperatureNode6,hourly;
Output:Variable,*,CondFDSurfaceTemperatureNode7,hourly;
Output:Variable,*,CondFDSurfaceTemperatureNode8,hourly;
Output:Variable,*,CondFDSurfaceTemperatureNode9,hourly;
Output:Variable,*,CondFDSurfaceTemperatureNode10,hourly;

If,instead,youhadenteredthekeyvaluesascreatedbyEnergyPlus,e.g.,
Output:Variable,SurfaceNameNode#1,CondFDNodalTemperature,hourly;
Output:Variable,SurfaceNameNode#2,CondFDNodalTemperature,hourly;
Thesewillbeproperlytransitionedto:
Output:Variable,SurfaceName,CondFDSurfaceTemperatureNode1,hourly;
Output:Variable,SurfaceName,CondFDSurfaceTemperatureNode2,hourly;

3. Coiloutputs.Coiloutputshavebeencollapsed.Whatusedtobedifferentiatedbycoiltypeisno
longer.
OldName NewName
DXCoilLatentCoolingEnergy CoolingCoilLatentCoolingEnergy
DXCoilLatentCoolingRate CoolingCoilLatentCoolingRate
DXCoilRuntimeFraction CoolingCoilRuntimeFraction
DXCoilSensibleCoolingEnergy CoolingCoilSensibleCoolingEnergy
DXCoilSensibleCoolingRate CoolingCoilSensibleCoolingRate
VSAirtoAirHPLoadSideLatentCoolingEnergy CoolingCoilLatentCoolingEnergy
VSAirtoAirHPLoadSideLatentHeatTransferRate CoolingCoilLatentCoolingRate
WatertoAirHPLoadSideLatentCoolingEnergy CoolingCoilLatentCoolingEnergy
WatertoAirHPLoadSideLatentHeatTransferRate CoolingCoilLatentCoolingRate

Thiscollapsenecessitatescheckingthateachcoilnameisuniqueacrossallcoils.
4. PlantLoopandCondenserLoopoutputs.PlantLoopandCondenserLoopoutputshavebeen
collapsedandchangedtouseSupplySideandDemandSideterminology.
OldName NewName
CondLoopInletTemp PlantSupplySideInletTemperature
PlantLoopInletTemp PlantSupplySideInletTemperature
CondLoopDemandSidePressureDrop PlantDemandSideLoopPressure
Difference
PlantLoopDemandSidePressureDrop PlantDemandSideLoopPressure
Difference

You might also like