Terme | mc Help Center

Zuletzt geändert: 2025-11-05

Im mathematischen Sinne ermöglicht ein "Term" die Definition von benutzerdefinierten Datenpunkten auf der 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, Messdaten 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 insgesamt erzeugte Energie (E_Z_EVU) zu bestimmen.

Einen Term erstellen

Voraussetzungen

Sie gehören zur Benutzergruppe Techniker, Operations oder Administrator. Siehe Benutzergruppen.

Schritte

Auf ANLAGENEBENE gehen Sie zu Anlagenkonfiguration > Berechnungen > Terme > Term-Editor.

Falls erforderlich, sehen Sie sich die verfügbaren Datenquellen (= Variablen) und die entsprechenden Terme an und wählen Sie relevante Geräte aus der Messwertübersicht aus. Siehe auch Verfügbare Datenpunkte und Kategorien.
Wählen Sie Term, um einen neuen Term zu erstellen.

Definieren Sie den neuen Term:
- Bezeichnung: Geben Sie Ihrem Term eine Bezeichnung. Dies ist ein benutzerfreundlicher Name, der später in Grafiken und Berichten sichtbar sein wird. Die Bezeichnung wird nicht in andere Sprachen übersetzt.
- Kürzel: Geben Sie Ihrem Term eine Kürzel. Dies definiert, wie die Ergebnisse dieses Terms in anderen Terme 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.
- Typ (Aggregation): Wählen Sie aus, 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).
- Einheit: Wählen Sie die Einheit aus, die in Diagrammen und Berichte angezeigt werden soll.
  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.
- Formel: Definieren Sie eine Formel für Ihren Term, die aus Variablen, Zahlen, Operatoren und einfachen oder komplexen Funktionen besteht. Siehe auch Formeln. Falls erforderlich, lesen Sie die Dokumentation oder benutzen Sie den Vorschau der Formelergebnisse für den ausgewählten Tag.
Wählen Sie Speichern.

Der Term erscheint in der Liste der Terme und kann nun in VCOM verwendet werden, zum Beispiel im Power-Flow-Portlet und in den Diagrammen.

📗

Beispiel

Im folgenden Beispiel ist der Datenpunkt E_Z_EVU als die Energiesumme der Wechselrichter definiert.

Weitere Aktionen

Vorschau der Details, Bearbeiten oder Löschen eines Terms, indem Sie den entsprechenden Aktionspunkt in der Liste der Terme auswählen.

Neuberechnung der Terme

Wenn Sie einen Term ändern, müssen Sie möglicherweise alle Terme für vorherige Zeiträume neu berechnen.

Vorsicht

Die Neuberechnung der Terme überschreibt vorherige Werte.

Voraussetzungen

Sie gehören zur Benutzergruppe Techniker, Operations oder Administrator. Siehe Benutzergruppen.

Schritte

Auf ANLAGENEBENE gehen Sie zu Anlagenkonfiguration > Berechnungen > Terme > Term-Editor.
Wählen Sie Neuberechnung der Terme.
Geben Sie den Zeitraum ein, für den Sie alle neu erstellten Terme neu berechnen möchten. Wenn der Neuberechnungszeitraum 1 Jahr überschreitet, müssen Sie eine weitere Neuberechnung durchführen.
Wählen Sie Nachberechnung starten.

Alle Terme wurden jetzt für den ausgewählten Zeitraum neu berechnet und die Diagramme zeigen die neuen Werte an.

Abkürzungen mit besonderer Bedeutung

Eine vollständige Liste aller Abkürzungen finden Sie unter Messwertübersicht.

