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 ChartType

ChartType

ChartType ir IntEnum kas identificē diagrammas veidu.

SaveOptionsSaveOptionsSaveOptions
LINE0Pilnībā atbalstīts saglabāšanai.
BAR1Pilnībā atbalstīts saglabāšanai.
PIE2Pilnībā atbalstīts saglabāšanai.
AREA3Pilnībā atbalstīts saglabāšanai.
BOX_WHISKER4Saglabāts, izmantojot chartEx formātu.
WATERFALL5Saglabāts, izmantojot chartEx formātu.
COMBO6SaveOptions NotImplementedError saglabājot.
SCATTER7SaveOptions NotImplementedError saglabājot.
STOCK8Pilnībā atbalstīts saglabāšanai.
SURFACE9SaveOptions NotImplementedError saglabājot.
RADAR10SaveOptions NotImplementedError saglabājot.
TREEMAP11SaveOptions NotImplementedError saglabājot.
SUNBURST12SaveOptions NotImplementedError saglabājot.
HISTOGRAM13SaveOptions NotImplementedError saglabājot.
FUNNEL14SaveOptions NotImplementedError saglabājot.
MAP15SaveOptions 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

SaveOptionsSaveOptionsSaveOptionsSaveOptions
typeChartTypeSaveOptionsDiagrammas veids iestatīts izveides brīdī.
title`strNone`Lasīt/Rakstīt
category_data`strNone`Lasīt/Rakstīt
n_seriesNSeriesSaveOptionsDatu sēriju kolekcija.
show_legendboolLasīt/RakstītTrue (noklusējums) lai parādītu diagrammas leģendu.
legend_positionstrLasīt/RakstītLeģendas novietojums: 'right', 'left', 'top', 'bottom', 'top_right' (pieņem arī īsos veidus 'r', 'l', 't', 'b', 'tr').
smoothboolLasīt/RakstītTrue lai izmantotu gludas (splaina) līnijas līniju diagrammās.
groupingstrLasīt/RakstītSēriju grupēšana: 'standard', 'stacked', 'percentStacked', 'clustered'.
bar_directionstrLasīt/RakstītSaveOptions BAR diagrammas: 'bar' (horizontāls) vai 'col' (vertikāls/kolonna).
gap_widthintLasīt/RakstītAtstarpe starp joslu/kolonnas grupām, 0–500 (noklusējums 150).
overlapintLasīt/RakstītSērijas pārklājuma procenti, -100 līdz 100 (noklusējums 0).
vary_colorsboolLasīt/RakstītTrue piešķirt katram datu punktam atšķirīgu krāsu.
first_slice_angleintLasīt/RakstītSākuma leņķis pirmajam pīrāga gabalam, 0–360 grādi.
is_3dboolLasīt/RakstītTrue lai aktivizētu 3D renderēšanu.
view_3dChartView3DSaveOptions3D rotation and perspective settings.
axeslist[ChartAxis]SaveOptionsDiagrammas asu saraksts.
upper_left_rowintSaveOptions0-based row index of the chart’s top-left anchor cell.
upper_left_columnintSaveOptions0-based column index of the chart’s top-left anchor cell.
lower_right_rowintSaveOptions0-based row index of the chart’s bottom-right anchor cell.
lower_right_columnintSaveOptions0-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
) -> Chart

Pievieno 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

SaveOptionsSaveOptions
countDiagrammu 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
) -> ChartSeries

Pievieno 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

SaveOptionsSaveOptions
countSē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

SaveOptionsSaveOptionsSaveOptions
valuesstrDiapazona virkne Y‑vērtību datiem (piemēram,., "Sheet1!B2:B6").
category_datastrDiapazona virkne kategorijas/X‑asīzes etiķetēm šai sērijai.
name`strNone`
chart_type`ChartTypeNone`
x_valuesstrDiapazona virkne X vērtībām izkliedes diagrammai.
error_bars`ChartErrorBarsNone`
smoothboolTrue 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
) -> ChartErrorBars

Pievieno kļūdu joslas šai sērijai un atgriež ChartErrorBars objektu.

SaveOptionsSaveOptions
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

SaveOptionsSaveOptionsSaveOptions
title`strNone`
number_format`strNone`
minimum_scale`floatNone`
maximum_scale`floatNone`
major_unit`floatNone`
minor_unit`floatNone`
is_logarithmicboolTrue izmantot logaritmisko skalu.
log_basefloatLogaritma bāze, kad is_logarithmic ir True.
crossesstrKur šī ass krustojas ar perpendikulāro asi: 'autoZero', 'min', 'max'.
crosses_at`floatNone`
reverse_orderboolTrue lai apgrieztu ass virzienu.
axis_typestrAssas kategorijas veids: 'catAx', 'valAx', 'dateAx', 'serAx'.
orientationstr'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

SaveOptionsSaveOptionsSaveOptions
rotation_xintX‑asīzes rotācija (paaugstinājums), 0–90 grādi.
rotation_yintY‑asīzes rotācija, 0–360 grādi.
right_angle_axesboolTrue lai izmantotu taisnas leņķa asis (izometriska skats).
perspectiveintPerspektīvas deformācija, 0–100. Ignorēts, ja right_angle_axes ir True.
height_percentintDiagrammas augstums kā procentuālā daļa no pamata, 5–500.
depth_percentintDiagrammas dziļums kā bāzes procents, 20–2000.

ChartErrorBars

ChartErrorBars tiek piekļūts caur series.error_bars. Izveidot ar series.add_error_bars(...).

SaveOptions

SaveOptionsSaveOptionsSaveOptions
directionstrKļūdas joslas virziens: 'x', 'y', 'xy'.
bar_typestrKuras joslas rādīt: 'both', 'minus', 'plus'.
val_typestrVērtības veids: 'fixedVal', 'percentage', 'stdDev', 'stdErr'.
valfloatFiksēta vai procentuālā vērtība, ko izmanto, kad val_type ir 'fixedVal' vai 'percentage'.
no_end_capboolTrue lai izlaistu beigu kapu līniju uz kļūdas joslām.
plus_formula`strNone`
minus_formula`strNone`
line_width`intNone`
line_color`strNone`

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

Skatīt arī

 Latviešu