CoefficientOfVariation (FPScript)
Calcule le coefficient de variation absolu ou relatif d'un ensemble de données.
Syntaxe
CoefficientOfVariation(DataSet, [ Mode = CV_ABSOLUTE + PROCESS_ROWS ] [ , IntervalWidth ])
La syntaxe de la fonction CoefficientOfVariation 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. Pour les types de données complexes, un nombre est formé. 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. |
||||||||||||||||||||
Mode |
Précise comment les matrices de données et les séries de signaux doivent être traitées et si les coefficients individuels, glissants ou par blocs doivent être déterminés. L'argument Mode peut avoir les valeurs suivantes :
...plus une constante, qui détermine le traitement des matrices de données et des séries de signaux...
...plus une constante optionnelle, qui détermine la méthode de calcul :
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 CV_ABSOLUTE + PROCESS_ROWS . |
||||||||||||||||||||
IntervalWidth |
Cet argument est nécessaire pour déterminer les coefficients glissants et 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
Le résultat est toujours du type de données Virgule flottante de 64 bits.
Le coefficient de variation absolu d'un échantillon est défini comme suit :
Le coefficient de variation relatif d'un échantillon est défini comme suit :
avec la moyenne
et l'écart type
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 coefficients à virgule flottante et bloc, 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 le coefficient de variation recherché. Sinon, le résultat est une série de données ou un signal avec un coefficient de variation par colonne ou ligne.
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
CoefficientOfVariation({100, 100, 100}) |
Renvoie 0. L'ensemble de données à valeurs constantes a un écart-type de 0 et une moyenne de 100, ce qui donne un coefficient de variation de 0 / 100 = 0. |
CoefficientOfVariation({90, 100, 110}) |
Renvoie 0.1. L'ensemble de données ayant la plus grande variabilité a un écart-type de 10 et une moyenne de 100, ce qui donne un coefficient de variation de 10 / 100 = 0,1. |
CoefficientOfVariation({1, 5, 6, 8, 10, 40, 65, 88}) |
Renvoie 1.18042521004003. L'ensemble de données dont la variabilité est encore plus élevée se traduit par un coefficient encore plus élevé. |
CoefficientOfVariation({1, 5, 6, 8, 10, 40, 65, 88}, CV_RELATIVE) |
Renvoie 0.4461587924395862. Correspond à CoefficientOfVariation({1, 5, 6, 8, 10, 40, 65, 88}) / Sqrt(7). |
CoefficientOfVariation({{90, 100, 110}, {990, 1000, 1010}}, PROCESS_COLUMNS) |
Renvoie {0.1, 0.01}. |
CoefficientOfVariation({{90, 990}, {100, 1000}, {110, 1010}}) |
Renvoie {0.1, 0.01}. |
CoefficientOfVariation({90, 100, 110, 100, 90}, CALC_MOVING, 3) |
Renvoie { 0.0744322927564787, 0.1, 0.05587260669577074, 0.1, 0.0744322927564787 }. La fonction calcule le coefficient de variation pour {90, 100}, {90, 100, 110}, {100, 110, 100}, {110, 100, 90} et {100, 90}. |
CoefficientOfVariation({90, 100, 110, 990, 1000, 1010}, CALC_BLOCK, 3) |
Renvoie {0.1, 0.01}. La fonction calcule le coefficient de variation pour les blocs {90, 100, 110} et {990, 1000, 1010}. |