Axe des X Vs. Axe des catégories

Scénarios d’utilisation possibles

Il existe différents types d’axes des X. Alors que l’axe des Y est un axe de type Valeur, l’axe des X peut être un axe de type Catégorie ou un axe de type Valeur. En utilisant un axe de Valeur, les données sont traitées comme des données numériques continuellement variables, et le marqueur est placé à un point le long de l’axe qui varie en fonction de sa valeur numérique. En utilisant un axe de Catégorie, les données sont traitées comme une séquence d’étiquettes de texte non numériques, et le marqueur est placé à un point le long de l’axe selon sa position dans la séquence. L’exemple ci-dessous illustre la différence entre les axes de Valeur et de Catégorie. Nos données d’exemple sont présentées dans le fichier de tableau d’exemple ci-dessous. La première colonne contient nos données d’axe des X, qui peuvent être traitées comme des catégories ou comme des valeurs. Notez que les nombres ne sont pas également espacés, et ils n’apparaissent même pas dans un ordre numérique.

Manipulez l’axe des X et l’axe des catégories comme Microsoft Excel

Nous afficherons ces données sur deux types de graphiques, le premier graphique est un graphique XY (dispersion) avec l’axe des X comme axe de valeur, le deuxième graphique est un graphique linéaire avec l’axe des X comme axe de catégorie.

Le code d’exemple suivant génère le fichier Excel de sortie.

Code d’exemple

		// Create an instance of Workbook
		Workbook workbook = new Workbook();
		// Access the first worksheet.
		Worksheet worksheet = workbook.getWorksheets().get(0);
		// Put the sample values used in charts
		worksheet.getCells().get("A2").putValue(1);
		worksheet.getCells().get("A3").putValue(3);
		worksheet.getCells().get("A4").putValue(2.5);
		worksheet.getCells().get("A5").putValue(3.5);
		worksheet.getCells().get("B1").putValue("Cats");
		worksheet.getCells().get("C1").putValue("Dogs");
		worksheet.getCells().get("D1").putValue("Fishes");
		worksheet.getCells().get("B2").putValue(7);
		worksheet.getCells().get("B3").putValue(6);
		worksheet.getCells().get("B4").putValue(5);
		worksheet.getCells().get("B5").putValue(4);
		worksheet.getCells().get("C2").putValue(7);
		worksheet.getCells().get("C3").putValue(5);
		worksheet.getCells().get("C4").putValue(4);
		worksheet.getCells().get("C5").putValue(3);
		worksheet.getCells().get("D2").putValue(8);
		worksheet.getCells().get("D3").putValue(7);
		worksheet.getCells().get("D4").putValue(3);
		worksheet.getCells().get("D5").putValue(2);
		//Create Line Chart: X as Category Axis
		int pieIdx = worksheet.getCharts().add(ChartType.LINE_WITH_DATA_MARKERS, 6, 15, 20, 21);
		// Retrieve the Chart object
		Chart chart = worksheet.getCharts().get(pieIdx);
		// Add Series
		chart.getNSeries().add("B2:D5", true);
		// Set the category data
		chart.getNSeries().setCategoryData("=Sheet1!$A$2:$A$5");
		// Set the first series name
		chart.getNSeries().get(0).setName("Cats");
		// Set the second series name
		chart.getNSeries().get(1).setName("Dogs");
		// Set the third series name
		chart.getNSeries().get(2).setName("Fishes");
		// Set the Legend at the bottom of the chart area
		chart.getLegend().setPosition(LegendPositionType.BOTTOM);
		// Fill the PlotArea area with nothing 
		chart.getPlotArea().getArea().getFillFormat().setFillType(FillType.NONE);
		// Create XY (Scatter) Chart: X as Value Axis
		pieIdx = worksheet.getCharts().add(ChartType.SCATTER_CONNECTED_BY_LINES_WITH_DATA_MARKER, 6, 6, 20, 12);
		// Retrieve the Chart object
		chart = worksheet.getCharts().get(pieIdx);
		// Add Series
		chart.getNSeries().add("B2:D5", true);
		// Set X values for series 
		chart.getNSeries().get(0).setXValues("{1,3,2.5,3.5}");
		chart.getNSeries().get(1).setXValues("{1,3,2.5,3.5}");
		chart.getNSeries().get(2).setXValues("{1,3,2.5,3.5}");
		// Set the first series name
		chart.getNSeries().get(0).setName("Cats"); 
		// Set the second series name
		chart.getNSeries().get(1).setName("Dogs");
		// Set the third series name
		chart.getNSeries().get(2).setName("Fishes");
		// Set the Legend at the bottom of the chart area
		chart.getLegend().setPosition(LegendPositionType.BOTTOM);
		// Fill the PlotArea area with nothing 
		chart.getPlotArea().getArea().getFillFormat().setFillType(FillType.NONE); 
		// Save the Excel file
		workbook.save("XAxis.xlsx");