modelIrradianceVariableLocation
Information
Analytical model of the solar irradiance on an inclined plane without considering weather conditions. By default, only the direct irradiance is considered. The sun position (sun height and sun azimuth) is calculated according to the DIN 5034 algorithm, as described in [Quaschning2015], section 2.5, eqs. (2.22) to (2.28). The angle of incidence on the inclined plane is calculated by eq. (2.32) and the direct irradiance on the inclined plane by eq. (2.35).
Atmospheric attenuation
If useAirMass = false (default), the direct normal irradiance is equal to irradianceRef,
independent of the sun height, i.e., the atmospheric attenuation is not considered. All transmission factors of eq. (2.17) of
[Quaschning2015] are equal to one in this case.
As a consequence, the irradiance of an inclined plane facing the rising or setting sun changes abruptly at sunrise and sunset.
If useAirMass = true, the direct normal irradiance depends on the relative optical air mass
airMass. The air mass is calculated by the approximation of
[Kasten1989]:
airMass = 1 / (sin(sunHeight) + 0.50572 * (sunHeight/deg + 6.07995)^(-1.6364))
The extraterrestrial irradiance varies over the year due to the varying distance between sun and earth, see eq. (2.10) of [Quaschning2015]:
irradianceExtraterrestrialActual = irradianceExtraterrestrial * (1 + 0.0334 * cos(0.9855° * dayOfYear - 2.7198°))
The parameter irradianceExtraterrestrial is the solar constant, 1360.8 W/m² according to eq. (2.9) of
[Quaschning2015].
The attenuation of the direct normal irradiance is determined by the empirical relationship of
[Meinel1976]:
directIrradianceNormal = irradianceExtraterrestrialActual * 0.7^(airMass^0.678)
In this case, the parameter irradianceRef is not used.
The direct irradiance smoothly approaches (almost) zero at sunrise and sunset.
For the sun at the horizon, the air mass is approximately 38 and the direct normal irradiance is approximately
1.5 % of the extraterrestrial irradiance.
For the sun below the horizon, the direct normal irradiance is zero.
Diffuse and ground reflected irradiance
If useDiffuse = false (default), diffuse and ground reflected irradiance are not considered.
If useDiffuse = true, the diffuse irradiance on the horizontal is determined for a clear sky according to
[Liu1960]:
diffuseIrradianceHorizontal = irradianceExtraterrestrialActual * sin(sunHeight) * (0.271 - 0.294 * tau_b) tau_b = directIrradianceNormal / irradianceExtraterrestrialActual
The diffuse irradiance on the inclined plane is calculated by the isotropic sky model and the ground reflected irradiance
by the ground reflectance rho, see
[Duffie2013]:
diffuseIrradianceInclined = diffuseIrradianceHorizontal * (1 + cos(gamma)) / 2 reflectedIrradianceInclined = rho * (directIrradianceHorizontal + diffuseIrradianceHorizontal) * (1 - cos(gamma)) / 2
The output irradiance is the sum of the direct, diffuse and ground reflected irradiance on the inclined plane.
The clear sky model is intended to be used with useAirMass = true.
Clouds are not considered, i.e., the results represent a sunny day without clouds.
Parameters
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | startDay | 10 | Day |
| Integer | startMonth | 9 | Month |
| Integer | startYear | 2016 | Year |
| Integer | TimeZone | 1 | Time zone |
| Modelica.Units.SI.Angle | longitude | 0.2856929452589518 | Longitude |
| Modelica.Units.SI.Angle | latitude | 0.8418964085999744 | Latitude |
| Modelica.Units.SI.Irradiance | irradianceRef | 1000 | Reference solar irradiance (direct normal irradiance, if useAirMass = false) |
| Atmosphere | |||
| Boolean | useAirMass | false | Consider air mass dependent attenuation of direct normal irradiance, if true |
| Modelica.Units.SI.Irradiance | irradianceExtraterrestrial | 1360.8 | Solar constant, i.e., mean extraterrestrial irradiance, see [Quaschning2015], eq. (2.9) |
| Boolean | useDiffuse | false | Consider clear sky diffuse and ground reflected irradiance, if true |
| Real | rho | 0.2 | Ground reflectance (albedo) |
Connectors
| Type | Name | Default | Description |
|---|---|---|---|
| Modelica.Blocks.Interfaces.RealOutput | irradiance | Irradiance of inclined area | |
| Modelica.Blocks.Interfaces.RealInput | gamma | Inclination angle of area | |
| Modelica.Blocks.Interfaces.RealInput | azimuth | Azimuth of area |
Components
| Type | Name | Default | Description |
|---|---|---|---|
| Integer | startDayOfYear | Start day of year in simulation | |
| Integer | dayOfYear | Actual day of year | |
| Integer | daysOfYear | Total number of days of year | |
| Integer | year | Actual year | |
| Modelica.Units.SI.Angle | Jprime | Equivalent angle of the day of the year w.r.t. total number of days | |
| Real | delta_J | ||
| Real | timeequation_J | ||
| Modelica.Units.NonSI.Time_day | localTimeDays | Local time in days | |
| Integer | localDays | Local day | |
| Modelica.Units.SI.Time | localTime | Local time | |
| Modelica.Units.NonSI.Time_hour | localTimeHours | Local time in unit hours | |
| Modelica.Units.NonSI.Time_hour | LocalMeanTimeHours | Local mean time in unit hours | |
| Modelica.Units.NonSI.Time_hour | trueMeanTimeHours | True mean time in unit hours | |
| Modelica.Units.SI.Angle | hoursAngle | Hours angle | |
| Modelica.Units.SI.Angle | sunHeight | Sun height | |
| Modelica.Units.SI.Angle | sunAzimuth1 | Sun azimuth before 12 p.m. | |
| Modelica.Units.SI.Angle | sunAzimuth2 | Sun azimuth after 12 p.m. | |
| Modelica.Units.SI.Angle | sunAzimuth | Sun azimuth | |
| Modelica.Units.SI.Angle | angleOfIncidence | Angle of incidence between a vector in sun direction and a normal vector | |
| Modelica.Units.SI.Irradiance | irradianceExtraterrestrialActual | Extraterrestrial irradiance w.r.t. actual day of the year | |
| Real | airMass | Relative optical air mass (Kasten and Young 1989) | |
| Modelica.Units.SI.Irradiance | directIrradianceNormal | Direct normal irradiance | |
| Modelica.Units.SI.Irradiance | directIrradianceHorizontal | Direct irradiance on the horizontal in W/m^2 | |
| Modelica.Units.SI.Irradiance | directIrradianceInclined | Direct irradiance on the inclined plane in W/m^2 | |
| Modelica.Units.SI.Irradiance | diffuseIrradianceHorizontal | Diffuse irradiance on the horizontal in W/m^2 | |
| Modelica.Units.SI.Irradiance | diffuseIrradianceInclined | Diffuse irradiance on the inclined plane in W/m^2 | |
| Modelica.Units.SI.Irradiance | reflectedIrradianceInclined | Ground reflected irradiance on the inclined plane in W/m^2 |