Crear y gestionar gráficos

Creando gráficos

Simplemente creando un gráfico

Es sencillo crear un gráfico con Aspose.Cells para Python via .NET con los siguientes códigos de ejemplo:

from aspose.cells import Workbook
from aspose.cells.charts import ChartType
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
# The path to the documents directory.
dataDir = RunExamples.GetDataDir(".")
# Instantiating a Workbook object
workbook = Workbook()
# Obtaining the reference of the first worksheet
worksheet = workbook.worksheets[0]
# Adding sample values to cells
worksheet.cells.get("A2").put_value("Category1")
worksheet.cells.get("A3").put_value("Category2")
worksheet.cells.get("A4").put_value("Category3")
worksheet.cells.get("B1").put_value("Column1")
worksheet.cells.get("B2").put_value(4)
worksheet.cells.get("B3").put_value(20)
worksheet.cells.get("B4").put_value(50)
worksheet.cells.get("C1").put_value("Column2")
worksheet.cells.get("C2").put_value(50)
worksheet.cells.get("C3").put_value(100)
worksheet.cells.get("C4").put_value(150)
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.COLUMN, 5, 0, 15, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Setting chart data source as the range "A1:C4"
chart.set_chart_data_range("A1:C4", True)
# Saving the Excel file
workbook.save(dataDir + "output.xls")
view raw Charts-ManipulateChart-HowToCreateColumnChart-1.py hosted with ❤ by GitHub

Cosas a saber para crear un gráfico

Antes de crear gráficos, es importante entender algunos conceptos básicos que son útiles al crear gráficos usando Aspose.Cells para Python via .NET.

Objetos de gráficos

Aspose.Cells para Python via .NET proporciona un conjunto especial de clases en el espacio de nombres Aspose.Cells.Charts que se usan para crear los gráficos compatibles con Aspose.Cells para Python via .NET. Estas clases se usan para crear objetos de gráficos, que actúan como los bloques de construcción del gráfico. Los objetos de gráficos se enumeran a continuación:

  • Series, una sola serie de datos en un gráfico.
  • Eje, el eje de un gráfico.
  • Gráfico, un solo gráfico de Excel.
  • Área de gráfico, el área de gráfico en la hoja de cálculo.
  • Tabla de datos del gráfico, una tabla de datos de gráfico.
  • ChartFrame, el objeto de marco en un gráfico.
  • ChartPoint, un solo punto en una serie en un gráfico.
  • ChartPointCollection, una colección que contiene todos los puntos en una serie.
  • Charts, una colección de objetos Chart.
  • DataLabels, una colección de todos los objetos DataLabel para la serie especificada.
  • FillFormat, formato de relleno para una forma.
  • Floor, el suelo de un gráfico en 3D.
  • Legend, la leyenda del gráfico.
  • Line, la línea del gráfico.
  • SeriesCollection, una colección de objetos Series.
  • TickLabels, las etiquetas de marca de graduación asociadas con las marcas en un eje de un gráfico.
  • Title, el título de un gráfico o eje.
  • Trendline, una línea de tendencia en un gráfico.
  • TrendlineCollection, una colección de todos los objetos Trendline para la serie de datos especificada.
  • Walls, las paredes de un gráfico en 3D.

Usar objetos de gráficos

Como se mencionó anteriormente, todos los objetos de gráficos son instancias de sus clases respectivas y proporcionan propiedades y métodos específicos para realizar tareas específicas. Use objetos de gráficos para crear gráficos.

Agregue cualquier tipo de gráfico a una hoja de cálculo usando la colección charts. Cada elemento en la colección charts representa un objeto Chart. Un objeto Chart engloba todos los demás objetos de gráficos requeridos para personalizar la apariencia del gráfico. La siguiente sección muestra cómo usar algunos objetos básicos de gráficos para crear un gráfico simple.

Crear gráfico usando Aspose.Cells para Python via .NET

