Pages From InputOutputReference
Pages From InputOutputReference
0 Documentation
Build: f420c06a69
COPYRIGHT (c) 1996-2021 THE BOARD OF TRUSTEES OF THE UNIVERSITY OF ILLINOIS,
THE REGENTS OF THE UNIVERSITY OF CALIFORNIA THROUGH THE ERNEST ORLANDO
LAWRENCE BERKELEY NATIONAL LABORATORY, OAK RIDGE NATIONAL LABORATORY,
MANAGED BY UT-BATTELLE, ALLIANCE FOR SUSTAINABLE ENERGY, LLC, AND OTHER
CONTRIBUTORS. ALL RIGHTS RESERVED. NO PART OF THIS MATERIAL MAY BE REPRO-
DUCED OR TRANSMITTED IN ANY FORM OR BY ANY MEANS WITHOUT THE PRIOR WRIT-
TEN PERMISSION OF THE UNIVERSITY OF ILLINOIS OR THE ERNEST ORLANDO LAWRENCE
BERKELEY NATIONAL LABORATORY. ENERGYPLUS IS A TRADEMARK OF THE US DEPART-
MENT OF ENERGY.
Contents
1 Input-Output Reference 25
1.1 What’s different about EnergyPlus Input and Output? . . . . . . . . . . . . . . . . 25
1.1.1 EnergyPlus Input Processing . . . . . . . . . . . . . . . . . . . . . . . . . . 25
1.1.2 General Input Rules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 26
1.1.3 EnergyPlus Output Processing . . . . . . . . . . . . . . . . . . . . . . . . . 27
1.2 IDD Conventions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 27
1.2.1 IDD – IP Units . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 31
1.3 Input – Output Descriptions (Document) . . . . . . . . . . . . . . . . . . . . . . . . 33
1.3.1 Input Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 33
1.3.2 Output Descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 34
1.4 Using EnergyPlus as a Library . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 36
1.4.1 State API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
1.4.2 Functional API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 38
1.4.3 Runtime API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 39
1.4.4 Data Exchange API . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
1.4.5 Full Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.4.6 Building and Linking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.5 Group – Simulation Parameters . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 43
1.5.1 Version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
1.5.2 Timestep . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 44
1.5.3 ConvergenceLimits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
1.5.4 Building . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47
1.5.5 SurfaceConvectionAlgorithm:Inside . . . . . . . . . . . . . . . . . . . . . . . 54
1.5.6 SurfaceConvectionAlgorithm:Outside . . . . . . . . . . . . . . . . . . . . . . 55
1.5.7 HeatBalanceAlgorithm . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 56
1.5.8 HeatBalanceSettings:ConductionFiniteDifference . . . . . . . . . . . . . . . 57
1.5.9 ZoneAirHeatBalanceAlgorithm . . . . . . . . . . . . . . . . . . . . . . . . . 58
1.5.10 ZoneAirContaminantBalance . . . . . . . . . . . . . . . . . . . . . . . . . . 59
1.5.11 ShadowCalculation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 60
1.5.12 Output:Diagnostics . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 64
1.5.13 Output:DebuggingData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 65
1.5.14 Output:PreprocessorMessage . . . . . . . . . . . . . . . . . . . . . . . . . . 66
1.5.15 ZoneCapacitanceMultiplier:ResearchSpecial . . . . . . . . . . . . . . . . . . 66
1.5.16 SimulationControl . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 67
1.5.17 PerformancePrecisionTradeoffs . . . . . . . . . . . . . . . . . . . . . . . . . 69
1.5.18 HVACSystemRootFindingAlgorithm . . . . . . . . . . . . . . . . . . . . . . 77
2
CONTENTS 3
1.5.19 Meter:Custom . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 78
1.5.20 Meter:CustomDecrement . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 79
1.5.21 Custom Meter Examples . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 81
1.5.22 Simulation Parameter Outputs . . . . . . . . . . . . . . . . . . . . . . . . . 82
1.6 Group – Compliance Objects . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
1.6.1 Compliance:Building . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
1.7 Group – Location – Climate – Weather File Access . . . . . . . . . . . . . . . . . . 82
1.7.1 Site:Location . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 82
1.7.2 Site:VariableLocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 83
1.7.3 SizingPeriod:DesignDay . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 84
1.7.4 Longer Design Periods . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 93
1.7.5 SizingPeriod:WeatherFileDays . . . . . . . . . . . . . . . . . . . . . . . . . . 93
1.7.6 SizingPeriod:WeatherFileConditionType . . . . . . . . . . . . . . . . . . . . 95
1.7.7 RunPeriod . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 96
1.7.8 RunPeriodControl:SpecialDays . . . . . . . . . . . . . . . . . . . . . . . . . 100
1.7.9 RunPeriodControl:DaylightSavingTime . . . . . . . . . . . . . . . . . . . . . 101
1.7.10 WeatherProperty:SkyTemperature . . . . . . . . . . . . . . . . . . . . . . . 102
1.7.11 Site:WeatherStation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 104
1.7.12 Site:HeightVariation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 105
1.7.13 Site:GroundTemperature:BuildingSurface . . . . . . . . . . . . . . . . . . . . 107
1.7.14 Site:GroundTemperature:Shallow . . . . . . . . . . . . . . . . . . . . . . . . 107
1.7.15 Site:GroundTemperature:Deep . . . . . . . . . . . . . . . . . . . . . . . . . 108
1.7.16 Site:GroundTemperature:Undisturbed:FiniteDifference . . . . . . . . . . . . 108
1.7.17 Site:GroundTemperature:Undisturbed:KusudaAchenbach . . . . . . . . . . . 109
1.7.18 Site:GroundTemperature:Undisturbed:Xing . . . . . . . . . . . . . . . . . . 110
1.7.19 Site:GroundDomain:Slab . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 111
1.7.20 Site:GroundDomain:Basement . . . . . . . . . . . . . . . . . . . . . . . . . . 117
1.7.21 Site:GroundTemperature:FCfactorMethod . . . . . . . . . . . . . . . . . . . 122
1.7.22 Site:GroundReflectance . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 122
1.7.23 Site:GroundReflectance:SnowModifier . . . . . . . . . . . . . . . . . . . . . . 123
1.7.24 Site:WaterMainsTemperature . . . . . . . . . . . . . . . . . . . . . . . . . . 123
1.7.25 Site:Precipitation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 124
1.7.26 RoofIrrigation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 126
1.7.27 Solar and Visible Spectrum Objects . . . . . . . . . . . . . . . . . . . . . . . 126
1.7.28 Site:SolarAndVisibleSpectrum . . . . . . . . . . . . . . . . . . . . . . . . . . 127
1.7.29 Site:SpectrumData . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 127
1.7.30 Climate Group Outputs . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 128
1.7.31 Weather Data Related Outputs . . . . . . . . . . . . . . . . . . . . . . . . . 128
1.7.32 Outputs for local temperature/wind speed calculations . . . . . . . . . . . . 135
1.8 Group – Schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
1.8.1 Day Type . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 136
1.8.2 ScheduleTypeLimits . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 137
1.8.3 Day Schedules . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
1.8.4 Schedule:Day:Hourly . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 138
1.8.5 Schedule:Day:Interval . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 139
1.8.6 Schedule:Day:List . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 140
4 CONTENTS