Question-and-Answer Resource for the Building Energy Modeling Community
Get s tarted with the Help page
Ask Your Question

What are appropriate values for Temperature and Loads Convergence Tolerance?

asked 2015-08-18 07:13:56 -0600

antifx gravatar image

updated 2020-11-03 08:41:30 -0600

There is no default value in loads/temperature convergence tolerance. Tutorials recommend: for temperature (0.4 default); loads tolerances (0.04 default). In the most example files there is a Temperature convergence tolerance of 0.005. With this value I get the following severe error:

* Severe * CheckWarmupConvergence: Loads Initialization, Zone="zone1" did not converge after 25 warmup days.

* ~~~ * See Warmup Convergence Information in .eio file for details.

* ~~~ * ...Environment(RunPeriod)="GRAZ - AUT IWEC Data WMO#=112400"

* ~~~ * ..Max Temp Comparison = 0.22 vs Temperature Convergence Tolerance=5.00E-003 - Fail Convergence

* ~~~ * ..Min Temp Comparison = 0.21 vs Temperature Convergence Tolerance=5.00E-003 - Fail Convergence

Is a temperature convergence tolerance of 0.4 a proper value?

edit retag flag offensive close merge delete

2 Answers

Sort by ยป oldest newest most voted

answered 2015-08-18 08:19:42 -0600

Actually, there is a default for these convergence criteria. From the idd file, the convergence tolerance defaults are 0.04 and 0.4 for loads and temperature, respectively.

 N2 , \field Loads Convergence Tolerance Value
   \note Loads Convergence Tolerance Value is a fraction of load
   \type real
   \minimum> 0.0
   \maximum .5
   \default .04
 N3 , \field Temperature Convergence Tolerance Value
   \units deltaC
   \type real
   \minimum> 0.0
   \maximum .5
   \default .4

The use of 0.005 is not wrong, it's just very tight and would likely be met in most simulations. Changing the temperature convergence tolerance to 0.25 will eliminate these warnings.

What this tolerance looks at is the maximum temperature difference between warmup days. When all convergence tolerances are reached during warmup, the simulation will move on to the actual simulation (unless a minimum number of warmup days is specified).

The question is why did this simulation result in a large difference between one warmup day and another. You could investigate the reason by adding OutputDiagnostics:ReportDuringWarmup to your input file and plotting the zone temperatures for each warmup day. Look for a cyclic change in zone temperatures where every other day is the same, while days in between are different.

For example, if zone humidity control is specified, the warmup may use humidity control on one day, and then find that humidity control is not required on the following warmup day. Then humidity control is required again on the 3rd warmup day and the cycle repeats.

It's not a bad thing that the simulation did not find a very tight convergence solution, it's just that the simulation will proceed with these warmup results. Even a 0.2C temperature convergence is reasonable. For those simulations that cannot converge using a 0.5C criteria, one should certainly determine why that maximum criteria could not be met using the ReportDuringWarmup technique described above.

edit flag offensive delete link more

answered 2015-08-18 08:09:49 -0600

updated 2015-08-18 08:10:48 -0600

The EnergyPlus v8.3 IDD file gives a default of 0.4 for the Building object Temperature Convergence Tolerance Value field and 0.04 for the Loads Convergence Tolerance Value field. So yes, 0.4 is a proper value for temperature convergence.

edit flag offensive delete link more


Are these tolerances only used in warmup or also in simulation? I'm struggling with AirFlowWindows...

Jean Marais gravatar image Jean Marais  ( 2020-11-03 09:14:58 -0600 )edit

Your Answer

Please start posting anonymously - your entry will be published after you log in or create a new account.

Add Answer


Question Tools

1 follower


Asked: 2015-08-18 07:13:56 -0600

Seen: 1,290 times

Last updated: Nov 03 '20