Twilight: Unterschied zwischen den Versionen
(Erste Version der Seite) |
(Beschreibung erweitert) |
||
| Zeile 8: | Zeile 8: | ||
}} | }} | ||
[[Twilight]] ist ein Hilfsmodul, für eine über Koordinaten spezifizierte Position diverse Dämmerungszustände 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. | [[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 == | == Voraussetzungen == | ||
| Zeile 22: | Zeile 22: | ||
:Virtueller Horizont | :Virtueller Horizont | ||
;Weather_Position | ;Weather_Position | ||
:Yahoo Wetter-ID für den gewünschten Standort | :Yahoo Wetter-ID für den gewünschten Standort; der eingegebene Wert wird als "internal value" '''WEATHER''' gespeichert. | ||
=== Attribute === | === Attribute === | ||
Eine Auswahl der Readings, die das angelegte Twilight-Objekt enthält: | |||
;sr* | |||
:verschiedene Werte für den Sonnenaufgang ("'''s'''un'''r'''ise"): astronomisch, bürgerlich, nautisch, ... | |||
;ss* | |||
:verschiedene Werte für den Sonnenuntergang ("'''s'''un'''s'''et"): 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 === | === Funktionen === | ||
| Zeile 31: | Zeile 62: | ||
== Anwendungsbeispiel(e) == | == Anwendungsbeispiel(e) == | ||
Anwendung der Funktion ''twilight'' zur Zeitsteuerung: | |||
:<code>define morgens at *{twilight("myTL","sr_indoor","7:30:00","9:00:00")} set Rollo on</code> | |||
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) | |||
:<code>define myTL Twilight 44.444444 8.888888 ...</code> | |||
definiert worden sein. | |||
== Links == | == Links == | ||
* ... | |||
[[Kategorie:Code Snippets]] | |||
Version vom 9. Mai 2014, 12:56 Uhr
| Twilight | |
|---|---|
| Zweck / Funktion | |
| Virtuelles Gerät zur Berechnung der Dämmerungszustände für eine gegebene Position | |
| Allgemein | |
| Typ | Hilfsmodul |
| Details | |
| Dokumentation | EN / DE |
| Modulname | 59_Twilight.pm |
| Ersteller | dietmar63 / Dietmar63 |
| Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! | |
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
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, um bei der Dämmerungsberechnung Minimal-/Maximalwerte ("frühestens/spätestens") spezifizieren zu können
Anwendungsbeispiel(e)
Anwendung der Funktion twilight zur Zeitsteuerung:
define morgens at *{twilight("myTL","sr_indoor","7:30:00","9:00: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.
Links
- ...