Interne Datenpunkte für SmartSCADA

_SSC_KPI_Instance

Der Datenpunkttyp _SSC_KPI_instance definiert die Struktur einer KPI-Instanz. Ein KPI repräsentiert einen Indikator Ihres Systems.

Beachten Sie, dass der Datenpunkttyp _SSC_KPI_Instance nicht ein interner Datenpunkttyp ist wie andere Typen in diesem Kapitel. Eine KPI-Instanz kann erstellt werden nachdem eine KPI-Definition erstellt wurde. Siehe Datenpunkttyp _SSC_KPI für die KPI-Definition. Im UI werden KPI-Instanzen im Zuweisungspanel des KPI-Wizards erstellt.


Datenpunktelement	Typ	Beschreibung
kpiKey	string	kpiKey ist ein eindeutiger Identifikator einer KPI-Instanz.
result	float	Das result-Element enthält das Resultat einer KPI-Instanz-Berechnung. Eine Berechnungsformel muss für einen KPI definiert werden bevor eine KPI-Instanz erstellt wird und zur Laufzeit berechnet wird. Für Berechnungsformel, siehe Datenpunkttyp _SSC_KPI. Im UI muss eine Berechnungsformel im Definitionspanel des KPI-Wizards definiert werden bevor eine KPI-Instanz im Zuweisungspanel erstellt wird und die Instanz zur Laufzeit berechnet wird.
comment	langstring	Definiert die Beschreibung einer KPI-Instanz. Die Beschreibung beschreibt eine KPI-Instanz detaillierter. Im UI werden die Beschreibungen für KPI-Instanzen im Zuweisungspanel des KPI-Wizards unter "Beschreibung" definiert.
configuration	.kpiName (string)	Der Knoten "configuration" enthält die KPI-Instanz-Konfiguration. Der Knoten "configuration" besteht aus einem Struct-Knoten der mehrere Elemente enthält. Die Elemente und deren Typen werden im Folgenden beschrieben. Die Typen für die Elemente finden Sie in der Spalte links. Das Element kpiName enthält den Namen einer KPI-Definition. Der DP-Name der für das kpiName-Element verwendet wird ist vom Typ _SSC_KPI. Im UI wird die KPI-Definition im Definitionspanel des KPI-Wizards definiert spezifiziert.
	.parameterInstances (string)	Das Element parameterInstances: definiert die Datenpunktelementnamen für die KPI-Parameter. Die Datenpunktelementnamen werden den KPI-Parametern einer KPI-Instanz zugewiesen. Für Parameter, siehe Datenpunkttyp _SSC_KPI. Im UI werden KPI-Instanzen im Zuweisungspanel des KPI-Wizards erstellt und Datenpunktelemente den Parametern im Zuweisungspanel unter "Konfiguration" zugewiesen.
	.trigger (string)	Das Trigger-Element definiert den Datenpunktelement-Namen für den Trigger oder eine Liste von DPE-Namen, wenn ein * (Stern) für den Trigger verwendet wird. Mit Trigger definieren Sie wie eine KPI-Instanz-Berechnung getriggert wird. Im UI wird der Trigger im Zuweisungspanel des KPI-Wizards selektiert.
	.parameterTypes (dyn_int)	Das Element parameterTypes ist ein Dyn-Element und enthält einen Eintrag für jeden KPI-Parameter. Online = 1 bedeutet, dass der Online-Wert des Parameters verwendet wird. Wenn der Parameter Online = 0 ist, ist der Parameter ein konstanter String. Im UI finden Sie die Einträge im Zuweisungspanel des KPI- Wizards. Im Zuweisungspanel werden Checkboxen für die Einträge verwendet.
	.searchInContext (dyn_bool)	Das searchInContext-Element ist ein dyn_bool und enthält einen Eintrag für jeden KPI-Parameter einer KPI-Instanz. Wenn ein Eintrag vom searchInContext TRUE ist, definiert der Eintrag, dass der KPI-Kontext für die Parameter einer KPI-Instanz verwendet werden. Wenn der Eintrag FALSE ist, definiert er, dass der KPI-Kontext nicht verwendet wird. Im UI wird der KPI-Kontext für die Parameter einer KPI-Instanz im Zuweisungspanel des KPI- Wizards selektiert. Siehe auch das Element "context" unterhalb.
	.context (string)	Das context-Element definiert den KPI-Kontext der für die Parameter einer KPI-Instanz verwendet wird. Der Kontext wird verwendet, um nach den Datenpunkten, die den Parametern zugewiesen wurden, zu suchen. Datenpunkttypen, Datenpunkte sowie Anlagenmodellpfade können für den Kontext verwendet werden. Im UI kann der KPI-Kontext den Parametern im Zuweisungspanel des KPI-Wizards zugewiesen werden.
