CDCOpenData
| CDCOpenData | |
|---|---|
| Zweck / Funktion | |
| Abruf zuletzt gefallener und kurzfristig vorhergesagter Regenmengen für vorgegebene Orte. | |
| Allgemein | |
| Typ | Gerätemodul |
| Details | |
| Dokumentation | EN / DE Thema |
| Support (Forum) | Wettermodule |
| Modulname | 98_CDCOpenData.pm |
| Ersteller | JoWiemann (Forum /Wiki) |
| Wichtig: sofern vorhanden, gilt im Zweifel immer die (englische) Beschreibung in der commandref! | |
Diese Seite ist noch im Aufbau
Der Deutsche Wetterdienst (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 einige angrenzende Bereiche 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
Das Modul wird über den regulären FHEM-update Prozess bereitgestellt
Define
define <devicename> CDCOpenData
Attribute
Die Einstellung
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.