Buildings.BoundaryConditions.SolarGeometry

Package with models to compute solar geometry

Information

This package contains models to compute the solar geometry and incidence angles on tilted surfaces.

Extends from Modelica.Icons.VariantsPackage (Icon for package containing variants).

Package Content

Name	Description
IncidenceAngle	Solar incidence angle on a tilted surface
ProjectedShadowLength	Length 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

Buildings.BoundaryConditions.SolarGeometry.IncidenceAngle

Solar incidence angle on a tilted surface

Buildings.BoundaryConditions.SolarGeometry.IncidenceAngle

Information

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.

Extends from Modelica.Blocks.Icons.Block (Basic graphical layout of input/output block).

Parameters

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

Connectors

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

Modelica definition

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

Length of shadow projected onto a direction

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.

For a definition of the parameters, see the User's Guide Buildings.BoundaryConditions.UsersGuide. The surface azimuth is defined in Buildings.Types.Azimuth.

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.

Extends from Modelica.Blocks.Icons.Block (Basic graphical layout of input/output block).

Parameters

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]

Connectors

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

Modelica definition

block ProjectedShadowLength "Length 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( absFilNam) "Longitude"; parameter Modelica.SIunits.Angle lat(displayUnit="deg")= Buildings.BoundaryConditions.WeatherData.BaseClasses.getLatitudeTMY3( absFilNam) "Latitude"; parameter Modelica.SIunits.Time timZon(displayUnit="h")= Buildings.BoundaryConditions.WeatherData.BaseClasses.getTimeZoneTMY3(absFilNam) "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 final parameter String absFilNam = Buildings.BoundaryConditions.WeatherData.BaseClasses.getAbsolutePath(filNam) "Absolute path of the file"; 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.Sources.RealExpression pShaLen( y=noEvent(if abs(zen.zen) < 0.5*Modelica.Constants.pi then proShaLen.y else 0.0)) "Projected shadow length"; 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(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); connect(pShaLen.y, y); end ProjectedShadowLength;

Buildings.BoundaryConditions.SolarGeometry.ZenithAngle

Zenith angle

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.

Extends from Modelica.Blocks.Icons.Block (Basic graphical layout of input/output block).

Parameters

Type	Name	Default	Description
Angle	lat		Latitude [rad]

Connectors

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

Modelica definition

block ZenithAngle "Zenith angle" extends Modelica.Blocks.Icons.Block; parameter Modelica.SIunits.Angle lat "Latitude"; Modelica.Blocks.Interfaces.RealOutput y( final quantity="Angle", final unit="rad", displayUnit="deg") "Zenith angle"; WeatherData.Bus weaBus "Weather data"; protected Buildings.BoundaryConditions.SolarGeometry.BaseClasses.ZenithAngle zen(final lat=lat); equation connect(zen.zen, y); connect(weaBus.solDec, zen.decAng); connect(weaBus.solHouAng, zen.solHouAng); end ZenithAngle;