Graphique à barres d'erreur (contrôles Chart)

Le type de graphique à barres d'erreur est constitué de courbes assorties de marqueurs utilisés pour afficher des informations statistiques sur les données représentées dans un graphique. Dans un graphique à barres d'erreur, une série a trois valeurs Y. Si ces valeurs peuvent être affectées manuellement à chaque point, elles sont, dans la plupart des cas, calculées à partir des données présentes dans une autre série. L'ordre des valeurs Y est important, car chaque position dans le tableau de valeurs représente une valeur sur la barre d'erreur.

Caractéristiques du graphique

Valeur SeriesChartType	SeriesChartType.ErrorBar
Nombre de valeurs Y par point	3 (voir le tableau ci-dessous).
Nombre de séries	1
Prend en charge des marqueurs	Oui
Ne peut pas être combiné avec :	des graphiques en anneau, à secteurs ou à barres.
Attributs personnalisés	DrawSideBySide, ErrorBarCenterMarkerStyle, ErrorBarSeries, ErrorBarStyle, ErrorBarType, MaxPixelPointWidth, MinPixelPointWidth, PixelPointDepth, PixelPointGapDepth, PixelPointWidth, PointWidth

Une série de graphique à barres d'erreur utilise trois valeurs Y. Le classement des valeurs Y est important, car chaque valeur Y représente un point sur le graphique.

Index des valeurs Y	Description
0	Valeur centrale ou moyenne des points.
1	Valeur d'erreur inférieure.
2	Valeur d'erreur supérieure.

Notes

Par défaut, le graphique à barres d'erreur affiche les erreurs inférieure et supérieure. Pour n'afficher que l'un des points d'erreur, utilisez l'attribut personnalisé ErrorBarStyle.

La propriété DataPoint.MarkerStyle s'applique aux marqueurs des barres d'erreur, tandis que ErrorBarCenterMarkerStyle s'applique au marqueur de la valeur centrale. Les marqueurs ne sont pas définis par défaut, et les valeurs d'erreur supérieure et inférieure sont affichées sous forme de lignes horizontales dans le graphique à barres d'erreur.

Calcul des valeurs d'erreur d'une autre série

Dans la plupart des cas, les valeurs des points de données du graphique à barres d'erreur sont calculées à l'aide de formules appliquées aux données existantes dans d'autres séries. Pour cela, utilisez l'attribut personnalisé ErrorBarSeries afin d'associer le graphique à barres d'erreur à une autre série préexistante, puis utilisez l'attribut personnalisé ErrorBarType pour définir la formule de calcul des valeurs d'erreur. Cela vous permet également de voir les barres d'erreur de n'importe quelle série, y compris au moment de la conception. Suivez les étapes ci-dessous.

1. Affectez à ErrorBarSeries le nom de l'objet Series à utiliser ou spécifiez-le avec l'index de la valeur Y, selon le format suivant : "Nom:Yindex".

   Si vous spécifiez la série de données sans l'index de la valeur Y, le graphique utilise par défaut la première valeur Y de chaque point de données.

2. Affectez une formule à l'attribut personnalisé ErrorBarType selon le format suivant : "Nom_formule(Paramètre1, Paramètre2, …)". Le tableau suivant présente les formules disponibles.

Notes

Ces formules ne sont pas les mêmes que les formules financières ou statistiques décrites dans Formules.

Nom de la formule	Paramètre	Description
Valeur fixe	Obligatoire	Calcule la marge d'erreur comme une différence de valeur fixe par rapport à la valeur centrale.
Pourcentage	Facultatif	Calcule la marge d'erreur comme un pourcentage de la valeur centrale. Si ce paramètre n'est pas spécifié, une marge d'erreur de 10 % est utilisée.
StandardDeviation	Facultatif	Les valeurs d'erreur sont déterminées en appliquant un calcul d'écart type aux valeurs centrales présentes dans la série de la barre d'erreur. Si le paramètre n'est pas spécifié, la valeur d'écart type 1 est utilisée.
StandardError	Facultatif	Les valeurs d'erreur sont déterminées en appliquant un calcul d'erreur standard aux valeurs centrales présentes dans la série de la barre d'erreur. Si le paramètre n'est pas spécifié, la valeur d'erreur standard 1 est utilisée.

Exemple

Le code suivant montre comment appliquer le graphique à barres d'erreur à la troisième valeur Y (Y2) de la série de données Price en appliquant un calcul d'écart type à la série.

Chart1.Series("Series1")("ErrorBarSeries")="Price:Y2"
Chart1.Series("Series1")("ErrorBarType")="StandardDeviation()"

Chart1.Series["Series1"]["ErrorBarSeries"]="Price:Y2";
Chart1.Series["Series1"]["ErrorBarType"]=" StandardDeviation()";

Voir aussi

Référence

System.Windows.Forms.DataVisualization.Charting

System.Web.UI.DataVisualization.Charting

Autres ressources

Types de graphiques