Chart

Chart — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss palaiko diagramų įterpimą į darbalapius. Diagramomis valdomi per ws.charts, kažkoks ChartCollection priskiriamas kiekvienam Worksheet. Serijos duomenys pridedami per chart.n_series, vienas NSeries kolekcija.

Example: aspose.cells_foss

from aspose.cells_foss import ChartType

ChartType

ChartType yra IntEnum kuri identifikuoja diagramos tipą.

Example	Example	Example
`LINE`	0	Pilnai palaikoma išsaugojimui.
`BAR`	1	Pilnai palaikoma išsaugojimui.
`PIE`	2	Pilnai palaikoma išsaugojimui.
`AREA`	3	Pilnai palaikoma išsaugojimui.
`BOX_WHISKER`	4	Išsaugota naudojant chartEx formatą.
`WATERFALL`	5	Išsaugota naudojant chartEx formatą.
`COMBO`	6	Example `NotImplementedError` išsaugojant.
`SCATTER`	7	Example `NotImplementedError` išsaugojant.
`STOCK`	8	Pilnai palaikoma išsaugojimui.
`SURFACE`	9	Example `NotImplementedError` išsaugojus.
`RADAR`	10	Example `NotImplementedError` išsaugojus.
`TREEMAP`	11	Example `NotImplementedError` išsaugojus.
`SUNBURST`	12	Example `NotImplementedError` išsaugojus.
`HISTOGRAM`	13	Example `NotImplementedError` išsaugojus.
`FUNNEL`	14	Example `NotImplementedError` išsaugojus.
`MAP`	15	Example `NotImplementedError` išsaugojus.

Example

Chart objektai nėra kuriami tiesiogiai. Naudokite ws.charts.add(...) arba tipizuotus patogumo metodus (add_bar(), add_line(), add_pie(), add_area()).

Example

Example	Example	Example	Example
`type`	`ChartType`	Example	Diagramos tipas nustatytas kūrimo metu.
`title`	`str	None`	Skaityti/Rašyti
`category_data`	`str	None`	Skaityti/Rašyti
`n_series`	`NSeries`	Example	Duomenų serijų rinkinys.
`show_legend`	`bool`	Skaityti/Rašyti	`True` (numatyta) rodyti diagramos legendą.
`legend_position`	`str`	Skaityti/Rašyti	Legendo vieta: `'right'`, `'left'`, `'top'`, `'bottom'`, `'top_right'` (taip pat priima trumpus formatus `'r'`, `'l'`, `'t'`, `'b'`, `'tr'`).
`smooth`	`bool`	Skaityti/Rašyti	`True` naudoti glotnius (spline) linijas linijinėse diagramose.
`grouping`	`str`	Skaityti/Rašyti	Serijų grupavimas: `'standard'`, `'stacked'`, `'percentStacked'`, `'clustered'`.
`bar_direction`	`str`	Skaityti/Rašyti	Example `BAR` diagramos: `'bar'` (horizontal) arba `'col'` (vertikalus/stulpelis).
`gap_width`	`int`	Skaityti/Rašyti	Tarpas tarp juostų/stulpelių grupių, 0–500 (numatyta 150).
`overlap`	`int`	Skaityti/Rašyti	Serijų persidengimo procentas, -100 iki 100 (numatyta 0).
`vary_colors`	`bool`	Skaityti/Rašyti	`True` priskirti skirtingą spalvą kiekvienam duomenų taškui.
`first_slice_angle`	`int`	Skaityti/Rašyti	Pradinis kampas pirmam pyrago skilteliui, 0–360 laipsnių.
`is_3d`	`bool`	Skaityti/Rašyti	`True` įjungti 3D atvaizdavimą.
`view_3d`	`ChartView3D`	Example	3D rotation and perspective settings.
`axes`	`list[ChartAxis]`	Example	Diagramų ašių sąrašas.
`upper_left_row`	`int`	Example	0-based row index of the chart’s top-left anchor cell.
`upper_left_column`	`int`	Example	0-based column index of the chart’s top-left anchor cell.
`lower_right_row`	`int`	Example	0-based row index of the chart’s bottom-right anchor cell.
`lower_right_column`	`int`	Example	0-based column index of the chart’s bottom-right anchor cell.

ChartCollection

ChartCollection prieinama kaip ws.charts. Jame yra visos darbalapyje įterptos diagramos.

Example

add

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

Prideda diagramą nurodyto tipo. Visi pozicijos argumentai yra nulio pagrindo eilutės/stulpelio indeksai.

add_bar

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

Spartusis klavišas add(ChartType.BAR, ...).

add_line

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

Spartusis klavišas add(ChartType.LINE, ...).

add_pie

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

Spartusis klavišas add(ChartType.PIE, ...).

add_area

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

Spartusis klavišas add(ChartType.AREA, ...).

Savybės ir iteravimas

