modelBuildingShade
Extends from IDEAS.Buildings.Components.Shading.Interfaces.PartialShadingDevice.
Information
This model computes the shading cast by a building (or other object) at
distance L and relative height dh
on a window (or wall) with height hWin.
For a window this height corresponds to the window glazing height,
excluding the window frame.
Diffuse sky solar radiation is reduced
by computing a simplified view factor of the building,
which blocks the sky view.
Diffuse ground solar radiation is unaffected by this model.

Assumption and limitations
This model assumes that the obstructing object is very wide (infinite) compared to the window/wall and that it is parallel to the window. This model is inaccurate when this is not the case.
We assume that the opposite building is shaded or that its reflectivity is zero,
such that it does not reflect solar irradiation towards
the window.
Partial shading, e.g. when modelling treelines,
can be modelled by changing the value of parameter fraSha accordingly.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Boolean | controlled (from PartialShading) | true | if true, shading has a control input |
| Modelica.Units.SI.Area | A_glazing (from PartialShading) | Surface area of the glazing | |
| Modelica.Units.SI.Area | A_frame (from PartialShading) | Surface area of the frame | |
| Modelica.Units.SI.Angle | inc (from PartialShading) | Surface inclination | |
| Modelica.Units.SI.Temperature | Tenv_nom (from PartialShading) | 280 | Nominal temperature of environment |
| Modelica.Units.SI.Emissivity | epsSw_frame (from PartialShading) | Short wave solar absorption coefficient of the frame | |
| Modelica.Units.SI.Emissivity | epsLw_frame (from PartialShading) | Long wave solar absorption coefficient of the frame | |
| Modelica.Units.SI.Emissivity | epsLw_glazing (from PartialShading) | Long wave solar absorption coefficient of the glazing | |
| Modelica.Units.SI.Emissivity | epsSw_shading (from PartialShading) | 0.8 | Short wave emissivity of the shading object |
| Real | g_glazing (from PartialShading) | Nominal shading coefficient of the glazing | |
| Boolean | linCon (from PartialShading) | false | Linearise convective heat transfer |
| Boolean | linRad (from PartialShading) | false | Linearise radiative heat transfer |
| Boolean | haveBoundaryPorts (from PartialShading) | true | Include ports for setting boundary conditions |
| Boolean | haveFrame (from PartialShading) | A_frame*epsLw_frame > 0 | Frame enabled |
| Modelica.Units.SI.CoefficientOfHeatTransfer | hSha (from PartialShading) | 12 | Equivalent thermal conductance of the shading device |
| Real | fraSha | 1 | Fraction of the light that is shaded, e.g. smaller than 1 for shading cast by tree lines. |
| Real | fraSunDifSky | 1 - vieAngObj/(Modelica.Constants.pi/2) | Fraction of window area exposed to diffuse sun light |
| Window properties | |||
| Modelica.Units.SI.Angle | azi (from PartialShading) | Window azimuth angle | |
| Dimensions (see illustration in documentation) | |||
| Modelica.Units.SI.Length | L | Distance to object perpendicular to window | |
| Modelica.Units.SI.Length | dh | Height difference between top of object and top of window glazing | |
| Modelica.Units.SI.Length | hWin | 1 | Window height: distance between top and bottom of window glazing |
Connectors
Components
Revisions
-
July 18, 2022 by Filip Jorissen:
Refactored for #1270 for including thermal effect of screens. -
September 22, 2019 by Filip Jorissen:
Added assert that checks validity of parameterfraSunDifSky. See #843. -
April 10, 2019 by Filip Jorissen:
Revised computation offraSunDifSkyto avoid negative shading fractions. See #1007. -
February 21, 2019 by Filip Jorissen:
Added parametershaFrafor lowering shading fraction of the model. See #912. -
September 25, 2018 by Filip Jorissen:
Clarified meaning ofhWinand grouped parameters with reference to documentation. See #909. -
May 26, 2017 by Filip Jorissen:
Added computation of diffuse solar shading. See #735. -
May 25, 2017, by Filip Jorissen:
Fixed implementation for non-south oriented windows. -
December 9, 2016, by Filip Jorissen:
Fixed implementation for non-circular type building. -
July 14, 2015, by Filip Jorissen:
Added documentation. -
June 12, 2015, by Filip Jorissen:
First implementation.