Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklineovi su minijaturni grafikoni ugrađeni u pojedinačne ćelije, uvedeni u Excelu 2010. aspose-cells-foss upravlja sparklineovima putem SparklineGroup i SparklineGroupCollection (ws.sparkline_groups). Svaka grupa sadrži jedan ili više Sparkline objekata koji dijele iste postavke vrste i boje.

: aspose.cells_foss

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

SparklineType

SparklineType je IntEnum koji identificira vizualni oblik sparkline grupe.


`LINE`	0	Linijski sparkline — prikazuje podatke kao povezanu liniju.
`COLUMN`	1	Stupčasti sparkline — prikazuje podatke kao okomite trake.
`WIN_LOSS`	2	Win/loss sparkline — svaka vrijednost prikazana je kao pozitivni ili negativni blok.

SparklineEmptyCells

SparklineEmptyCells je IntEnum koji kontrolira kako se prazne ćelije obrađuju unutar sparklinea.


`ZERO`	0	Tretira prazne ćelije kao nulu.
`GAP`	1	Ostavlja prazninu gdje su ćelije prazne (linija je prekinuta).
`CONNECTED`	2	Povezuje susjedne ne-prazne vrijednosti, preskačući prazninu.

Jedan Sparkline veže jedan raspon podataka na jedno mjesto ćelije.

Sparkline(data_range: str, cell_reference: str)


`data_range`	`str`	A1‑stil raspon koji sadrži izvorne podatke za sparkline (npr., `"Sheet1!B2:G2"`).
`cell_reference`	`str`	A1‑stil adresa ćelije gdje je sparkline prikazan (npr., `"H2"`).


`data_range`	`str`	Raspon izvornih podataka.
`cell_reference`	`str`	Adresa ćelije za prikaz.

SparklineGroup

A SparklineGroup definira zajedničke vizualne postavke (vrstu, boje, rukovanje praznim ćelijama) za skup sparklineova. SparklineGroup objekti se ne konstruiraju izravno — koristite ws.sparkline_groups.add(...) ili ws.sparkline_groups.add_group(...).


`type`	`SparklineType`	Sparkline oblik: `LINE`, `COLUMN`, ili `WIN_LOSS`.
`display_empty_cells_as`	`SparklineEmptyCells`	Kako rukovati praznim ćelijama u rasponu podataka.
`color_series`	`str`	Boja glavne linije/barova sparklinea, u RRGGBB heks formatu.
`color_negative`	`str`	Boja barova s negativnim vrijednostima (WIN_LOSS i COLUMN), u RRGGBB heks formatu.
`color_axis`	`str`	Boja linije nulte osi, u RRGGBB heks formatu.
`color_markers`	`str`	Boja oznaka podataka na linijskim sparklineovima, u RRGGBB heks formatu.
`color_first`	`str`	Boja isticanja za prvi podatak, u RRGGBB heks formatu.
`color_last`	`str`	Boja isticanja za posljednji podatak, u RRGGBB heks formatu.
`color_high`	`str`	Boja isticanja za najviši podatak, u RRGGBB heks formatu.
`color_low`	`str`	Boja isticanja za najniži podatak, u RRGGBB heks formatu.
`sparklines`	`list[Sparkline]`	Popis pojedinačnih sparklineova u ovoj grupi, samo za čitanje.
`count`	`int`	Broj sparklineova u ovoj grupi (samo za čitanje).

add_sparkline

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

Dodaje pojedinačni sparkline u ovu grupu i vraća novi Sparkline objekt.

SparklineGroupCollection

SparklineGroupCollection se pristupa kao ws.sparkline_groups. Sadrži sve skupine sparklineova na radnom listu.

add

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

Stvara novu grupu i po želji je popunjava sparklineovima izvedenim iz data_range (redovi ili stupci ovisno o is_vertical) smještenim u ćelije opisane s location_range. Vraća novi SparklineGroup.


`sparkline_type`	`SparklineType`	Vizualni oblik sparklineova.
`data_range`	`str	None`
`is_vertical`	`bool`	`True`, svaki stupac u `data_range` opskrbljuje jedan sparkline; kada `False`, svaki red to čini.
`location_range`	`str	None`

add_group

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

Stvara praznu grupu zadane vrste. Sparklineove je potrebno dodavati pojedinačno pomoću group.add_sparkline(...).

Svojstva i iteracija


`count`	Broj sparkline grupa na ovom radnom listu (samo za čitanje).
`__len__()`	`count`.
`__iter__()`	Iterira kroz sve `SparklineGroup` objekte.
`__getitem__(index)`	Vraća `SparklineGroup` na nultom `index`.

Sljedeći primjer zapisuje mjesečne prihode za tri regije i dodaje linijski sparkline za svaki red.

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