Neues Plotsystem für FHEM

Begonnen von Prof. Dr. Peter Henning, 20 November 2026, 13:13:44

Vorheriges Thema - Nächstes Thema

Prof. Dr. Peter Henning

Ziel: Das etwas in die Jahre gekommene Plotsystem von FHEM zu modernisieren. Dabei sollen alle vorhandenen Features von 98_SVG.pm und 98_logProxy.pm erhalten bleiben und ergänzt werden.

Zum Rendern bleibe ich erst einmal bei SVG, das kann aber problemlos durch andere Renderer (z.B. eCharts) ersetzt werden.

Zunächst bezieht sich das auf die Plotdefinition. Dafür schlage ich ein YAML-Format vor, mit den folgenden Grundsätzen:
- Ein einfacher Plot soll mit möglichst wenigen Angaben auskommen.
- Datenquellen und grafische Objekte bleiben voneinander getrennt.
- Achsen und Koordinatensysteme werden bei Bedarf automatisch ergänzt.
- Komplexe Darstellungen dürfen explizit konfiguriert werden.
- Die YAML-Datei enthält keine unmittelbar auszuführenden Perl-Anweisungen.

Drei Beispiele. Im ersten Beispiel soll ein Zeitreihendiagramm mit Außen- und Innentemperatur aus verschiedenen Quellen gezeichnet werden
Zitatversion: 1
plot:
  title: Temperaturen

sources:
  outdoor:
    type: FileLog
    device: FileLog_Wetter
    reading: temperature

  indoor:
    type: DbLog
    device: Wohnzimmer
    reading: temperature

axes:
  x:
    type: time

  y:
    label: Temperatur
    unit: °C

objects:
  - type: line
    source: outdoor
    label: Außentemperatur
    color: "#0088cc"

  - type: line
    source: indoor
    label: Innentemperatur
    color: "#cc4400"

Im zweiten Beispiel soll ein allgemeines x-y-Diagramm gezeichnet werden, aus statisch vorgegebenen Daten. Und zwar Linie zuzüglich Punkten
Zitatversion: 1
plot:
  title: Strom-Spannungs-Kennlinie

sources:
  characteristic:
    type: static
    columns: [voltage, current]
    values:
      - [0.0, 0.0]
      - [0.5, 0.2]
      - [1.0, 0.8]
      - [1.5, 1.7]
      - [2.0, 3.1]
      - [2.5, 4.8]

axes:
  x:
    type: linear
    label: Spannung
    unit: V
    min: 0
    max: 3

  y:
    type: linear
    label: Strom
    unit: A
    min: 0
    max: 6

objects:
  - type: line
    source: characteristic
    x: voltage
    y: current
    label: Kennlinie
    color: "#0066cc"
    width: 2

  - type: points
    source: characteristic
    x: voltage
    y: current
    symbol: circle
    size: 4
    color: "#0066cc"

Selbstverständlich soll es auch möglich sein, die Datenwerte aus verschiedenen Readings gegeneinander zu plotten - in einer Datenaufbereitungsroutine werden unterschiedliche Zeitstempel behandelt.

Im dritten Beispiel soll für eine Wallbox dargestellt werden:
- Ladeleistung in kW.
- Netzbezug in kW.
- Batterieladezustand in Prozent.
- Eine horizontale Leistungsgrenze.
- Eine vertikale Markierung des Ladebeginns.
- Eine farbig hinterlegte Ladephase.

Zitatversion: 1

plot:
  title: Wallbox – Ladevorgang
  height: 400
  legend: bottom

sources:
  charging:
    type: FileLog
    device: FileLog_Wally
    reading: power

  grid:
    type: DbLog
    device: PowerFlow
    reading: grid_power

  soc:
    type: DbLog
    device: ID7
    reading: soc

axes:
  time:
    type: time
    position: bottom
    format: "%H:%M"
    grid: true

  power:
    type: linear
    position: left
    label: Leistung
    unit: kW
    min: 0
    grid: true

  battery:
    type: linear
    position: right
    label: Ladezustand
    unit: "%"
    min: 0
    max: 100

coordinates:
  charging:
    x: time
    y: power

  battery:
    x: time
    y: battery

objects:
  - id: charging_power
    type: line
    source: charging
    coordinates: charging
    label: Ladeleistung
    color: "#0088cc"
    width: 2

  - id: grid_power
    type: line
    source: grid
    coordinates: charging
    label: Netzbezug
    color: "#cc4400"
    width: 2

  - id: soc
    type: line
    source: soc
    coordinates: battery
    label: Ladezustand
    color: "#008800"
    width: 2

  - id: power_limit
    type: hline
    coordinates: charging
    y: 11
    label: Leistungsgrenze
    color: red
    dash: dashed

  - id: charging_start
    type: vline
    coordinates: charging
    x: "2026-11-20T10:30:00+01:00"
    label: Ladebeginn
    color: green

  - id: charging_period
    type: region
    coordinates: charging
    x:
      from: "2026-11-20T10:30:00+01:00"
      to: "2026-11-20T12:00:00+01:00"
    fill: "#ccffcc"
    opacity: 0.25

Das YAML-Konfigurationsformat umfasst also folgende Bereiche
Zitatversion: 1

plot: {}

sources: {}

datasets: {}

axes: {}

coordinates: {}

viewports: {}

objects: []

layout: {}

Davon wären lediglich version und objects grundsätzlich erforderlich. Das Definitionsformat unterstützt bereits

- Zeitreihen und allgemeine X/Y-Diagramme.
- Mehrere Datenquellen.
- Beliebig viele benannte Achsen.
- Unterschiedliche Koordinatensysteme.
- Mehrere grafische Objekte aus demselben Datensatz.
- Horizontale und vertikale Referenzlinien.
- Dynamische statistische Referenzwerte.
- Datenverarbeitung und mathematische Funktionen.
- Mehrere Viewports.
- Automatisches und explizites Layout.

LG

pah