Zum Inhalt springen

Xplot-Konfiguration: Unterschied zwischen den Versionen

Aus FHEMWiki
Pahenning (Diskussion | Beiträge)
Pahenning (Diskussion | Beiträge)
Zeile 343: Zeile 343:
| width || Zahl ≥ 0 || Strichbreite; Standard 2.
| width || Zahl ≥ 0 || Strichbreite; Standard 2.
|-
|-
| dash || <code>solid</code> || Durchgezogene Linie; Standard.
| dash || <code>solid</code> || Durchgezogene Linie (Standard; kein <code>stroke-dasharray</code>).
|-
|-
| || <code>dashed</code> || Gestrichelte Linie.
| || <code>dashed</code> || Gestrichelt; SVG-Muster <code>6 4</code>.
|-
|-
| || <code>dotted</code> || Gepunktete Linie.
| || <code>dotted</code> || Gepunktet; SVG-Muster <code>2 4</code>.
|-
| || <code>longdash</code> || Lange Striche; SVG-Muster <code>12 5</code>.
|-
| || <code>shortdash</code> || Kurze Striche; SVG-Muster <code>3 3</code>.
|-
| || <code>dashdot</code> || Strich-Punkt; SVG-Muster <code>8 3 2 3</code>.
|-
| || <code>longdashdot</code> || Langer Strich-Punkt; SVG-Muster <code>12 4 2 4</code>.
|-
| || <code>dashdotdot</code> || Strich-Punkt-Punkt; SVG-Muster <code>8 3 2 3 2 3</code>.
|}
|}
Die Zahlenfolgen bezeichnen abwechselnd Strich- und Lückenlängen in SVG-Einheiten.


== layout ==
== layout ==

Version vom 22. November 2026, 06:47 Uhr

Allgemeines

Die Konfigurationsdateien für das Xplot-System müssen in /opt/fhem/www/xplot stehen, sie haben die Endung .xplot

Damit diese Konfigurationsdateien mit dem FHEM-internen Editor bearbeitet werden können, muss in der zugehörigen Instanz des FHEMWEB-Devices das Attribut editFileList richtig gesetzt werden. Derzeit (21.11.2026) muss es den Wert

Own modules and helper files:$MW_dir:^(.*sh|[0-9][0-9].*Util.*pm|.*cfg|.*holiday|myUtilsTemplate.pm|.*layout)$
Gplot files:$FW_gplotdir:^.*gplot$
Xplot files:'/opt/fhem/www/xplot':^.*xplot$
Styles:$FW_cssdir:^.*(css|svg)$

haben. Darin sind erste, zweite und vierte Zeile der bisherige Default-Wert, die dritte Zeile erlaubt das Editieren der .xplot-Dateien.

Achtung: Datei-Eigentümer auf fhem:dialout setzen !

Konfigurationsbeispiel

Mit der folgenden Datei werden vier Kurven gezeichnet, bei zwei Koordinatensystemen und zwei Achsen

#-- Xplot v15: GasD, four FileLog data series
api_version: 1
#-- Allgemeine Informationen, Titel etc.
canvas:
 width: 600
 height: 300
 title: 'Gas'
 frame: rounded
 theme: default
#--- Datenquellen für vier Kurven, benannt als power, power.av, energy und energy.ac
sources:
 power:
   type: filelog
   device: GasD
   spec:
     regex: 'G.Verb.energy:'
     column: 7
   range: day
 power.av:
   type: filelog
   device: GasD
   spec:
     regex: 'G.Verb.power.av:'
     column: 4
   range: day
 energy:
   type: filelog
   device: GasD
   spec:
     regex: 'G.Verb.energy:'
     column: 4
   range: day
 energy_ac:
   type: filelog
   device: GasD
   spec:
     regex: 'G.Verb.energy_AC:'
     column: 4
   range: day
#--- Definition einer horizontalen und zweier vertikaler Achsen
axes:
 time:
   type: time
   position: bottom
   label: Uhrzeit
   range: day
 energy:
   type: linear
   position: right
   label: 'V [m³]'
   range:
     min: 0
     max: 20
 power:
   type: linear
   position: left
   label: 'P [m³/h]'
   range:
     min: 0
     max: 3
