BuildSysPro.IBPSA.BoundaryConditions.UsersGuide

# .BuildSysPro.IBPSA.BoundaryConditions.UsersGuide

User's Guide

## Information

This package contains models to read or compute boundary conditions, such as weather data, solar irradition and sky temperatures. The calculations follow the description in Wetter (2004), Appendix A.4.2.

#### Accessing weather data

The model IBPSA.BoundaryConditions.WeatherData.ReaderTMY3 can read TMY3 weather data for different locations. The documentation of that model explains how to add weather data for locations that are not distributed with the `IBPSA` library.

To access these weather data from the graphical model editor, proceed as follows:

1. Create an instance of IBPSA.BoundaryConditions.WeatherData.ReaderTMY3.

2. Create an instance of IBPSA.BoundaryConditions.WeatherData.Bus.

3. Draw a connection between these two instances.

4. Finally, to send weather data to an input connector of a model, connect the input connector of that model with the instance of IBPSA.BoundaryConditions.WeatherData.Bus. Some models connect to the whole weather data bus, such as IBPSA.BoundaryConditions.SolarGeometry.Examples.IncidenceAngle, in which case the connection will directly be drawn. Other models require only an individual signal from the weather data bus, such as IBPSA.BoundaryConditions.SkyTemperature.Examples.BlackBody. In this situation, Modelica modeling environments typically show a window that allows you to select what data from this weather data bus you want to connect with your model.

#### Conventions for surface azimuth and tilt

To compute the solar irradiation, parameters such as the surface azimuth and the surface tilt are defined as shown in the following three figures.

For the surface azimuth and tilt, the enumerations IBPSA.Types.Azimuth and IBPSA.Types.Tilt can be used.

Note that a ceiling has a tilt of 0 if they are facing straight upwards. This is correct because the solar irradiation on a ceiling construction is on the other-side surface, which faces upwards toward the sky. Hence, a construction is considered a ceiling from the view point of a person standing inside a room.

#### References

- Michael Wetter.
  Simulation-based Building Energy Optimization.
  Dissertation. University of California at Berkeley. 2004.

Generated at 2026-05-09T18:18:56Z by OpenModelicaOpenModelica 1.26.7 using GenerateDoc.mos