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.