enabled	bool	Das Element wird auf TRUE gesetzt, wenn eine KPI-Instanz aktiviert wird. Aktiviert bedeutet, dass die KPI-Instanz zur Laufzeit berechnet wird. Das bedeutet, dass die verbindung zu den Datenpunkten aufgebaut wird. Im UI werden die KPI-Instanzen im Zuweisungspanel des KPI-Wizards aktiviert.
singleUpdated	bool	Das "singleUpdated"-Element wird auf TRUE gesetzt wenn der "Einzelbearbeitungsmodus" für eine KPI-Instanz selektiert wurde. Der Einzelbearbeitungsmodus selektiert den Namen der KPI-Instanz für den Einzelbearbeitungsmodus. Daher wird nur diese KPI-Instanz geändert, wenn Sie die Parameterwerte ändern. Im UI wird der Einzelbearbeitungsmodus im Zuweisungspanel des KPI-Wizards selektiert.

_SSC_Configuration

_SSC_Configuration ist der globale Konfigurationsdatenpunkttyp. Der Typ beschreibt die Konfigurationen für den Simulator und die KPIs.


Datenpunktelement	Typ	Beschreibung
simulator	string	Enthält den Namen des SmartSCADA Simulator Konfigurations-DPs.
kpi	string	Enthält den Namen des KPI Konfigurations-DPs vom Typ _SSC_KPI_Configuration: "_ssc_kpi_std_configuration".

_SSC_KPI

Der Datenpunkttyp _SSC_KPI definiert einen KPI. IM UI werden KPIs über das Definitionspanel des KPI-Wizards erstellt.

Hinweis

Der Datenpunkt "_SSC_KPI" besitzt das auth-Config mit defaultmäßig gesetzten Berechtigungsstufen für die Configs _address, _default, dp_fct und _original.


Datenpunktelement	Typ	Beschreibung
parameters	dyn_string	Definiert die KPI-Parameter, die zu einem KPI hinzugefügt werden. Im UI werden die Parameter zu einem KPI im Definitionspanel des KPI-Wizards hinzugefügt. Anmerkung: Das Datenpunktelement "parameters" besitzt das auth-Config mit defaultmäßig gesetzten Berechtigungsstufen für die Configs _address, _default, dp_fct und _original.
displayName	langString	Definiert den Namen eines KPIs wie z.B. "Elektrische_Leistung. Im UI werden die Namen über das Definitionspanel des KPI-Wizards erstellt.
kpiFunc	string	Definiert eine KPI-Berechnungsformel, die für einen KPI definiert wird. KPI-Berechnungsformeln werden verwendet, um KPI-Instanzen zur Laufzeit zu berechnen. Im UI werden KPI-Berechnugsformeln im Definitionspanel des KPI-Wizards definiert. Anmerkung: Das Datenpunktelement "kpiFunc" besitzt das auth-Config mit defaultmäßig gesetzten Berechtigungsstufen für die Configs _address, _default, dp_fct und _original.

_SSC_KPI_Configuration

Der Datenpunkttyp _SSC_KPI_Configuration definiert die allgemeinen Einstellungen für das KPI-Framework. Das KPI-Framework ermöglicht die Definition, Konfiguration und Kalkulation von KPIs.


