Einstellungen (Instanz und Datenpunkt)

Welche Einheiten werden unterstützt (Energie, Volumen, Gewicht, Länge)?

Kurz: SourceAnalytix kennt 30 feste Einheiten für Leistung, Energie, Volumen, Masse und Länge. Umgerechnet wird nur innerhalb derselben Größe und zwischen Litern und Kubikmetern. Leistung wird über die Zeit zu Energie aufsummiert.

Größe	Einheiten	Wird umgerechnet in
Leistung	GW, MW, kW, W, mW	Energie (GWh bis mWh), über die Zeit aufsummiert
Energie	GWh, MWh, kWh, Wh, mWh	jede andere Energie-Einheit
Volumen (Kubik)	km³, m³, dm³, cm³, mm³	jede andere Volumen-Einheit, auch Liter
Volumen (Liter)	hl, l, dl, cl, ml	jede andere Volumen-Einheit, auch Kubikmeter (1 m³ = 1.000 l)
Masse	t, kg, g	jede andere Masse-Einheit
Länge	km, m, dm, cm, mm, µm, nm	jede andere Länge-Einheit

Bis v0.6.1 müssen die Zeichen genau so geschrieben sein: m³ mit hochgestellter 3, l klein, kWh mit großem W. Welche Schreibweisen ab v0.6.2 zusätzlich erkannt werden, steht weiter unten.

Welche Einheit gilt wo?

Es gibt zwei Einheiten, und beide musst du kennen:

Einstellung	Bedeutung
„Einheit“ bei der Quelle (ab v0.7.0 in der Detailansicht, bis v0.6.x im Objekt-Dialog „Wählen Sie Einheit“)	Die Einheit, in der das Gerät den Wert liefert (Quelleinheit). Voreinstellung ist „Automatisch erkennen“: SourceAnalytix nimmt dann die Einheit, die am Objekt des Datenpunkts steht.
„Einheit“ in der Preisdefinition	Die Einheit, in der SourceAnalytix rechnet und anzeigt (Zieleinheit). Alle Verbrauchs-States, Startwerte und der Preis pro Einheit beziehen sich auf sie.

Beispiele:

• Wasserzähler liefert l, Preisdefinition hat m³: aus 1.000 l werden 1 m³.
• Stromzähler liefert Wh, Preisdefinition hat kWh: aus 1.000 Wh werden 1 kWh.
• Steckdose liefert W, Preisdefinition hat kWh: SourceAnalytix rechnet die Leistung über die Zeit in Energie um.

IMPORTANT

Bei einer Leistungs-Quelle (W, kW …) muss die Preisdefinition eine Energie-Einheit haben (kWh, Wh …). Passen Quelle und Preisdefinition nicht zusammen, zum Beispiel kg und kWh oder kWh und W, rechnet SourceAnalytix bis v0.6.1 nichts und schreibt bei jedem Wert ins Log: reading incorrect after conversion contact DEV. Bei W und m³ rechnet es ohne Meldung falsch. Ab v0.6.2 startet der Datenpunkt dann nicht, und im Log steht Unit <Einheit> of <Datenpunkt> cannot be converted to unit <Einheit> of price definition <Name>.

WARNING

