المقدمة

تمكّن 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. من خلال واجهات برمجة تطبيقات بديهية، يمكن للمستخدمين تحديد أنواع المخططات، ربط نطاقات البيانات، وتعيين عناوين المخططات، كل ذلك برمجياً. تُعد هذه القدرة ذات قيمة خاصة لأتمتة التقارير، ولوحات تحليلات البيانات، وتدفقات عمل الذكاء التجاري حيث تكون التصورات القابلة للتضمين والمتسقة ضرورية.

  • دعم لأنواع متعددة من المخططات بما في ذلك المخططات العمودية، الخطية، الشريطية، والدائرية عبر طرق add_bar()، add_line()، add_pie()، وadd_area() المخصصة.
  • ربط مباشر لنطاقات خلايا ورقة العمل كمصادر بيانات باستخدام n_series.add() مع معاملات الكلمات المفتاحية الاختيارية category_data وname.
  • التحكم برمجيًا في عناوين المخططات عبر chart.title = "My Title" (تعيين سلسلة نصية عادية).
  • تكوين محور الفئات عبر chart.category_data = "A2:A6".
  • التحكم في وسيلة الإيضاح عبر 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")

انظر أيضًا