Slopes (FPScript)

21.09.2021

Sucht nach Flanken vorgegebener Mindeststeilheit in einem Datensatz.

Syntax

Slopes(DataSet, DeltaY, DeltaX, Hysteresis, [ Orientation = EVENT_BOTH ] [ , Operation = EVENT_DEFAULT ])

 

Die Syntax der Slopes-Funktion besteht aus folgenden Teilen:

Teil

Beschreibung

DataSet

Der zu durchsuchende Datensatz.

Erlaubte Datenstrukturen sind Datenreihe, Datenmatrix, Signal und Signalreihe. Es sind alle numerischen Datentypen erlaubt.

Bei komplexen Datentypen erfolgt eine Betragsbildung.

Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste.

DeltaY

Gibt das Y-Intervall an, um das die Amplitude mindestens steigen bzw. fallen muss, damit eine Flanke erkannt wird.

Erlaubte Datenstrukturen sind Einzelwert. Es sind alle numerischen Datentypen erlaubt. Die Einheit muss mit der von Parameter DataSet kompatibel sein.

Bei komplexen Datentypen erfolgt eine Betragsbildung.

Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste.

DeltaX

Gibt das X-Intervall an, innerhalb dem die Amplitude um mindestens den Betrag DeltaY steigen bzw. fallen muss.

Erlaubte Datenstrukturen sind Einzelwert. Es sind alle numerischen Datentypen erlaubt. Die Einheit muss mit der von Parameter DataSet kompatibel sein.

Bei komplexen Datentypen erfolgt eine Betragsbildung.

Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste.

Hysteresis

Gibt den Betrag an, um den die Signalamplitude innerhalb einer Flanke maximal in die Gegenrichtung ausschlagen darf.

Erlaubte Datenstrukturen sind Einzelwert. Es sind alle numerischen Datentypen erlaubt. Die Einheit muss mit der von Parameter DataSet kompatibel sein.

Bei komplexen Datentypen erfolgt eine Betragsbildung.

Ist das Argument eine Liste, dann wird die Funktion für jedes Element der Liste ausgeführt und das Ergebnis ist ebenfalls eine Liste.

Orientation

Gibt an, ob nach fallenden und/oder steigenden Flanken gesucht werden soll.

Das Argument Orientation kann folgende Werte haben:

Konstante

Bedeutung

EVENT_POSITIVE

Nur nach steigenden Flanken suchen.

EVENT_NEGATIVE

Nur nach fallenden Flanken suchen.

EVENT_BOTH

Nach fallenden und steigenden Flanken suchen.

Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert EVENT_BOTH gesetzt.

Operation

Legt die Arbeitsweise der Funktion fest.

Das Argument Operation kann folgende Werte haben:

Konstante

Bedeutung

EVENT_INDEX

Im Ergebnis-Datensatz werden die Indizes der Werte bzw. Punkte abgelegt, die der Bedingung entsprechen.

EVENT_EXTRACT

Nur die Punkte bzw. Werte, die der Bedingung entsprechen, werden in den Ergebnis-Datensatz übertragen.

EVENT_SETVOID

Punkte bzw. Werte, die der Bedingung nicht entsprechen, werden zwar mit in den Ergebnis-Datensatz übernommen, dort aber ungültig markiert.

EVENT_DEFAULT

Entspricht EVENT_SETVOID, wenn eine Datenmatrix oder Signalreihe vorliegt, und ansonsten EVENT_INDEX.

+ EVENT_COMPLEMENT

Diese Konstante kann optional hinzu addiert werden und kehrt dann die gewählte Operation um. Es werden dann z. B. bei EVENT_EXTRACT die Punkte übernommen, die der Bedingung nicht entsprechen.

Ist das Argument eine Liste, dann wird deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

Wenn das Argument nicht angegeben wird, wird es auf den Vorgabewert EVENT_DEFAULT gesetzt.

Anmerkungen

Die Flanken zeichnen sich dadurch aus, dass die Amplitude innerhalb der X-Differenz DeltaX um mindestens den Betrag DeltaY ansteigt bzw. abfällt. In Bezug auf DeltaX wird für Datenreihe und Datenmatrix ein Inkrement von 1 angenommen.

Verfügbarkeit

FlexPro Basic, Professional, Developer Suite

Beispiele

Slopes({0, 0.1, 0, 1.2, 1.3, 1.2, 1.4, 0.3, 0.1}, 1, 5, 0.3)

Ergibt {1L, 5L}. Sucht nach steigenden und fallenden Flanken innerhalb des angegebenen Datensatzes. Zurückgegeben werden die mittleren Indizes der steigenden und fallenden Flanken. Das Intervall der steigenden Flanke, bei der die Amplitude um mindestens 1 steigt, ist {0, 0.1, 0, 1.2}. Der mittlere Index entspricht der Position 1. Das Intervall der fallenden Flanke ist {1.2, 1.3, 1.2, 1.4, 0.3, 0.1}. Der mittlere Index entspricht der Position 5.

Siehe auch

NextSlope-Funktion

SlopesAtLevel-Funktion

NextSlopeAtLevel-Funktion

Analyseobjekt Ereignisisolation

Artikel teilen oder als Email versenden:

Diese Beiträge könnten Sie ebenfalls interessieren