Daten verarbeiten

Eine Action verarbeitet die ausgewählten Eingangssymbole und erzeugt daraus neue Ausgangssymbole — beispielsweise Kennwerte, reduzierte Datenraten oder berechnete Ergebnisse. Anders als bei einer Condition werden nicht alle Eingangssymbole weitergegeben, sondern nur die zuvor ausgewählten. Actions sind Bausteine innerhalb einer Rule. Sie werden über AddAction<T>() an der Rule erzeugt. Alle Actions haben folgende Eigenschaften und Methoden:

Eigenschaft

Beschreibung

Properties

Parametrierung der Action

Methode

Beschreibung

UseSymbol(IConfigSymbol symbol)

Nimmt ein einzelnes Symbol in die Verarbeitung auf.

RemoveSymbol(IConfigSymbol symbol)

Entfernt ein einzelnes Symbol aus der Verarbeitung.

UseAllSymbols(int lastConditionID = 0)

Nimmt alle verfügbaren Symbole auf. Optional kann die ID einer Condition angegeben werden, sodass alle Symbole dieser Condition verwendet werden.

RemoveAllSymbols()

Entfernt alle ausgewählten Symbole.

Min/Max/Avg Action (IMinMaxAvgAction)

Berechnet Minimum, Maximum und Mittelwert der ausgewählten Symbole. Die Parametrierung erfolgt über das Properties-Objekt.

Eigenschaft

Beschreibung

WithInterval

Gibt an, ob die Berechnung über ein Zeitintervall erfolgt.

IntervalTime

Zeitintervall, über das berechnet wird.

Methode

Beschreibung

SetIntervalTime(TimeSpan timeSpan)

Legt das Zeitintervall fest, über das berechnet wird.

ResetInterval()

Hebt das Zeitintervall auf; die Berechnung erfolgt über alle verfügbaren Daten.

Zusätzliche Methoden der Action:

Methode

Beschreibung

GetMinOutput(IConfigSymbol symbol)

Liefert das Ausgangssymbol mit dem Minimum des angegebenen Eingangssymbols.

GetMaxOutput(IConfigSymbol symbol)

Liefert das Ausgangssymbol mit dem Maximum des angegebenen Eingangssymbols.

GetAvgOutput(IConfigSymbol symbol)

Liefert das Ausgangssymbol mit dem Mittelwert des angegebenen Eingangssymbols.

StdDev Action (IStdDevAction)

Berechnet die Standardabweichung der ausgewählten Symbole. Die Parametrierung erfolgt über das Properties-Objekt.

Eigenschaft

Beschreibung

UseBesselCorrection

Gibt an, ob die Bessel-Korrektur verwendet wird.

SelectedWindowMode

Fenstermodus der Berechnung: gleitendes Fenster, festes Fenster oder fortlaufend.

WindowSize

Größe des Berechnungsfensters

Methode

Beschreibung

SetUseBesselCorrection(bool useUseBesselCorrection)

Aktiviert oder deaktiviert die Bessel-Korrektur.

SetSelectedWindowMode(TcIoTAlySPWindowMode windowMode)

Legt den Fenstermodus der Berechnung fest.

SetWindowSize(int windowSize)

Legt die Größe des Berechnungsfensters fest.

Zusätzliche Methoden der Action:

Methode

Beschreibung

GetStandardDeviation(IConfigSymbol inputSymbol)

Liefert das Ausgangssymbol mit der Standardabweichung des angegebenen Eingangssymbols.

Downsampling Action (IDownsamplingAction)

Reduziert die Datenrate der ausgewählten Symbole. Die Parametrierung erfolgt über das Properties-Objekt.

Eigenschaft

Beschreibung

DownsamplingFactor

Faktor, um den die Datenrate reduziert wird.

Methode

Beschreibung

SetDownsamplingFactor(int downsamplingFactor)

Legt den Reduktionsfaktor fest; der Wert muss größer als eins sein.

Zusätzliche Methoden der Action:

Methode

Beschreibung

GetSampledOutput(IConfigSymbol inputSymbol)

Liefert das reduzierte Ausgangssymbol des angegebenen Eingangssymbols.

EdgeCounter Action (IEdgeCounterAction)

Erkennt und zählt Flanken auf den ausgewählten Symbolen. Die Parametrierung erfolgt über das Properties-Objekt.

Eigenschaft

Beschreibung

Operator

Vergleichsoperator für die Flankenerkennung (EdgeOperator).

Threshold

Schwellwert für die Flankenerkennung.

Methode

Beschreibung

SetValues(EdgeOperator operatorEdge, float thresholdEdge)

Legt Vergleichsoperator und Schwellwert für die Flankenerkennung fest.

Zusätzliche Methoden der Action:

Methode

Beschreibung

GetEdgeOutput(IConfigSymbol inputSymbol)

Liefert das Ausgangssymbol, das die erkannte Flanke signalisiert.

GetCountOutput(IConfigSymbol inputSymbol)

Liefert das Ausgangssymbol mit der Anzahl der erkannten Flanken.

GetLastEventOutput(IConfigSymbol inputSymbol)

Liefert das Ausgangssymbol mit dem Zeitpunkt der zuletzt erkannten Flanke.

MathOperation Action (IMathOperationAction)

Verknüpft die ausgewählten Symbole mathematisch und kann zusätzlich einen festen Wert auf das Ergebnis anwenden. Die Parametrierung erfolgt über das Properties-Objekt.

Eigenschaft

Beschreibung

VariableOperator

Operator, mit dem die ausgewählten Variablen verknüpft werden (MathOperator).

UseValue

Gibt an, ob zusätzlich ein fester Wert auf das Ergebnis angewendet wird.

Value

Fester Wert, der auf das Ergebnis angewendet wird.

ValueOperator

Operator, mit dem der feste Wert auf das Ergebnis angewendet wird.

Methode

Beschreibung

SetVariableOperator(MathOperator mathOperator)

Legt den Operator für die Verknüpfung der Variablen fest.

SetValue(MathOperator mathOperator, double value)

Legt den festen Wert und den zugehörigen Operator fest.

ResetValue()

Entfernt den festen Wert; es wird nur die Variablenverknüpfung berechnet.

Zusätzliche Methoden der Action:

Methode

Beschreibung

GetOutputSymbol()

Liefert das Ausgangssymbol mit dem Ergebnis der Berechnung.

Im Unterschied zu den übrigen Actions erzeugt die MathOperation Action kein Ausgangssymbol je Eingangssymbol, sondern ein einzelnes Ergebnissymbol aus der Verknüpfung aller ausgewählten Symbole.