Chart — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss از جاسازی نمودارها در برگه‌های کاری پشتیبانی می‌کند. نمودارها از طریق ws.charts, یک ChartCollection متصل به هر Worksheet. داده‌های سری از طریق chart.n_series, یک NSeries مجموعه.

ColladaSaveOptions: aspose.cells_foss

from aspose.cells_foss import ChartType

ChartType

ChartType یک IntEnum که نوع نمودار را شناسایی می‌کند.

ColladaSaveOptions

Chart اشیاء به‌صورت مستقیم ساخته نمی‌شوند. از ws.charts.add(...) یا روش‌های راحتی تایپ‌شده (add_bar(), add_line(), add_pie(), add_area()).

ColladaSaveOptions

ChartCollection

ChartCollection دسترسی به آن به صورت ws.charts. شامل تمام نمودارهای جاسازی‌شده در یک برگه کاری است.

ColladaSaveOptions

add

ws.charts.add(
    chart_type: ChartType,
    upper_left_row: int,
    upper_left_column: int,
    lower_right_row: int,
    lower_right_column: int
) -> Chart

یک نمودار از نوع مشخص‌شده را اضافه می‌کند. تمام آرگومان‌های موقعیت به صورت ایندکس‌های ردیف/ستون صفر‑پایه هستند.

add_bar

ws.charts.add_bar(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

کلید میانبر برای add(ChartType.BAR, ...).

add_line

ws.charts.add_line(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

میانبر برای add(ChartType.LINE, ...).

add_pie

ws.charts.add_pie(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

میانبر برای add(ChartType.PIE, ...).

add_area

ws.charts.add_area(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

میانبر برای add(ChartType.AREA, ...).

ویژگی‌ها و تکرار

NSeries

NSeries از طریق chart.n_series. این سری‌های داده متعلق به یک نمودار را مدیریت می‌کند.

ColladaSaveOptions

add

chart.n_series.add(
    area: str,
    is_vertical: bool = False,
    category_data: str | None = None,
    name: str | None = None,
    chart_type: ChartType | None = None
) -> ChartSeries

یک سری داده اضافه می‌کند. area یک رشته بازه است مانند "Sheet1!B1:B5". تنظیم is_vertical=True زمانی که داده‌ها به صورت ستون‌ها مرتب شده‌اند. chart_type نوع نمودار والد را برای این سری بازنویسی می‌کند (در نمودارهای ترکیبی استفاده می‌شود).

ویژگی‌ها و تکرار

ChartSeries

ChartSeries نمایانگر یک سری دادهٔ منفرد درون یک نمودار است. به‌دست آمده از طریق chart.n_series[index].

ColladaSaveOptions

ColladaSaveOptions

add_error_bars

series.add_error_bars(
    direction='y',
    bar_type='both',
    val_type='fixedVal',
    val=1.0,
    no_end_cap=False
) -> ChartErrorBars

نوارهای خطا را به این سری اضافه می‌کند و باز می‌گرداند ChartErrorBars شی.

ChartAxis

ChartAxis از طریق chart.axes[index].

ColladaSaveOptions

ChartView3D

ChartView3D از طریق chart.view_3d. فقط زمانی اعمال می‌شود که chart.is_3d است True.

ColladaSaveOptions

ChartErrorBars

ChartErrorBars از طریق series.error_bars. ایجاد کنید با series.add_error_bars(...).

ColladaSaveOptions

ColladaSaveOptions

مثال زیر داده‌های درآمد ماهانه را می‌نویسد، یک نمودار میله‌ای خوشه‌ای با عنوان و دو سری داده‌ای ایجاد می‌کند و کتاب کار را ذخیره می‌نماید.

from aspose.cells_foss import Workbook, ChartType

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Revenue"

# Write headers and data
headers = ["Month", "Product A", "Product B"]
data = [
    ["Jan", 12000, 9500],
    ["Feb", 14500, 11000],
    ["Mar", 13200, 12800],
    ["Apr", 15800, 14100],
]
for col, h in enumerate(headers):
    ws.cells[0][col].put_value(h)
for row, row_data in enumerate(data, start=1):
    for col, val in enumerate(row_data):
        ws.cells[row][col].put_value(val)

# Add a bar chart covering rows 6-20, columns 0-6
chart = ws.charts.add_bar(6, 0, 20, 6)
chart.title = "Monthly Revenue by Product"
chart.bar_direction = "col"   # vertical (column chart)
chart.grouping = "clustered"

# Series: Product A and Product B
chart.n_series.add("Revenue!B2:B5", is_vertical=True, category_data="Revenue!A2:A5", name="Product A")
chart.n_series.add("Revenue!C2:C5", is_vertical=True, category_data="Revenue!A2:A5", name="Product B")

chart.show_legend = True
chart.legend_position = "bottom"

wb.save("revenue_chart.xlsx")

همچنین ببینید

• Cells Python API Reference صفحه اصلی
• مرجع کلاس Workbook
• مرجع کلاس Worksheet
• شروع کار
• راهنمای توسعه‌دهنده