This package contains the models for the BESTEST validation
This package contains the models that were used for the BESTEST validation (ANSI/ASHRAE 2007). The basic model from which all other models extend from is Buildings.Rooms.Validation.BESTEST.Case600FF.
All examples have a script that runs an annual simulation and plots the results with the minimum, mean and maximum value listed in the ANSI/ASHRAE Standard 140-2007.
The script compares the following quantitiesHeating and cooling is controlled using the PI controller Buildings.Controls.Continuous.LimPID with anti-windup.
Hourly averaged values, and annual mean values, are computed using an instance of Modelica.Blocks.Math.Mean.
ANSI/ASHRAE. 2007. ANSI/ASHRAE Standard 140-2007, Standard Method of Test for the Evaluation of Building Energy Analysis Computer Programs.
Thierry Stephane Nouidui, Michael Wetter, and Wangda Zuo. Validation of the window model of the Modelica Buildings library. Proc. of the 5th SimBuild Conference, Madison, WI, USA, August 2012.
Extends from Modelica.Icons.ExamplesPackage (Icon for packages containing runnable examples).
Name | Description |
---|---|
Case600 | Case 600FF, but with dual-setpoint for heating and cooling |
Case600FF | Basic test with light-weight construction and free floating temperature |
Case610 | Case 600 with south shading |
Case620 | Case 600, but with windows on East and West side walls |
Case630 | Case 620, but with added overhang and sidefins |
Case640 | Case 600, but with heating schedule |
Case650 | Case 600, but cooling based on schedule, night venting, and no heating |
Case650FF | Case 600, no heating, no cooling, and ventilation as in case 650 |
Case900 | Case 600, but with high thermal mass |
Case900FF | Case 600FF, but with high thermal mass |
Case920 | Case 900, but with windows on East and West side walls |
Case940 | Case 900, but with heating schedule |
Case950 | Case 900, but cooling based on schedule, night venting, and no heating |
Case950FF | Case 900, but no heating, no cooling, and ventilation as in case 650 |
Case960 | Case 600, but with an unconditioned sun-space |
nStaRef=6 | Number of states in a reference material |
Data | This package contains the data for the BESTEST validation |
BaseClasses | Package with base classes for Buildings.Rooms.Validation.BESTEST |
constant Integer nStaRef = 6 "Number of states in a reference material";
Case 600FF, but with dual-setpoint for heating and cooling
This model is used for the basic test case 600 of the BESTEST validation suite. Case 600 is a light-weight building with room temperature control set to 20°C for heating and 27°C for cooling. The room has no shade and a window that faces south.
Extends from Case600FF (Basic test with light-weight construction and free floating temperature).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | Exterior wall | |
Generic | matFlo | Floor | |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Basic test with light-weight construction and free floating temperature
This model is used for the test case 600FF of the BESTEST validation suite. Case 600FF is a light-weight building. The room temperature is free floating.
Extends from Modelica.Icons.Example (Icon for runnable examples).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | Exterior wall | |
Generic | matFlo | Floor | |
Generic | soil | Soil properties | |
Generic | roof | Roof | |
StandardResultsFreeFloating | staRes | redeclare parameter Building... | Reference results from ASHRAE/ANSI Standard 140 |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 600 with south shading
This model is the case 610 of the BESTEST validation suite. Case 610 differs from case 600 in that the window has an overhang.
Two overhangs have been added, one for each window, because each window only sees its own overhang.
Extends from Buildings.Rooms.Validation.BESTEST.Case600 (Case 600FF, but with dual-setpoint for heating and cooling).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | Exterior wall | |
Generic | matFlo | Floor | |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 600, but with windows on East and West side walls
This model is the case 620 of the BESTEST validation suite. Case 620 differs from case 600 in that the west and east facing walls have a window, but there is no window in the south facing wall.
Extends from Buildings.Rooms.Validation.BESTEST.Case600 (Case 600FF, but with dual-setpoint for heating and cooling).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | Exterior wall | |
Generic | matFlo | Floor | |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 620, but with added overhang and sidefins
This model is case 630 of the BESTEST validation suite. Case 630 differs from case 620 in that the windows on the west and east walls have an overhang and side fins.
Extends from Buildings.Rooms.Validation.BESTEST.Case620 (Case 600, but with windows on East and West side walls).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | Exterior wall | |
Generic | matFlo | Floor | |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 600, but with heating schedule
This model is used for the basic test case 640 of the BESTEST validation suite. Case640 is the same as Case600, but with the following modifications:
Extends from Case600 (Case 600FF, but with dual-setpoint for heating and cooling).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | Exterior wall | |
Generic | matFlo | Floor | |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 600, but cooling based on schedule, night venting, and no heating
This model is used for the test case 650 of the BESTEST validation suite. Case650 is the same as Case600, but with the following modifications:
Extends from Case600 (Case 600FF, but with dual-setpoint for heating and cooling).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | Exterior wall | |
Generic | matFlo | Floor | |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 600, no heating, no cooling, and ventilation as in case 650
This model is used for the test case 650FF of the BESTEST validation suite. Case 650FF is identical to case 650, except that there is no heating and no cooling.
Extends from Case600FF (Basic test with light-weight construction and free floating temperature).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | Exterior wall | |
Generic | matFlo | Floor | |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 600, but with high thermal mass
This model is used for the basic test case 900 of the BESTEST validation suite. Case 900 is a heavy-weight building with room temperature control set to 20°C for heating and 27°C for cooling. The room has no shade and a window that faces south.
Extends from Case600 (Case 600FF, but with dual-setpoint for heating and cooling).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | extWalCase900 | Exterior wall |
Generic | matFlo | floorCase900 | Floor |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 600FF, but with high thermal mass
This model is used for the test case 900FF of the BESTEST validation suite. Case 900FF is a heavy-weight building. The room temperature is free floating.
Extends from Case600FF (Basic test with light-weight construction and free floating temperature).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | extWalCase900 | Exterior wall |
Generic | matFlo | floorCase900 | Floor |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 900, but with windows on East and West side walls
This model is the case 920 of the BESTEST validation suite. Case 920 differs from case 900 in that the west and east facing walls have a window, but there is no window in the south facing wall.
Extends from Buildings.Rooms.Validation.BESTEST.Case900 (Case 600, but with high thermal mass).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | extWalCase900 | Exterior wall |
Generic | matFlo | floorCase900 | Floor |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 900, but with heating schedule
This model is used for the basic test case 940 of the BESTEST validation suite. Case940 is the same as Case900, but with the following modifications:
Extends from Case900 (Case 600, but with high thermal mass).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | extWalCase900 | Exterior wall |
Generic | matFlo | floorCase900 | Floor |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 900, but cooling based on schedule, night venting, and no heating
This model is used for the test case 950 of the BESTEST validation suite. Case950 is the same as Case900, but with the following modifications:
Extends from Case900 (Case 600, but with high thermal mass).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | extWalCase900 | Exterior wall |
Generic | matFlo | floorCase900 | Floor |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 900, but no heating, no cooling, and ventilation as in case 650
This model is used for the test case 950FF of the BESTEST validation suite. Case 950FF is identical to case 950, except that there is no heating and no cooling.
Extends from Case900FF (Case 600FF, but with high thermal mass).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | extWalCase900 | Exterior wall |
Generic | matFlo | floorCase900 | Floor |
Generic | soil | Soil properties | |
Generic | roof | Roof |
Type | Name | Description |
---|---|---|
Bus | weaBus |
Case 600, but with an unconditioned sun-space
This model is used for the test case 960 of the BESTEST validation suite. Case 960 is a two zones building, whereas the south-facing zone is an unconditioned sun-space.
Extends from Buildings.Rooms.Validation.BESTEST.Case600 (Case 600FF, but with dual-setpoint for heating and cooling).
Type | Name | Default | Description |
---|---|---|---|
Angle | S_ | Buildings.Types.Azimuth.S | Azimuth for south walls [rad] |
Angle | E_ | Buildings.Types.Azimuth.E | Azimuth for east walls [rad] |
Angle | W_ | Buildings.Types.Azimuth.W | Azimuth for west walls [rad] |
Angle | N_ | Buildings.Types.Azimuth.N | Azimuth for north walls [rad] |
Angle | C_ | Buildings.Types.Tilt.Ceiling | Tilt for ceiling [rad] |
Angle | F_ | Buildings.Types.Tilt.Floor | Tilt for floor [rad] |
Angle | Z_ | Buildings.Types.Tilt.Wall | Tilt for wall [rad] |
Integer | nConExtWin | 1 | Number of constructions with a window |
Integer | nConBou | 1 | Number of surface that are connected to constructions that are modeled inside the room |
Generic | matExtWal | Exterior wall | |
Generic | matFlo | Floor | |
Generic | soil | Soil properties | |
Generic | roof | Roof | |
Brick120 | matLayPar | Construction material for partition walls | |
ExteriorWallCase900 | extWalCase900 | Exterior wall | |
FloorCase900 | floorCase900 | Floor |
Type | Name | Description |
---|---|---|
Bus | weaBus |