FOSS (Fosul)
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines sunt grafice miniaturale încorporate în celule individuale, introduse în Excel 2010. aspose-cells-foss gestionează sparklines prin SparklineGroup și SparklineGroupCollection (ws.sparkline_groups). Fiecare grup conține unul sau mai multe Sparkline obiecte care împărtășesc aceleași setări de tip și culoare.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType este un IntEnum care identifică forma vizuală a unui grup de sparklines.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Sparkline de tip Linie — redă datele ca o linie conectată.
COLUMN1Sparkline de tip Coloană — redă datele ca bare verticale.
WIN_LOSS2Sparkline de tip Câștig/Pierdere — fiecare valoare este afișată ca un bloc pozitiv sau negativ.

SparklineEmptyCells

SparklineEmptyCells este un IntEnum care controlează modul în care celulele goale sunt gestionate într-un sparkline.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Tratează celulele goale ca zero.
GAP1Lasă un gol acolo unde celulele sunt goale (linia este întreruptă).
CONNECTED2Conectează valorile ne-goale adiacente, sărind peste gol.

ImageRenderOptions

A Sparkline leagă un singur interval de date de o singură locație de celulă.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrInterval în stil A1 care conține datele sursă ale sparkline-ului (de ex., "Sheet1!B2:G2").
cell_referencestrAdresă de celulă în stil A1 unde este afișat sparkline-ul (de ex., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrInterval de date sursă.
cell_referencestrAdresă de celulă pentru afișare.

SparklineGroup

A SparklineGroup definește setările vizuale partajate (tip, culori, gestionarea celulelor goale) pentru un set de sparkline-uri. SparklineGroup obiectele nu sunt construite direct — folosiți ws.sparkline_groups.add(...) sau ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeFormă Sparkline: LINE, COLUMN, sau WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsCum să gestionați celulele goale din intervalul de date.
color_seriesstrCuloarea pentru linia/barele principale ale sparkline-ului, ca hex RRGGBB.
color_negativestrCuloarea pentru barele cu valori negative (WIN_LOSS și COLUMN), ca hex RRGGBB.
color_axisstrCuloarea liniei axei zero, ca hex RRGGBB.
color_markersstrCuloarea marker-elor punctelor de date pe sparkline-urile de tip linie, ca hex RRGGBB.
color_firststrCuloarea de evidențiere pentru primul punct de date, ca hex RRGGBB.
color_laststrCuloarea de evidențiere pentru ultimul punct de date, ca hex RRGGBB.
color_highstrCuloarea de evidențiere pentru cel mai înalt punct de date, ca hex RRGGBB.
color_lowstrCuloarea de evidențiere pentru cel mai mic punct de date, ca hex RRGGBB.
sparklineslist[Sparkline]Listă numai în citire a sparkline-urilor individuale din acest grup.
countintNumărul de sparkline-uri din acest grup (numai în citire).

ImageRenderOptions

add_sparkline 

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

Adaugă un sparkline individual în acest grup și returnează noul Sparkline obiect.

SparklineGroupCollection

SparklineGroupCollection se accesează ca ws.sparkline_groups. Conține toate grupurile de sparkline-uri dintr-o foaie de calcul.

ImageRenderOptions

add 

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

Creează un grup nou și, opțional, îl populează cu sparkline-uri derivate din data_range (rânduri sau coloane în funcție de is_vertical) plasate în celulele descrise de location_range. Returnează noul SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeForma vizuală a sparkline-urilor.
data_range`strNone`
is_verticalboolImageRenderOptions True, fiecare coloană în data_range alimentează un sparkline; când False, fiecare rând face.
location_range`strNone`

add_group 

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

Creează un grup gol de tipul specificat. Sparkline-urile trebuie adăugate individual cu group.add_sparkline(...).

Proprietăți și iterare

ImageRenderOptionsImageRenderOptions
countNumărul de grupuri de sparkline pe această foaie de lucru (doar citire).
__len__()ImageRenderOptions count.
__iter__()Iterează peste toate SparklineGroup obiectele.
__getitem__(index)Returnează SparklineGroup la bază zero index.

ImageRenderOptions

Exemplul următor scrie datele de venit lunar pentru trei regiuni și adaugă un sparkline de tip linie pentru fiecare rând.

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

Vezi și

 Română