CDCOpenData

Aus FHEMWiki
CDCOpenData
Zweck / Funktion
Abruf zuletzt gefallener und kurzfristig vorhergesagter Regenmengen für vorgegebene Orte.

Bitte nach "Anleitung" Vorlage:Infobox_Modul vervollständigen

Allgemein
Typ Inoffiziell
Details
Dokumentation siehe Forum
Modulname
Ersteller
Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref!

Diese Seite ist noch im Aufbau

Der DWD stellt auf den ftp-Seiten seines Climate Data Centers (CDC) Werte der pro Tag gefallenen Regenmengen zur Verfügung, die auf Regenradar-Messungen beruhen und deren Werte an die gemessenen Mengen der Wetterstation angeeicht wurden. Die räumliche Auflösung beträgt dabei 1 km, was die Daten für diejenigen interessant macht, die keine eigene Regenmengenmessung zur Verfügung haben.

Mit der gleichen räumlichen Auflösung sind auch Daten der vorhergesagten Niederschläge der nächsten 120 Minuten verfügbar. Es sind die gleichen Daten, die z.B. auch im Regenradarfilm der DWD WarnWetter-App als Film dargestellt werden.

Mit dem Modul 98_CDCOpenData.pm kann auf diese Daten zugegriffen werden. Zur Zeit liefert das Modul folgende Daten:

  • die Regenmenge der letzten N Tage (N konfigurierbar, default 5); update beim DWD täglich
  • die Regenmenge seit Mitternacht; update stündlich
  • die prognostizierten Regenintensitäten der nächsten 120 Minuten; update alle 5 Minuten

Die Werte werden für den akuellen 'Home'-Ort (soweit in global per latitude/longitude definiert) und für weitere konfigurierbare Orte in Deutschland und einigen angrenzenden Bereichen von Nachbarländern geliefert.

Anwendung

Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung u,U, zusätzliche Perl-Module, die nicht standardmäßig vorinstalliert sind und je nach Systemkonfiguration nachinstalliert werden müssen.

Vorbereitung

Da Modul wird über den regulären FHEM-update Prozess bereitgestellt

Define

define <devicename> CDCOpenData

Attribute

attr <devicename> enableDWDdata <rainByDay, rainSinceMidnight, rainRadarbyLocation>

Wählt aus, welche Daten periodisch abgefragt werden. Standardmäßig ist nichts ausgewählt.

attr <devicename> INTERVAL 300

Legt das Abfrage-Intervall fest. Der Standardwert ist 300 (Sekunden). Kleinster möglicher Wert ist 60. Wenn das Attribut cronTime gesetzt ist, wird INTERVAL deaktiviert.

attr <devicename> cronTime <* * * * *>

Falls gesetzt, bestimmt der cron-Ausdruck das Abfrageintervall.

attr <devicename> locations <[name:]latitude,longitude> [name:]latitude,longitude ...

Durch Leerzeichen getrennte Liste weiterer Orte, für die Daten zusätzlich zum Standard-Ort abgefragt werden. <name[:]> ist optional der "sprechende" Name des Ortes.

Anwendungsbeispiele

Beispiel zur Modul-Einrichtung