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 [ , le Parameter Variable 0 ])
ou
UpperEnvelope(Amplitude, le Time, le 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érie 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érie 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érie 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 indiquée sans unité, elle détermine le nombre de voisins qui doivent être pris en compte pour déterminer le point de repère suivant. Avec l'unité "%" ou comme valeur négative, il détermine l'hystérésis en pourcentage de l'étendue 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. Dans la variante à deux arguments, cet argument est facultatif. 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 présentant la pente la plus élevée devient le prochain point d'échantillonnage de l'enveloppe et l'algorithme se poursuit avec cette valeur.
Vous pouvez spécifier explicitement le nombre de voisins en saisissant une valeur positive pour le paramètre Parameter en spécifiant une valeur positive sans unité. Cette valeur doit ensuite être choisie de manière à couvrir au moins une période pour les signaux périodiques. Si vous indiquez 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. La plus grande distance entre ces maxima locaux est ensuite utilisée comme nombre de voisins.
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 % est utilisée pour l'algorithme. |