Example	Example
`count`	Diagramų skaičius kolekcijoje (tik skaitymui).
`__len__()`	Example `count`.
`__iter__()`	Iteruoja per visus `Chart` objektus.
`__getitem__(index)`	Grąžina `Chart` nulio pagrindo `index`.

NSeries

NSeries prieinama per chart.n_series. Valdo diagramai priklausančias duomenų serijas.

Example

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

Prideda duomenų seriją. area yra intervalo eilutė, pvz. "Sheet1!B1:B5". Nustatykite is_vertical=True kai duomenys išdėstyti stulpeliais. chart_type pakeičia tėvo diagramos tipą šiai serijai (naudojama kombinuotose diagramose).

Savybės ir iteravimas

Example	Example
`count`	Serijų skaičius (tik skaitymui).
`__len__()`	Example `count`.
`__iter__()`	Iteruoja per visus `ChartSeries` objektus.
`__getitem__(index)`	Grąžina `ChartSeries` nuliniu pagrindu `index`.

ChartSeries

ChartSeries žymi vieną duomenų seriją diagramoje. Gaunama per chart.n_series[index].

Example

Example	Example	Example
`values`	`str`	Diapazono eilutė Y‑reikšmių duomenims (pvz., `"Sheet1!B2:B6"`).
`category_data`	`str`	Diapazono eilutė kategorijos/X ašies etiketėms šiai serijai.
`name`	`str	None`
`chart_type`	`ChartType	None`
`x_values`	`str`	Diapazono eilutė sklaidos diagramos X reikšmėms.
`error_bars`	`ChartErrorBars	None`
`smooth`	`bool`	`True` naudoti glotnius linijas šiai serijai.

Example

add_error_bars

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

Prideda klaidos juostas prie šios serijos ir grąžina ChartErrorBars objektą.

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

ChartAxis

ChartAxis prieinama per chart.axes[index].

Example

Example	Example	Example
`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` naudoti logaritminį mastelį.
`log_base`	`float`	Logaritmo pagrindas, kai `is_logarithmic` yra `True`.
`crosses`	`str`	Kur ši ašis kertasi su statmenąja ašimi: `'autoZero'`, `'min'`, `'max'`.
`crosses_at`	`float	None`
`reverse_order`	`bool`	`True` atvirkštinti ašies kryptį.
`axis_type`	`str`	Ašies kategorijos tipas: `'catAx'`, `'valAx'`, `'dateAx'`, `'serAx'`.
`orientation`	`str`	`'minMax'` įprastai krypčiai, `'maxMin'` atvirkštinei.

ChartView3D

ChartView3D prieinama per chart.view_3d. Taikoma tik kai chart.is_3d yra True.

Example

Example	Example	Example
`rotation_x`	`int`	X ašies sukimas (aukštis), 0–90 laipsnių.
`rotation_y`	`int`	Y ašies sukimas, 0–360 laipsnių.
`right_angle_axes`	`bool`	`True` naudoti stačiakampes ašis (izometrinį vaizdą).
`perspective`	`int`	Perspektyvos iškraipymas, 0–100. Ignoruojama, kai `right_angle_axes` yra `True`.
`height_percent`	`int`	Diagramos aukštis procentais nuo bazės, 5–500.
`depth_percent`	`int`	Diagramos gylis kaip bazės procentas, 20–2000.

ChartErrorBars

ChartErrorBars prieinama per series.error_bars. Sukurti naudojant series.add_error_bars(...).

Example

Example	Example	Example
`direction`	`str`	Klaidos juostos kryptis: `'x'`, `'y'`, `'xy'`.
`bar_type`	`str`	Kurių juostų rodyti: `'both'`, `'minus'`, `'plus'`.
`val_type`	`str`	Vertės tipas: `'fixedVal'`, `'percentage'`, `'stdDev'`, `'stdErr'`.
`val`	`float`	Fiksuota arba procentinė vertė naudojama, kai `val_type` yra `'fixedVal'` arba `'percentage'`.
`no_end_cap`	`bool`	`True` praleisti galutinės galvos liniją klaidos juostose.
`plus_formula`	`str	None`
`minus_formula`	`str	None`
`line_width`	`int	None`
`line_color`	`str	None`

Example

Toliau pateiktas pavyzdys įrašo mėnesines pajamų duomenis, sukuria grupinę stulpelinę diagramą su pavadinimu ir dviem duomenų serijomis, ir išsaugo darbaknygę.

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

Chart — Aspose.Cells FOSS for Python API Reference

ChartType

Example

Example

ChartCollection

Example

add

add_bar

add_line

add_pie

add_area

Savybės ir iteravimas

NSeries

Example

add

Savybės ir iteravimas

ChartSeries

Example

Example

add_error_bars

ChartAxis

Example

ChartView3D

Example

ChartErrorBars

Example

Example

Žr. taip pat