Quantile (FPScript)

21.09.2021

Détermine des quantiles moyens individuels, glissants ou par blocs pour un ensemble de données.

Syntaxe

Quantile(DataSet, Alpha, [ Mode = PROCESS_COLUMNS ] [ , IntervalWidth ])

 

La syntaxe de la fonction Quantile se compose des éléments suivants :

Section

Description

DataSet

L'ensemble de données à évaluer.

Toutes les structures de données sont autorisées. 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.

Alpha

Spécifie le paramètre de détermination du quantile.

Les structures de données autorisées sont Scalaire. Tous les types de données numériques sont autorisés.

La valeur doit être supérieure ou égale à 0 et infé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é.

Mode

Précise comment les matrices de données et les séries de signaux doivent être traitées et si des quantiles individuels, glissants ou par blocs doivent être déterminés. Si vous omettez l'argument, les quantiles individuels sont déterminés colonne par colonne.

L'argument Mode peut avoir les valeurs suivantes :

Constante

Signification

PROCESS_COLUMNS

Les matrices de données et les séries de signaux sont traitées colonne par colonne. Le résultat est une série de données ou un signal avec un quantile par colonne.

PROCESS_ROWS

Les matrices de données et les séries de signaux sont traitées ligne par ligne. Le résultat est une série de données ou un signal avec un quantile par ligne.

PROCESS_COMPLETE

Les matrices de données et les séries de signaux sont traitées comme un tout. Le résultat est une valeur scalaire avec un quantile pour l'ensemble des données.

...plus une constante optionnelle, qui détermine la méthode de calcul :

Constante

Signification

+ CALC_BLOCK

Calcul bloc par bloc. Une valeur est calculée par intervalle.

+ CALC_MOVING

Calcul glissant. Pour chaque valeur de l'ensemble de données, un résultat est déterminé dans l'intervalle spécifié.

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 PROCESS_COLUMNS .

IntervalWidth

Cet argument est nécessaire pour déterminer les quantiles glissants et les quantiles par blocs. La largeur de l'intervalle spécifie ensuite le nombre de valeurs à examiner. La largeur doit être un nombre impair. Sinon, l'intervalle est asymétrique, et une valeur supplémentaire est incluse dans le calcul à droite du centre par opposition à la gauche.

Les structures de données autorisées sont Scalaire. Tous les types de données entiers sont autorisés.

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

Pour déterminer le quantile Alpha, l'échantillon est trié puis la valeur à la position Alpha * Nombre de lignes(DataSet) est prise.

Si Alpha spécifie une position qui se situe entre deux valeurs voisines (par exemple, nombre pair de valeurs et Alpha = 0,5), alors une interpolation linéaire a lieu entre les valeurs. Des termes spécifiques sont utilisés pour les valeurs Alpha suivantes :

Valeur de Alpha

Interprétation

0.25

Quartile inférieur

0.5

Médiane

0.75

Quartile supérieur

Une valeur scalaire est retournée sans modification. Pour les signaux et les séries de signaux, la composante Y est traitée et la composante X ou Z est copiée, si possible. Lors du calcul des quantiles glissants et des quantiles par blocs, la structure des données du résultat correspond à celle de l'argument. Si, en revanche, DataSet est une série de données ou un signal, le résultat est une valeur scalaire avec les quantiles recherchés. Sinon, le résultat est une série de données ou un signal avec un quantile par colonne ou ligne.

Les types de données temps calendaire et période de temps sont conservés dans le résultat. Pour tous les autres types de données numériques, le résultat est du type virgule flottante de 64 bits.

Remarque        Le Quantile est adaptée pour réaliser un filtre médian. Ici, vous utilisez la fonction avec Alpha = 0,5 et en mode CALC_MOVING . Un signal est lissé avec un filtre médian similaire à une moyenne glissante, mais il répond mieux aux signaux présentant des valeurs aberrantes. Les valeurs aberrantes individuelles influencent grandement la moyenne, mais ont peu d'influence sur la médiane. Les différences sont illustrées ci-dessous :

Disponible dans

FlexPro Basic, Professional, Developer Suite

Exemples

Quantile({2, 5, 7, 1, 3}, 0.5)

Renvoie 3. (la médiane)

Quantile(Signal, 0.5, CALC_MOVING, 10)

Filtrage médian utilisant une largeur de lissage de 10.

Voir aussi

Fonction Mean

Objet d'analyse Grandeurs Statistiques

Objet d'analyse Lissage de Signal

Partager l’article ou envoyer par mail :

Vous serez probablement intéressé par les articles suivants :