NextSlope (FPScript)

07.02.2018
 Daten mathematisch analysieren > Referenz > FPScript-Funktionen > Ereignisisolation > NextSlope

NextSlope (FPScript)

<< Klicken, um Inhaltsverzeichnis anzuzeigen >>

  Daten mathematisch analysieren > Referenz > FPScript-Funktionen > Ereignisisolation >

NextSlope (FPScript)

Sucht nach der nächsten Flanke vorgegebener Mindeststeilheit ab einer bestimmten Position.

Syntax

NextSlope(DataSet, [ Position ], DeltaY, DeltaX, Hysteresis, [ Orientation = EVENT_BOTH ] [ , Direction = EVENT_RIGHT ])

 

Die Syntax der NextSlope-Funktion besteht aus folgenden Teilen:

Teil

Beschreibung

DataSet

Ist der zu durchsuchende Datensatz.

Erlaubte Datenstrukturen sind Datenreihe und Signal. 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.

Position

Wenn Sie in einem Signal suchen, ist dies der X-Wert, ab dem gesucht werden soll. Wenn Sie in einer Datenreihe suchen, dann ist dies der Index des Wertes, ab dem gesucht werden soll. Ein negativer Index bestimmt hierbei eine Position relativ zum Ende des Datensatzes. Wenn Sie das Argument weglassen oder den Wert Empty übergeben, beginnt die Suche je, nach Suchrichtung, am Anfang oder am Ende des Datensatzes. Der erste bzw. letzte Wert des Datensatzes wird nur berücksichtigt, wenn Sie das Argument weglassen oder den Wert Empty übergeben.

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 deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

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 deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

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 deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

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 deren erstes Element entnommen. Ist dies wieder eine Liste, dann wird der Vorgang wiederholt.

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.

Direction

Legt die Suchrichtung der Funktion fest.

Das Argument Direction kann folgende Werte haben:

Konstante

Bedeutung

EVENT_RIGHT

Nach rechts suchen.

EVENT_LEFT

Nach links 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_RIGHT gesetzt.

Anmerkungen

Das Ergebnis hat immer die Datenstruktur Einzelwert.

Die Flanke zeichnet sich dadurch aus, dass benachbarte Werte die vorgegebene Steilheit über- bzw. unterschreiten. Wenn DataSet eine Datenreihe ist, dann ist das Ergebnis der Index der gefundenen Flanke. Ist DataSet ein Signal, dann ist das Ergebnis der X-Wert der Flanke. Wenn keine Flanke gefunden werden konnte, dann wird der Wert Empty als Ergebnis ausgegeben.

Verfügbarkeit

FlexPro Standard, Professional, Developer Suite

Beispiele

NextSlope(Signal, 5.5 s, 1.2 V, 0.1 s, EVENT_POSITIVE, EVENT_LEFT)

Sucht in einem Signal ab der Position X = 5.5 s nach links die nächste steigende Flanke, die in 0.1 s um mindestens 1.2 V ansteigt. Das Ergebnis ist der X-Wert der gefundenen Flanke.

Signal[[NextSlope(Signal, 4.5 s, 1.2 V, 0.1 s)]]

Sucht in einem Signal ab der Position X = 4.5 s nach rechts die nächste steigende oder fallende Flanke. Das Ergebnis ist der Y-Wert der gefundenen Flanke.

Siehe auch

Slopes-Funktion

NextSlopeAtLevel-Funktion

SlopesAtLevel-Funktion

Analyseobjekt Ereignisisolation

Share article or send as email:

You might be interested in these articles