Chart

Chart — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss תומך בהטמעת תרשימים בגיליונות עבודה. תרשימים מנוהלים באמצעות ws.charts, a ChartCollection מצורף לכל Worksheet. נתוני הסדרה מתווספים באמצעות chart.n_series, an NSeries אוסף.

ColladaSaveOptions: aspose.cells_foss

from aspose.cells_foss import ChartType

ChartType

ChartType הוא an IntEnum שמזהה את סוג התרשים.

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
LINE0נתמך במלואו לשמירה.
BAR1נתמך במלואו לשמירה.
PIE2נתמך במלואו לשמירה.
AREA3נתמך במלואו לשמירה.
BOX_WHISKER4נשמר באמצעות פורמט chartEx.
WATERFALL5נשמר באמצעות פורמט chartEx.
COMBO6ColladaSaveOptions NotImplementedError בעת שמירה.
SCATTER7ColladaSaveOptions NotImplementedError בעת שמירה.
STOCK8נתמך במלואו לשמירה.
SURFACE9ColladaSaveOptions NotImplementedError בשמירה.
RADAR10ColladaSaveOptions NotImplementedError בשמירה.
TREEMAP11ColladaSaveOptions NotImplementedError בשמירה.
SUNBURST12ColladaSaveOptions NotImplementedError בשמירה.
HISTOGRAM13ColladaSaveOptions NotImplementedError בשמירה.
FUNNEL14ColladaSaveOptions NotImplementedError בשמירה.
MAP15ColladaSaveOptions NotImplementedError בשמירה.

ColladaSaveOptions

Chart אובייקטים אינם נבנים ישירות. השתמש ws.charts.add(...) או בשיטות נוחות המוגדרות (add_bar(), add_line(), add_pie(), add_area()).

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
typeChartTypeColladaSaveOptionsסוג התרשים נקבע בזמן היצירה.
title`strNone`קריאה/כתיבה
category_data`strNone`קריאה/כתיבה
n_seriesNSeriesColladaSaveOptionsאוסף של סדרות נתונים.
show_legendboolקריאה/כתיבהTrue (ברירת מחדל) להצגת מקרא התרשים.
legend_positionstrקריאה/כתיבהמיקום המקרא: 'right', 'left', 'top', 'bottom', 'top_right' (גם מקבל צורות קצרות 'r', 'l', 't', 'b', 'tr').
smoothboolקריאה/כתיבהTrue להשתמש בקווים חלקים (ספליין) בתרשימי קו.
groupingstrקריאה/כתיבהקיבוץ סדרות: 'standard', 'stacked', 'percentStacked', 'clustered'.
bar_directionstrקריאה/כתיבהColladaSaveOptions BAR תרשימים: 'bar' (אופקי) או 'col' (אנכי/עמודה).
gap_widthintקריאה/כתיבהמרווח בין אשכולות של בר/עמודה, 0–500 (ברירת מחדל 150).
overlapintקריאה/כתיבהאחוז חפיפה של סדרות, -100 עד 100 (ברירת מחדל 0).
vary_colorsboolקריאה/כתיבהTrue להקצות צבע ייחודי לכל נקודת נתון.
first_slice_angleintקריאה/כתיבהזווית התחלה לפרוסת הפאי הראשונה, 0–360 מעלות.
is_3dboolקריאה/כתיבהTrue להפעיל רינדור תלת‑ממדי.
view_3dChartView3DColladaSaveOptions3D rotation and perspective settings.
axeslist[ChartAxis]ColladaSaveOptionsרשימת צירי התרשים.
upper_left_rowintColladaSaveOptions0-based row index of the chart’s top-left anchor cell.
upper_left_columnintColladaSaveOptions0-based column index of the chart’s top-left anchor cell.
lower_right_rowintColladaSaveOptions0-based row index of the chart’s bottom-right anchor cell.
lower_right_columnintColladaSaveOptions0-based column index of the chart’s bottom-right anchor cell.

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

