UpperEnvelope (FPScript)
Détermine une enveloppe supérieure pour un signal ou les indices des points d'un signal qui appartiennent à sa courbe enveloppe supérieure.
Syntaxe
UpperEnvelope(Signal [ , Parameter = 0 ])
ou
UpperEnvelope(Amplitude, Time, Parameter)
La syntaxe de la fonction UpperEnvelope se compose des éléments suivants :
Section |
Description |
|---|---|
Signal |
L'ensemble de données dont l'enveloppe supé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 en tant que pourcentage de la plage de l'ensemble de données pour la recherche de maxima 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 consiste en un sous-ensemble de valeurs de l'ensemble de données à analyser, qui sont recherchées à l'aide de l'algorithme suivant. En partant du premier point, on calcule les connexions en ligne droite vers un nombre déterminé de voisins et on détermine leurs pente. Le voisin avec le gradient le plus élevé devient le point d'échantillonnage suivant de l'enveloppe et l'algorithme est poursuivi avec 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 pour rechercher tous les maxima locaux dans l'ensemble de données. Comme nombre de voisins, on utilise alors la plus grande distance qui se produit pour ces maxima 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 supérieure :
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
UpperEnvelope(Signal, 10%) |
Calcule l'enveloppe supérieure du signal. Une hystérésis de 10% sera utilisée pour l'algorithme. |