packageUsersGuide

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

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

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)

Revisions

• March 11, 2020, by Ettore Zanetti:
  first implementation of BESTEST weather validation