Bis v0.6.1 rechnet SourceAnalytix die Einheiten km³, dm³, cm³, mm³, µm und nm falsch um, sobald Quelle und Preisdefinition verschiedene Einheiten haben. Beispiel: 1.000 dm³ werden zu 100 m³ statt zu 1 m³. Wähle bei diesen Einheiten in der Preisdefinition dieselbe Einheit wie am Datenpunkt. m³, die Liter-Reihe und die Umrechnung zwischen l und m³ stimmen. Ab v0.6.2 ist der Fehler behoben (#1278).

Einheiten außerhalb der Liste

Nicht unterstützt sind:

• Zählerstände ohne Einheit, also Stück oder Impulse,
• Zeit, zum Beispiel Betriebsstunden in h,
• Datenmengen wie MB oder GB,
• Raten wie m³/h, l/min oder kg/h,
• alle anderen Größen, zum Beispiel %, hPa, V oder A.

Hat der Datenpunkt eine solche Einheit oder gar keine, startet er nicht, und im Log steht No unit defined. Wenn der Wert in Wahrheit in einer unterstützten Einheit vorliegt und nur das Objekt falsch beschriftet ist, wählst du die richtige Einheit selbst aus: ab v0.7.0 in der Detailansicht der Quelle unter „Einheit“ oder im Tab „Probleme“ bei „Einheit fehlt oder wird nicht erkannt“ mit „Beheben“, bis v0.6.x im Objekt-Dialog unter „Wählen Sie Einheit“. Wie das geht, steht unter Fehler „unit not supported“ / „No unit defined“.

Ab v0.7.0 kommen Stück und Impulse dazu, siehe den nächsten Abschnitt. Zeit, Datenmengen, Raten wie m³/h und die übrigen Größen bleiben außerhalb der Liste.

Stück und Impulse (ab v0.7.0)

Ab v0.7.0 gibt es zwei weitere Einheiten (#304, #74):

Einheit	Wofür	Erkannte Schreibweisen am Objekt
piece	Zählerstände ohne physikalische Einheit, zum Beispiel Brennerstarts, und Impulszähler mit Gesamtzahl der Impulse	pcs, pc, pieces, Stk, Stück, imp, impulse, pulses
piece/min	Impulse pro Minute, zum Beispiel pulses/min bei einem ESPHome-Impulszähler. SourceAnalytix summiert sie über die Zeit auf, wie eine Leistung.	pulses/min, imp/min, pcs/min

So setzt du sie ein. Die Felder für Impulse stehen in der Detailansicht der Quelle: „Impulse pro <Einheit>“ im Bereich „Einstellungen“, sobald die Quelle in piece oder piece/min liefert und die Preisdefinition nicht in piece rechnet, „Jede Aktualisierung addiert ihren Wert“ unter „Für Experten“.

• Nur zählen, zum Beispiel Brennerstarts: Lege eine Preisdefinition mit der Einheit piece an. Ein Preis pro Stück ist möglich, aber nicht nötig.
• Impulse in kWh oder m³ umrechnen: Trage bei „Impulse pro <Einheit>“ ein, wie viele Impulse eine Einheit der Preisdefinition ergeben, zum Beispiel 1000 für einen Stromzähler mit 1000 imp/kWh und eine Preisdefinition in kWh. Ohne diesen Wert startet die Quelle nicht, und im Log steht Unit piece of <Datenpunkt> cannot be converted to unit kWh of price definition <Name>.
• Jede Aktualisierung ist ein Impuls: Sendet der Datenpunkt keinen Zählerstand, sondern bei jedem Impuls ein Update, zum Beispiel 1, true oder 0.001 kWh, setze den Haken „Jede Aktualisierung addiert ihren Wert“. Dann zählt jedes Update, auch wenn sich der Wert nicht ändert (#479). Negative Werte werden ignoriert, und der Wert, der beim Start von SourceAnalytix schon im Datenpunkt steht, zählt nicht noch einmal.

Eine Quelle in piece/min und eine Quelle mit „Jede Aktualisierung addiert ihren Wert“ führen ihren Gesamtstand selbst, wie eine Leistungsquelle: Er beginnt bei 0, es gibt keine Reset-Erkennung, und Startwerte lässt du leer. Eine Quelle in piece mit Gesamtzahl der Impulse verhält sich wie ein Zählerstand, mit Reset-Erkennung.

Ab v0.6.2: SourceAnalytix erkennt am Objekt auch abweichende Schreibweisen (#1264): m3, M3 und m^3 gelten als m³, kwh und KWH als kWh, L als l. Eine Schreibweise, die auf zwei Einheiten passt, wird nicht umgedeutet: mwh kann MWh oder mWh sein. Ausgeschriebene Namen wie Liter oder Watt erkennt SourceAnalytix auch weiterhin nicht. Wenn eine Schreibweise umgedeutet wird, steht im Log zum Beispiel Unit "m3" of <Datenpunkt> is used as m³. Auch der Einstellungsdialog nimmt diese Schreibweisen bei „Automatisch erkennen“ an (#1278).

Siehe auch: Welche Einheit stelle ich am Datenpunkt ein? · Startwerte und ihre Einheit · Wie rechnet SourceAnalytix Watt in kWh um?

Welche Instanz-Einstellungen gibt es (Perioden, Nachkommastellen)?

Kurz: Die Instanz-Einstellungen von SourceAnalytix haben ab v0.7.0 vier Tabs. In „Haupteinstellungen“ legst du fest, welche Wochen-, Monats- und Quartals-States entstehen und wie viele Nachkommastellen neue Quellen bekommen. Fehlt ein State, ist meist die passende Option dort aus oder an der Quelle ist „Verbrauch“, „Kosten“ oder „Zählerstände speichern“ nicht gesetzt.

Die Tabs (ab v0.7.0)

Tab	Inhalt	Wann wirkt eine Änderung
„Übersicht“	Alle Quellen mit Status, Gesamtstand und den Werten für „Heute“, „Monat“ und „Jahr“. „Quelle hinzufügen“ startet den Assistenten, ein Klick auf eine Quelle öffnet ihre Detailansicht.	Aktionen mit ⚡ sofort, ohne Speichern und ohne Neustart
„Probleme“	Prüft alle Quellen und schlägt zu jedem Befund eine Lösung vor	sofort
„Preisdefinitionen“	Tabelle der Preise, siehe Wie ist eine Preisdefinition aufgebaut?	nach „Speichern“, die Instanz startet dabei neu
„Haupteinstellungen“	Jahresstatistik, laufendes Jahr, Rundung (siehe unten)	nach „Speichern“, die Instanz startet dabei neu

„Übersicht“ und „Probleme“ fragen die laufende Instanz ab. Ist sie gestoppt, steht dort „Instanz läuft nicht“, und die Sofort-Aktionen sind gesperrt. Was die Detailansicht einer Quelle enthält, steht unter Was bewirken die Einstellungen am Datenpunkt?.

Bis v0.6.x gibt es nur die Tabs „Haupteinstellungen“ und „Preisdefinitionen“. Quellen richtest du dort im Objekt-Dialog des Datenpunkts ein.

Tab „Haupteinstellungen“

Bereich	Option	Standard	Was SourceAnalytix anlegt
„Jahresstatistik“	„Wochen“	aus	Archiv <Gerät>.<Jahr>.<Kategorie>.weeks.01 bis 53
„Jahresstatistik“	„Monate“	an	Archiv <Gerät>.<Jahr>.<Kategorie>.months.01_January bis 12_December
„Jahresstatistik“	„Quartale“	aus	Archiv <Gerät>.<Jahr>.<Kategorie>.quarters.Q1 bis Q4
„Laufendes Jahr“	„Wochentag“	an	currentYear.<Kategorie>.currentWeek.01_Monday bis 07_Sunday
„Laufendes Jahr“	„Wochen“	an	currentYear.<Kategorie>.weeks.01 bis 53
„Laufendes Jahr“	„Monate“	an	currentYear.<Kategorie>.months.01_January bis 12_December
„Laufendes Jahr“	„Quartale“	an	currentYear.<Kategorie>.quarters.Q1 bis Q4
„Laufendes Jahr“	„Vorheriger Zeitraum“	an	01_previousDay bis 05_previousYear, mit „Wochentag“ auch previousWeek.01_Monday bis 07_Sunday
„Rundung“	„Nachkommastellen für Verbrauchswerte“	3	Vorlage für neue Quellen
„Rundung“	„Nachkommastellen für Kostenwerte“	2	Vorlage für neue Quellen

Bis v0.6.x heißt die Option „Quartale“ in der deutschen Oberfläche „Viertel“.

<Kategorie> ist consumed oder delivered für den Verbrauch, costs oder earnings für das Geld und meterReadings für Zählerstände. Ist eine der drei Optionen der „Jahresstatistik“ an, gibt es im Jahresordner zusätzlich die Jahressummen <Jahr>.consumedCumulative (oder deliveredCumulative), <Jahr>.costsCumulative (oder earningsCumulative) und den Zählerstand <Jahr>.readingCumulative. Was in den einzelnen States steht, beschreibt Welche Wochen-, Monats- und Quartals-States gibt es?.

Warum manche States fehlen

• Die Option ist aus. Dann legt SourceAnalytix die States nicht an. Schaltest du eine Option aus, löscht es die vorhandenen States des laufenden Jahres, sobald die Quelle das nächste Mal startet, also beim Neustart der Instanz nach dem Speichern.
• An der Quelle fehlt der Haken. Verbrauchs-States gibt es nur mit „Verbrauch“, Kosten-States nur mit „Kosten“, Zählerstände nur mit „Zählerstände speichern“.
• Die Woche gehört zum nächsten Jahr. Vom 29. bis 31. Dezember kann schon die Kalenderwoche 01 des neuen Jahres laufen. Sie wird unter currentYear.<Kategorie>.weeks nicht geschrieben, siehe Warum zeigt Woche 52/53 Werte im neuen Jahr?.
• Der erste Periodenwechsel steht noch aus. Vorperioden-States stehen bis dahin auf 0, siehe Wo finde ich gestern, letzte Woche, letzten Monat?.

WARNING

Schaltest du „Wochen“, „Monate“, „Quartale“, „Wochentag“ oder „Vorheriger Zeitraum“ aus, sind die Werte des laufenden Jahres in diesen States weg. Aufzeichnungen in einem History-Adapter und die Jahresordner früherer Jahre bleiben erhalten.

Nachkommastellen

Die beiden Werte unter „Rundung“ sind nur eine Vorlage. Jede Quelle übernimmt sie einmal beim Anlegen und speichert ihre eigenen Nachkommastellen. Änderst du die Vorlage später, behalten vorhandene Quellen ihren Wert. Ab v0.7.0 änderst du die Stellen einer Quelle in ihrer Detailansicht unter „Für Experten“: „Nachkommastellen Verbrauch“ und „Nachkommastellen Kosten“.

• Erlaubt sind 0 bis 15. Mit -1 speichert SourceAnalytix den Wert ungerundet. Größere Zahlen gelten als 15, jede negative als -1.
• Gerundet werden nur die geschriebenen States. Der Gesamtstand in cumulativeReading bleibt ungerundet.
• Zählerstände unter meterReadings werden mit den Nachkommastellen für Verbrauchswerte gerundet.

Siehe auch: Warum so viele Nachkommastellen? · Was passiert beim Jahreswechsel? · Wie werte ich Werte über mehrere Jahre aus?

Was bewirken die Einstellungen am Datenpunkt (Costs, Consumption, Meter values)?

Kurz: Jede Quelle hat eigene Einstellungen: Preisdefinition, Einheit und die Haken „Verbrauch“, „Kosten“ und „Zählerstände speichern“, die festlegen, welche States entstehen. Ab v0.7.0 stellst du sie beim Anlegen im Assistenten ein und änderst sie später in der Detailansicht der Quelle. „Übernehmen“ wirkt sofort, ohne Neustart.

So kommst du zu den Einstellungen (ab v0.7.0)

1. Öffne die Instanz-Einstellungen von SourceAnalytix, Tab „Übersicht“.
2. Klicke auf die Quelle. Die Detailansicht zeigt oben Datenpunkt, Art, Gesamtstand, Preis und „Letzte Aktualisierung“, darunter die Bereiche „Werte“, „Einstellungen“ und „Aktionen“.
3. Ändere im Bereich „Einstellungen“ die Felder. Weitere Felder stehen unter „Für Experten“.
4. Klicke auf „Übernehmen“. Ist ein Feld ungültig, markiert die Seite es und speichert nichts.

Alle Einstellungen einer Quelle

Die Spalte „Standard“ nennt die Vorbelegung im Assistenten. Die letzte Spalte nennt für Umsteiger den Namen des Felds im Objekt-Dialog am Datenpunkt bis v0.6.x.

Einstellung (ab v0.7.0)	Wirkung	Standard	Bis v0.6.x im Objekt-Dialog
„Name“	Anzeigename des Ordners der Quelle. Ändert keine State-ID, siehe Wie benenne ich den Datenpunkt?	Name des Datenpunkts	„Name“
„Einheit“	Einheit, in der der Datenpunkt liefert. „Automatisch erkennen“ nimmt die Einheit am Objekt, siehe Welche Einheiten werden unterstützt?	erkannte Einheit	„Wählen Sie Einheit“
„Preisdefinition“	Pflicht. Legt die Zieleinheit fest und ob Verbrauch und Kosten oder Einspeisung und Erlös gezählt werden	–	„Preisdefinition auswählen“
„Verbrauch“	States unter currentYear.consumed oder currentYear.delivered	an	„Verbrauch berechnen“
„Kosten“	States unter currentYear.costs oder currentYear.earnings	an	„Kosten berechnen“
„Grundpreis einrechnen“	Bucht den „Preis pro Monat“ der Preisdefinition in die Kosten. Wirkt nur mit „Kosten“	an, wenn keine andere Quelle derselben Preisdefinition ihn schon bucht	„Inklusive Grundpreis“
„Zählerstände speichern“	Zählerstände je Periode unter currentYear.meterReadings	an	„Zählerwerte speichern“
„Reset-Erkennung“	Fängt Sprünge des Zählers auf 0 ab, siehe Threshold und Abschalten der Reset-Erkennung	nach der Frage „Springt der Wert manchmal auf 0 …?“	„Erkennung der Zurücksetzung des Gerätewerts Aktiviert“
„Negative Werte ignorieren“	Nur bei Leistung: Negative Werte zählen als 0 W, zum Beispiel bei Wechselrichtern in der Nacht	aus	„Negative Leistungswerte ignorieren“
„Schwelle Reset-Erkennung (<Einheit>)“ unter „Für Experten“	Größter Rückgang, der noch als Messschwankung gilt	1	„Schwelle“
„Nachkommastellen Verbrauch“ / „Nachkommastellen Kosten“ unter „Für Experten“	Rundung der geschriebenen States, siehe Instanz-Einstellungen	Vorlage der Instanz (3 / 2)	„Nachkommastellen für Verbrauchswerte“ / „… Kostenwerte“

Diese Einstellungen erscheinen nur bei passenden Quellen oder fragt der Assistent nicht ab. Ab v0.7.0 stehen sie alle in der Detailansicht (#1285):

Einstellung	Wo in der Detailansicht	Wirkung	Standard
„Technische ID“	unter „Für Experten“, auch im Assistenten	Name des Ordners sourceanalytix.0.<Gerät>. Erlaubt sind Buchstaben, Ziffern, _ und -. Eine Änderung verschiebt alle Werte in den neuen Ordner, siehe Wie benenne ich den Datenpunkt?	aus dem Namen gebildet
„Mittelwert bei Leistung“	bei Leistungsquellen, auch im Assistenten	Rechnet je Abschnitt mit dem Mittel aus altem und neuem Wert statt mit dem alten Wert	aus
„Maximale Lücke zwischen Leistungswerten (Minuten)“	bei Leistungsquellen	Längere Pausen ohne neuen Leistungswert zählen als 0 (#1266)	leer = aus
„Impulse pro <Einheit>“	bei Quellen in piece oder piece/min, deren Preisdefinition nicht in piece rechnet	Rechnet Impulse in die Zieleinheit um, zum Beispiel 1000 bei 1000 imp/kWh	leer
„Jede Aktualisierung addiert ihren Wert“	unter „Für Experten“	Jedes Update zählt als Zuwachs statt als Zählerstand	aus
„Startwerte“ „Tag“ bis „Jahr“	eigener Abschnitt „Startwerte“, im Assistenten nur bei Zählerstand	Gesamtstand zu Beginn der laufenden Periode, siehe Startwerte	leer = ab jetzt zählen

Zahlen trägst du mit Komma oder Punkt ein. Ein einzelnes Komma oder ein einzelner Punkt ist immer das Dezimalzeichen: 1.283 heißt 1,283. Die Startwerte prüft die Detailansicht wie der Assistent; solange ein Startwert einen Fehler zeigt, bleibt „⚡ Übernehmen“ gesperrt.

Ab v0.7.0: Im Objekt-Dialog am Datenpunkt (Reiter „Objekte“, Schraubenschlüssel) gibt es nur noch den Haken „aktiviert“, einen Hinweis und den Knopf „SourceAnalytix-Einstellungen öffnen“. Schaltest du eine Quelle dort ein, setzt SourceAnalytix „Verbrauch“, „Kosten“, „Zählerstände speichern“ und „Reset-Erkennung“ mit Schwelle 1. Weil noch keine Preisdefinition gewählt ist, erscheint die Quelle im Tab „Probleme“ mit „Keine Preisdefinition gewählt“. Bestehende Einstellungen bleiben dabei unverändert (#1286).

Bis v0.6.x: Legst du eine Quelle im Objekt-Dialog neu an, sind „Verbrauch berechnen“, „Kosten berechnen“ und „Zählerwerte speichern“ nicht vorbelegt. Ohne diese Haken pflegt SourceAnalytix nur cumulativeReading und statisticsJson.

WARNING

Nimmst du „Verbrauch“, „Kosten“ oder „Zählerstände speichern“ wieder heraus, löscht SourceAnalytix die zugehörigen States der Quelle. Aufzeichnungen in einem History-Adapter bleiben erhalten.

Wann der Ordner meterReadings leer bleibt

meterReadings enthält den Gesamtstand am Ende einer Periode, nicht den Verbrauch. Er bleibt leer oder unvollständig, wenn:

• „Zählerstände speichern“ aus ist,
• du den aktuellen Stand suchst: Einen State meterReadings.01_currentDay gibt es nicht, der aktuelle Stand steht in cumulativeReading,
• in den Instanz-Einstellungen „Wochentag“, „Wochen“, „Monate“, „Quartale“ oder „Vorheriger Zeitraum“ aus sind, denn nur für diese Perioden entstehen Zählerstände,
• der erste Periodenwechsel noch aussteht: 01_previousDay und die anderen Vorperioden werden erst dann gefüllt.

Bis v0.6.1 wird ein Zählerstand von genau 0 nicht unter meterReadings geschrieben. Ab v0.6.2 ist das behoben (#1253).

Bis v0.6.x gibt es die Detailansicht nicht. Alle Einstellungen stehen dann im Objekt-Dialog am Datenpunkt, wie unter Wo konfiguriere ich SourceAnalytix für einen Datenpunkt? beschrieben.

Siehe auch: Warum sind Meter-Readings kumuliert? · Welche Quelltypen gibt es? · Datenpunkt aktiviert, aber es entstehen keine Ordner

Wie funktionieren Threshold und Abschalten der Reset-Erkennung?

Kurz: Die Reset-Erkennung und ihre Schwelle stellst du für jede Quelle einzeln ein. Lass die Erkennung an, wenn dein Zähler nach einem Neustart oder Stromausfall bei 0 beginnen kann. Die Schwelle (Standard 1, in der Zieleinheit) ist der größte Rückgang, der noch als Messschwankung gilt. Ausschalten ist nur für Quellen gedacht, die bewusst fallen dürfen.

So stellst du es ein (ab v0.7.0)

1. Öffne in den Instanz-Einstellungen, Tab „Übersicht“, die Quelle.
2. Setze oder entferne im Bereich „Einstellungen“ den Haken „Reset-Erkennung“.
3. Klicke auf „Für Experten“ und trage unter „Schwelle Reset-Erkennung (<Einheit>)“ die Schwelle in der Zieleinheit ein, zum Beispiel 0.5 für 0,5 kWh.
4. Klicke auf „Übernehmen“.

Beim Anlegen fragt der Assistent: „Springt der Wert manchmal auf 0, z. B. nach einem Stromausfall?“ Mit „Ja“ ist die Reset-Erkennung an, mit „Nein“ aus. Vorgewählt ist „Nein“, bei Datenpunkten von Shelly oder Tasmota „Ja“.

Was bei einem Rückgang passiert

Rückgang des Gerätewerts	Reset-Erkennung an	Reset-Erkennung aus
höchstens die Schwelle	Messschwankung: Der Wert wird ignoriert, der Gesamtstand bleibt stehen	Der Gesamtstand fällt mit
mehr als die Schwelle	Möglicher Reset: SourceAnalytix wartet auf den nächsten Wert und rechnet dann mit einem neuen Offset weiter	Der Gesamtstand fällt mit, der Verbrauch der Perioden kann negativ werden

Wie die Bestätigung eines Resets im Einzelnen abläuft, steht unter Was bedeutet „Device reset detected“?. Eine Messschwankung steht nur im Debug-Log („Ignoring cumulative reading jitter“).

Welche Schwelle passt?

• Größer als das normale Rauschen des Geräts, damit kleine Rückgänge nicht als Reset gelten.
• Kleiner als der Stand, mit dem das Gerät nach einem Reset oder Tausch wieder beginnt. Fällt ein Zähler nur knapp unter den alten Stand, wird er sonst nicht als Reset erkannt.
• 0 heißt: Jeder Rückgang ist ein möglicher Reset.

Schwelle und Reset-Erkennung wirken nur bei Zählerständen. Bei Leistungsquellen (W), bei piece/min und bei „Jede Aktualisierung addiert ihren Wert“ führt SourceAnalytix den Gesamtstand selbst; dort gibt es keine Reset-Erkennung. Der Assistent zeigt die Schwelle bei Leistung deshalb nicht an.

WARNING

Mit „Nein“ im Assistenten ist die Reset-Erkennung aus. Springt so ein Zähler doch einmal auf 0, fällt der Gesamtstand mit, und die Werte der laufenden Perioden werden negativ. Der Tab „Probleme“ meldet dann „Zähler springt auf 0, Reset-Erkennung ist aus“ und bietet „Einschalten“ an. Wie du die Werte danach korrigierst, steht unter Falsche Werte korrigieren.

Ab v0.6.2: Die Meldung „Cumulative reading for … decreased while reset detection is disabled“ steht nur noch im Debug-Log. Bis v0.6.1 stand sie bei jedem Rückgang im Info-Log (#1262).

Bis v0.6.x stellst du beides im Objekt-Dialog am Datenpunkt ein: „Erkennung der Zurücksetzung des Gerätewerts Aktiviert“ (Standard an) und „Schwelle“ (Standard 1).

Siehe auch: Mein Zähler startet nach Stromausfall bei 0 · Zähler, der täglich auf 0 zurückgesetzt wird · Zähler oder Gerät getauscht

Wie ist eine Preisdefinition aufgebaut (Kategorien, Grundpreis, Dezimalzeichen)?

Kurz: Eine Preisdefinition ist eine Zeile im Tab „Preisdefinitionen“ der Instanz-Einstellungen. Sie hat einen frei wählbaren Namen („Kategorie“), eine Einheit, eine Kostenart und einen Preis. Jede Quelle bekommt genau eine Preisdefinition. Der monatliche Grundpreis wird voll gebucht, einmal je Monat, nicht anteilig pro Tag.

Die Felder

Spalte	Bedeutung
„Kategorie“	Name der Preisdefinition, zum Beispiel Strom oder Waermepumpe. Unter ihm wählst du sie an der Quelle aus. Jeder Name darf nur einmal vorkommen.
„Beschreibung“	Freier Text, nur für dich
„Kostenart“	„Kosten“ für Bezug (Verbrauch und Kosten) oder „Erträge“ für Einspeisung und Erlös. Bestimmt, ob die Werte unter consumed und costs oder unter delivered und earnings stehen.
„Einheit“	Die Zieleinheit: In ihr rechnet und zeigt SourceAnalytix alles für die Quellen dieser Preisdefinition
„Preisquelle“	„Festpreis“, „Datenpunkt“ oder „Tarifumschaltung“, siehe unten
„Preis pro Einheit“	Preis je Zieleinheit, zum Beispiel 0.32 für 0,32 €/kWh
„Preis-Datenpunkt“	Nur bei „Datenpunkt“ und „Tarifumschaltung“: der State, der den Preis oder den Tarif liefert
„Aktiver Tarifpreis“	Nur bei „Tarifumschaltung“: Preis, solange der Tarif aktiv ist
„Aktiver Auswahlwert“	Nur bei „Tarifumschaltung“: Wert des Preis-Datenpunkts, bei dem der Tarif aktiv ist
„Gültig ab“	Ab wann Preis und Grundpreis gelten, ab 0:00 Uhr dieses Tages
„Preis pro Monat“	Grundpreis je Monat

Gibt es eine Kategorie doppelt, gilt nur die letzte Zeile. In State-IDs wird jedes Zeichen außer Buchstaben, Ziffern, _ und - durch _ ersetzt.

Preisquelle

„Preisquelle“	Woher der Preis kommt
„Festpreis“	Aus „Preis pro Einheit“. Ein neuer Preis gilt ab „Gültig ab“ oder, ohne Datum, ab dem Speichern. Ältere Werte rechnet SourceAnalytix nicht von selbst neu.
„Datenpunkt“	Aus dem „Preis-Datenpunkt“, zum Beispiel einem dynamischen Strompreis in €/kWh. Jede Änderung wird mit ihrem Zeitstempel gespeichert. Ist der State beim Start leer, gilt „Preis pro Einheit“ als Ersatz.
„Tarifumschaltung“	Ein State schaltet zwischen „Preis pro Einheit“ und „Aktiver Tarifpreis“ um. Ohne „Aktiver Auswahlwert“ gilt der Tarif als aktiv bei true, bei einer Zahl ungleich 0 und bei jedem Text außer 0, false, off, no, closed oder leer. Mit Auswahlwert muss der State genau diesen Wert haben.

Ändert sich der Preis zwischen zwei Werten der Quelle, teilt SourceAnalytix den Verbrauch nach Zeit auf alten und neuen Preis auf. Wie du einen Preis ab einem Datum änderst und Kosten nachträglich neu rechnest, steht unter Werden Kosten neu berechnet, wenn ich den Preis ändere?. Dynamische Preise und Tag-/Nachttarif erklären Dynamischer Strompreis und Tag-/Nachttarif.

Grundpreis: voll, einmal im Monat

• Der „Preis pro Monat“ wird voll gebucht: einmal an dem Tag, ab dem er gilt, danach am 1. jedes Monats um 0:00 Uhr. Eine Verteilung auf die Tage gibt es nicht.
• In den Tages- und Wochenwerten steht der ganze Betrag deshalb nur an dem Tag und in der Woche der Buchung.
• Hast du kein „Gültig ab“ eingetragen, gilt der Grundpreis beim ersten Einrichten ab dem 1. Januar des laufenden Jahres. Der Jahreswert enthält dann alle Monate seit Januar.
• Er zählt nur für Quellen mit „Grundpreis einrechnen“ und „Kosten“. Jede dieser Quellen bucht ihn voll. Haben zwei Quellen derselben Preisdefinition den Haken, zählt er doppelt.

Ab v0.7.0: Bucht schon eine andere Quelle den Grundpreis derselben Preisdefinition, warnen der Assistent und der Tab „Probleme“ („Grundpreis wird doppelt gebucht“, mit „Hier ausschalten“). Beim Start steht außerdem ein Hinweis im Log (#1268). Wie du den Grundpreis richtig zuordnest, steht unter Wie rechne ich einen monatlichen Grundpreis ein?.

Komma oder Punkt?

SourceAnalytix liest beide Schreibweisen: 0,32 und 0.32 ergeben denselben Preis. Das gilt für Preise aus der Tabelle, aus einem Preis-Datenpunkt und für geschriebene Werte in currentPrice. Lass den Tausenderpunkt weg. Ob der Preis richtig angekommen ist, siehst du nach dem Speichern im State sourceanalytix.0.priceDefinitions.<Kategorie>.currentPrice.

IMPORTANT

Ist ein Preis keine Zahl, rechnet SourceAnalytix mit 0 und schreibt Price definition <Kategorie> has no valid unit price …, using 0 to avoid invalid cost calculations ins Log. Die Kosten bleiben dann 0.

Eine neue oder geänderte Preisdefinition gilt erst nach „Speichern“, dabei startet die Instanz neu. Erst danach kannst du sie bei einer Quelle auswählen.

Siehe auch: Wie ordne ich Preise zu und lege eigene Tarife an? · Wie sind Preise als States lesbar und setzbar? · Kosten bleiben 0

Wie benenne ich den Datenpunkt (Alias, Output-ID)?

Kurz: Eine Quelle hat zwei Namen. Der „Name“ ist nur der Anzeigename und lässt sich jederzeit ändern. Die „Technische ID“ ist der Ordner sourceanalytix.0.<Gerät>, in dem alle States der Quelle liegen. Sie legst du am besten beim Anlegen fest, denn eine spätere Änderung zieht den ganzen Ordner um, und Skripte, VIS und History-Abfragen musst du dann anpassen.

	„Name“	„Technische ID“
Wirkt auf	Anzeigename des Ordners und source.name in statisticsJson	State-IDs: sourceanalytix.0.<Gerät>.cumulativeReading, sourceanalytix.0.<Gerät>.currentYear.…
Im Assistenten (ab v0.7.0)	Schritt „Name“	unter „Für Experten“ im Schritt „Name“; vorbelegt aus dem Namen, zum Beispiel strom_haus aus „Strom Haus“
In der Detailansicht (ab v0.7.0)	„Name“ unter „Einstellungen“	„Technische ID“ unter „Einstellungen“, „Für Experten“
Bis v0.6.x im Objekt-Dialog	„Name“	„Ausgabe-ID“, vorbelegt aus der ID des Datenpunkts, Punkte werden zu __
Leer gelassen	Name des Datenpunkts, ohne Namen No name known, please provide alias	ID des Datenpunkts mit __ statt Punkten

Regeln für die technische ID

• Erlaubt sind Buchstaben, Ziffern, _ und -, höchstens 128 Zeichen. Der Vorschlag des Assistenten nutzt nur Kleinbuchstaben, Ziffern und _.
• Die ID muss eindeutig sein. Nutzt sie schon eine andere Quelle, lässt sich nicht speichern („Diese ID nutzt schon eine andere Quelle.“).
• info, priceDefinitions, priceHistory und basicPriceHistory sind belegt, weil SourceAnalytix dort eigene States anlegt.

Wenn du die technische ID änderst

Du änderst die ID in der Detailansicht der Quelle unter „Für Experten“ im Feld „Technische ID“ und klickst auf „⚡ Übernehmen“. Unter dem Feld steht dann „Beim Übernehmen werden alle Werte in den neuen Ordner verschoben. Skripte, Visualisierungen und Historien-Abfragen musst du anpassen.“ SourceAnalytix kopiert den ganzen Ordner mit allen Objekten und Werten unter die neue ID, prüft die Kopie und löscht erst danach den alten Ordner. Während der Kopie rechnet die Quelle nicht. Im Log steht Migrated SourceAnalytix output for <Datenpunkt> from <alte ID> to <neue ID>.

Klappt das nicht, behält SourceAnalytix die alte ID und meldet Cannot use output ID "<neue ID>" for <Datenpunkt>: <Grund>; keeping "<alte ID>". Bricht die Instanz mitten im Umzug ab, räumt SourceAnalytix beim nächsten Start auf und versucht es erneut.

WARNING

Nach dem Umzug zeigen Skripte, VIS-Views, Aliase und History-Abfragen noch auf die alte ID. Passe sie von Hand an. Werte, die ein History-Adapter vor dem Umzug aufgezeichnet hat, bleiben unter der alten ID gespeichert.

Einen anderen Datenpunkt als Quelle zu nutzen und die Daten zu behalten, ist noch nicht möglich. In der Detailansicht steht die Aktion „Datenpunkt wechseln“ deshalb als „geplant“ (#1271).

Siehe auch: Wo finde ich meine Werte? · Migration älterer Versionen und Altlasten · Wie lese ich SourceAnalytix-Werte im Skript?

Welche Quelltypen gibt es (Zähler, Leistung)?

Kurz: Es gibt zwei Arten von Quellen. Ein Zählerstand steigt immer weiter, SourceAnalytix rechnet den Verbrauch aus der Differenz. Eine Leistung zeigt den Momentanwert, SourceAnalytix summiert sie über die Zeit und führt den Gesamtstand selbst. Welche Art eine Quelle hat, ergibt sich aus ihrer Einheit.

	Zählerstand	Leistung
Einheiten	Energie (Wh, kWh …), Volumen (m³, l …), Masse, Länge, piece	Leistung (W, kW …) und piece/min
Anzeige in der Detailansicht (ab v0.7.0)	„Zählerstand · kWh“	„Leistung · W → kWh“
Gesamtstand cumulativeReading	Gerätewert + Offset	beginnt bei 0 und wächst mit jeder Messung
Reset-Erkennung und Schwelle	ja	nein
Startwerte	möglich	nicht nötig, lass sie leer
„Zählerstand angleichen“ (ab v0.7.0)	ja	ja
„Zähler getauscht“ (ab v0.7.0)	ja	nein
Eigene Optionen	–	„Negative Werte ignorieren“, „Mittelwert bei Leistung“, „Maximale Lücke zwischen Leistungswerten (Minuten)“

Eine Quelle mit „Jede Aktualisierung addiert ihren Wert“ verhält sich wie eine Leistung: SourceAnalytix führt den Gesamtstand selbst, es gibt keine Reset-Erkennung und keine Startwerte.

Ob Bezug oder Einspeisung gezählt wird, hängt nicht vom Quelltyp ab, sondern von der „Kostenart“ der Preisdefinition: „Kosten“ füllt consumed und costs, „Erträge“ füllt delivered und earnings.

Beim Anlegen schlägt der Assistent im Schritt „Messart“ die Art aus der Einheit vor. Welchen Datenpunkt du nehmen solltest, wenn ein Gerät beides liefert, steht unter Zähler (kWh) oder Leistung (W)?.

Siehe auch: Wie rechnet SourceAnalytix Watt in kWh um? · Welche Einheiten werden unterstützt? · Was bedeutet „Device reset detected“?