Abkürzung	Benötigte Einheit	Beschreibung	Verwendung in VCOM	Weitere Details
E_Z_EVU	kWh	Pro Intervall erzeugte Energie für die gesamte Anlage.	Simulation Alarme Diagramme Verschiedene KPIs	Die Standarddefinition von VCOM ist ‚E_INT', die alle Wechselrichter umfasst.
E_Z_x (x = 1...99)	kWh	Andere Messungen erzeugter Energie (Intervallwerte) zum Beispiel für Teilanlagen.	Zählervergleichsdiagramm
G_M0	W/m²	Einstrahlungsstärke auf der Modulebene (POAI)	Simulation Diagramme Verschiedene KPIs	Wenn Ihre Anlage mehrere Einstrahlungssensoren hat, wählen Sie die aus, die Sie in die Formel für G_M0 unter ANLAGENEBENE einbeziehen möchten. Navigieren Sie zu Anlagenkonfiguration > Berechnungen > Terme > Bereich Einstrahlung in Modulebene (POAI). Standardmäßig wird der Durchschnitt aller ausgewählten Sensoren berechnet. Wenn Sensoren zu Teilanlagen mit unterschiedlichen Ausrichtungen gehören, wählen Sie Gewichtung ändern, um dies zu berücksichtigen. Vorsicht Verwenden Sie keine Satellitenstrahlungsdatenpunkte, um G_M0 zu definieren. Die Verfügbarkeit von Satellitendaten ist zeitlich verzögert und auf stündliche Aktualisierungen beschränkt. Dies kann zu Unregelmäßigkeiten in KPIs, Simulationen und verschiedenen Diagrammen führen.
G_Mx (x = 1…99)	W/m²	Andere Messungen der Einstrahlung auf Modulebene (POAI)	Simulation
G_H0	W/m²	Globale horizontale Einstrahlungsstärke (GHI)	Auswertung
G_Hx (x = 1...99)	W/m²	Andere Messungen der globalen horizontalen Einstrahlungsstärke (GHI)	Auswertung
M_AC_E_EXP	kWh	Energienetz-Export	Eigenverbrauchsdiagramm	Für die Erstellung dieser Terme siehe Eigenverbrauchsterme.
M_AC_E_IMP	kWh	Energienetz-Import
M_AC_E_OWN	kWh	Eigenverbrauch von Energie
M_AC_E_CON	kWh	Gesamtverbrauch der Energie
B_E_DISCHARGE_AC	kWh	Batterieentladung
B_E_CHARGE	kWh	Batterieladung
PF_P_GRID	W	Strom Import/Export	Leistungsfluss-Portlet	Erstellen Sie die jeweiligen Terme, indem Sie das Portlet konfigurieren, wenn Sie es zum ersten Mal zu einem Tab hinzufügen.
PF_P_CON	W	Verbrauchsleistung
PF_P_BAT	W	Batterieleistung
T_M0	°C	Modultemperatur pro Intervall für die gesamte Anlage	KPIs Diagramme
T_Mx (x = 1...99)	°C	Andere Messungen der Modultemperatur (Intervallwerte)	Diagramme
T_Ux (x = 0...99)	°C	Messung der Umgebungstemperatur
W_Vx (x = 0…99)	m/s	Messung der Windgeschwindigkeit
W_Dx (x = 0…99)	°	Messungen der 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 Messwertübersicht während der Bearbeitung eines Terms aus. 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.

