LowerEnvelope (FPScript)
Détermine une enveloppe inférieure pour un signal ou les indices des points d'un signal qui appartiennent à son enveloppe inférieure.
Syntaxe
LowerEnvelope(Signal [ , Parameter = 0 ])
ou
LowerEnvelope(Amplitude, Time, Parameter)
La syntaxe de la fonction LowerEnvelope se compose des éléments suivants :
Section |
Description |
|---|---|
Signal |
L'ensemble de données dont l'enveloppe inférieure est déterminée. Si vous spécifiez une série de données, la composante X sera générée automatiquement. Les structures de données autorisées sont Séries de données et Signal. Tous les types de données numériques 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. |
Amplitude |
Une série de données avec la composante Y du signal. Si vous spécifiez un signal, alors sa composante Y est utilisée. Les structures de données autorisées sont Séries de données et Signal. Tous les types de données numériques sont autorisé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é. |
Time |
Une série de données avec la composante X du signal. Si vous spécifiez un signal, alors sa composante Y est utilisée. Les structures de données autorisées sont Séries de données et Signal. Tous les types de données numériques sont autorisé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é. |
Parameter |
Si cette valeur est positive et spécifiée sans unité, elle indique le nombre de voisins à prendre en considération lors de la détermination du prochain point d'échantillonnage respectif. Si elle a l'unité "%" ou est spécifiée comme une valeur négative, elle détermine l'hystérésis pour la recherche de minima locaux dans le signal qui sont ensuite utilisés pour déterminer le nombre de voisins. Cet argument est facultatif pour la variante de syntaxe à deux arguments. Si vous omettez l'argument ou passez 0, cela correspond à une hystérésis de 5 %. Les structures de données autorisées sont Scalaire. 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 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 0 . |
Remarques
Le résultat a la même unité que l'argument Signal.
L'enveloppe est constituée d'un sous-ensemble de valeurs de l'ensemble de données à analyser, qui sont recherchées à l'aide de l'algorithme suivant. En commençant par le premier point, des connexions en ligne droite sont calculées pour un nombre spécifié de voisins et leurs gradients sont déterminés. Le voisin présentant le gradient le plus faible devient le prochain point d'échantillonnage de la courbe d'enveloppe et l'algorithme se poursuit en utilisant cette valeur.
Vous pouvez spécifier explicitement le nombre de voisins en indiquant une valeur positive sans unité pour Parameter. Cette valeur doit alors être sélectionnée de telle sorte que, pour les signaux périodiques, elle couvre au moins une période. Si vous spécifiez une valeur avec l'unité "%", son montant est utilisé comme argument pour la fonction Extrema afin de rechercher tous les minima locaux dans l'ensemble de données. Comme nombre de voisins, on utilise alors la plus grande distance qui se produit pour ces minima locaux.
Si vous spécifiez un signal, le résultat est un signal du même type de données qui contient les points appartenant à l'enveloppe. Si l'amplitude et le temps sont spécifiés, alors le résultat est une série de données avec des valeurs entières sur 64 bits qui représentent des indices pour les points d'échantillonnage de l'enveloppe trouvés.
L'illustration suivante montre un signal transitoire et son enveloppe inférieure :
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
LowerEnvelope(Signal, 10 %) |
Calcule l'enveloppe inférieure du signal. Une hystérésis de 10 % sera utilisée pour l'algorithme. |