Pasos:

  1. Agregue algunos datos a las celdas de la hoja de cálculo con el método put_value del objeto Cell. Esto se utilizará como fuente de datos para el gráfico.
  2. Agregue un gráfico a la hoja de cálculo llamando al método add de la colección charts, encapsulado en el objeto Worksheet.
  3. Especifique el tipo de gráfico con la enumeración ChartType. Por ejemplo, el ejemplo a continuación utiliza el valor ChartType.PYRAMID como tipo de gráfico.
  4. Acceda al nuevo objeto Chart de la colección charts pasando su índice.
  5. Utilice cualquiera de los objetos de gráficos encapsulados en el objeto Chart para gestionar el gráfico. El ejemplo a continuación utiliza el objeto de gráficos SeriesCollection para especificar la fuente de datos del gráfico.

Cuando se agrega datos de origen al gráfico, la fuente de datos puede ser un rango de celdas (como “A1:C3”), o una secuencia de celdas no contiguas (como “A1, A3, A5”), o una secuencia de valores (como “1,2,3”).

Estos pasos generales le permiten crear cualquier tipo de gráfico. Utilice diferentes objetos de gráficos para crear distintos gráficos.

Es posible crear muchos tipos diferentes de gráficos con Aspose.Cells para Python via .NET. Todos los gráficos estándar soportados por Aspose.Cells para Python via .NET están predefinidos en una enumeración llamada Aspose.Cells.Charts.ChartType.

Los tipos de gráficos predefinidos son:

Tipos de Gráficos Descripción
Column Representa Gráfico de Columnas Agrupadas
ColumnStacked Representa Gráfico de Columnas Apiladas
Column100PercentStacked Representa Gráfico de Columnas Apiladas al 100%
Column3DClustered Representa Gráfico de Columnas Agrupadas en 3D
Column3DStacked Representa Gráfico de Columnas Apiladas en 3D
Column3D100PercentStacked Representa Gráfico de Columnas Apiladas al 100% en 3D
Column3D Representa Gráfico de Columnas en 3D
Bar Representa Gráfico de Barras Agrupadas
BarStacked Representa Gráfico de Barras Apiladas
Bar100PercentStacked Representa Gráfico de Barras Apiladas al 100%
Bar3DClustered Representa Gráfico de Barras Agrupadas en 3D
Bar3DStacked Representa Gráfico de Barras Apiladas en 3D
Bar3D100PercentStacked Representa Gráfico de Barras Apiladas al 100% en 3D
Line Representa Gráfico de Líneas
LineStacked Representa Gráfico de Líneas Apiladas
Line100PercentStacked Representa Gráfico de Líneas Apiladas al 100%
LineWithDataMarkers Representa Gráfico de Líneas con marcadores de datos
LineStackedWithDataMarkers Representa Gráfico de Líneas Apiladas con marcadores de datos
Line100PercentStackedWithDataMarkers Representa Gráfico de Líneas Apiladas al 100% con marcadores de datos
Line3D Representa Gráfico de Líneas en 3D
Pie Representa Gráfico Circular
Pie3D Representa Gráfico Circular en 3D
PiePie Representa Gráfico de Pastel de Pastel
PieExploded Representa Gráfico de Pastel Explodido
Pie3DExploded Representa Gráfico de Pastel Explodido en 3D
PieBar Representa Gráfico de Barras de Pastel
Scatter Representa Gráfico de Dispersión
ScatterConnectedByCurvesWithDataMarker Representa un gráfico de dispersión conectado por curvas, con marcadores de datos
ScatterConnectedByCurvesWithoutDataMarker Representa un gráfico de dispersión conectado por curvas, sin marcadores de datos
ScatterConnectedByLinesWithDataMarker Representa un gráfico de dispersión conectado por líneas, con marcadores de datos
ScatterConnectedByLinesWithoutDataMarker Representa un gráfico de dispersión conectado por líneas, sin marcadores de datos
Area Representa un gráfico de área
AreaStacked Representa un gráfico de área apilada
Area100PercentStacked Representa un gráfico de área apilada al 100%
Area3D Representa un gráfico de área 3D
Area3DStacked Representa un gráfico de área 3D apilada
Area3D100PercentStacked Representa un gráfico de área 3D apilada al 100%
Doughnut Representa un gráfico de rosquilla
DoughnutExploded Representa un gráfico de rosquilla explosionada
Radar Representa un gráfico radar
RadarWithDataMarkers Representa un gráfico radar con marcadores de datos
RadarFilled Representa un gráfico radar relleno
Surface3D Representa un gráfico de superficie 3D
SurfaceWireframe3D Representa un gráfico de superficie 3D con estructura de alambre
SurfaceContour Representa un gráfico de contorno
SurfaceContourWireframe Representa un gráfico de contorno con estructura de alambre
Bubble Representa un gráfico de burbujas
Bubble3D Representa Gráfico de Burbujas 3D
Cylinder Representa Gráfico de Cilindro
CylinderStacked Representa Gráfico de Cilindro Apilado
Cylinder100PercentStacked Representa Gráfico de Cilindro Apilado al 100%
CylindericalBar Representa Gráfico de Barras Cilíndricas
CylindericalBarStacked Representa Gráfico de Barras Cilíndricas Apiladas
CylindericalBar100PercentStacked Representa Gráfico de Barras Cilíndricas Apiladas al 100%
CylindericalColumn3D Representa Gráfico de Columnas Cilíndricas 3D
Cone Representa Gráfico de Cono
ConeStacked Representa Gráfico de Cono Apilado
Cone100PercentStacked Representa Gráfico de Cono Apilado al 100%
ConicalBar Representa Gráfico de Barras Cónicas
ConicalBarStacked Representa Gráfico de Barras Cónicas Apiladas
ConicalBar100PercentStacked Representa Gráfico de Barras Cónicas Apiladas al 100%
ConicalColumn3D Representa Gráfico de Columnas Cónicas 3D
Pyramid Representa Gráfico de Pirámide
PyramidStacked Representa Gráfico de Pirámide Apilada
Pyramid100PercentStacked Representa Gráfico de Pirámide Apilada al 100%
PyramidBar Representa Gráfico de Barras de Pirámide
PyramidBarStacked Representa Gráfico de Barras de Pirámide Apiladas
PyramidBar100PercentStacked Representa un gráfico de barras de pirámide apilada al 100%
PyramidColumn3D Representa un gráfico de columnas de pirámide 3D

