ODLInfo

This plugin retrieves the Gamma-Ortsdosisleistung (ODL) in µSv/h (and some more information) from measuring stations in Germany. For more information see https://odlinfo.bfs.de. From version 1.5.2 it uses the novel interface, described in detail at https://odlinfo.bfs.de/ODL/DE/service/datenschnittstelle/datenschnittstelle_node.html. Also take care to read the terms of use at https://www.imis.bfs.de/geoportal/resources/sitepolicy.html.

Requirements

This plugin requires lib requests. You can install this lib with:

sudo pip3 install requests --upgrade

All mappings to items need to be done via your own logic.

Forum thread to the plugin: https://knx-user-forum.de/forum/supportforen/smarthome-py/986480-odlinfo-plugin-f%C3%BCr-strahlungsdaten

The odlinfo measuring point identifier can be retrieved by selecting your station on the map on https://odlinfo.bfs.de and looking in the URL of the station, e.g. for 86949 Windach: https://odlinfo.bfs.de/DE/aktuelles/messstelle/091811461.html => id = 091811461

Alternatively you can use the webinterface of the plugin to determine the international measuring point id (e.g. DEZ1419) or the odlinfo measuring point identifier (e.g. 091811461). Both can be used for the methods provided by this plugin.

Take care not to request the interface too often, e.g. only once every hour (cycle = 3600). Data sets are typically updated hourly.

The data provided by odlinfo is copyrighted by Bundesamt für Strahlenschutz (BfS), Willy-Brandt-Straße 5, 38226 Salzgitter, Deutschland Do not directly link the data interface / URL of ODLINFO in any context.

Nutzung der Daten / Terms of Service