מוסיף תרשים מהסוג שצוין. כל ארגומנטים של המיקום הם אינדקסים של שורות/עמודות שמתחילים מ‑0.

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, ...).

מאפיינים וחזרה

ColladaSaveOptionsColladaSaveOptions
countמספר התרשימים באוסף (קריאה בלבד).
__len__()ColladaSaveOptions count.
__iter__()עובר על כל Chart אובייקטים.
__getitem__(index)מחזיר את Chart באינדקס שמתחיל מאפס index.

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 עוקף את סוג התרשים ההורה עבור סדרה זו (משמש בתרשימים משולבים).

מאפיינים וחזרה

ColladaSaveOptionsColladaSaveOptions
countמספר הסדרות (קריאה בלבד).
__len__()ColladaSaveOptions count.
__iter__()עובר על כולם ChartSeries אובייקטים.
__getitem__(index)מחזיר את ChartSeries באינדקס שמתחיל מאפס index.

ChartSeries

ChartSeries מייצג סדרת נתונים יחידה בתוך תרשים. מתקבל דרך chart.n_series[index].

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
valuesstrמחרוזת טווח לנתוני ערכי Y (לדוגמה,., "Sheet1!B2:B6").
category_datastrמחרוזת טווח לתוויות הקטגוריה/ציר X עבור סדרה זו.
name`strNone`
chart_type`ChartTypeNone`
x_valuesstrמחרוזת טווח לערכי X בתרשים פיזור.
error_bars`ChartErrorBarsNone`
smoothboolTrue להשתמש בקווים חלקים עבור סדרה זו.

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 האובייקט.

ColladaSaveOptionsColladaSaveOptions
direction'x', 'y', 'xy'
bar_type'both', 'minus', 'plus'
val_type'fixedVal', 'percentage', 'stdDev', 'stdErr'

ChartAxis

ChartAxis נגיש דרך chart.axes[index].

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
title`strNone`
number_format`strNone`
minimum_scale`floatNone`
maximum_scale`floatNone`
major_unit`floatNone`
minor_unit`floatNone`
is_logarithmicboolTrue להשתמש בסקלה לוגריתמית.
log_basefloatבסיס הלוגריתם כאשר is_logarithmic הוא True.
crossesstrהיכן שהציר הזה חוצה את הציר האנכי: 'autoZero', 'min', 'max'.
crosses_at`floatNone`
reverse_orderboolTrue להפוך את כיוון הציר.
axis_typestrסוג קטגוריית הציר: 'catAx', 'valAx', 'dateAx', 'serAx'.
orientationstr'minMax' לכיוון רגיל, 'maxMin' להפוך.

ChartView3D

ChartView3D נגיש דרך chart.view_3d. חל רק כאשר chart.is_3d הוא True.

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
rotation_xintסיבוב ציר X (גובה), 0–90 מעלות.
rotation_yintסיבוב ציר Y, 0–360 מעלות.
right_angle_axesboolTrue להשתמש בצירים בזווית ישרה (תצוגה איזומטרית).
perspectiveintעיוות פרספקטיבה, 0–100. מתעלמים כאשר right_angle_axes הוא True.
height_percentintגובה התרשים כאחוז מהבסיס, 5–500.
depth_percentintעומק התרשים כאחוז מהבסיס, 20–2000.

ChartErrorBars

ChartErrorBars נגיש דרך series.error_bars. צור עם series.add_error_bars(...).

ColladaSaveOptions

ColladaSaveOptionsColladaSaveOptionsColladaSaveOptions
directionstrכיוון קו השגיאה: 'x', 'y', 'xy'.
bar_typestrאילו קווים להציג: 'both', 'minus', 'plus'.
val_typestrסוג ערך: 'fixedVal', 'percentage', 'stdDev', 'stdErr'.
valfloatערך קבוע או אחוז משמש כאשר val_type הוא 'fixedVal' או 'percentage'.
no_end_capboolTrue להשמיט את קו הקצה על קווי השגיאה.
plus_formula`strNone`
minus_formula`strNone`
line_width`intNone`
line_color`strNone`

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

ראה גם

 עברית