QPegel

A QGIS plugin for interactive hydrological sensor station discovery via Dict-API and push-based, real-time data visualization using the MQTT protocol.

The plugin was developed based on the PegelOnline and EDIS projects.

Usage Information

• This plugin is currently only usable with valid user data. If you are interested to use it, please contact edis@itzbund.de.

• A minimum QGIS version of 3.99 is required.

• To connect and receive data, a stable internet connection is required.

• If interested, find more detailed information in the Documentation

Installation via zip

1. Download the latest QPegel.zip from Github
2. In QGIS open from menu: Plugins → Manage and Install Plugins... → Install from ZIP
3. Choose downloaded zip
4. Click "Install Plugin"
5. Click Yes

6. For the next two screens, check the settings and click **OK**

7. Check for the QPegel logo in your QGIS toolbars. If necessary, add the "Plugins Toolbar" to your QGIS interface

Core Features

Station Search & Handling

Search: Integrated PegelOnline Dict-API (see the documentation here) for easy map- and parameter-based station search

Handling: subscribe, unsubscribe or remove selected stations

Visualization

Map: view stations and latest measurement in the map canvas

Plots: view data (updating automatically with new incoming data)

Example Workflow

Optional: Add PegelOnline WMS to your project: https://pegelonline.wsv.de/webservices/gis/wms/aktuell/mnwmhw?request=GetCapabilities&service=WMS&version=1.3.0 to see all available stations

1. User Authentification
   • fill in the user data and click Connect
2. Set request parmeters (Tab "Request")
   • define your AOI
     • click Draw Area of Interest
     • draw a polygon in the map
     • finish by right-clicking
   • add parameters
     • open Additional Parameters
     • add a river (located in your AOI!)
   • Info: if there is no parameter input, you will receive all existing stations
3. Click Send Request
   • Info: you can send multiple requests with different parameters, the new stations will be appended to the previously retrieved ones
4. Select Available Stations of Interest
5. Subscribe
   • the selected stations are added to the layer panel and will store incoming data (have a look in the attribute table later)
   • as soon as the first data arrives you can also see a label showing a small station statistic
6. Switch to the Tab "View Data"
   • choose a station
   • choose visible units (if >1 available)
7. Wait and see new data arrive...