Buildings.BoundaryConditions.SolarGeometry

Name	Description
IncidenceAngle	Solar incidence angle on a tilted surface
ProjectedShadowLength	Lenght of shadow projected onto a direction
ZenithAngle	Zenith angle
Examples	Collection of models that illustrate model use and test models
BaseClasses	Package with base classes for Buildings.BoundaryConditions.SolarGeometry

This component computes the solar incidence angle on a tilted surface. For a definition of the parameters, see the User's Guide Buildings.BoundaryConditions.UsersGuide.

Parameters

Connectors

Modelica definition

Type	Name	Description
Angle	lat	Latitude [rad]
Angle	azi	Surface azimuth [rad]
Angle	til	Surface tilt [rad]

Type	Name	Description
output RealOutput	y	Incidence angle [rad]
Bus	weaBus	Weather data

block IncidenceAngle "Solar incidence angle on a tilted surface" extends Modelica.Blocks.Icons.Block; parameter Modelica.SIunits.Angle lat "Latitude"; parameter Modelica.SIunits.Angle azi "Surface azimuth"; parameter Modelica.SIunits.Angle til "Surface tilt"; Modelica.Blocks.Interfaces.RealOutput y( final quantity="Angle", final unit="rad", displayUnit="deg") "Incidence angle"; WeatherData.Bus weaBus "Weather data"; protected Buildings.BoundaryConditions.SolarGeometry.BaseClasses.Declination decAng "Declination angle"; Buildings.BoundaryConditions.SolarGeometry.BaseClasses.SolarHourAngle solHouAng "Solar hour angle"; Buildings.BoundaryConditions.SolarGeometry.BaseClasses.IncidenceAngle incAng( final lat=lat, final azi=azi, final til=til) "Incidence angle"; equation connect(incAng.incAng, y); connect(decAng.decAng, incAng.decAng); connect(solHouAng.solHouAng, incAng.solHouAng); connect(weaBus.cloTim, decAng.nDay); connect(weaBus.solTim, solHouAng.solTim); end IncidenceAngle;

Buildings.BoundaryConditions.SolarGeometry.ProjectedShadowLength

Information

This component computes the length of a shadow projected onto a horizontal plane into the direction that is perpendicular to the surface azimuth azi.

The parameter azi is the azimuth of the surface that is perpendicular to the direction of the view. For example, if azi=Buildings.Types.Azimuth.S, then one is looking towards South. Hence, in the Northern hemisphere, at noon, the length of the shadow is negative as one is looking towards South but the shadow is in ones back. Similarly, for azi=Buildings.Types.Azimuth.E, there is a shade of negative length in the morning, and of positive length in the afternoon. The example Buildings.BoundaryConditions.SolarGeometry.Examples.ProjectedShadowLength illustrates this.

The component requires as parameters the longitude, latitude and time zone. These can automatically be assigned by setting the parameter filNam to a weather data file, in which case these values are read from the weather data file.

Parameters

Connectors

Modelica definition

Type	Name	Default	Description
Length	h		Height of surface [m]
Angle	azi		Surface azimuth [rad]
Location
String	filNam	""	Name of weather data file (used to read longitude, latitude and time zone)
Angle	lon	Buildings.BoundaryConditions...	Longitude [rad]
Angle	lat	Buildings.BoundaryConditions...	Latitude [rad]
Time	timZon	Buildings.BoundaryConditions...	Time zone [s]

Type	Name	Description
output RealOutput	y	Projected shadow length [m]

block ProjectedShadowLength "Lenght of shadow projected onto a direction" extends Modelica.Blocks.Icons.Block; parameter String filNam="" "Name of weather data file (used to read longitude, latitude and time zone)"; parameter Modelica.SIunits.Angle lon(displayUnit="deg")= Buildings.BoundaryConditions.WeatherData.BaseClasses.getLongitudeTMY3( filNam) "Longitude"; parameter Modelica.SIunits.Angle lat(displayUnit="deg")= Buildings.BoundaryConditions.WeatherData.BaseClasses.getLatitudeTMY3( filNam) "Latitude"; parameter Modelica.SIunits.Time timZon(displayUnit="h")= Buildings.BoundaryConditions.WeatherData.BaseClasses.getTimeZoneTMY3(filNam) "Time zone"; parameter Modelica.SIunits.Length h "Height of surface"; parameter Modelica.SIunits.Angle azi "Surface azimuth"; Modelica.Blocks.Interfaces.RealOutput y( final quantity="Length", final unit="m") "Projected shadow length"; protected WeatherData.BaseClasses.LocalCivilTime locTim( final lon=lon, final timZon=timZon) "Local civil time"; WeatherData.BaseClasses.EquationOfTime eqnTim "Equation of time"; WeatherData.BaseClasses.SolarTime solTim "Solar time"; Utilities.Time.ModelTime modTim "Model time"; BaseClasses.Declination decAng "Declination angle"; Buildings.BoundaryConditions.SolarGeometry.BaseClasses.ZenithAngle zen( final lat=lat) "Solar zenith angle"; Modelica.Blocks.Math.Tan tan "Tangent of solar zenith angle"; Modelica.Blocks.Math.Gain shaLen(k=-h) "Length of shadow"; BaseClasses.SolarAzimuth solAzi( final lat=lat) "Solar azimuth"; Modelica.Blocks.Sources.Constant surAzi(final k=azi) "Surface azimuth"; Modelica.Blocks.Math.Add add( final k1=1, final k2=-1) "Angle between surface azimuth and solar azimuth"; Modelica.Blocks.Math.Cos cos "Cosine"; Modelica.Blocks.Math.Product proShaLen "Projected shadow length"; BaseClasses.SolarHourAngle solHouAng "Solar hour angle"; Modelica.Blocks.Logical.LessThreshold lessThreshold( final threshold=0.5*Modelica.Constants.pi) "Output zero if sun is below horizon"; Modelica.Blocks.Logical.Switch switch1 "Switch to select the output signal"; Modelica.Blocks.Sources.Constant zer(final k=0) "Zero output"; equation connect(tan.u, zen.zen); connect(tan.y, shaLen.u); connect(solAzi.zen, zen.zen); connect(add.u1, surAzi.y); connect(solAzi.solAzi, add.u2); connect(add.y, cos.u); connect(shaLen.y, proShaLen.u2); connect(proShaLen.u1, cos.y); connect(solHouAng.solHouAng, zen.solHouAng); connect(lessThreshold.u, zen.zen); connect(lessThreshold.y, switch1.u2); connect(switch1.u1, proShaLen.y); connect(zer.y, switch1.u3); connect(switch1.y, y); connect(modTim.y,locTim. cloTim); connect(modTim.y,eqnTim. nDay); connect(eqnTim.eqnTim, solTim.equTim); connect(locTim.locTim, solTim.locTim); connect(solHouAng.solTim, solTim.solTim); connect(decAng.nDay, modTim.y); connect(zen.decAng, decAng.decAng); connect(solAzi.decAng, decAng.decAng); connect(solAzi.solTim, solTim.solTim); end ProjectedShadowLength;

Buildings.BoundaryConditions.SolarGeometry.ZenithAngle

Information

This component computes the zenith angle, which is the angle between the earth surface normal and the sun beam. For a definition of the parameters, see the User's Guide Buildings.BoundaryConditions.UsersGuide.