Available data sources (variables) — 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 / 0` `NULL`	`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 < NULL` `NULL` `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`.	`take_positive(5)` `take_positive(0)` `take_positive(-3)` `take_positive(NULL)`	`5` `NULL` `NULL` `NULL`
`weighted_average`	4..998 (only even) first-value; first-weight; second-value; second-weight;...	Gibt den gewichteten Mittelwert aller Werte zurück, die nicht "null" sind, oder `null`, wenn eine der Gewichtungen `null` ist oder es keine Werte gibt.	`weighted_average(25; 2; 10; 1)` `weighted_average(25; 2; NULL; 1)` `weighted_average(25; 2; 10; NULL)` `weighted_average(NULL; 2; NULL; 1)NULL`	`20` `25` `NULL` `NULL`

Komplexe Funktionen

Liste der komplexen Funktionen

Kennung	Anzahl der Parameter	Beschreibung	Beispiel
			Zeitstempel	Formel	Ergebnis
`Jahr`	0	Gibt das aktuelle Jahr zurück	`2024-02-09 12:00:00`	`year()`	`2024`
`month`	0	Gibt den aktuellen Monat des Jahres zurück (1-12)	`2024-02-09 12:00:00`	`month()`	`2`
`day`	0	Gibt den aktuellen Tag des Monats zurück (1-31)	`2024-02-09 12:00:00`	`day()`	`9`
`before`	1-6 Jahr; Monat = 1; Tag = 1; Stunde = 0; Minute = 0; Sekunde = 0	Gibt `1` zurück, wenn der aktuell ausgewertete Zeitstempel genau vor dem als Parameter angegebenen Datum liegt, andernfalls `0`	`2023-12-31 23:59:59` `2024-01-01 00:00:00`	`before(2024)` `before(2024)`	`1` `0`
`after`	1-6 Jahr; Monat = 1; Tag = 1; Stunde = 0; Minute = 0; Sekunde = 0	Gibt 1 zurück, wenn der aktuell ausgewertete Zeitstempel genau nach dem als Parameter angegebenen Datum liegt, andernfalls `0`.	`2023-12-31 23:59:59` `2024-01-01 00:00:00`	`after(2023; 12; 31; 23; 59; 59)` `after(2023; 12; 31; 23; 59; 59)1`	`0` 1
`before_time`	1-3 Stunde; Minute = 0; Sekunde = 0	Gibt `1` zurück, wenn die Zeit des aktuell ausgewerteten Zeitstempels genau vor der als Parameter angegebenen Zeit liegt, ansonsten `0`.	`04:59:59` `05:00:00`	`before_time(5)` `before_time(5)`	`1` `0`
`after_time`	1-3 Stunde; Minute = 0; Sekunde = 0	Gibt `1` zurück, wenn die aktuell ausgewertete Zeitstempelzeit strikt nach der als Parameter angegebenen Zeit liegt, andernfalls `0`.	`19:59:59` `20:00:00`	`after_time(19; 59; 59)` `after_time(19; 59; 59)`	`0` `1`
`is_monday` `is_tuesday` `is_wednesday` `is_thursday` `is_friday` `is_saturday` `is_sunday`	0	Gibt `1` zurück, wenn der aktuell ausgewertete Zeitstempel auf einen Montag/Dienstag/Mittwoch/Donnerstag/Freitag/Samstag/Sonntag fällt, ansonsten `0`	`2024-02-09 00:00:00` `2024-02-09 23:59:59` `2024-02-10 00:00:00`	`is_friday()` `is_friday()` `is_friday()`	`1` `1` `0`
`sun_up`	0	Gibt `1` zurück, wenn die Sonne über dem Horizont steht, sonst `0`. *Das tatsächliche Ergebnis hängt von der Zeit und dem Standort der Anlage ab.	`2024-02-09 07:30:00` `2024-02-09 07:35:00` `2024-02-09 17:25:00` `2024-02-09 17:30:00`	`sun_up()` `sun_up()` `sun_up()` `sun_up()`	`0` * `1` * 1 * `0` *
`sun_azimuth`	0	Gibt den Azimutwinkel der Sonne in Grad (0=Nord, 180=Süd) zum aktuell ausgewerteten Zeitstempel zurück. *Das tatsächliche Ergebnis hängt von der Zeit und dem Standort der Anlage ab.	`2024-02-09 07:30:00` `2024-02-09 12:00:00` `2024-02-09 17:30:00`	`sun_azimuth()` `sun_azimuth()` `sun_azimuth()`	`110` * `171.74` * `250` *
`sun_elevation`	0	Gibt den Höhenwinkel der Sonne zwischen Horizont und Sonne in Grad zum aktuell ausgewerteten Zeitstempel zurück. *Das tatsächliche Ergebnis hängt von der Zeit und dem Standort der Anlage ab.	`2024-02-09 12:00:00`	`sun_elevation()`	`26.54` *
`delta`	1-3 gesamt; negativer Grenzwert = -∞; positiver Grenzwert = ∞	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`