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 ChartTypeChartType
ChartType הוא an IntEnum שמזהה את סוג התרשים.
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
LINE | 0 | נתמך במלואו לשמירה. |
BAR | 1 | נתמך במלואו לשמירה. |
PIE | 2 | נתמך במלואו לשמירה. |
AREA | 3 | נתמך במלואו לשמירה. |
BOX_WHISKER | 4 | נשמר באמצעות פורמט chartEx. |
WATERFALL | 5 | נשמר באמצעות פורמט chartEx. |
COMBO | 6 | ColladaSaveOptions NotImplementedError בעת שמירה. |
SCATTER | 7 | ColladaSaveOptions NotImplementedError בעת שמירה. |
STOCK | 8 | נתמך במלואו לשמירה. |
SURFACE | 9 | ColladaSaveOptions NotImplementedError בשמירה. |
RADAR | 10 | ColladaSaveOptions NotImplementedError בשמירה. |
TREEMAP | 11 | ColladaSaveOptions NotImplementedError בשמירה. |
SUNBURST | 12 | ColladaSaveOptions NotImplementedError בשמירה. |
HISTOGRAM | 13 | ColladaSaveOptions NotImplementedError בשמירה. |
FUNNEL | 14 | ColladaSaveOptions NotImplementedError בשמירה. |
MAP | 15 | ColladaSaveOptions NotImplementedError בשמירה. |
ColladaSaveOptions
Chart אובייקטים אינם נבנים ישירות. השתמש ws.charts.add(...) או בשיטות נוחות המוגדרות (add_bar(), add_line(), add_pie(), add_area()).
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|---|
type | ChartType | ColladaSaveOptions | סוג התרשים נקבע בזמן היצירה. |
title | `str | None` | קריאה/כתיבה |
category_data | `str | None` | קריאה/כתיבה |
n_series | NSeries | ColladaSaveOptions | אוסף של סדרות נתונים. |
show_legend | bool | קריאה/כתיבה | True (ברירת מחדל) להצגת מקרא התרשים. |
legend_position | str | קריאה/כתיבה | מיקום המקרא: 'right', 'left', 'top', 'bottom', 'top_right' (גם מקבל צורות קצרות 'r', 'l', 't', 'b', 'tr'). |
smooth | bool | קריאה/כתיבה | True להשתמש בקווים חלקים (ספליין) בתרשימי קו. |
grouping | str | קריאה/כתיבה | קיבוץ סדרות: 'standard', 'stacked', 'percentStacked', 'clustered'. |
bar_direction | str | קריאה/כתיבה | ColladaSaveOptions BAR תרשימים: 'bar' (אופקי) או 'col' (אנכי/עמודה). |
gap_width | int | קריאה/כתיבה | מרווח בין אשכולות של בר/עמודה, 0–500 (ברירת מחדל 150). |
overlap | int | קריאה/כתיבה | אחוז חפיפה של סדרות, -100 עד 100 (ברירת מחדל 0). |
vary_colors | bool | קריאה/כתיבה | True להקצות צבע ייחודי לכל נקודת נתון. |
first_slice_angle | int | קריאה/כתיבה | זווית התחלה לפרוסת הפאי הראשונה, 0–360 מעלות. |
is_3d | bool | קריאה/כתיבה | True להפעיל רינדור תלת‑ממדי. |
view_3d | ChartView3D | ColladaSaveOptions | 3D rotation and perspective settings. |
axes | list[ChartAxis] | ColladaSaveOptions | רשימת צירי התרשים. |
upper_left_row | int | ColladaSaveOptions | 0-based row index of the chart’s top-left anchor cell. |
upper_left_column | int | ColladaSaveOptions | 0-based column index of the chart’s top-left anchor cell. |
lower_right_row | int | ColladaSaveOptions | 0-based row index of the chart’s bottom-right anchor cell. |
lower_right_column | int | ColladaSaveOptions | 0-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, ...).
מאפיינים וחזרה
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
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 עוקף את סוג התרשים ההורה עבור סדרה זו (משמש בתרשימים משולבים).
מאפיינים וחזרה
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
count | מספר הסדרות (קריאה בלבד). |
__len__() | ColladaSaveOptions count. |
__iter__() | עובר על כולם ChartSeries אובייקטים. |
__getitem__(index) | מחזיר את ChartSeries באינדקס שמתחיל מאפס index. |
ChartSeries
ChartSeries מייצג סדרת נתונים יחידה בתוך תרשים. מתקבל דרך chart.n_series[index].
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
values | str | מחרוזת טווח לנתוני ערכי Y (לדוגמה,., "Sheet1!B2:B6"). |
category_data | str | מחרוזת טווח לתוויות הקטגוריה/ציר X עבור סדרה זו. |
name | `str | None` |
chart_type | `ChartType | None` |
x_values | str | מחרוזת טווח לערכי X בתרשים פיזור. |
error_bars | `ChartErrorBars | None` |
smooth | bool | True להשתמש בקווים חלקים עבור סדרה זו. |
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 האובייקט.
| ColladaSaveOptions | ColladaSaveOptions |
|---|---|
direction | 'x', 'y', 'xy' |
bar_type | 'both', 'minus', 'plus' |
val_type | 'fixedVal', 'percentage', 'stdDev', 'stdErr' |
ChartAxis
ChartAxis נגיש דרך chart.axes[index].
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
title | `str | None` |
number_format | `str | None` |
minimum_scale | `float | None` |
maximum_scale | `float | None` |
major_unit | `float | None` |
minor_unit | `float | None` |
is_logarithmic | bool | True להשתמש בסקלה לוגריתמית. |
log_base | float | בסיס הלוגריתם כאשר is_logarithmic הוא True. |
crosses | str | היכן שהציר הזה חוצה את הציר האנכי: 'autoZero', 'min', 'max'. |
crosses_at | `float | None` |
reverse_order | bool | True להפוך את כיוון הציר. |
axis_type | str | סוג קטגוריית הציר: 'catAx', 'valAx', 'dateAx', 'serAx'. |
orientation | str | 'minMax' לכיוון רגיל, 'maxMin' להפוך. |
ChartView3D
ChartView3D נגיש דרך chart.view_3d. חל רק כאשר chart.is_3d הוא True.
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
rotation_x | int | סיבוב ציר X (גובה), 0–90 מעלות. |
rotation_y | int | סיבוב ציר Y, 0–360 מעלות. |
right_angle_axes | bool | True להשתמש בצירים בזווית ישרה (תצוגה איזומטרית). |
perspective | int | עיוות פרספקטיבה, 0–100. מתעלמים כאשר right_angle_axes הוא True. |
height_percent | int | גובה התרשים כאחוז מהבסיס, 5–500. |
depth_percent | int | עומק התרשים כאחוז מהבסיס, 20–2000. |
ChartErrorBars
ChartErrorBars נגיש דרך series.error_bars. צור עם series.add_error_bars(...).
ColladaSaveOptions
| ColladaSaveOptions | ColladaSaveOptions | ColladaSaveOptions |
|---|---|---|
direction | str | כיוון קו השגיאה: 'x', 'y', 'xy'. |
bar_type | str | אילו קווים להציג: 'both', 'minus', 'plus'. |
val_type | str | סוג ערך: 'fixedVal', 'percentage', 'stdDev', 'stdErr'. |
val | float | ערך קבוע או אחוז משמש כאשר val_type הוא 'fixedVal' או 'percentage'. |
no_end_cap | bool | True להשמיט את קו הקצה על קווי השגיאה. |
plus_formula | `str | None` |
minus_formula | `str | None` |
line_width | `int | None` |
line_color | `str | None` |
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")