Datenpunktelement	Typ	Beschreibung
unsubscribeFilters	dyn_string	Nur für den internen Gebrauch.
blockingTime	unsigned	Das blockingTime-Element kann verwendet werden, um eine KPI-Berechnung zu blockieren. Dies ist sinnvoll, wenn ein * (Stern) als Trigger verwendet wird und die KPI-Instanz mehrere Parameter enthält, die eine KPI-Berechnung fast gleichzeitig auslösen. Eine KPI-Berechnung wird nicht mehrere Male gleichzeitig ausgelöst solange die gesetzte blockingTime gilt. Die blockingTime wird in Millisekunden angegeben. Für das Datenpunktelement "tigger", siehe Datenpunkttyp SSC_KPI_Instance. Für die Beschreibung des Triggers im UI, siehe Kapitel KPI Wizard - Zuweisung.
kpiFunctions	dyn_string	Definiert die KPI-Funktionen, die für KPI-Berechnungsformeln verwendet werden, um KPI-Instanzen zu berechnen. Es gibt zwei vordefinierte Formeln ssc_kpi_histSum und ssc_predictCondition. Im UI finden Sie die KPI-Funktionen im Definitionspanel des KPI-Wizards. Sie können auch ihre eigenen Funktionen erstellen, siehe KPI-Wizard - Definition.
activeKPIs	unsigned	Nur für den internen Gebrauch.

_SSC_Model

Enthält die Daten für ein Random Forest Modell.

Ein Random Forest ist ein Klassifikationsverfahren, welches aus mehreren Entscheidungsbäumen besteht. Neben der Klassifikation kann der Random Forest auch zur Regression eingesetzt werden. Die WinCC OA SmartSCADA-Onlinehilfe bietet keine detaillierte Information darüber was ein Random Forest-Modell ist, da das Modell ein gängiger Begriff im maschinellen Lernen ist. Detaillierte Informationen finden Sie im Internet.

Ein Random Modell wird über den Klassifikationswizard erstellt. Siehe Kapitel Klassifikation Wizard - Auswahl.


Datenpunktelement	Typ	Beschreibung
model	blob	Enthält das eigentliche Random Forest-Modell.
metadataRef	string	Verweist auf einen Datenpunkt der die Daten des Random Forest Modells enthält.
modelName	string	Typ des Modells. rf = Random Forest.

_SSC_Labelset

Enthält die Labels eines Labelsets. Labels werden verwendet, um verschiedene Stati den Clustern zuzuweisen. Anders gesagt definieren Cluster über Labels welche Stati welchen Datenpunkten in einem WinCC OA -System zugewiesen werden. Für mehr Information Clusters, siehe Klassifikation Wizard - Clustering.


Datenpunktelement	Typ	Beschreibung
labels	dyn_string	Enthält die Labels eines Labelsets. Im UI definieren Sie und weisen Sie Labels den Clustern zu im Clustering-Panel des Klassifikationswizards.

_SSC_METADATA_DM

Enthält die Daten des Data Mining-Wizards. Verwenden Sie den Data Mining-Wizard um Korrelationen zwischen den Datenpunkten zu erkennen. Im Data-Mining-Wizard selektieren Sie Datenpunkte für eine Session und konfigurieren Sie Einstellungen wie den Zeitbereich und äquidistante Zeitintervalle für die selektierten Datenpunktelemente. Die Datenpunktelemente sowie die Einstellungen werden im Datenpunkttyp _SSC_METADATA_DM gespeichert und in der folgenden Tabelle beschrieben.


