Diagramme à surfaces (contrôles Chart)

Article
02/27/2011

Un diagramme à surfaces consiste en un ou plusieurs symboles de surface qui résument la distribution des données dans un ou plusieurs groupes de données. Un diagramme à surfaces affiche un rectangle vertical avec des lignes de valeurs s'étendant entre les deux extrémités.

Les valeurs d'une surface sont généralement des valeurs calculées à partir de données présentes dans une autre série. Un symbole de surface (objet DataPoint) est associé à une série de données. Les données d'une série de diagramme à surfaces peuvent toujours être remplies à l'aide de la liaison de données ou en employant le membre Series.Points (un objet DataPointCollection).

Image du type de diagramme à surfaces

Caractéristiques du graphique

Valeur SeriesChartType	SeriesChartType.BoxPlot
Nombre de valeurs Y par point	Six ou plus (voir le tableau ci-dessous).
Nombre de séries	1
Prend en charge des marqueurs	Non
Ne peut pas être combiné avec :	des graphiques en anneau, à secteurs ou à barres.
Attributs personnalisés	BoxPlotPercentile, BoxPlotSeries, BoxPlotShowAverage, BoxPlotShowMedian, BoxPlotShowUnusualValues, BoxPlotWhiskerPercentile, DrawSideBySide, MaxPixelPointWidth, MinPixelPointWidth, PixelPointDepth, PixelPointGapDepth, PixelPointWidth, PointWidth

Une série de diagramme à surfaces utilise au moins six valeurs Y. Toutefois, il est possible d'ajouter et de tracer des valeurs Y supplémentaires en tant que marqueurs (appelés points inhabituels). Le classement des valeurs est important, car chaque valeur représente un point sur le graphique.

Index des valeurs Y	Valeur Y
0	Valeur minimale
1	Valeur maximale
2	Zone inférieure
3	Zone supérieure
4	Moyenne
5	Médiane
>=6	D'autres points inhabituels, comme le marqueur moyen ou médian, peuvent être masqués si la valeur Y du marqueur est définie sur double.NaN.

Notes

Les lignes Médiane et Moyenne sont dessinées par défaut, mais peuvent être masquées à l'aide des attributs personnalisés BoxPlotShowMedian et BoxPlotShowAverage. Le code suivant supprime les lignes Médiane (Median) et Moyenne (Average).

Chart1.Series("Series1")("BoxPlotShowMedian")="false"
Chart1.Series("Series1")("BoxPlotShowAverage")="false"

Chart1.Series["Series1"]["BoxPlotShowMedian"]="false";
Chart1.Series["Series1"]["BoxPlotShowAverage"]="false";

Les valeurs des séries de données d'origine qui ne sont pas comprises entre les valeurs minimale et maximale peuvent être affichées comme des valeurs individuelles pour le diagramme à surfaces. Pour activer cette fonctionnalité, utilisez l'attribut personnalisé BoxPlotShowUnusualValues. Le code suivant illustre cette méthode.

Chart1.Series("Series1")("BoxPlotShowUnusualValues")="true"

Chart1.Series[Series1"]["BoxPlotShowUnusualValues"]="true"

Valeurs calculées d'un diagramme à surfaces

L'attribut personnalisé BoxPlotSeries sert à associer le type de diagramme à surfaces à une ou plusieurs séries existantes (par nom) à utiliser pour les calculs. Cet attribut personnalisé peut être défini pour la série entière ou pour chaque point de données du diagramme. Lorsqu'il est défini sur la série, l'attribut BoxPlotSeries contient un ou plusieurs noms de série, séparés par des points-virgules. Par conséquent, chaque valeur de point du diagramme à surfaces sera calculé et ajouté pour chaque série spécifiée dans l'attribut personnalisé BoxPlotSeries.

Si BoxPlotSeries est défini dans un objet DataPoint uniquement, un seule série peut être spécifiée. La première valeur Y de la série sera utilisée par défaut. L'utilisateur peut éventuellement spécifier la valeur à utiliser avec le nom de la série.

Chart1.Series("Series1")("BoxPlotSeries")="Price:Y2;Volume"

Chart1.Series["Series1"]["BoxPlotSeries"]="Price:Y2;Volume";

Par défaut, les valeurs des zones supérieure et inférieure sont calculées à l'aide du 25e/75e centile. Les valeurs du diagramme à surfaces sont calculées à l'aide du 10e/90e centile. Ce comportement peut être modifié à l'aide des attributs personnalisés BoxPlotPercentile et BoxPlotWhiskerPercentile. Le code suivant montre comment modifier les valeurs des zones supérieure et inférieure de sorte qu'elles utilisent le 30e/70e centile et les valeurs du diagramme à surfaces de sorte qu'elles utilisent le 5e/95e centile.

Chart1.Series("Series1")("BoxPlotPercentile")="30"
Chart1.Series("Series1")("BoxPlotWhiskerPercentile")="5"

Chart1.Series["Series1"]["BoxPlotPercentile"]="30";
Chart1.Series["Series1"]["BoxPlotWhiskerPercentile"]="5";

Exemple

L'exemple suivant montre comment créer un diagramme à surfaces du 15e centile.

' Add data to Box Plot Source series.
Dim yValues As Double() = {55.62, 45.54, 73.45, 9.73, 88.42, 45.9, 63.6, 85.1,67.2, 23.6}
Chart1.Series("DataSeries").Points.DataBindY(yValues)

' Specify data series name for the Box Plot.
Chart1.Series("BoxPlotSeries")("BoxPlotSeries") = "DataSeries"

' Set other custom attributes
Chart1.Series("BoxPlotSeries")("BoxPlotWhiskerPercentile") = "15"
Chart1.Series("BoxPlotSeries")("BoxPlotShowAverage") = "true"
Chart1.Series("BoxPlotSeries")("BoxPlotShowMedian") = "true"
Chart1.Series("BoxPlotSeries")("BoxPlotShowUnusualValues") = "true"

// Add data to Box Plot Source series.
yValues = {55.62, 45.54, 73.45, 9.73, 88.42, 45.9, 63.6, 85.1, 67.2, 23.6};
Chart1.Series["DataSeries"].Points.DataBindY(yValues);

// Specify data series name for the Box Plot.
Chart1.Series["BoxPlotSeries"]["BoxPlotSeries"] = "DataSeries";

// Set other custom attributes
Chart1.Series["BoxPlotSeries"]["BoxPlotWhiskerPercentile"] = "15";
Chart1.Series["BoxPlotSeries"]["BoxPlotShowAverage"] = "true";
Chart1.Series["BoxPlotSeries"]["BoxPlotShowMedian"] = "true";
Chart1.Series["BoxPlotSeries"]["BoxPlotShowUnusualValues"] = "true";