Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Sparklines ovat pienikokoisia kaavioita, jotka upotetaan yksittäisiin soluihin, ja ne esiteltiin Excelissä 2010. aspose-cells-foss hallinnoi sparklinesia kautta SparklineGroup ja SparklineGroupCollection (ws.sparkline_groups). Jokainen ryhmä sisältää yhden tai useamman Sparkline objektia, jotka jakavat saman tyyppi- ja väriasetuksen.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType on IntEnum joka tunnistaa sparkline-ryhmän visuaalisen muodon.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0Line sparkline — esittää tiedot yhtenäisenä viivana.
COLUMN1Column sparkline — esittää tiedot pystypalkkeina.
WIN_LOSS2Win/loss sparkline — jokainen arvo näytetään positiivisena tai negatiivisena lohkona.

SparklineEmptyCells

SparklineEmptyCells on IntEnum joka ohjaa, miten tyhjät solut käsitellään sparklineissa.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0Käsittelee tyhjät solut nollina.
GAP1Jättää aukon, kun solut ovat tyhjiä (viiva katkeaa).
CONNECTED2Yhdistää vierekkäiset ei-tyhjät arvot, ohittaen aukon.

ImageRenderOptions

A Sparkline sitoo yhden data-alueen yhteen solun sijaintiin.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrA1-tyylinen alue, joka sisältää sparkline-lähdetiedot (esim., "Sheet1!B2:G2").
cell_referencestrA1-tyylinen solun osoite, jossa sparkline näytetään (esim., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrLähdetietojen alue.
cell_referencestrNäyttösolun osoite.

SparklineGroup

A SparklineGroup määrittelee jaetut visuaaliset asetukset (tyyppi, värit, tyhjien solujen käsittely) joukolle sparklines. SparklineGroup objekteja ei rakenneta suoraan — käytä ws.sparkline_groups.add(...) tai ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineTypeSparkline-lomake: LINE, COLUMN, tai WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsMiten käsitellä tyhjiä soluja tietojoukossa.
color_seriesstrVäri pää‑sparkline‑viivalle/pylväille, RRGGBB‑heksana.
color_negativestrVäri negatiivisten arvojen pylväille (WIN_LOSS ja COLUMN), RRGGBB‑heksana.
color_axisstrNollakaaren viivan väri, RRGGBB‑heksana.
color_markersstrDatapisteiden merkintöjen väri viiva‑sparklinesissa, RRGGBB‑heksana.
color_firststrKorostusväri ensimmäiselle datapisteelle, RRGGBB‑heksana.
color_laststrKorostusväri viimeiselle datapisteelle, RRGGBB‑heksana.
color_highstrKorostusväri korkeimmalle datapisteelle, RRGGBB‑heksana.
color_lowstrKorostusväri alimmalle datapisteelle, RRGGBB‑heksana.
sparklineslist[Sparkline]Vain luku -lista ryhmän yksittäisistä sparklinesista.
countintRyhmässä olevien sparklinesien määrä (vain luku).

ImageRenderOptions

add_sparkline 

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

Lisää yksittäisen sparkline-kaavion tähän ryhmään ja palauttaa uuden Sparkline objektin.

SparklineGroupCollection

SparklineGroupCollection kutsutaan ws.sparkline_groups. Se sisältää kaikki sparkline-ryhmät laskentataulukossa.

ImageRenderOptions

lisää 

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

Luo uuden ryhmän ja valinnaisesti täyttää sen sparkeineilla, jotka on johdettu data_range (rivit tai sarakkeet riippuen is_vertical) sijoitettu soluihin, jotka on kuvattu location_range. Palauttaa uuden SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineTypeVisuaalisen muodon sparkeineista.
data_range`strNone`
is_verticalboolImageRenderOptions True, jokainen sarake kohteessa data_range syöttää yhden sparkline‑kuvakkeen; kun False, jokainen rivi tekee niin.
location_range`strNone`

add_group 

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

Luo tyhjän ryhmän annettua tyyppiä. Sparkeineja on lisättävä yksitellen käyttäen group.add_sparkline(...).

Ominaisuudet ja iteraatio

ImageRenderOptionsImageRenderOptions
countSparkline-ryhmien määrä tässä laskentataulukossa (vain luku).
__len__()ImageRenderOptions count.
__iter__()Iteroi kaikkien SparklineGroup objektien.
__getitem__(index)Palauttaa SparklineGroup nollapohjaisessa index.

ImageRenderOptions

Seuraava esimerkki kirjoittaa kuukausittaiset liikevaihtotiedot kolmelle alueelle ja lisää viivasparkline‑objektin jokaiselle riville.

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

Katso myös

 Suomi