Datenpunktelement	Typ	Beschreibung
inputDPs	dyn_string	Definiert die Datenpunktelemente für eine Session. Im UI können die Datenpunktelemente im Auswahl-Panel des Data Mining-Wizards selektiert werden.
startTime	time	Definiert die Startzeit für die Datenpunktelemente, die für eine Session selektiert wurden (siehe oberhalb). Das bedeutet die Startzeit des Zeitbereiches, wenn DPE-Werte abgefragt werden. Im UI werden die Datenpunktelemente im Auswahl-Panel des Data Mining-Wizards selektiert. Die Zeitformat ist: JJJJ.MM.TT. SS.MM.SS.mmm.
endTime	time	Definiert die Endzeit für die Datenpunktelemente, die für eine Session selektiert wurden (siehe oberhalb). Das bedeutet die Endzeit des Zeitbereiches, wenn DPE-Werte abgefragt werden. Die Zeitformat ist: JJJJ.MM.TT. SS.MM.SS.mmm.
equiTimeInterval	int	Definiert die Zeit für "äquidistante Zeitintervalle" für Datenpunktelemente, die für die Session selektiert wurden (siehe oberhalb). Die "Äquidistante Zeitintervalle" erlauben es Werte jede [angegebene] Sekunde zu generieren. Dies ist hilfreich, wenn die unterschiedlichen selektierten Datenpunkte nicht die gleiche Anzahl an Werten enthalten. Anders gesagt, ist die "Anzahl" nicht gleich für alle selektierten DPEs. Über den Spinbutton können Werte in Intervallen der angegebenen [Zeit] generiert werden. Abhängig von der Zeit werden Werte z.B. jede 2 Sekunden generiert. Für Datenpunkte siehe das Element inputDPs oberhalb. Im UI kann die Zeit für die "äquidistante Zeitintervalle" über die Checkbox "Äquidistante Zeitintervalle" selektiert werden.
maxLagDetection	int	Gibt die maximale Zeit (Verzögerung) zwischen den Werten aller Datenpunkte an. Mehrere Werte werden oft benötigt, um eine Korrelation zu berechnen. Über "maxLagDetection" können Sie die maximale Zeit angeben, die zwischen allen Werten unterschiedlicher Datenpunkte erlaubt ist. Anders gesagt, die Zeit zwischen zwei Werten, wenn zwei Datenpunkte verglichen werden. Für Datenpunkte siehe das Element inputDPs oberhalb. Im UI setzen Sie den Wert über die Checkbox Lag Erkennung anwenden des Auswahl-Panels.
quality	bool	Wird auf TRUE gesetzt, wenn die Qualitätskennzahlen berechnen-Checkbox im UI aktiviert wurde. Die Checkbox "Qualitätskennzahlen berechnen" wird angezeigt, wenn die Checkbox "Äquidistante Zeitintervalle" aktiviert wurde. Wenn Sie die Checkbox aktivieren, wird der Mittelwert des Intervalls (argValInt), die Anzahl der durchschnittlichen absoluten Fehler (MAE) und die Anzahl der durchschnittlichen normalisierten absoluten Fehler (NMAE) berechnet.
selectedDPs	dyn_string	Definiert die Datenpunktelemente, die für die Korrelation selektiert wurden. Im UI werden die Datenpunktelemente im Korrelationspanel des Data Mining-Wizards für die Korrelation selektiert.
lastSaved	time	Enthält die Zeit als der selektierte Zeitbereich und die selektierten Datenpunktelemente für die Session im Auswahl-Panel des Data Mining-Wizards über die "Übernehmen"- Schaltfläche gespeichert wurden. Die Zeitformat ist: JJJJ.MM.TT. SS.MM.SS.mmm.

_SSC_METADATA_KM

Enthält die Daten des Klassifikation-Wizards. Mit dem Klassifikation-Wizard generieren Sie Cluster. Cluster definieren über Labels welche Stati welchen Datenpunktwerten in einem WinCC OA -System zugewiesen werden. Danach wird der Klasssifikation-Wizard verwendet, um ein Random Forest Modell zu erstellen und um Grundursachen zu identifizieren.

Für mehr Information über den Klassifikation-Wizard, siehe Kapitel Übersicht des Klassifikation-Wizards.


