Twilight: Unterschied zwischen den Versionen

Twilight
Zweck / Funktion
	Virtuelles Gerät zur Berechnung der Dämmerungszustände für eine gegebene Position
Allgemein
Typ	Hilfsmodul
Details
Dokumentation	EN / DE
Support (Forum)	Unterstuetzende Dienste
Modulname	59_Twilight.pm
Ersteller	dietmar63 / Dietmar63
	Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Version vom 24. Januar 2015, 20:12 Uhr

Twilight ist ein Hilfsmodul, das für eine über Koordinaten spezifizierte Position diverse Dämmerungszustände, Zeiten und die Helligkeit berechnet und als Readings bereitstellt. Darüber hinaus werden auch, sofern spezifiziert, über die Yahoo Wetter-ID Wetterinformationen bereitgestellt bzw. in die Berechnungen mit einbezogen.

Voraussetzungen

Keine.

Anwendung

Define

define <name> Twilight <latitude> <longitude> [<indoor_horizon> [<Weather_Position>]]

Die Bedeutung der Parameter:

latitude / longitude: Geokoordinaten, für die die Werte berechnet werden sollen
indoor_horizon: Virtueller Horizont
Weather_Position: Yahoo Wetter-ID für den gewünschten Standort; der eingegebene Wert wird als "internal value" WEATHER gespeichert.

Attribute

Readings

Eine Auswahl der Readings, die das angelegte Twilight-Objekt enthält:

sr*

verschiedene Werte für den Sonnenaufgang ("sunrise"): astronomisch, bürgerlich, nautisch, ...

ss*

verschiedene Werte für den Sonnenuntergang ("sunset"): astronomisch, bürgerlich, nautisch, ...

nextEvent

Name des Ereignisses, das als nächstes eintreten wird (z. B. "ss_weather")

nextEventTime

Zeitpunkt, zu dem das (unter nextEvent benannte) nächste Ereignis eintreten wird

light

ein errechneter Helligkeitswert mit den folgenden möglichen Werten (zwischen 0 und 6):

0: Völlige Dunkelheit; relativer Sonnenstand zum Horizont: -18°
1: nautische Dämmerung; relativer Sonnenstand zum Horizont: zwischen -12° und -18°
2: astronomische Dämmerung; relativer Sonnenstand zum Horizont: zwischen -6° und -12°
3: bürgerliche Dämmerung; relativer Sonnenstand zum Horizont: zwischen 0° und -6°
4: "indoor"-Dämmerung; Sonnenstand zwischen indoor_horizon (sofern der Wert ungleich Null ist) und 0°
5: "Wetter"-Dämmerung; Sonnenstand zwischen indoor_horizon und einem virtuellen Wetter-Horizont (abhängig von der Angabe einer Weather_position)
6: "normales" Tageslicht

azimuth: Azimut; Horizontalwinkel des Sonnenstands (0°=Süden, 90%´°=Westen, usw.)
elevation: Höhe des Sonnenstands
twilight: Dämmerungswert, errechnet aus der Höhe des Sonnenstands. Der Wert geht von 0% bis 100% bei einem Sonnenstand zwischen -12° und 6° (also während der Dämmerungsphase).

Funktionen

twilight($twilight, $reading, $min, $max)

Funktion im Modul, um bei der Dämmerungsberechnung Minimal-/Maximalwerte ("frühestens/spätestens") spezifizieren und das Ergebnis beispielsweise in einem at weiterverarbeiten zu können.

Anwendungsbeispiel(e)

Kurzes Beispiel

Anwendung der Funktion twilight zur Zeitsteuerung:

define morgens at *{twilight("myTL","sr_indoor","7:30","9:00")} set Rollo on

Dieses at wird morgens zum Zeitpunkt sr_indoor des Twilight Objekts myTL - aber frühestens um 7:30 und spätestens um 9:00 Uhr - dem Gerät Rollo einen on-Befehl schicken. Das Objekt myTL muss natürlich vorher mit (beispielsweise)

define myTL Twilight 44.444444 8.888888 ...

definiert worden sein.

Ausführliches Beispiel

Twilight Anwendungsbeispiel mit detaillierten Erläuterungen

Links

...

@@ Zeile 26: / Zeile 26: @@
 === Attribute ===
+=== Readings ===
 Eine Auswahl der Readings, die das angelegte Twilight-Objekt enthält:
 ;sr*
@@ Zeile 60: / Zeile 62: @@
 === Funktionen ===
 :<code>twilight($twilight, $reading, $min, $max)</code>
-Funktion, um bei der Dämmerungsberechnung Minimal-/Maximalwerte ("frühestens/spätestens") spezifizieren zu können
+Funktion im Modul, um bei der Dämmerungsberechnung Minimal-/Maximalwerte ("frühestens/spätestens") spezifizieren und das Ergebnis beispielsweise in einem <code>at</code> weiterverarbeiten zu können.
 == Anwendungsbeispiel(e) ==