(in German only - most recent version see https://www.imis.bfs.de/geoportal/resources/sitepolicy.html and https://odlinfo.bfs.de/ODL/DE/service/downloadbereich/downloadbereich_node.html)

Bei der Nutzung der vom Bundesamt für Strahlenschutz erhobenen Daten ist zu beachten:

Das Bundesamt für Strahlenschutz ist Urheber der ODL-Messnetz-Daten soweit diese nicht anders gekennzeichnet sind. Es wird insbesondere vorsorglich auf den Inhalt der § 62, § 63 des Urheberrechtsgesetz (UrhG) hingewiesen:

Bei der Nutzung der Daten ist es grundsätzlich verboten, sie selbst, ihren Inhalt, ihren Titel oder die Urheberbezeichnung zu ändern, § 62 Absatz 1 UrhG. Zulässige Änderungen ergeben sich allein aus dem Inhalt des § 62 Absatz 2 und Abs. 3 UrhG. Bei der Nutzung der Daten oder der auf ihnen beruhenden Applikationen ist in Anerkennung der jeweiligen Urheberschaft die Quelle deutlich anzugeben, also der Name des jeweiligen Urhebers sowie die Fundstelle, § 63 Absatz 1 UrhG.

Die Nichteinhaltung der Bestimmungen des Urheberrechts stellt eine Rechtsverletzung dar. Für diesen Fall behält sich das BfS vor, zu ihrer Durchsetzung rechtliche Maßnahmen zu ergreifen. Mit dem Herunterladen und Speichern der Daten erkennt der Nutzer die Nutzungsbedingungen an. Im Übrigen wird an dieser Stelle ausdrücklich auf die rechtlichen Hinweise des Internetangebots des Bundesamtes für Strahlenschutz hingewiesen. Es ist zu beachten, dass das technische Verfahren der Bereitstellung der Daten und das verwendete Format noch nicht abschließend festgelegt ist, es kann jederzeit und ohne Vorankündigung geändert werden.

Angesichts der Sensibilität des Themas bittet das BfS darum, die Daten der Gamma-Ortsdosisleistung im Rahmen einer möglichen Veröffentlichung in sachlicher Art und Weise darzustellen. Auf Rückfrage unterstützt sie das BfS gerne bei fachlichen Erklärungen und wissenschaftlichem Hintergrundwissen.

Daten

Die ODL-Tagesmittelwerte auf dieser Seite sind geprüft und mit einem Schlüssel versehen, der die Originalität der Daten verifiziert. Tagesmittelwerte werden nur gebildet, wenn die Station den ganzen Tag betriebsbereit war und mindestens 80 Prozent der Einzelwerte vorhanden und fehlerfrei sind. Unplausible Messwerte und damit Lücken in den Zeitreihen ergeben sich unter anderem durch:

Qualitätssicherungsmessungen, bei denen eine radioaktive Quelle für 30 Minuten an der Sonde befestigt war fehlerhafte Komponenten oder externe Störungen (zum Beispiel Schaltvorgänge bei benachbarten Industrieanlagen) die einzelne Peaks mit sehr hoher Amplitude bewirken können (siehe hierzu Menüpunkt Messwertinterpretation) langfristige Stromausfälle (mehr als zwei Tage) Wartungsarbeiten oder Sondentausch

Sprünge in der Zeitreihe, bei denen sich das Niveau langfristig ändert, können durch Erdarbeiten nahe der Sonde oder durch sonstige Veränderungen der Umgebungsbedingungen verursacht sein. Kleinere Differenzen sind auch sichtbar, wenn veraltete Sonden erneuert wurden. Im Rahmen der Messnetzpflege kommt es ständig zu Verlegungen von Sondenstandorten. Dies führt dazu, dass einzelne Zeitreihen abrupt enden.

Configuration

plugin.yaml

odlinfo:
    class_name: ODLInfo
    class_path: plugins.odlinfo
    cycle: 3600
    verify: True

items.yaml

Example:

outside:

    radiation: #this item will be updated via logic
        type: num
        cache: 'yes'

        wessling: #these items will be auto updated by the plugin, using the international and odlinfo id
            radiation: 
                type: num
                odl_station: '091881441'
                odl_data_type: 'value'

            radiation_terrestrial:
                type: num
                odl_station: '091881441'
                odl_data_type: 'value_terrestrial'

            radiation_cosmic:
                type: num
                odl_station: 'DEZ1453'
                odl_data_type: 'value_cosmic'

Functions

get_stations_for_ids(odlinfo_ids):

Gets a list of measuring stations (incl. radiation values) and according stations to an array of internal odlinfo_ids Dict keys per station entry: ‚id‘, ‚kenn‘, ‚plz‘, ‚name‘, ‚site_status‘, ‚site_status_text‘, ‚kid‘, ‚height_above_sea‘, ‚start_measure‘, ‚end_measure‘, ‚value‘, ‚value_cosmic‘, ‚value_terrestrial‘, ‚unit‘, ‚validated‘, ‚nuclide‘, ‚duration‘ Description see https://odlinfo.bfs.de/ODL/DE/service/datenschnittstelle/datenschnittstelle_node.html

sh.odlinfo.get_stations_for_ids(['010620461','091811461']) # station Meddewade and Windach

get_station_for_id(odlinfo_id)

Gets a measuring station (incl. radiaton value) to an internal odlinfo_id Dict keys per station entry: ‚id‘, ‚kenn‘, ‚plz‘, ‚name‘, ‚site_status‘, ‚site_status_text‘, ‚kid‘, ‚height_above_sea‘, ‚start_measure‘, ‚end_measure‘, ‚value‘, ‚value_cosmic‘, ‚value_terrestrial‘, ‚unit‘, ‚validated‘, ‚nuclide‘, ‚duration‘ Description see https://odlinfo.bfs.de/ODL/DE/service/datenschnittstelle/datenschnittstelle_node.html

sh.odlinfo.get_station_for_id('091811461') # station Windach

Logics

Fill item with radiation data

station_data = sh.odlinfo.get_station_for_id('091811461') # station Windach
sh.outside.radiation(station_data['value'])