Datenpunktelement	Typ	Beschreibung
clusterVector	dyn_uint	Enthält den Cluster-Vektor.
centers	dyn_float	Definiert die Datenpunktelementwerte der Cluster. Im UI werden die Werte im Clustering-Panel des Klassifikation-Wizards angezeigt. Die Datenpunkte deren Werte für die Cluster angezeigt werden, werden im ersten Schritt im Auswahl-Panel des Klassifikation-Wizards selektiert.
numClusters	int	Definiert die Anzahl der Cluster. Im UI wird die Anzahl der Cluster im Clustering-Panel des Klassifikation-Wizards definiert.
inputDPs	dyn_string	Definiert die Datenpunktelemente für das Clustering. Im UI werden die Datenpunktelemente im Auswahlpanel des Klassifikation-Wizards selektiert.
startTime	time	Definiert die Startzeit für die selektierten Datenpunktelemente (siehe inputDPs oberhalb). Das bedeutet die Startzeit des Zeitbereiches, wenn DPE-Werte abgefragt werden. Die Zeitformat ist: JJJJ.MM.TT. SS.MM.SS.mmm. Im UI wird die Startzeit im Auswahl-Panel des Klassifikation-Wizards selektiert.
endTime	time	Definiert die Endzeit für die selektierten Datenpunktelemente (siehe inputDPs oberhalb ). Das bedeutet die Endzeit des Zeitbereiches, wenn DPE-Werte abgefragt werden. Die Zeitformat ist: JJJJ.MM.TT. SS.MM.SS.mmm. Im UI wird die Endzeit im Auswahl-Panel des Klassifikation-Wizards selektiert.
labelsetRef	string	Definiert den Namen des Labelsets das für die Cluster verwendet wird. Ein Labelset enthält die Labels, die verwendet werden, um Stati den Datenpunktelementwerten in einem WinCC OA -System zuzuweisen. Im UI wird das Labelset im Clustering-Panel des Klassifikation-Wizards selektiert.
labelMapping	dyn_int	Definiert ein Mapping der Labels und deren Werte. Das ist ein dyn_int-Element und es wird ein Wert für jedes Label das für die Cluster verwendet wird, hinzugefügt. Das bedeutet, dass wenn es z.B. drei Labels gibt: "Zu hoch", "Zu nieder" und "OK" enthält das dyn_int-Element die Nummern 1,2, und 3. Das dyn_int-Element enthält die Nummern ein- oder mehrere Male abhängig von der Anzahl der Cluster und davon wie oft ein Label einem Cluster zugewiesen wurde. Wenn z.B. das Label "OK" für zwei Cluster verwendet wurde, enthält das labelMapping-Element die Nummer 3(OK) zwei Mal. Im UI werden die Labels den Clustern im Clustering-Panel des Klassifikation-Wizards zugewiesen.
equiTimeInterval	int	Definiert die Zeit für "äquidistante Zeitintervalle". Die "Äquidistante Zeitintervalle" erlauben es Werte jede [angegebene] Sekunde zu generieren. Dies ist hilfreich, wenn die unterschiedlichen selektierten Datenpunkte nicht die gleiche Anzahl an Werten enthalten. Anders gesagt, ist die "Anzahl" nicht gleich für alle selektierten DPEs. Über "Äquidistante Zeitintervalle" können Werte in Intervallen der angegebenen [Zeit] generiert werden. Abhängig von der Zeit werden Werte z.B. jede 2 Sekunden generiert. Im UI kann die Zeit für die "äquidistante Zeitintervalle" über die Checkbox "Äquidistante Zeitintervalle" im Auswahlpanel des Klassifikation-Wizards selektiert werden.

_SSC_METADATA_RF

Enthält die Daten für ein Random Forest Modell, wenn ein Modell über das Klassifikationswizard erstellt wird.


Datenpunktelement	Typ	Beschreibung
confusionMatrix	.elements (dyn_string)	Der Knoten "confusionMatrix" besteht aus einem Struct-Knoten der mehrere Elemente enthält. Die Elemente und deren Typen werden im Folgenden beschrieben. Die Typen für die Elemente finden Sie in der Spalte links. Das elements-Element definiert die einzelnen Werte der Fehlermatrix. Die Fehlerrate zeigt, wie exakt die Voraussage eines Zustandsin einem Modell ist. Im UI wird die Fehlermatrix im Qualitätpanel des Klassifikationswizards angezeigt.
	.rowHeaders (dyn_string)	Nur für internen Gebrauch.
	.columnHeaders (dyn_string)	Nur für internen Gebrauch.
