Smooth (FPScript)
Lisse un ensemble de données en calculant une valeur moyenne glissante.
Syntaxe
Smooth(DataSet, SmoothingWidth)
La syntaxe de la fonction Smooth se compose des éléments suivants :
Section |
Description |
|---|---|
DataSet |
L'ensemble de données à lisser. 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. 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. |
SmoothingWidth |
Spécifie combien de valeurs voisines à gauche et à droite de la valeur à lisser doivent être incluses dans la valeur moyenne. Une valeur de 2, par exemple, spécifie que deux voisins sont pris à la fois à gauche et à droite. La valeur moyenne est donc formée à partir d'un total de cinq valeurs. Les structures de données autorisées sont Scalaire. Les types de données pris en charge sont Entier de 16 bits et Entier de 32 bits. La valeur doit être supérieure ou égale à 1. 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é. |
Remarques
Le type de données du résultat est toujours Virgule flottante de 64 bits.
La structure du résultat correspond à celle de l'argument DataSet.
Pour chaque valeur de l'ensemble de données, la moyenne arithmétique est formée avec SmoothingWidth valeurs voisines à gauche et à droite. Lors du calcul du lissage, il n'y a pas suffisamment de voisins de gauche et de droite disponibles pour la première ou la dernière valeur SmoothingWidth dans DataSet. Elles sont ensuite assimilées à la première ou à la dernière valeur dans DataSet. Cela signifie que le résultat contient le même nombre de valeurs que l'argument DataSet.
Le lissage correspond à une convolution du signal avec une fenêtre rectangulaire de largeur n = 2 * SmoothingWidth + 1. L'illustration suivante montre la fonction de transfert de la fenêtre rectangulaire pour n = 10 et n = 20 :
Pour les types de données complexes, un nombre est formé.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
Smooth({1., 4., 3., 5., 8., 7., 9.}, 1) |
Renvoie {2, 2.66, 4., 5.33, 6.66, 8, 8.33}. |