SlopesAtLevel (FPScript)
Sucht in einem Datensatz nach Flanken vorgegebener Mindeststeilheit, die einem bestimmten Pegel durchlaufen müssen.
Syntax
SlopesAtLevel(DataSet, Level, DeltaY, DeltaX, Hysteresis, [ Orientation = EVENT_BOTH ] [ , Operation = EVENT_DEFAULT ])
Die Syntax der SlopesAtLevel-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. |
||||||||||||
Level |
Gibt den Pegel an, den die Flanken durchlaufen müssen. 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. |
||||||||||||
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:
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:
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 diese den vorgegeben Pegel durchlaufen und 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
SlopesAtLevel({0, 0.4, 1., 1.2, 1.3, 1.2, 1.4, 0.7, 0.3, 0.1}, 0.5, 0.5, 5, 0.3) |
Ergibt {1L, 7L}. Sucht nach steigenden und fallenden Flanken innerhalb des angegebenen Datensatzes. Zurückgegeben werden die Indizes, an denen der Pegel 0,5 mit der geforderten Steilheit durchschritten wird. |