Bursts (FPScript)
Recherche des débuts et/ou des fins de salves dans un ensemble de données.
Syntaxe
Bursts(DataSet, Threshold, DeltaX, [ Orientation = EVENT_BOTH ] [ , Operation = EVENT_DEFAULT ])
La syntaxe de la fonction Bursts 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. |
||||||||||||
Orientation |
Précise s'il faut rechercher les débuts, les fins ou les deux. L'argument Orientation 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_BOTH . |
||||||||||||
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 égale à 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
Bursts({0, 0.1, 0, 0.1, 1.3, 1.2, 1.4, 0.3, 0.1, 0, 0.2}, 0.2, 1) |
Renvoie {3L, 8L}. Cet exemple recherche les débuts et les fins de salves 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. |