#--- Definition von zwei Koordinatensystemen
coordinates:
 energy:
   type: cartesian
   viewport: main
   x_axis: time
   y_axis: energy
 power:
   type: cartesian
   viewport: main
   x_axis: time
   y_axis: power
#--- Definition von vier grafischen Objekten vom Typ line
objects:
 - type: line
   dataset: power
   x: x
   y: y
   coordinates: power
   style:
     stroke: red
     width: 0.3
 - type: line
   dataset: power.av
   x: x
   y: y
   coordinates: power
   style:
     stroke: red
     width: 1.6
 - type: line
   dataset: energy
   x: x

Xplot – Konfigurationsreferenz (Version 16)

Referenz für *.xplot-Dateien

<name> bezeichnet einen frei wählbaren Schlüssel; - type einen Eintrag der YAML-Liste. „—“ bedeutet: kein fester Wert vorgegeben.

api_version

Schlüssel Mögliche Werte Erläuterung
api_version 1 Pflichtangabe; Version des Konfigurationsformats.

canvas

Schlüssel Mögliche Werte Erläuterung
width Zahl ≥ 200 SVG-Breite; Standard 800.
height Zahl ≥ 150 SVG-Höhe; Standard 400.
title Text mit Datums- und Statistikvariablen Plotüberschrift; Standard leer. Variablen werden bei jedem Rendern aufgelöst, z. B. Gas ${date}: $max{energy:2}.
frame rect / rounded Rechteckiger bzw. abgerundeter Rahmen; Standard rect.
theme default / dark / <name> Globales Theme aus themes.yaml.
background RGB-Wert (#RGB, #RRGGBB) / Theme-Farbname Füllfarbe außerhalb des Plotrahmens, auch bei frame: rounded. Überschreibt den Wert aus Theme.
plot_background RGB-Wert (#RGB, #RRGGBB) / Theme-Farbname Füllfarbe innerhalb des Plotrahmens, auch bei frame: rounded. Überschreibt den Wert aus Theme. Ohne Angabe identisch mit background.
foreground RGB-Wert (#RGB, #RRGGBB) / Theme-Farbname Text- und Achsenfarbe. Überschreibt den Wert aus Theme.
grid_color RGB-Wert (#RGB, #RRGGBB) / Theme-Farbname Gitternetzfarbe. Überschreibt den Wert aus Theme.
frame_color RGB-Wert (#RGB, #RRGGBB) / Theme-Farbname Rahmenfarbe. Überschreibt den Wert aus Theme.

Dynamische Variablen in canvas.title und axes.<name>.label

Schlüssel / Variable Mögliche Werte Erläuterung
${date} TT.MM.JJJJ Heutiges Datum nach lokaler Serverzeit.
${day}, ${month}, ${year} Tag / Monat / Jahr Aktuelles Kalenderdatum als Einzelwerte.
${month_name}, ${weekday} Monats- / Wochentagsname Sprache entsprechend der Locale des FHEM-Servers.
${time}, ${datetime}, ${date_iso} HH:MM / Datum und Uhrzeit / JJJJ-MM-TT Weitere aktuelle Zeitangaben.
${range_start}, ${range_end} TT.MM.JJJJ Beginn und Ende der dargestellten Zeitachse; benötigt einen eindeutigen Zeitbereich.
${range_start:%d.%m.%Y} strftime-Format Individuelle Formatierung von Bereichsbeginn oder -ende; analog für range_end.
$min{<source>}, $max{<source>} Zahl Minimum bzw. Maximum der Y-Werte der benannten Datenquelle.
$sum{<source>}, $avg{<source>} Zahl Summe bzw. arithmetischer Mittelwert der gültigen Y-Werte (keine zeitliche Integration).
$cnt{<source>} Ganzzahl Anzahl gültiger Y-Werte.
$firstval{<source>}, $currval{<source>} Zahl Erster bzw. letzter gültiger Wert in X-Reihenfolge.
$firstdate{<source>}, $currdate{<source>} X-Wert X-Koordinate des ersten bzw. letzten gültigen Wertes.
$mindate{<source>}, $maxdate{<source>} X-Wert X-Koordinate des Minimums bzw. Maximums.
$lastraw{<source>} Rohwert / - Nur verfügbar, wenn die Quelle einen Rohwert bereitstellt; bei den derzeitigen Standardquellen -.
$curr{<source>}, $current{<source>} Zahl Aliase für $currval.
$minAll, $maxAll Zahl Kleinstes Minimum bzw. größtes Maximum der Standardwertspalten aller Datenquellen.
$max{<source>:2} 0–12 Nachkommastellen Numerische Formatierung; funktioniert analog für andere Statistikvariablen.
$max{<source>.<spalte>} Quell- und Spaltenname Explizite Spaltenwahl für Array-Daten, z. B. $max{messung.strom:2}.

sources

Schlüssel Mögliche Werte Erläuterung
<name> frei wählbar Kennung einer Datenquelle; Referenz über objects[].dataset.
type filelog Werte aus einem FHEM-FileLog.
array Inline-Datenreihe, unabhängig von FileLog und FHEM.
columns Liste eindeutiger Spaltennamen. Pflicht für array; z. B. [spannung, strom]. Mindestens zwei Spalten.
rows Liste numerischer Zeilen. Pflicht für array; jede Zeile muss genau so viele Werte wie columns enthalten. Beispiel: - [1.0, 2.5].
consty Konstanter Y-Wert: horizontale Linie.
constx Konstanter X-Wert: vertikale Linie oder Punkt.
device FHEM-Devicename Bei filelog: FileLog-Device.
spec Mapping / Legacy-String Bei filelog: Auswahl der Daten.
spec.regex regulärer Ausdruck Suchmuster für FileLog-Einträge.
spec.column positive Ganzzahl Spalte des Messwerts (ab 1).
range hour / 6hours / day / 3days / week / month / year / 5years Kalenderbezogener Zeitbereich; bei filelog ohne Angabe last_24h.
day -1 / week -2 / … Verschobener Zeitraum mit ganzzahligem Offset.
last_24h Gleitende letzte 24 Stunden.
value Zahl Bei consty: konstanter Y-Wert.
from Zeitstempel / Zahl Bei consty: optionaler X-Anfang.
to Zeitstempel / Zahl Bei consty: optionales X-Ende.
time Zeitstempel / Zahl Bei constx: X-Position.
x Zeitstempel / Zahl Bei constx: Alias für time.
y Zahl Bei constx: erster Y-Wert.
y2 Zahl Bei constx: zweiter Y-Wert; ohne y2 nur ein Punkt.

axes

Schlüssel Mögliche Werte Erläuterung
<name> frei wählbar Kennung der Achse.
type linear Lineare Zahlenachse.
time Zeitachse.
position left / right Position einer Y-Achse.
bottom / top Position einer X-Achse.
label Text Achsenbeschriftung, auch Unicode (z. B. m³).
range Mapping mit min, max Expliziter Zahlenbereich; Grenzen einzeln optional.
Zeitraum, z. B. day -1 Bei Zeitachsen: Kalenderbereich mit optionalem Offset.
range.min Zahl Untere Grenze einer numerischen Achse.
range.max Zahl Obere Grenze einer numerischen Achse.

viewports

Optional seit v14; ohne Angabe wird main automatisch angelegt.

Schlüssel Mögliche Werte Erläuterung
<name> frei wählbar Viewport-Kennung, z. B. main.
layout auto Automatisches Layout des Standardviewports.
row Ganzzahl 0–19 Zeile im Viewport-Raster.
column Ganzzahl 0–19 Spalte im Viewport-Raster.
show_axes Liste von Achsennamen Auswahl sichtbarer Achsen; aktuelle Einschränkungen beachten.

coordinates

Schlüssel Mögliche Werte Erläuterung
<name> frei wählbar Kennung eines Koordinatensystems.
type cartesian Kartesisches Koordinatensystem.
viewport main / Viewport-Name Zielviewport; Standard main.
x_axis Achsenname X-Achse; Standard x.
y_axis Achsenname Y-Achse; Standard y.

objects

Liste von Grafikobjekten; jeder Eintrag beginnt mit - type:.

Schlüssel Mögliche Werte Erläuterung
- type line / lines Linienzug; beide Schreibweisen unterstützt.
steps / fsteps / histeps Varianten von Treppenlinien.
bars / ibars / needles Balken, Intervallbalken bzw. Nadeln.
points Datenpunkte.
points:diamond / points:circle / points:square Punktform: Raute, Kreis, Quadrat.
points:triangleup / points:triangledown Dreieck nach oben/unten.
points:plus / points:cross / points:minus Plus, Kreuz, waagerechter Strich.
points:circle:4 usw. Punktform mit Größenangabe als drittem Typsegment.
horizontalLineFrom / horizontalLineTo Horizontale Verbindungen.
cubic / quadratic / quadraticSmooth Geglättete Kurven.
hline / vline Feste horizontale bzw. vertikale Referenzlinie.
dataset Quellenname Zu zeichnender Datensatz.
coordinates Koordinatensystemname Zielkoordinatensystem; Standard main.
x Spaltenname X-Spalte der Datenquelle; bei numerischen X/Y-Plots frei wählbar, Standard x.
y Spaltenname Y-Spalte der Datenquelle; Standard y.
autoscale true / false bzw. 1 / 0 Objekt bei automatischer Skalierung berücksichtigen; Standard aktiv.
size Zahl ≥ 0 Größe einer Punktmarkierung.
bar_width Zahl > 0 Balkenbreite in X-Einheiten.
baseline Zahl Basiswert für Balken; Standard 0.
from Zahl Optionaler Anfang einer hline bzw. vline.
to Zahl Optionales Ende einer hline bzw. vline.

objects[].style

Schlüssel Mögliche Werte Erläuterung
stroke #RGB / #RRGGBB Explizite Linienfarbe.
Theme-Farbname Z. B. red, blue, gas.
width Zahl ≥ 0 Strichbreite; Standard 2.
dash solid Durchgezogene Linie (Standard; kein stroke-dasharray).
dashed Gestrichelt; SVG-Muster 6 4.
dotted Gepunktet; SVG-Muster 2 4.
longdash Lange Striche; SVG-Muster 12 5.
shortdash Kurze Striche; SVG-Muster 3 3.
dashdot Strich-Punkt; SVG-Muster 8 3 2 3.
longdashdot Langer Strich-Punkt; SVG-Muster 12 4 2 4.
dashdotdot Strich-Punkt-Punkt; SVG-Muster 8 3 2 3 2 3.

Die Zahlenfolgen bezeichnen abwechselnd Strich- und Lückenlängen in SVG-Einheiten.

layout

Schlüssel Mögliche Werte Erläuterung
viewport_gap Zahl ≥ 0 Abstand zwischen Viewports; Standard 12.
axis_spacing.tick_labels Zahl ≥ 0 Abstand der Tick-Beschriftungen; Standard 5.
axis_spacing.titles Zahl ≥ 0 Abstand der Achsentitel; Standard 12.
margins.left Zahl ≥ 0 Mindestabstand links.
margins.right Zahl ≥ 0 Mindestabstand rechts.
margins.top Zahl ≥ 0 Mindestabstand oben.
margins.bottom Zahl ≥ 0 Mindestabstand unten.

themes.yaml (globale Theme-Datei)

Nicht Bestandteil der einzelnen .xplot-Datei; Ablage unter /opt/fhem/lib/Xplot/themes.yaml.

Schlüssel Mögliche Werte Erläuterung
themes.<name> default / dark / eigener Name Theme-Definition.
background RGB-Farbe Hintergrund.
foreground RGB-Farbe Schrift und Achsen.
grid RGB-Farbe Gitternetz.
frame RGB-Farbe Plotrahmen.
colors.<name> RGB-Farbe Benannter Paletteneintrag, z. B. blue, red, green, purple, orange, gray, solar, grid, battery, gas, water.

Stand: Xplot v15. Die Übersicht ist als eigenständige Wiki-Datei gedacht, nicht als README-Ergänzung.