weisang.com > Dokumentation > NegativePeaks (FPScript)

FlexPro-Dokumentation

NegativePeaks (FPScript)

21.09.2021

Sucht in einem Datensatz nach negativen Peaks.

Syntax

NegativePeaks(DataSet, Level, [ Orientation = EVENT_BOTH ], [ Operation = EVENT_DEFAULT ], [ DeltaXmin ] [ , DeltaXmax ])

Die Syntax der NegativePeaks-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.

Für die X-Komponente gelten zusätzliche Beschränkungen.Die Werte müssen monoton wachsend 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.

Level

Gibt den Pegel an, unter dem die Werte liegen 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.

Orientation

Gibt die Orientierung der zu suchenden Peaks an.

Das Argument Orientation kann folgende Werte haben:

Konstante	Bedeutung
EVENT_BEGINNING	Nur nach Peak-Anfängen suchen.
EVENT_END	Nur nach Peak-Enden suchen.
EVENT_BOTH	Nach Peak-Anfängen und -Enden 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.

DeltaXmin

Legt optional die Zeitdauer bzw. die Werteanzahl fest, die ein Ereignis mindestens andauern muss, um gültig zu sein. Wenn Sie in einem Signal suchen, so entspricht dies dem X-Bereich vom 1. Wert des Ereignisses bis zum letzten Wert des Ereignisses. Wenn Sie in einer Datenreihe suchen, so ist dies die Anzahl an Datenpunkten, die das Ereignis mindestens haben 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.

DeltaXmax

Legt optional die Zeitdauer bzw. die Werteanzahl fest, die ein Ereignis höchstens andauern darf, um gültig zu sein. Wenn Sie in einem Signal suchen, so entspricht dies dem X-Bereich vom 1. Wert des Ereignisses bis zum letzten Wert des Ereignisses. Wenn Sie in einer Datenreihe suchen, so ist dies die Anzahl an Datenpunkten, die das Ereignis höchstens haben 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.

Anmerkungen

Ein Peak-Anfang wird gefunden, wenn der Wert kleiner gleich dem Pegel ist und der vorige Wert größer als der Pegel ist. Ein Peak-Ende wird gefunden, wenn der Wert kleiner gleich dem Pegel ist und der nachfolgende Wert größer als der Pegel ist. Es werden auch Peaks gefunden, die am Anfang oder Ende des Datensatzes liegen.

Verfügbarkeit

FlexPro Basic, Professional, Developer Suite

Beispiele

NegativePeaks({2,2,3,4,2,2,4,2}, 2, EVENT_POSITIVE)	Ergibt {0L, 4L, 7L}. Sucht im Datensatz nach negativen Peaks, deren Pegeldurchgang bei 2 liegt. Zurückgegeben werden die Indizes, bei denen die Peaks beginnen.
NegativePeaks(Signal({2,2,2,3,4,2,2,4,2},1), 2, EVENT_BOTH, EVENT_INDEX, , 1)	Ergibt {5L, 6L, 8L, 8L}. Sucht im Signal nach negativen Peaks, deren Pegeldurchgang bei 2 liegt. Zurückgegeben werden die Indizes, bei denen die Peaks beginnen und enden. Ein Peak darf höchstens die Breite 1 haben.