NextValueInBurst (FPScript)

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

NextValueInBurst (FPScript)

<< Klicken, um Inhaltsverzeichnis anzuzeigen >>

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

NextValueInBurst (FPScript)

Sucht nach dem nächsten Wert in einem Burst ab einer vorgegebenen Position.

Syntax

NextValueInBurst(DataSet, [ Position ], Threshold, DeltaX [ , Direction = EVENT_RIGHT ])

 

Die Syntax der NextValueInBurst-Funktion besteht aus folgenden Teilen:

Teil

Beschreibung

DataSet

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.

Threshold

Gibt den Schwellenwert für die Burst-Suche vor. Es werden die Werte einem Burst zugerechnet, für die mindestens einer der Nachbarwerte im Intervall [-DeltaX, DeltaX] links oder rechts über dem Schwellenwert liegt.

Erlaubte Datenstrukturen sind Einzelwert. Es sind alle numerischen Datentypen erlaubt.

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

Bestimmt das Intervall [-DeltaX, DeltaX], in dem mindestens ein Wert über dem Schwellenwert liegen muss, damit der jeweils zu prüfende Wert dem Burst zugerechnet 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.

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

Ein Wert wird als zu einem Burst gehörend erkannt, wenn er entweder selbst oder mindestens einer der Nachbarwerte im Intervall [-DeltaX, DeltaX] links oder rechts davon über der Schwelle liegen. Wenn DataSet eine Datenreihe ist, dann ist das Ergebnis der Index des gefundenen Wertes. Ist DataSet ein Signal, dann ist das Ergebnis der X-Wert. Wenn kein nächster Wert in einem Burst gefunden werden konnte, dann wird der Wert Empty als Ergebnis ausgegeben.

Folgende Grafik zeigt ein Signal mit zwei hervorgehobenen Bursts:

Verfügbarkeit

FlexPro Standard, Professional, Developer Suite

Beispiele

NextValueInBurst(Signal, , 0.2 V, 0.1 s, EVENT_LEFT)

Sucht in einem Signal ab dem Signalende nach links den nächsten Wert in einem Burst. Der Schwellenwert ist 0.2 V und das X-Intervall [-0.1 s, 0.1 s]. Das Ergebnis ist der X-Wert des gefundenen Burst.

Signal[[NextValueInBurst(Signal, 4.5 s, 0.2 V, 0.1 s)]]

Sucht in einem Signal ab der Position X = 4.5 s nach rechts den nächsten Wert in einem Burst. Das Ergebnis ist der Y-Wert der gefundenen Stelle.

Siehe auch

Bursts-Funktion

NextBurst-Funktion

ValuesInBursts-Funktion

Analyseobjekt Ereignisisolation

Share article or send as email:

You might be interested in these articles