Gráfico de pirámide

Cuando se ejecuta el código de ejemplo, se agrega un gráfico de pirámide a la hoja de cálculo.

from aspose.cells import Workbook
from aspose.cells.charts import ChartType
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
# The path to the documents directory.
dataDir = RunExamples.GetDataDir(".")
# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding sample values to cells
worksheet.cells.get("A1").put_value(50)
worksheet.cells.get("A2").put_value(100)
worksheet.cells.get("A3").put_value(150)
worksheet.cells.get("B1").put_value(4)
worksheet.cells.get("B2").put_value(20)
worksheet.cells.get("B3").put_value(50)
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.PYRAMID, 5, 0, 15, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding SeriesCollection (chart data source) to the chart ranging from "A1" cell to "B3"
chart.n_series.add("A1:B3", True)
# Saving the Excel file
workbook.save(dataDir + "output.xls")
view raw Charts-ManipulateChart-HowToCreatePyramidChart-1.py hosted with ❤ by GitHub

Gráfico de líneas

En el ejemplo anterior, simplemente cambiando el ChartType a Línea se crea un gráfico de líneas. La fuente completa se proporciona a continuación. Cuando se ejecuta el código, se agrega un gráfico de líneas a la hoja de cálculo.

from aspose.cells import Workbook
from aspose.cells.charts import ChartType
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
# The path to the documents directory.
dataDir = RunExamples.GetDataDir(".")
# Instantiating a Workbook object
workbook = Workbook()
# Adding a new worksheet to the Excel object
sheetIndex = workbook.worksheets.add()
# Obtaining the reference of the newly added worksheet by passing its sheet index
worksheet = workbook.worksheets[sheetIndex]
# Adding sample values to cells
worksheet.cells.get("A1").put_value(50)
worksheet.cells.get("A2").put_value(100)
worksheet.cells.get("A3").put_value(150)
worksheet.cells.get("B1").put_value(4)
worksheet.cells.get("B2").put_value(20)
worksheet.cells.get("B3").put_value(50)
# Adding a chart to the worksheet
chartIndex = worksheet.charts.add(ChartType.LINE, 5, 0, 15, 5)
# Accessing the instance of the newly added chart
chart = worksheet.charts[chartIndex]
# Adding SeriesCollection (chart data source) to the chart ranging from "A1" cell to "B3"
chart.n_series.add("A1:B3", True)
# Saving the Excel file
workbook.save(dataDir + "output.xls")
view raw Charts-ManipulateChart-HowToCreateLineChart-1.py hosted with ❤ by GitHub

