ValuesInBursts (FPScript)
Recherche, dans un ensemble de données, des valeurs appartenant à une salve.
Syntaxe
ValuesInBursts(DataSet, Threshold, DeltaX [ , Operation = EVENT_DEFAULT ])
La syntaxe de la fonction ValuesInBursts se compose des éléments suivants :
Section |
Description |
||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
DataSet |
L'ensemble de données dans lequel rechercher. Les structures de données autorisées sont Séries de données, Matrice de données, Signal et Série de signaux. Tous les types de données numériques sont autorisés. Pour les types de données complexes, un nombre est formé. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
||||||||||||
Threshold |
Spécifie la valeur seuil pour la recherche de salves. Les valeurs pour lesquelles au moins une des valeurs voisines dans l'intervalle [-DeltaX, DeltaX] se trouve à gauche ou à droite se situe au-dessus du seuil sont affectées à une salve. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. L'unité doit être compatible avec celle du paramètre DataSet . Pour les types de données complexes, un nombre est formé. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
||||||||||||
DeltaX |
Détermine l'intervalle [-DeltaX, DeltaX] dans lequel au moins une valeur doit se trouver au-dessus de la valeur seuil pour que la valeur respective à vérifier soit attribuée à la salve. Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés. L'unité doit être compatible avec celle du paramètre DataSet . Pour les types de données complexes, un nombre est formé. Si l'argument est une liste, alors la fonction est exécutée pour chaque élément de la liste et le résultat est également une liste. |
||||||||||||
Operation |
Précise le mode de fonctionnement de la fonction. L'argument Operation peut avoir les valeurs suivantes :
Si l'argument est une liste, alors son premier élément est pris. S'il s'agit à nouveau d'une liste, le processus est répété. Si l'argument n'est pas spécifié, il est défini à la valeur par défaut EVENT_DEFAULT . |
Remarques
L'argument DeltaX doit être aussi faible que possible, mais supérieur à la durée de la période, afin que les ondes individuelles ne soient pas considérées comme des salves individuelles. Cette fonction ne permet pas seulement d'analyser des signaux périodiques. Par exemple, vous pouvez utiliser cette fonction pour extraire une rampe d'un signal. Pour DeltaX égal à zéro, la fonction représente un simple discriminateur de valeur seuil.
L'illustration suivante montre un signal avec deux salves en surbrillance :
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
Arguments s |
Cet exemple recherche les salves dans un signal et génère un signal dans lequel toutes les valeurs n'appartenant pas aux salves sont mises à zéro. |
ValuesInBursts({0, 0.1, 0, 0.1, 1.3, 1.2, 1.4, 0.3, 0.1, 0, 0.2}, 0.2, 1) |
Renvoie {3L, 4L, 5L, 6L, 7L, 8L}. Cet exemple recherche des valeurs dans une salve et renvoie les indices. Une valeur appartient à une salve si elle-même ou la valeur voisine de gauche ou de droite est supérieure à 0,2. |