NextPositivePeak (FPScript)

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

NextPositivePeak (FPScript)

<< Klicken, um Inhaltsverzeichnis anzuzeigen >>

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

NextPositivePeak (FPScript)

Sucht in einem Datensatz nach dem nächsten positiven Peak ab einer vorgegebenen Position.

Syntax

NextPositivePeak(DataSet, [ Position ], Level, [ Orientation = EVENT_BOTH ], [ Direction = EVENT_RIGHT ], [ DeltaXmin ] [ , DeltaXmax ])

 

Die Syntax der NextPositivePeak-Funktion besteht aus folgenden Teilen:

Teil

Beschreibung

DataSet

Der zu durchsuchende Datensatz.

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

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.

Level

Gibt den Pegel an, über dem die Werte liegen müssen. Es werden nur Peaks gefunden, die in beide Richtungen Pegeldurchgänge haben. Ein Peak-Anfang wird gefunden, wenn der Wert größer gleich dem Pegel ist und der vorherige Wert kleiner als der Pegel ist. Ein Peak-Ende wird gefunden, wenn der Wert größer gleich dem Pegel ist und der nachfolgende Wert kleiner als der Pegel ist.

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 die Orientierung der zu suchenden Peaks an.

Das Argument Orientation kann folgende Werte haben:

Konstante

Bedeutung

EVENT_POSITIVE

Nur nach Peak-Anfängen suchen.

EVENT_NEGATIVE

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.

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.

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

Das Ergebnis hat immer die Datenstruktur Einzelwert.

Wenn DataSet eine Datenreihe ist, dann ist das Ergebnis der Index des gefundenen Peak-Anfangs oder -endes. Ist DataSet ein Signal, dann ist das Ergebnis der X-Wert des Peak-Anfangs oder -endes. Wenn kein Peak gefunden werden konnte, dann wird der Wert Empty als Ergebnis ausgegeben.

Verfügbarkeit

FlexPro Standard, Professional, Developer Suite

Beispiele

NextPositivePeak(Signal({3,1,1,3,2,1,4,3,2,1,4,1},1), , 2, EVENT_BOTH, EVENT_RIGHT, 2)

Ergibt 6. Sucht im Datensatz von Anfang an nach dem nächsten positiven Peak mit der Mindestbreite 2, deren Pegeldurchgang bei 2 liegt. Zurückgegeben wird der X-Wert, bei dem der Peak beginnt.

NextPositivePeak({2,4,4,3,2,1,4,3,2,1,4,1}, , 2, EVENT_BOTH, EVENT_RIGHT, , 2)

Ergibt 10L. Sucht im Datensatz von Anfang an nach dem nächsten positiven Peak mit maximal 2 Werten, deren Pegeldurchgang bei 2 liegt. Zurückgegeben wird der Index, bei dem der Peak beginnt.

NextPositivePeak({2,4,4,3,2,1,4,3,2,1,3,4,1}, -1, 2, EVENT_POSITIVE, EVENT_LEFT)

Ergibt 10L. Sucht ab dem Ende des Datensatz in umgekehrt er Richtung nach dem nächsten positiven Peak, deren Pegeldurchgang bei 2 liegt. Zurückgegeben wird der Index, bei dem der Peak beginnt.

Siehe auch

PositivePeaks-Funktion

NegativePeaks-Funktion

NextNegativePeak-Funktion

LevelCrossings-Funktion

ValuesAboveLevel-Funktion

ValuesBelowLevel-Funktion

ValuesInInterval-Funktion

Analyseobjekt Ereignisisolation

Share article or send as email:

You might be interested in these articles