Chart — Aspose.Cells FOSS for Python API Reference
aspose-cells-foss atbalsta diagrammu iegulšanu darblapās. Diagrammas tiek pārvaldītas caur ws.charts, viena ChartCollection pievienota katram Worksheet. Sērijas dati tiek pievienoti caur chart.n_series, viens NSeries kolekcija.
SaveOptions: aspose.cells_foss
from aspose.cells_foss import ChartTypeChartType
ChartType ir IntEnum kas identificē diagrammas veidu.
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
LINE | 0 | Pilnībā atbalstīts saglabāšanai. |
BAR | 1 | Pilnībā atbalstīts saglabāšanai. |
PIE | 2 | Pilnībā atbalstīts saglabāšanai. |
AREA | 3 | Pilnībā atbalstīts saglabāšanai. |
BOX_WHISKER | 4 | Saglabāts, izmantojot chartEx formātu. |
WATERFALL | 5 | Saglabāts, izmantojot chartEx formātu. |
COMBO | 6 | SaveOptions NotImplementedError saglabājot. |
SCATTER | 7 | SaveOptions NotImplementedError saglabājot. |
STOCK | 8 | Pilnībā atbalstīts saglabāšanai. |
SURFACE | 9 | SaveOptions NotImplementedError saglabājot. |
RADAR | 10 | SaveOptions NotImplementedError saglabājot. |
TREEMAP | 11 | SaveOptions NotImplementedError saglabājot. |
SUNBURST | 12 | SaveOptions NotImplementedError saglabājot. |
HISTOGRAM | 13 | SaveOptions NotImplementedError saglabājot. |
FUNNEL | 14 | SaveOptions NotImplementedError saglabājot. |
MAP | 15 | SaveOptions NotImplementedError saglabājot. |
SaveOptions
Chart objekti netiek konstruēti tieši. Izmantojiet ws.charts.add(...) vai tipizētās ērtuma metodes (add_bar(), add_line(), add_pie(), add_area()).
SaveOptions
| SaveOptions | SaveOptions | SaveOptions | SaveOptions |
|---|---|---|---|
type | ChartType | SaveOptions | Diagrammas veids iestatīts izveides brīdī. |
title | `str | None` | Lasīt/Rakstīt |
category_data | `str | None` | Lasīt/Rakstīt |
n_series | NSeries | SaveOptions | Datu sēriju kolekcija. |
show_legend | bool | Lasīt/Rakstīt | True (noklusējums) lai parādītu diagrammas leģendu. |
legend_position | str | Lasīt/Rakstīt | Leģendas novietojums: 'right', 'left', 'top', 'bottom', 'top_right' (pieņem arī īsos veidus 'r', 'l', 't', 'b', 'tr'). |
smooth | bool | Lasīt/Rakstīt | True lai izmantotu gludas (splaina) līnijas līniju diagrammās. |
grouping | str | Lasīt/Rakstīt | Sēriju grupēšana: 'standard', 'stacked', 'percentStacked', 'clustered'. |
bar_direction | str | Lasīt/Rakstīt | SaveOptions BAR diagrammas: 'bar' (horizontāls) vai 'col' (vertikāls/kolonna). |
gap_width | int | Lasīt/Rakstīt | Atstarpe starp joslu/kolonnas grupām, 0–500 (noklusējums 150). |
overlap | int | Lasīt/Rakstīt | Sērijas pārklājuma procenti, -100 līdz 100 (noklusējums 0). |
vary_colors | bool | Lasīt/Rakstīt | True piešķirt katram datu punktam atšķirīgu krāsu. |
first_slice_angle | int | Lasīt/Rakstīt | Sākuma leņķis pirmajam pīrāga gabalam, 0–360 grādi. |
is_3d | bool | Lasīt/Rakstīt | True lai aktivizētu 3D renderēšanu. |
view_3d | ChartView3D | SaveOptions | 3D rotation and perspective settings. |
axes | list[ChartAxis] | SaveOptions | Diagrammas asu saraksts. |
upper_left_row | int | SaveOptions | 0-based row index of the chart’s top-left anchor cell. |
upper_left_column | int | SaveOptions | 0-based column index of the chart’s top-left anchor cell. |
lower_right_row | int | SaveOptions | 0-based row index of the chart’s bottom-right anchor cell. |
lower_right_column | int | SaveOptions | 0-based column index of the chart’s bottom-right anchor cell. |
ChartCollection
ChartCollection tiek piekļūts kā ws.charts. Tajā ir iekļautas visas diagrammas, kas iegultas darblapā.
SaveOptions
add
ws.charts.add(
chart_type: ChartType,
upper_left_row: int,
upper_left_column: int,
lower_right_row: int,
lower_right_column: int
) -> ChartPievieno diagrammu norādītā tipa. Visi pozīcijas argumenti ir 0‑bāzes rindu/kolonnas indeksi.
add_bar
ws.charts.add_bar(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> ChartĪsceļš uz add(ChartType.BAR, ...).
add_line
ws.charts.add_line(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> ChartĪsceļš uz add(ChartType.LINE, ...).
add_pie
ws.charts.add_pie(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> ChartĪsceļš uz add(ChartType.PIE, ...).
add_area
ws.charts.add_area(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> ChartĪsceļš uz add(ChartType.AREA, ...).
Īpašības un iterācija
| SaveOptions | SaveOptions |
|---|---|
count | Diagrammu skaits kolekcijā (tikai lasāms). |
__len__() | SaveOptions count. |
__iter__() | Iterē pār visiem Chart objekti. |
__getitem__(index) | Atgriež Chart ar nulles indeksu index. |
NSeries
NSeries tiek piekļūts caur chart.n_series. Tas pārvalda datu sērijas, kas pieder diagrammai.
SaveOptions
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
) -> ChartSeriesPievieno datu sēriju. area ir diapazona virkne, piemēram "Sheet1!B1:B5". Iestatīt is_vertical=True kad dati ir sakārtoti kolonnās. chart_type pārraksta vecāku diagrammas tipu šai sērijai (izmanto kombinētajās diagrammās).
Īpašības un iterācija
| SaveOptions | SaveOptions |
|---|---|
count | Sēriju skaits (tikai lasāms). |
__len__() | SaveOptions count. |
__iter__() | Iterē pār visiem ChartSeries objekti. |
__getitem__(index) | Atgriež ChartSeries ar nulles bāzi index. |
ChartSeries
ChartSeries pārstāv vienu datu sēriju diagrammā. Iegūts caur chart.n_series[index].
SaveOptions
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
values | str | Diapazona virkne Y‑vērtību datiem (piemēram,., "Sheet1!B2:B6"). |
category_data | str | Diapazona virkne kategorijas/X‑asīzes etiķetēm šai sērijai. |
name | `str | None` |
chart_type | `ChartType | None` |
x_values | str | Diapazona virkne X vērtībām izkliedes diagrammai. |
error_bars | `ChartErrorBars | None` |
smooth | bool | True lai izmantotu gludas līnijas šai sērijai. |
SaveOptions
add_error_bars
series.add_error_bars(
direction='y',
bar_type='both',
val_type='fixedVal',
val=1.0,
no_end_cap=False
) -> ChartErrorBarsPievieno kļūdu joslas šai sērijai un atgriež ChartErrorBars objektu.
| SaveOptions | SaveOptions |
|---|---|
direction | 'x', 'y', 'xy' |
bar_type | 'both', 'minus', 'plus' |
val_type | 'fixedVal', 'percentage', 'stdDev', 'stdErr' |
ChartAxis
ChartAxis tiek piekļūts caur chart.axes[index].
SaveOptions
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
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 izmantot logaritmisko skalu. |
log_base | float | Logaritma bāze, kad is_logarithmic ir True. |
crosses | str | Kur šī ass krustojas ar perpendikulāro asi: 'autoZero', 'min', 'max'. |
crosses_at | `float | None` |
reverse_order | bool | True lai apgrieztu ass virzienu. |
axis_type | str | Assas kategorijas veids: 'catAx', 'valAx', 'dateAx', 'serAx'. |
orientation | str | 'minMax' normālam virzienam, 'maxMin' apgrieztam. |
ChartView3D
ChartView3D tiek piekļūts caur chart.view_3d. Piemērojams tikai tad, ja chart.is_3d ir True.
SaveOptions
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
rotation_x | int | X‑asīzes rotācija (paaugstinājums), 0–90 grādi. |
rotation_y | int | Y‑asīzes rotācija, 0–360 grādi. |
right_angle_axes | bool | True lai izmantotu taisnas leņķa asis (izometriska skats). |
perspective | int | Perspektīvas deformācija, 0–100. Ignorēts, ja right_angle_axes ir True. |
height_percent | int | Diagrammas augstums kā procentuālā daļa no pamata, 5–500. |
depth_percent | int | Diagrammas dziļums kā bāzes procents, 20–2000. |
ChartErrorBars
ChartErrorBars tiek piekļūts caur series.error_bars. Izveidot ar series.add_error_bars(...).
SaveOptions
| SaveOptions | SaveOptions | SaveOptions |
|---|---|---|
direction | str | Kļūdas joslas virziens: 'x', 'y', 'xy'. |
bar_type | str | Kuras joslas rādīt: 'both', 'minus', 'plus'. |
val_type | str | Vērtības veids: 'fixedVal', 'percentage', 'stdDev', 'stdErr'. |
val | float | Fiksēta vai procentuālā vērtība, ko izmanto, kad val_type ir 'fixedVal' vai 'percentage'. |
no_end_cap | bool | True lai izlaistu beigu kapu līniju uz kļūdas joslām. |
plus_formula | `str | None` |
minus_formula | `str | None` |
line_width | `int | None` |
line_color | `str | None` |
SaveOptions
Sekojošais piemērs ieraksta ikmēneša ieņēmumu datus, izveido grupētu joslu diagrammu ar virsrakstu un divām datu sērijām, un saglabā darba grāmatu.
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")