Im mathematischen Sinne ermöglicht ein "Term" die Definition von benutzerdefinierten Datenpunkten auf Anlagenebene unter Verwendung Ihrer eigenen Formel, die für die verwendeten Variablen für jeden verfügbaren Zeitstempel ausgewertet wird.
Der Term editor in VCOM ermöglicht es Ihnen, gemessene Daten aus Ihrer Anlage zu verarbeiten und Key Performance Indicators zu generieren. Terme sind Bestandteil von Diagrammen, Simulationen, KPIs, Auswertungen und bestimmten Portlets.
📗
Beispiel
Sie können Terme verwenden, um den Durchschnitt für mehrere Sensoren zu berechnen oder um die Parameter zu definieren, um die gesamte Energie (E_Z_EVU) zu bestimmen.
Term-Editor
Term-Editor
Neuen Term erstellen
Nr.
Name
Details
1
Term
Neuen Term erstellen
2
Neuberechnung der Terme
Berechnen Sie alle Terme innerhalb eines ausgewählten Zeitraums neu. Überschreibt die vorherigen Werte.
3
Bezeichnung
Die Bezeichnung eines Terms ist ein benutzerfreundlicher Name und wird später in Diagrammen und Reports sichtbar sein.
4
Abkürzung
Die Abkürzung eines Terms definiert, wie die Ergebnisse dieses Terms in anderen Termen und über die VCOM-API referenziert werden können. Verwenden Sie nach Möglichkeit die festgelegten Abkürzungen. Siehe Term-Abkürzungen mit einer besonderen Bedeutung
5
(Aggregations-) Typ
Das Feld Typ beschreibt, wie die Werte, die dieser Term liefert, aggregiert werden sollen. Derzeit gibt es zwei Möglichkeiten:
Summe: Die Ergebnisse werden über die Zeit aufsummiert (z. B. Energiewerte).
Mittelwert: Mittelwert der Ergebnisse über die Zeit (z. B. die Temperaturwerte).
Wichtig: Wenn die Einheit W/m² verwendet wird, sollte der Typ Mittelwert gewählt werden, da die Aggregation bei Zeitintervallen von mehr als einer Stunde automatisch auf die Einheit Wh/m² umschaltet.
6
Einheit
Hier wird die Einheit ausgewählt, die in Diagrammen und Reports angezeigt werden soll.
7
Formel
Die Formeln bestehen aus den folgenden Elementen. Siehe auch Formeln
Variablen
Zahlen
Operatoren
Funktionen: einfach und komplex
Augen-Icon: Vorschau der Formelergebnisse für den ausgewählten Tag
8
Messwertübersicht
Übersicht über die verfügbaren Datenquellen (=Variablen) und die entsprechenden Terme für Ihre Anlage
Terme erstellen: allgemeiner Arbeitsablauf
Voraussetzungen
Keine
Schritte
Gehen Sie zur Anlagenkonfiguration > Berechnungen > Terme > Term-Editor > Term.
Datenquellen anzeigen und relevante Geräte auswählen (Messwertübersicht).
Die Terme können dann in ganz VCOM verwendet werden, z. B. im Leistungsfluss Portlet und in den Diagrammen.
Abkürzungen mit besonderer Bedeutung
Abkürzung
Benötigte Einheit
Verwendung in VCOM
Beschreibung
E_Z_EVU
kWh
Simulation, Alarme, Diagramme, verschiedene KPIs
Pro Intervall erzeugte Energie für die gesamte Anlage
E_Z_PV(1..x)
kWh
Zählervergleichsdiagramm
G_M0
W/m²
Simulation, Diagramme, verschiedene KPIs
Gewichtete Bestrahlungsstärke auf der Modulebene
G_H0
W/m²
Auswertung
Gewichtete Bestrahlungsstärke in der horizontalen Ebene
G_Mx (x = 1..99)
W/m²
Simulation
Andere Messungen der Bestrahlungsstärke auf der Modulebene
G_Hx (x = 1..99)
W/m²
Auswertung
Andere Messungen der Bestrahlungsstärke in der horizontalen Ebene
E_Z_PVx (x= 1..99)
kWh
Energievergleichsdiagramm, Auswertung
T_M0
°C
KPIs
Modultemperatur pro Intervall für die gesamte Anlage
T_U(0..x)
°C
Umgebungstemperatur
M_AC_E_EXP
kWh
Eigenverbrauchsdiagramm
Energieexport
M_AC_E_IMP
kWh
Eigenverbrauchsdiagramm
Energieimport
M_AC_E_OWN
kWh
Eigenverbrauchsdiagramm
Eigenverbrauch von Energie
PF_P_GEN
W
Leistungsfluss-Portlet
PV-Leistung
PF_P_GRID
W
Leistungsfluss Portlet
Strom Import/Export
PF_P_CON
W
Leistungsfluss Portlet
Verbrauchsleistung
PF_P_BAT
W
Leistungsfluss Portlet
Batterieleistung
W_V(0..x)
m/s
Windgeschwindigkeit
W_D(0..x)
°
Windrichtung
Formeln
Variablen und Datenquelle
Sie müssen für jede Formel mindestens eine Variable angeben, sonst wird nichts berechnet. VCOM gibt Ihnen einen Überblick über die verfügbaren Datenquellen (=Variablen) und die entsprechenden Terme für Ihre Anlage. Wählen Sie dazu bei der Bearbeitung eines Terms die Messwertübersicht. Im Allgemeinen beginnen und enden alle Variablen mit einem Hochkomma ('). Jedes konfigurierte Gerät kann separat über das Dropdown-Menü ausgewählt werden. Wenn kein Gerät ausgewählt ist, wird die Summe aller Geräte genommen.
Verfügbare Datenquellen (=Variablen)
Hinweise
Das Ergebnis des Terms ist nicht an ein bestimmtes Gerät gebunden; selbst wenn es die Werte eines Geräts verwendet, gilt es für die gesamte Anlage und ist nicht mit einem bestimmten Gerät verbunden.
Um die Sache zu vereinfachen, wird das unten verwendete Beispiel keine Variablen verwenden und NULL verwenden, um einen Nullwert darzustellen, der von einer Variablen oder Berechnung zurückgegeben wird.
Zahlen
Zusätzlich zu Variablen können auch Zahlen verwendet werden. Sowohl , als auch . können als Dezimaltrennzeichen verwendet werden. Tausendertrennzeichen und wissenschaftliche Notation werden nicht unterstützt.
Operatoren
Um mehrere Variablen (und Zahlen) zu kombinieren, stehen verschiedene Operatoren zur Verfügung. Im Allgemeinen liefern alle Operatoren null, wenn einer der Operanden null ist. Die einzige Ausnahme von dieser Regel ist ??. Der Vorrang beschreibt die Reihenfolge der Berechnung, wobei Operatoren mit höherer Vorrang vor dem niedrigeren Vorrang ausgewertet werden.
Liste der Operatoren
Vorrang
Icon
Name
Beschreibung
Beispiel
Formel
Ergebnis
8
()
Parenthesis
Die Paare müssen ausgeglichen sein. Andere Arten von Klammern wie[] oder {} werden nicht unterstützt.
2 * (2 + 3)
10
7
!
Boolean-Negation
Gibt 0 für 1 und 0 für alles andere zurück. Dies ist ein unärer Operator, der dem Operanden vorangestellt wird.
!0
!1
!(-1)
1
0
0
7
-
Arithmetic-Negation
Gibt die arithmetische Negation der Variablen zurück. Dies ist ein unärer Operator, der dem Operanden vorangestellt wird.
-0
-1
-(-1)
0
-1
1
6
^
Exponentiation
Gibt den linken Operanden als Potenz des rechten Operanden zurück.
2 ^ 3
NULL ^ 3
2 ^ NULL
8
NULL
NULL
5
*
Multiplication
Gibt das Produkt der beiden Operanden zurück.
2 * 3
NULL * 3
2 * NULL
6
NULL
NULL
5
/
Division
Gibt den linken Operanden geteilt durch den rechten Operanden zurück. Gibt null zurück, wenn der rechte Operand 0 ist.
2 / 4
NULL / 3
2 / NULL
2 / 0NULL
0.5
NULL
NULL
NULL
5
%
Remainder
Gibt den Rest der Division des linken Operanden durch den rechten Operanden zurück. Gibt null zurück, wenn der rechte Operand 0 ist.
2 % 4
NULL % 3
2 % NULL
2 % 0
2
NULL
NULL
NULL
4
+
Addition
Gibt die Summe der beiden Operanden zurück.
2 + 3
NULL + 3
2 + NULL
5
NULL
NULL
4
-
Subtraction
Gibt den zweiten Operanden subtrahiert vom ersten Operanden zurück.
2 - 3
NULL - 3
2 - NULL
-1
NULL
NULL
3
==
Equality
Gibt 1 zurück, wenn der linke Operand gleich dem rechten Operanden ist, sonst 0.
2 == 2
2 == 3
2 == NULL
NULL == NULL
1
0
NULL
NULL
3
!=
Non-Equality
Gibt 0 zurück, wenn der linke Operand nicht gleich dem rechten Operanden ist, sonst 1.
2 != 3
2 != 2
2 != NULL
NULL != NULL
1
0
NULL
NULL
3
<
Less-Than
Gibt 1 zurück, wenn der linke Operand strikt kleiner als der rechte Operand ist, ansonsten 0.
2 < 3
2 < 2
2 < NULLNULL
NULL < NULL
1
0
NULL
NULL
3
>
Greater-Than
Gibt 1 zurück, wenn der linke Operand strikt größer als der rechte Operand ist, ansonsten 0.
2 > 1
2 > 2
2 > NULL
NULL > NULL
1
0
NULL
NULL
3
<=
Less-Or-Equal
Gibt 1 zurück, wenn der linke Operand kleiner oder gleich dem rechten Operanden ist, sonst 0.
2 <= 3
3 <= 2
2 <= NULL
NULL <= NULL
1
0
NULL
NULL
3
>=
Greater-Or-Equal
Gibt 1 zurück, wenn der linke Operand größer oder gleich dem rechten Operanden ist, sonst 0.
2 >= 2
2 >= 3
2 >= NULL
NULL >= NULL
1
0
NULL
NULL
2
&&
Logical And
Gibt 1 zurück, wenn beide Operanden ungleich 0 sind, sonst 0.
1 && 1
1 && 0
0 && 0
NULL && 1
1
0
0
NULL
2
||
Logical Or
Gibt 1 zurück, wenn einer der beiden Operanden nicht 0 ist, sonst 0.
1 || 1
1 || 0
0 || 1
0 || 0
NULL || 1
1
1
1
0
NULL
1
??
Null-Coalesce
Gibt den Wert des linken Operanden zurück, wenn dieser nicht null ist, andernfalls wird der rechte Operand zurückgegeben.
0 ?? 1
NULL ?? 1
0
1
Funktionen
Zusätzlich zu den Operatoren können Funktionen die Komplexität von Formeln erheblich reduzieren. Funktionsaufrufe bestehen aus einem Funktionsbezeichner, gefolgt von einer Liste von Parametern (getrennt durch ; ) in Klammern ( ). Der Aufruf von Funktionen mit weniger/mehr Parametern als erforderlich ist ein Fehler.
Einfache Funktionen
Liste der einfachen Funktionen
Kennung
Anzahl der Parameter
Beschreibung
Beispiel
Formel
Ergebnis
sum
2-999
Gibt die Summe aller Nicht-null-Parameter zurück, null, wenn es keine gibt.
sum(3; 3)
sum(2; NULL)
sum(NULL; NULL)
6
2
NULL
average
2-999
Gibt den Mittelwert aller Parameter zurück, die nicht null sind, oder null, wenn es keine gibt.
average(2; 4)
average(10; NULL; 30)
average(NULL; NULL)
3
20
NULL
median
2-999
Gibt den Median aller Nicht-null-Parameter zurück, null, wenn es keine gibt.
median(7; 3; 5)
median(7; NULL; 5)
median(NULL; NULL)
5
6.5
NULL
min
2-999
Gibt den kleinsten aller Nicht-null-Parameter zurück, null, wenn es keine gibt.
min(-1; 5; 3)
min(NULL; 5; 3)
min(NULL; NULL)
-1
3
NULL
max
2-999
Liefert den größten Wert aller Parameter, die nicht null sind, oder null, wenn es keine gibt.
max(-1; 5; 3)
max(-1; NULL; 3)
max(NULL; NULL)
5
3
NULL
pi
0
Gibt den Wert von pi zurück.
pi()
3,1415926535898
sin
1
Gibt den Sinus des Parameters zurück. Der Parameter muss im Bogenmaß angegeben werden, nicht in Grad. Gibt null zurück, wenn der Parameter null ist.
sin(pi()/2)
sin(0)
sin(NULL)
1
0
NULL
cos
1
Gibt den Kosinus des Parameters zurück. Der Parameter muss im Bogenmaß angegeben werden, nicht in Grad. Gibt null zurück, wenn der Parameter null ist.
cos(pi())
cos(0)
cos(NULL)
-1
1
NULL
if
2-3
Gibt den zweiten Parameter zurück, wenn der erste Parameter ungleich 0 oder null ist, andernfalls den dritten Parameter (falls gegeben) oder null.
if(1; 2)
if(0; 2)
if(NULL; 2)
if(-1; 2; 3)
if(0; 2; 3)
if(NULL; 2; 3)
2
NULL
NULL
2
3
3
select
2-999
Gibt den n-ten Parameter nach dem ersten Parameter zurück, wobei der Wert von n der erste Parameter ist, null, wenn kein Parameter gefunden wird.
select(1; 2; 3; 4)
select(2; 2; 3; 4)
select(3; 2; 3; 4)
select(4; 2; 3; 4)
2
3
4
NULL
take_positive
1
Gibt den ersten Parameter zurück, wenn er strikt größer als Null ist, ansonsten null.
Gibt die Differenz zwischen dem ersten Parameter dieses Zeitstempels und dem ersten Parameter des letzten Zeitstempels zurück; null, wenn außerhalb der Grenzen.
¹ Das erste Ergebnis der delta-Funktion an jedem Tag ist immer NULL
² Wenn die übergebene Summe NULL ist, wird die letzte Summe für die nächste Auswertung wieder verwendet
2024-02-09 00:00:00
2024-02-09 00:05:00
2024-02-09 00:10:00
2024-02-09 00:15:00
2024-02-09 00:20:00
delta(50)
delta(60)
delta(50)
delta(NULL)
delta(60)
NULL ¹
10
-10
NULL ²
10
tilted_irradiance
3
Gibt die geneigte Bestrahlungsstärke zurück, die aus dem Wert der horizontalen Bestrahlungsstärke (erster Parameter), der Neigung der Oberfläche (zweiter Parameter) und der Ausrichtung der Oberfläche (dritter Parameter) berechnet wird; null, wenn einer der beiden Parameter null ist.
*Das tatsächliche Ergebnis hängt von der Zeit und dem Standort der Anlage ab.
tilted_irradiance(800; 20; 180)
tilted_irradiance(NULL; 20; 180)
tilted_irradiance(800; NULL; NULL)
926 *
NULL
NULL
Beispiel: Energie-Summe
📗
Beispiel
Im folgenden Beispiel ist der Datenpunkt E_Z_EVU als die Energiesumme der Wechselrichter definiert.
Term Beispiel: Energiesumme
JavaScript errors detected
Please note, these errors can depend on your browser setup.
If this problem persists, please contact our support.
.png){kind=logo}
Anlagenkonfiguration > Berechnungen > Terme > Term-Editor > Term.
Messwertübersicht. Im Allgemeinen beginnen und enden alle Variablen mit einem Hochkomma (
