Aspose.Cells FOSS
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines sú miniaturizované grafy vložené do jednotlivých buniek, zavedené v Exceli 2010. aspose-cells-foss spravuje sparklines prostredníctvom SparklineGroup a SparklineGroupCollection (ws.sparkline_groups). Each group holds one or more Sparkline objekty zdieľajúce rovnaký typ a nastavenia farieb.

ImageRenderOptions: aspose.cells_foss

from aspose.cells_foss import SparklineType, SparklineEmptyCells, Sparkline, SparklineGroup

SparklineType

SparklineType je IntEnum identifikujúci vizuálny tvar skupiny sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Line sparkline — vykresľuje dáta ako spojenú čiaru.
COLUMN1Column sparkline — vykresľuje dáta ako vertikálne stĺpce.
WIN_LOSS2Win/loss sparkline — každá hodnota je zobrazená ako pozitívny alebo negatívny blok.

SparklineEmptyCells

SparklineEmptyCells je IntEnum riadiaci, ako sa prázdne bunky spracúvajú v rámci sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Považuje prázdne bunky za nulu.
GAP1Zanechá medzeru tam, kde sú bunky prázdne (čiara je prerušená).
CONNECTED2Spojí susediace ne‑prázdne hodnoty, preskočí medzeru.

ImageRenderOptions

A Sparkline viaže jeden rozsah dát k jednej bunke.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrRozsah v štýle A1 obsahujúci zdrojové údaje sparkline (napr., "Sheet1!B2:G2").
cell_referencestrAdresa bunky v štýle A1, kde je sparkline zobrazená (napr., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrRozsah zdrojových údajov.
cell_referencestrAdresa zobrazovacej bunky.

SparklineGroup

A SparklineGroup definuje zdieľané vizuálne nastavenia (typ, farby, spracovanie prázdnych buniek) pre sadu sparkline. SparklineGroup objekty sa nekonštruujú priamo — použite ws.sparkline_groups.add(...) alebo ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeFormulár Sparkline: LINE, COLUMN, alebo WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsAko spracovať prázdne bunky v dátovom rozsahu.
color_seriesstrFarba hlavnej čiary/pásov sparkline, ako hex RRGGBB.
color_negativestrFarba pre pásy s negatívnou hodnotou (WIN_LOSS a COLUMN), ako hex RRGGBB.
color_axisstrFarba čiary nuly osi, ako hex RRGGBB.
color_markersstrFarba značiek dátových bodov na čiarových sparkline, ako hex RRGGBB.
color_firststrFarba zvýraznenia pre prvý dátový bod, ako hex RRGGBB.
color_laststrFarba zvýraznenia pre posledný dátový bod, ako hex RRGGBB.
color_highstrFarba zvýraznenia pre najvyšší dátový bod, ako hex RRGGBB.
color_lowstrFarba zvýraznenia pre najnižší dátový bod, ako hex RRGGBB.
sparklineslist[Sparkline]Zoznam jednotlivých sparkline v tejto skupine len na čítanie.
countintPočet sparklineov v tejto skupine (iba na čítanie).

ImageRenderOptions

add_sparkline 

group.add_sparkline(data_range: str, cell_reference: str) -> Sparkline

Pridá jednotlivý sparkline do tejto skupiny a vráti nový Sparkline objekt.

SparklineGroupCollection

SparklineGroupCollection sa pristupuje ako ws.sparkline_groups. Obsahuje všetky skupiny sparkline na pracovnom hárku.

ImageRenderOptions

add 

ws.sparkline_groups.add(
    sparkline_type=SparklineType.LINE,
    data_range=None,
    is_vertical=False,
    location_range=None
) -> SparklineGroup

Vytvorí novú skupinu a voliteľne ju naplní sparkline odvodenými z data_range (riadky alebo stĺpce v závislosti od is_vertical) umiestnených do buniek opísaných location_range. Vráti novú SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeVizualizáciu sparkline.
data_range`strNone`
is_verticalboolImageRenderOptions True, každý stĺpec v data_range napája jeden sparkline; keď False, každý riadok tak robí.
location_range`strNone`

add_group 

ws.sparkline_groups.add_group(sparkline_type=SparklineType.LINE) -> SparklineGroup

Vytvorí prázdnu skupinu daného typu. Sparkline je potrebné pridávať jednotlivo pomocou group.add_sparkline(...).

Vlastnosti a iterácia

ImageRenderOptionsImageRenderOptions
countPočet sparkline skupín na tomto pracovnom hárku (iba na čítanie).
__len__()ImageRenderOptions count.
__iter__()Iteruje cez všetky SparklineGroup objekty.
__getitem__(index)Vráti the SparklineGroup na nultom indexe index.

ImageRenderOptions

Nasledujúci príklad zapisuje mesačné údaje o tržbách pre tri regióny a pridáva čiarový sparkline pre každý riadok.

from aspose.cells_foss import Workbook, SparklineType, SparklineEmptyCells

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Trends"

# Write headers
months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
for col, m in enumerate(months):
    ws.cells[0][col + 1].put_value(m)

ws.cells["A1"].put_value("Region")
ws.cells["H1"].put_value("Trend")

# Write three rows of data
regions = [
    ("North", [12000, 14500, 13800, 16200, 15900, 17400]),
    ("South", [9800,  10200, 11500, 10900, 12300, 13100]),
    ("West",  [7500,   8100,  7900,  8800,  9200, 10500]),
]
for row_i, (name, values) in enumerate(regions, start=1):
    ws.cells[row_i][0].put_value(name)
    for col_i, v in enumerate(values):
        ws.cells[row_i][col_i + 1].put_value(v)

# Add a line sparkline group — one sparkline per data row
group = ws.sparkline_groups.add(
    sparkline_type=SparklineType.LINE,
    data_range="Trends!B2:G4",
    is_vertical=False,
    location_range="Trends!H2:H4",
)

# Customize colors
group.color_series = "4472C4"       # blue lines
group.color_high   = "70AD47"       # green for peak
group.color_low    = "FF0000"       # red for trough
group.display_empty_cells_as = SparklineEmptyCells.GAP

wb.save("sparklines.xlsx")

Pozri tiež

 Slovenčina