Détermine les caractéristiques statistiques pour la représentation d'un box-plot (graphique en boîte).
Syntaxe
BoxPlot(DataSet, le [ Mode Variable PROCESS_COLUMNS ], le [ JitterMode Variable BOXP_JITTER_NONE ] [ , le Jitter Variable 0.25 ])
La syntaxe de la fonction BoxPlot se compose des éléments suivants :
Section |
Description |
||||||||
|---|---|---|---|---|---|---|---|---|---|
DataSet |
L'ensemble de données à évaluer. Les structures de données autorisées sont Série de données, le Matrice de données, le Signal, le Série de signaux et Liste. Tous les types de données numériques sont autorisés. |
||||||||
Mode |
Précise comment les matrices de données et les séries de signaux doivent être traitées. Si vous omettez l'argument, la détermination se fait colonne par colonne. L'argument Mode peut avoir les valeurs suivantes :
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 . |
||||||||
JitterMode |
Indique comment les points aberrants et les points intérieurs sont représentés. L'argument JitterMode peut avoir les valeurs suivantes :
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 BOXP_JITTER_NONE . |
||||||||
Jitter |
Indique la largeur du nuage de points à représenter. La valeur 0 signifie que les valeurs sont représentées par une ligne. La valeur 1 signifie que les points de la première série de mesures seront représentés entre 0, 5 et 1,5 s'ils sont dessinés au-dessus de la boîte, ou que les points de la première série de mesures seront représentés entre 0 et 1 s'ils sont dessinés à côté de la boîte. 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.0. 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.25 . |
Remarques
Le box-plot, également appelé box-whisker-plot ou graphique en boîte, est un graphique qui permet de représenter clairement les principales mesures robustes de position et de dispersion. Le minimum, le quartile inférieur, la médiane, le quartile supérieur et le maximum sont représentés. La fonction détermine ces paramètres statistiques et les renvoie sous forme de liste.
Le graphique suivant montre un box plot :
La boîte correspond à la zone dans laquelle se trouvent les 50 % moyens des données. Elle est donc limitée par les quartiles supérieur et inférieur. La longueur de la boîte correspond à l'intervalle interquartile (IQR). Il s'agit d'une mesure de la dispersion des données, déterminée par la différence entre le quartile supérieur et le quartile inférieur. La médiane est également affichée sous forme de ligne continue dans la boîte. Cette ligne divise l'ensemble du graphique en deux zones, chacune contenant 50 % des données.
Les antennes (whisker) permettent de représenter les valeurs situées à l'extérieur de la boîte. La longueur des trichites doit être limitée à 1,5 × IQR au maximum. Le whisker ne s'arrête toutefois pas exactement à cette longueur, mais à la valeur des données qui se situe encore dans cette limite.
Les séries de données ou les signaux fournissent exactement une boîte. Pour les matrices ou les séries de signaux, le nombre de boîtes correspond au nombre de colonnes ou au nombre de lignes, en fonction du mode sélectionné. Pour les listes, les éléments de la liste sont considérés individuellement et le résultat est une ou plusieurs boîtes.
La fonction renvoie les résultats suivants sous forme de liste :
Élément de liste |
Description |
|---|---|
Q1 |
Quartile inférieur : les 25 % les plus petits des valeurs de données sont inférieurs ou égaux à cette valeur caractéristique. |
Q2 |
Médiane : les 50 % les plus petits des valeurs de données sont inférieurs ou égaux à cette valeur caractéristique. |
Q3 |
Quartile supérieur. Les 75 % les plus petits des valeurs de données sont inférieurs ou égaux à cette valeur caractéristique. |
IQR |
Espacement interquartile : plage de valeurs dans laquelle se trouvent les 50 % moyens des données. |
LowerWhisker |
Position de l'antenne inférieure : Q1 - 1,5 × IQR. La valeur ne correspond pas à cette valeur calculée, mais à la valeur mesurée qui se situe encore dans cette limite. |
UpperWhisker |
Position de l'antenne supérieure : Q3 + 1,5 × IQR. La valeur ne correspond pas à cette valeur calculée, mais à la valeur mesurée qui se situe encore dans cette limite. |
InnerPoints |
Les points intérieurs : Il s'agit de toutes les valeurs mesurées qui se trouvent à l'intérieur des antennes inférieures et supérieures. |
Outliers |
Valeurs aberrantes : il s'agit de toutes les valeurs mesurées qui se trouvent en dehors des antennes. |
Les formes de représentation suivantes du diagramme box-plot sont possibles :
Box-plot |
|
|
Box-plot avec valeurs aberrantes |
|
|
Box plot avec valeurs aberrantes et points internes |
|
|
Box plot avec représentation de la gigue, valeurs aberrantes et points internes au-dessus de la boîte |
|
|
Box plot avec représentation de la gigue, valeurs aberrantes et points internes à côté de la boîte |
|
|
Disponible dans
FlexPro Basic, Professional, Developer Suite
Exemples
BoxPlot({2, 5, 7, 1, 3}) |
Fournit une liste des caractéristiques statistiques pour la représentation d'un graphique en boîte. |