ValuesInInterval (FPScript)

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

ValuesInInterval (FPScript)

<< Klicken, um Inhaltsverzeichnis anzuzeigen >>

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

ValuesInInterval (FPScript)

Sucht in einem Datensatz nach Werten, die in einem bestimmten Intervall liegen, oder nach ungültigen Werten.

Syntax

ValuesInInterval(DataSet, LowerLimit, UpperLimit, [ Operation = EVENT_INDEX ], [ DeltaXmin ] [ , DeltaXmax ])

 

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

LowerLimit

Gibt die Untergrenze des Intervalls an, in dem die Werte liegen müssen. Es werden auch solche Werte gefunden, die genau auf der Grenze liegen.

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.

UpperLimit

Gibt die Obergrenze des Intervalls an, in dem die Werte liegen müssen. Es werden auch solche Werte gefunden, die genau auf der Grenze liegen.

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.

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_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_INDEX 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

Wenn Sie einen bestimmten Wert suchen möchten, müssen Sie diesen als Ober- und Untergrenze angeben. Die Operationen EVENT_EXTRACT und EVENT_INDEX sind für Datenmatrizen und Signalreihen nicht erlaubt. Es sind alle numerischen Datentypen erlaubt. Sie können nach ungültigen Werten suchen, indem Sie LowerLimit und UpperLimit auf ungültig setzen.

Verfügbarkeit

FlexPro View, Standard, Professional, Developer Suite

Beispiele

ValuesInInterval({1, 5, 7, 4, 3}, 4, 5)

Ergibt {1L, 3L}. Das Ergebnis sind die Indizes der Werte, die im Intervall [4, 5] liegen.

ValuesInInterval({1, ?, 7, ?, 3}, ?, ?)

Ergibt {1L, 3L}. Das Ergebnis sind die Indizes der ungültigen Werte.

ValuesInInterval(Signal, 5.5, 5.5)

Sucht im Signal nach allen Vorkommnissen des Y-Wertes 5.5.

ValuesInInterval({1,2,3,3,4,4}, 2, 3, EVENT_INDEX , 2 , 3)

Ergibt {1L, 2L, 3L}. Das Ergebnis sind die Indizes der Werte, die im Intervall [2, 3] liegen. Die Anzahl benachbarter Werte des Ereignisses muss mindestens 2 sein und darf höchstens 3 sein.

Siehe auch

Clip-Funktion

LevelCrossings-Funktion

ValuesAboveLevel-Funktion

ValuesBelowLevel-Funktion

PositivePeaks-Funktion

NegativePeaks-Funktion

NextValueInInterval-Funktion

SearchVoidValues-Funktion

Analyseobjekt Ereignisisolation

Share article or send as email:

You might be interested in these articles