.BuildSysPro.BoundaryConditions.Solar.Utilities.SineH

Information

Return the sine of the solar elevation angle at (t0 + t) according to the longitude (in degrees) and the latitude (in degrees)

Hypothesis and equations

The function computing the sine of the solar elevation angle at (t0 + t) according to the longitude (in degrees) and the latitude (in degrees).

Output sin_h is a real in the interval [0; 1] and computed as:

1. sin(h)=sin(phi)*sin(delta)+cos(phi)*cos(delta)*cos(HA)
2. sin(h)=max(0, sin(h))

Where:

• phi: latitude converted in radians
• delta: sun declination in radians
• HA : hour angle in radians

Bibliography

H. BOUIA, "Amélioration du temps de calcul dans BuildSysPro par traitements numériques optimisés de la conduction et des calculs solaires", Note H-E14-2013-00715-FR, 03/2013.

Instructions for use

none

Known limits / Use precautions

none

Validations

Validated function - Hassan BOUIA 03/2013

--------------------------------------------------------------
Licensed by EDF under a 3-clause BSD-license
Copyright © EDF 2009 - 2023
BuildSysPro version 3.6.0
Author : Hassan BOUIA, EDF (2013)
--------------------------------------------------------------

Interface

function SineH
  input Real t0 = 0 "Time in seconds at t=0";
  input Modelica.Units.SI.Time t "Universal time in seconds";
  input Modelica.Units.NonSI.Angle_deg longitude "Longitude in degrees";
  input Modelica.Units.NonSI.Angle_deg latitude "Latitude in degrees";
  output Real sin_h "Sine of the solar elevation angle";
end SineH;

Revisions

Hassan Bouia 03/2013 : Simplification de l'écriture et adaptation au nouveau modèle MeteoFile

Benoît Charrier 01/2017 : Renommage de la sortie sinh en sin_h pour éviter toute confusion avec la fonction sinus hyperbolique de Modelica ayant le même nom