Introdução

Aspose.Cells permite que desenvolvedores criem e personalizem gráficos programaticamente diretamente em planilhas usando Python. A biblioteca capacita os usuários a visualizar dados sem depender de ferramentas externas ou intervenção manual no Microsoft Excel. Essa capacidade é essencial para gerar relatórios dinâmicos, painéis e documentos orientados por dados que exigem insights imediatos a partir de dados brutos de planilhas.

Com o Aspose.Cells, você pode adicionar vários tipos de gráfico (incluindo gráficos de coluna, linha, pizza e área) a uma planilha e definir fontes de dados usando a coleção n_series. Esses recursos facilitam a transformação de dados estáticos da planilha em representações visuais envolventes.

import os
from aspose.cells_foss import Workbook, ChartType

def get_output_directory():
    return os.path.abspath(os.path.join(".", "..", "..", "..", "Data", "02_OutputDirectory"))

def run_how_to_create_custom_chart():
    # Create a new workbook and get the first worksheet
    workbook = Workbook()
    worksheet = workbook.worksheets[0]

    # Populate cells with sample data
    worksheet.cells.get_cell_by_name("A1").put_value(50)
    worksheet.cells.get_cell_by_name("A2").put_value(100)
    worksheet.cells.get_cell_by_name("A3").put_value(150)
    worksheet.cells.get_cell_by_name("A4").put_value(110)
    worksheet.cells.get_cell_by_name("B1").put_value(260)
    worksheet.cells.get_cell_by_name("B2").put_value(12)
    worksheet.cells.get_cell_by_name("B3").put_value(50)
    worksheet.cells.get_cell_by_name("B4").put_value(100)

    # Add a bar chart to the worksheet using the dedicated add_bar() method
    chart = worksheet.charts.add_bar(5, 0, 25, 10)

    # Add NSeries data source ranging from A1 to B4
    chart.n_series.add("A1:B4", True)

    # Save the workbook
    output_path = os.path.join(get_output_directory(), "outputHowToCreateCustomChart.xlsx")
    workbook.save(output_path)

    print("HowToCreateCustomChart executed successfully.")

if __name__ == "__main__":
    run_how_to_create_custom_chart()

Principais Destaques

Aspose.Cells capacita desenvolvedores a gerar gráficos de qualidade profissional diretamente em planilhas usando Python. Com APIs intuitivas, os usuários podem definir tipos de gráfico, vincular intervalos de dados e definir títulos de gráfico, tudo programaticamente. Essa capacidade é especialmente valiosa para automação de relatórios, painéis de análise de dados e fluxos de trabalho de inteligência de negócios, onde visualizações consistentes e incorporáveis são essenciais.

  • Suporte a vários tipos de gráfico, incluindo colunas, linhas, barras e gráficos de pizza, por meio dos métodos dedicados add_bar(), add_line(), add_pie() e add_area().
  • Vinculação direta de intervalos de células da planilha como fontes de dados usando n_series.add() com argumentos de palavra‑chave opcionais category_data e name.
  • Controle programático dos títulos dos gráficos via chart.title = "My Title" (atribuição de string simples).
  • Configuração do eixo de categorias via chart.category_data = "A2:A6".
  • Controle da legenda via chart.show_legend e chart.legend_position.
  • Gráficos dos tipos LINE, BAR, PIE, AREA e STOCK são serializados totalmente para XLSX; outros tipos de gráfico geram NotImplementedError ao salvar.

Começando

Aspose.Cells permite que desenvolvedores criem e personalizem programaticamente gráficos em planilhas usando Python. Com código mínimo, você pode preencher células da planilha, adicionar um gráfico, definir sua fonte de dados e aplicar formatação, tudo sem precisar do Microsoft Excel.

from aspose.cells_foss import Workbook, ChartType

# Create a workbook and access the first worksheet
workbook = Workbook()
worksheet = workbook.worksheets[0]

# Populate cells with sample data
worksheet.cells["A1"].value = "Q1"
worksheet.cells["B1"].value = 42
worksheet.cells["A2"].value = "Q2"
worksheet.cells["B2"].value = 78

# Add a bar chart and bind data
chart = worksheet.charts.add_bar(5, 0, 20, 8)
chart.n_series.add("A1:B2", True)

# Save the workbook
workbook.save("chart_output.xlsx")

Veja Também