Buildings.BoundaryConditions.Validation.UsersGuide
User's Guide
Information
The package Buildings.BoundaryConditions.Validation.BESTEST contains the models that are used for the BESTEST validation ASHRAE 2020 for weather data acquisition and postprocessing.
Each model represents a different climate with different days as shown in the tables below. All examples have a script that runs the simulation according to the specifications and derive the required Json file as reported below.
The weather radiation data has to be provided at different orientations and inclinations.
Table 2: Azimuth and Slope for Surfaces
Azimuth |
Slope |
Horizontal |
0° from horizontal |
South |
90° from horizontal |
East |
90° from horizontal |
North |
90° from horizontal |
West |
90° from horizontal |
45° East of South |
90° from horizontal |
45° West of South |
90° from horizontal |
East |
30° from horizontal |
South |
30° from horizontal |
West |
30° from horizontal |
Additional parameters and correlations
- Ground reflectance ρ is set to 0 for cases from WD100 to WD500 and 0.2 for WD600
- Sky black body temperature calculated using Horizontal radiation or dew point temperature and sky cover.
- Diffused radiation calculated using Perez and Isotropic sky models
Outputs required
Annual Outputs
The following outputs are provided for an annual simulation:
- Average dry bulb temperature (°C)
- Average relative humidity (%)
- Average dewpoint temperature (°C)
- Average humidity ratio (kg moisture/kg dry air)
- Average wet bulb temperature (°C)
- Sum of total, beam, and diffuse solar radiation incident on each surface (Wh/m2)
Hourly Outputs
The following outputs are provided for each hour of the days specified for each test case in Table 3:
- Dry bulb temperature (°C)
- Relative humidity (%)
- Dewpoint temperature (°C)
- Humidity ratio (kg moisture/kg dry air)
- Wet bulb temperature (°C)
- Windspeed (m/s)
- Wind direction (degrees from north)
- Station pressure (mbar)
- Total cloud cover (tenths of sky)
- Opaque cloud cover (tenths of sky)
- Sky temperature (°C)
- Sum of total, beam, and diffuse solar radiation incident on each surface (Wh/m2)
Table 3: Specific Days for Output
Case |
Days |
WD100 |
May 4th, July 14th, September 6th |
WD200 |
May 24th, August 26th |
WD300 |
February 7th, August 13th |
WD400 |
January 24th, July 1st |
WD500 |
March 1st, September 14th |
WD600 |
May 4th, July 14th, September 6th |
Sub-hourly Outputs
The following outputs are provided at each timestep of the days specified for each test case in Table 3:
- Dry bulb temperature (C)
- Relative humidity (%)
- Sum of total, beam, and diffuse solar radiation incident on each surface (Wh/m2)
The following outputs are provided integrated hourly for the days specified for each test case in Table 3:
- Total incident horizontal solar radiation (Wh/m2)
- Total incident horizontal beam solar radiation (Wh/m2)
- Total incident horizontal diffuse solar radiation (Wh/m2)
Validation results
(Not available yet)
Implementation
To generate the data shown in this user guide, run
cd Buildings/Resources/Data/BoundaryConditions/Validation/BESTEST python3 generateResults.py -p
At the beginning of the Python script there are several options that the user can choose, by default the script will:
- Clone the last master branch of the Buildings repository into a temporary directory
- Execute all the simulations and create the folders with the .mat and .json files inside the BESTEST/Simulations folder
References
(Not available yet)
Extends from Modelica.Icons.Information (Icon for general information packages).