CDCOpenData: Unterschied zwischen den Versionen
KKeine Bearbeitungszusammenfassung |
K (Infobox ergänzt; diverse Korrekturen und Formatierungsänderungen) |
||
| (Eine dazwischenliegende Version von einem anderen Benutzer wird nicht angezeigt) | |||
| Zeile 1: | Zeile 1: | ||
{{Infobox Modul | {{Infobox Modul | ||
|ModPurpose= | |ModPurpose=Abruf zuletzt gefallener und kurzfristig vorhergesagter Regenmengen für vorgegebene Orte. | ||
|ModType=d | |||
|ModType= | |||
|ModCmdRef= | |ModCmdRef= | ||
|ModForumArea= | |ModForumArea=Wettermodule | ||
|ModFTopic= | |ModFTopic=134588 | ||
|ModTechName= | |ModTechName=98_CDCOpenData.pm | ||
|ModOwner= | |ModOwner=JoWiemann ({{Link2FU|94|Forum}}/[[Benutzer Diskussion:JoWiemann|Wiki]]) | ||
}} | }} | ||
'''Diese Seite ist noch im Aufbau''' | '''Diese Seite ist noch im Aufbau''' | ||
Der DWD stellt auf den [https://opendata.dwd.de/climate_environment/CDC/grids_germany/daily/radolan/ 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. | Der Deutsche Wetterdienst (DWD) stellt auf den [https://opendata.dwd.de/climate_environment/CDC/grids_germany/daily/radolan/ 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 [https://www.dwd.de/DE/leistungen/warnwetterapp/warnwetterapp.html DWD WarnWetter-App] als Film dargestellt werden. | 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 [https://www.dwd.de/DE/leistungen/warnwetterapp/warnwetterapp.html 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: | 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 der letzten N Tage (N konfigurierbar, default 5); update beim DWD täglich | ||
* die Regenmenge seit Mitternacht; update stündlich | * die Regenmenge seit Mitternacht; update stündlich | ||
* die prognostizierten Regenintensitäten der nächsten 120 Minuten; update alle 5 Minuten | * 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 | 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== | ==Anwendung== | ||
Aufgrund der unterschiedlichen vom DWD bereitgestellten Datenformate benötigt das Modul zur Dekodierung u | 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 === | ===Vorbereitung === | ||
Das Modul wird über den regulären FHEM-update Prozess bereitgestellt | |||
===Define === | ===Define === | ||
| Zeile 33: | Zeile 31: | ||
===Attribute=== | ===Attribute=== | ||
<code>attr <devicename> enableDWDdata <rainByDay, rainSinceMidnight, rainRadarbyLocation></code> | Die Einstellung | ||
:<code>attr <devicename> enableDWDdata <rainByDay, rainSinceMidnight, rainRadarbyLocation></code> | |||
wählt aus, welche Daten periodisch abgefragt werden. Standardmäßig ist nichts ausgewählt. | |||
:<code>attr <devicename> INTERVAL 300</code> | |||
<code>attr <devicename> INTERVAL 300</code> | 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. | ||
:<code>attr <devicename> cronTime <* * * * *></code> | |||
Falls gesetzt, bestimmt der cron-Ausdruck das Abfrageintervall. | Falls gesetzt, bestimmt der cron-Ausdruck das Abfrageintervall. | ||
<code>attr <devicename> locations <[name:]latitude,longitude> [name:]latitude,longitude ...</code> | :<code>attr <devicename> locations <[name:]latitude,longitude> [name:]latitude,longitude ...</code> | ||
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. | 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== | ==Anwendungsbeispiele== | ||
===Beispiel zur Modul-Einrichtung=== | ===Beispiel zur Modul-Einrichtung=== | ||
[[Kategorie:Wetterstationen]] | |||
Aktuelle Version vom 11. November 2023, 17:43 Uhr
| 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.