مقدمه

Aspose.Cells به توسعه‌دهندگان امکان می‌دهد تا به‌صورت برنامه‌نویسی‌وار نمودارها را مستقیماً در داخل صفحات‌گسترده با استفاده از Python ایجاد و سفارشی‌سازی کنند. این کتابخانه به کاربران قدرت می‌دهد تا داده‌ها را بدون وابستگی به ابزارهای خارجی یا مداخله دستی در Microsoft Excel بصری‌سازی کنند. این قابلیت برای تولید گزارش‌های پویا، داشبوردها و اسناد مبتنی بر داده که نیاز به بینش فوری از داده‌های خام صفحات‌گسترده دارند، ضروری است.

با Aspose.Cells می‌توانید انواع نمودارهای مختلف (از جمله نمودارهای ستونی، خطی، دایره‌ای و مساحتی) را به یک برگه کاری اضافه کنید و منابع داده را با استفاده از مجموعه n_series تعریف کنید. این ویژگی‌ها تبدیل داده‌های ثابت صفحه‌گسترده را به نمایش‌های بصری جذاب آسان می‌سازند.

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()

نکات کلیدی

Aspose.Cells به توسعه‌دهندگان امکان می‌دهد تا نمودارهای با کیفیت حرفه‌ای را مستقیماً در داخل صفحات گسترده با استفاده از Python تولید کنند. با APIهای شهودی، کاربران می‌توانند انواع نمودار را تعریف کنند، بازه‌های داده را بایند کنند و عناوین نمودار را به‌صورت برنامه‌نویسی تنظیم کنند. این قابلیت به‌ویژه برای خودکارسازی گزارش‌ها، داشبوردهای تحلیل داده و جریان‌های کاری هوش تجاری که به تجسم‌های سازگار و قابل‌امبد نیاز دارند، ارزشمند است.

  • پشتیبانی از انواع نمودارهای متعدد شامل ستون، خط، میله و دایره‌ای از طریق متدهای اختصاصی add_bar()، add_line()، add_pie() و add_area().
  • اتصال مستقیم بازه‌های سلول‌های کاربرگ به عنوان منابع داده با استفاده از n_series.add() به همراه آرگومان‌های کلیدی اختیاری category_data و name.
  • کنترل برنامه‌نویسی عنوان‌های نمودار از طریق chart.title = "My Title" (تخصیص رشته ساده).
  • پیکربندی محور دسته‌بندی از طریق chart.category_data = "A2:A6".
  • کنترل افسانه (Legend) از طریق chart.show_legend و chart.legend_position.
  • نمودارهای نوع LINE، BAR، PIE، AREA و STOCK به‌صورت کامل به XLSX سریال‌سازی می‌شوند؛ انواع دیگر نمودار در زمان ذخیره‌سازی خطای NotImplementedError را ایجاد می‌کنند.

شروع کار

Aspose.Cells به توسعه‌دهندگان امکان می‌دهد تا به‌صورت برنامه‌نویسی‌ایی نمودارها را در داخل صفحات گسترده با استفاده از Python ایجاد و سفارشی‌سازی کنند. با کدهای کم، می‌توانید سلول‌های کاربرگ را پر کنید، یک نمودار اضافه کنید، منبع داده آن را تعریف کنید و قالب‌بندی اعمال کنید، همه این‌ها بدون نیاز به 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")

موارد مرتبط