ValuesInSpikes (FPScript)

21.09.2021

Recherche dans un ensemble de données des valeurs qui appartiennent à un pic.

Syntaxe

ValuesInSpikes(DataSet, MinHeight, MaxWidth [ , Operation = EVENT_DEFAULT ])

 

La syntaxe de la fonction ValuesInSpikes 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.

MinHeight

Spécifie la quantité de delta y minimum qui doit être atteinte pour détecter le début ou la fin d'un pic.

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.

MaxWidth

Nombre maximum de points de données qu'un pic peut avoir.

Les structures de données autorisées sont Scalaire. Tous les types de données réels sont autorisés.

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 :

Constante

Signification

EVENT_INDEX

Les indices des valeurs ou des points remplissant la condition sont placés dans l'ensemble de données de résultat.

EVENT_EXTRACT

Seuls les points ou valeurs remplissant la condition sont transférés dans l'ensemble de données de résultat.

EVENT_SETVOID

Les points ou valeurs qui ne remplissent pas la condition sont également inclus dans l'ensemble de données de résultat, mais ils y sont marqués comme nuls.

EVENT_DEFAULT

Correspond à EVENT_SETVOID si une matrice de données ou une série de signaux est présente, et sinon EVENT_INDEX.

+ EVENT_COMPLEMENT

Cette constante peut être ajoutée de manière optionnelle et permet ensuite d'inverser l'opération sélectionnée. Ainsi, par exemple, avec EVENT_EXTRACT, les points qui ne correspondent pas à la condition sont copiés.

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

Un pic montant est détecté, par exemple, lorsque le signal augmente d'au moins MinHeight et tombe au plus tard après MaxWidth points de données par au moins -MinHeight. Les pics situés au début ou à la fin de l'ensemble de données sont également détectés, c'est-à-dire que le début de l'ensemble de données est considéré comme le début du pic et, par conséquent, la fin de l'ensemble de données est considérée comme la fin du pic.

Le graphique suivant montre un signal avec des pics surlignés d'une largeur maximale de 2 et d'une hauteur minimale de 0,15. Les deux pointes à l'extrémité ont été omises parce qu'elles étaient trop larges ou pas assez hautes.

Disponible dans

FlexPro Basic, Professional, Developer Suite

Exemples

Arguments s
Dim idx, y, n
idx = ValuesInSpikes(s, 0.1, 1, EVENT_INDEX)
s.y[idx] = ?
return s
 

Cet exemple recherche des pics dans un signal et produit un signal dans lequel toutes les valeurs appartenant aux pics sont mises à zéro.

Voir aussi

Fonction NextValueInSpike

Objet d'analyse Isolation d'événements

Partager l’article ou envoyer par mail :

Vous serez probablement intéressé par les articles suivants :