Gráfico de burbujas

Para crear un gráfico de burbujas, el ChartType debe configurarse en ChartType.BUBBLE y algunas propiedades adicionales como BubbleSizes, Values & XValues deben establecerse en consecuencia. Al ejecutar el código siguiente, se agrega un gráfico de burbujas a la hoja de cálculo.

Gráfico de líneas con marcadores de datos

Para crear un gráfico de líneas con marcadores de datos, ChartType debe configurarse en ChartType.LineWithDataMarkers y algunas propiedades adicionales como área de fondo, Marcadores de series, Values & XValues deben establecerse en consecuencia. Al ejecutar el código siguiente, se agrega un gráfico de líneas con marcadores de datos a la hoja de cálculo.

from aspose.cells import SaveFormat, Workbook
from aspose.cells.charts import ChartType, FormattingType
from aspose.pydrawing import Color
# For complete examples and data files, please go to https:# github.com/aspose-cells/Aspose.Cells-for-.NET
# Instantiate a workbook
workbook = Workbook()
# Access first worksheet
worksheet = workbook.worksheets[0]
# Set columns title
worksheet.cells.get(0, 0).value = "X"
worksheet.cells.get(0, 1).value = "Y"
# Create random data and save in the cells
for i in range(1, 21):
worksheet.cells.get(i, 0).value = i
worksheet.cells.get(i, 1).value = 0.8
for i in range(21, 41):
worksheet.cells.get(i, 0).value = i - 20
worksheet.cells.get(i, 1).value = 0.9
# Add a chart to the worksheet
idx = worksheet.charts.add(ChartType.LINE_WITH_DATA_MARKERS, 1, 3, 20, 20)
# Access the newly created chart
chart = worksheet.charts[idx]
# Set chart style
chart.style = 3
# Set autoscaling value to true
chart.auto_scaling = True
# Set foreground color white
chart.plot_area.area.foreground_color = Color.white
# Set Properties of chart title
chart.title.text = "Sample Chart"
# Set chart type
chart.type = ChartType.LINE_WITH_DATA_MARKERS
# Set Properties of categoryaxis title
chart.category_axis.title.text = "Units"
# Set Properties of nseries
s2_idx = chart.n_series.add("A2: A2", True)
s3_idx = chart.n_series.add("A22: A22", True)
# Set IsColorVaried to true for varied points color
chart.n_series.is_color_varied = True
# Set properties of background area and series markers
chart.n_series[s2_idx].area.formatting = FormattingType.CUSTOM
chart.n_series[s2_idx].marker.area.foreground_color = Color.yellow
chart.n_series[s2_idx].marker.border.is_visible = False
# Set X and Y values of series chart
chart.n_series[s2_idx].x_values = "A2: A21"
chart.n_series[s2_idx].values = "B2: B21"
# Set properties of background area and series markers
chart.n_series[s3_idx].area.formatting = FormattingType.CUSTOM
chart.n_series[s3_idx].marker.area.foreground_color = Color.green
chart.n_series[s3_idx].marker.border.is_visible = False
# Set X and Y values of series chart
chart.n_series[s3_idx].x_values = "A22: A41"
chart.n_series[s3_idx].values = "B22: B41"
# Save the workbook
workbook.save(outputDir + r"LineWithDataMarkerChart.xlsx", SaveFormat.XLSX)
view raw Charts-CreateLineWithDataMarkerChart-1.py hosted with ❤ by GitHub

Temas avanzados

Gestionar comentarios y notas Insertar imágenes y formas de archivos de Excel.