Metainformationen zur Seite

Unterschiede

Hier werden die Unterschiede zwischen zwei Versionen angezeigt.

Link zu dieser Vergleichsansicht

Beide Seiten der vorigen RevisionVorhergehende Überarbeitung
plugins:foshkplugin:foshkplugin_generic_version [2025/02/26 16:56] – Oliver Engelplugins:foshkplugin:foshkplugin_generic_version [2025/03/06 21:33] (aktuell) – Oliver Engel
Zeile 3307: Zeile 3307:
 The only difference is that some configuration changes in the LoxBerry version can be made via a web form. In the generic version, console access and an editor are required for [b]all[/b] configurations.\\ The only difference is that some configuration changes in the LoxBerry version can be made via a web form. In the generic version, console access and an editor are required for [b]all[/b] configurations.\\
 As this is also necessary for advanced configurations (e.g. forwards) in the LoxBerry version, you can also do this in general.\\ As this is also necessary for advanced configurations (e.g. forwards) in the LoxBerry version, you can also do this in general.\\
 +
 +++++
 +
 +----
 +
 +{{anchor:sunhours}}
 +
 +++++ Improved sunshine duration calculation and other solar topics |
 +
 +**Improved sunshine duration calculation and other solar topics**
 +
 +By default, FOSHKplugin checks whether the reported solar radiation value is higher than 120W/m² for the calculation of the daily sunshine duration in each transmission interval and if so, this minute is added to the sunshine duration.\\
 +A better calculation according to [[https://github.com/Jterrettaz/sunduration|Jterrettaz]] with dynamic and location-dependent thresholds (as WeeWX and WSWin also do) is available if you set Sunduration\SUN_CALC = True in the config file and (important!) also specify the geographical coordinates under Coordinates\ALT (altitude), Coordinates\LAT (latitude) and Coordinates\LON (logitude):\\
 +
 +<code syntaxhighlighter-pre>
 +[Coordinates]
 +# coordinates are only needed for calculating cloudbase and sunhours or export to Awekas-API, clientraw.txt, Weather365.net
 +ALT =                           # altitude in m e.g. 53
 +LAT =                           # latitude in decimal grad e.g. 52.668759; North of the equator has no sign. South of the equator has a - sign.
 +LON =                           # longitude in decimal grad e.g. 13.266274; for longitudes left of Greenwich a - sign is needed.
 +</code>
 +
 +Sunduration\SUN_MIN can be used to specify the solar radiation threshold above which the detection is counted as sunshine. The calculation can be tweaked with Sunduration\SUN_COEF (default=0.92): too little sunshine recorded: decrease value; too much sunshine recorded: increase the SUN_COEF value:\\
 +
 +<code syntaxhighlighter-pre>
 +[Sunduration]
 +SUN_CALC = False                # enable for better sunhours calculation (LAT, LON needed), disable to use static threshold of 120W/m²
 +SUN_MIN = 0                     # from this value (W/m²) calculation starts
 +SUN_COEF = 0.92                 # adjustment factor also depends on the location
 +SUNSHINE_HOLD = 0               # Hold time in seconds for value sunshine, this time continues to be output sunshine = True, even if there is no sunshine (default: 0)
 +</code>
 +
 +For compatibility reasons, the conventional calculation with a threshold value of 120W/m² - i.e. Sunduration\SUN_CALC = False - is the standard. The standard calculation is performed without specifying the geographical coordinates.\\
 +\\
 +FOSHKplugin outputs a few more light-specific entities, which are briefly explained here:\\
 +\\
 +last_suncheck = timestamp of the last time a sunshine check was performed\\
 +last_suntime = timestamp when sunshine was last detected\\
 +sunhours = shows the duration of daily sunshine in hours (solarradiation >= 120W/m² or - with Sunduration\SUN_CALC = True - with dynamic, location-dependent threshold value)\\
 +sunmins = shows the duration of daily sunshine in minutes (solarradiation >= 120W/m² or - with Sunduration\SUN_CALC = True - with dynamic, location-dependent threshold value)\\
 +sunshine = represents the presence of sunshine; can be artificially extended with Sunduration\SUNSHINE_HOLD to prevent constant changes\\
 +theosunsr = Theoretical sunshine limit above which sunshine would be declared\\
 +srsum = daily solar radiation sum since midnight (00:00)\\
 +\\
  
 ++++ ++++