importanceMatrix	elements (dyn_string)	Der Knoten "importanceMatrix" besteht aus einem Struct-Knoten der mehrere Elemente enthält. Die Elemente und deren Typen werden im Folgenden beschrieben. Die Typen für die Elemente finden Sie in der Spalte links. Das elements-Element definiert die einzelnen Werte der Wichtigkeitsmatrix. Die Wichtigkeitsmatrix zeigt, wie wichtig jede Datenpunktvariable für das Modell ist. Im UI wird die Wichtigkeitsmatrix im Qualitätpanel des Klassifikationswizards angezeigt.
	.rowHeaders (dyn_string)	Nur für internen Gebrauch.
	.columnHeaders (dyn_string)	Nur für internen Gebrauch.
headers	dyn_string	Definiert die Datenpunkt-Headers für die Wichtigkeitsmatrix. Diese sind erforderlich, um die Wichtigkeit der einzelnen Datenpunktelement-Variablen anzuzeigen.
clusterModel	string	Definiert den Modellnamen des Random Forest Modells. Der Name des Modells wird im UI eingegeben, wenn eine Session im Auswahl-Panel des Klassifikation-Wizards erstellt wird. Das Modell wird dann im Training-Panel erstellt.
inputDPs	dyn_string	Definiert die Datenpunkte, die für das Random Forest Modell sowie später für den Klassifikationstest im Qualitätpanel des Klassifikationswizards verwendet werden.
outOfBagError	float	Enthält die OOB-Fehlerrate. Die OOB- Fehlerrate definiert den voraussichtlichen Prozentsatz von Elementen, die nicht korrekt klassifiziert werden können. Das heißt den Prozentsatz der Datenpunktelemente die für das Modell selektiert wurden und nicht über Labels klassifiziert werden können. Im UI finden Sie die OOB-Fehlerrate im Qualitätspanel des Klassifikationswizards.
startTime	time	Definiert die Startzeit für die selektierten Datenpunktelemente. Das bedeutet die Startzeit des Zeitbereiches, wenn DPE-Werte abgefragt werden. Die Zeitformat ist: JJJJ.MM.TT. SS.MM.SS.mmm. Im UI selektieren Sie die Startzeit für das Modell im Auswahlpanel des Klassifikationswizards.
endTime	time	Definiert die Endzeit für die selektierten Datenpunktelemente. Das bedeutet die Endzeit des Zeitbereiches, wenn DPE-Werte abgefragt werden. Die Zeitformat ist: JJJJ.MM.TT. SS.MM.SS.mmm. Im UI selektieren Sie die Endzeit für das Modell im Auswahlpanel des Klassifikationswizards.
labelVector	dyn_string	Enthält einen Vektor der definierten Labels. Das ist ein dyn_string-Element und ein Wert wird für jedes Label das für die Cluster verwendet wird, hinzugefügt. Wenn es, z.B. drei Labels gibt: "Zu hoch", "Zu nieder" und "OK" enthält das dyn_string-Element die Nummern 1,2 und 3 in einem Vektor. Im UI werden die Labels den Clustern im Clustering-Panel des Klassifikationswizards zugewiesen.
labelsetRef	string	Enthält den Namen eines Labelsets. Das Labelset enthält die Labels die für die Cluster verwendet werden. Im UI wird ein Labelset im Clustering-Panel des Klassifikationswizards erstellt und selektiert.
equiTimeInterval	int	Definiert die Zeit für "äquidistante Zeitintervalle". Die "Äquidistante Zeitintervalle" erlauben es Werte jede [angegebene] Sekunde zu generieren. Dies ist hilfreich, wenn die unterschiedlichen selektierten Datenpunkte nicht die gleiche Anzahl an Werten enthalten. Anders gesagt, ist die "Anzahl" nicht gleich für alle selektierten DPEs. Über "Äquidistante Zeitintervalle" können Werte in Intervallen der angegebenen [Zeit] generiert werden. Abhängig von der Zeit werden Werte z.B. jede 2 Sekunden generiert. Im UI kann die Zeit für die "äquidistante Zeitintervalle" im Auswahlpanel des Klassifikationswizards eingegeben werden.
feedbackData	dyn_float	Nur für internen Gebrauch.
feedbackDataLabel	dyn_int	Nur für internen Gebrauch.