Cells
Python
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

Los sparklines son gráficos en miniatura incrustados en celdas individuales, introducidos en Excel 2010. aspose-cells-foss gestiona los sparklines a través de SparklineGroup y SparklineGroupCollection (ws.sparkline_groups). Cada grupo contiene uno o más Sparkline objetos que comparten el mismo tipo y configuración de color.

Examples: aspose.cells_foss

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

SparklineType

SparklineType es un IntEnum que identifica la forma visual de un grupo de sparkline.

ExamplesExamplesExamples
LINE0Sparkline de línea — representa los datos como una línea conectada.
COLUMN1Sparkline de columna — representa los datos como barras verticales.
WIN_LOSS2Sparkline de victorias/derrotas — cada valor se muestra como un bloque positivo o negativo.

SparklineEmptyCells

SparklineEmptyCells es un IntEnum controla cómo se manejan las celdas vacías dentro de una sparkline.

ExamplesExamplesExamples
ZERO0Trata las celdas vacías como cero.
GAP1Deja un espacio donde las celdas están vacías (la línea se rompe).
CONNECTED2Conecta valores adyacentes no vacíos, omitiendo el espacio.

Examples

Un Sparkline vincula un rango de datos único a una ubicación de celda única.

Examples 

Sparkline(data_range: str, cell_reference: str)
ExamplesExamplesExamples
data_rangestrRango con estilo A1 que contiene los datos de origen de la sparkline (p. ej., "Sheet1!B2:G2").
cell_referencestrDirección de celda con estilo A1 donde se muestra la sparkline (p. ej., "H2").

Examples

ExamplesExamplesExamples
data_rangestrRango de datos de origen.
cell_referencestrDirección de celda de visualización.

SparklineGroup

A SparklineGroup define la configuración visual compartida (tipo, colores, manejo de celdas vacías) para un conjunto de sparklines. SparklineGroup los objetos no se construyen directamente — use ws.sparkline_groups.add(...) o ws.sparkline_groups.add_group(...).

Examples

ExamplesExamplesExamples
typeSparklineTypeFormato de sparkline: LINE, COLUMN, o WIN_LOSS.
display_empty_cells_asSparklineEmptyCellsCómo manejar celdas vacías en el rango de datos.
color_seriesstrColor para la línea/barras principal del sparkline, como hex RRGGBB.
color_negativestrColor para las barras de valores negativos (WIN_LOSS y COLUMN), como hex RRGGBB.
color_axisstrColor de la línea del eje cero, como hex RRGGBB.
color_markersstrColor de los marcadores de puntos de datos en sparklines de línea, como hex RRGGBB.
color_firststrColor de resaltado para el primer punto de datos, como hex RRGGBB.
color_laststrColor de resaltado para el último punto de datos, como hex RRGGBB.
color_highstrColor de resaltado para el punto de datos más alto, como hex RRGGBB.
color_lowstrColor de resaltado para el punto de datos más bajo, como hex RRGGBB.
sparklineslist[Sparkline]Lista de solo lectura de sparklines individuales en este grupo.
countintNúmero de sparklines en este grupo (solo lectura).

Examples

add_sparkline 

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

Agrega un sparkline individual a este grupo y devuelve el nuevo Sparkline objeto.

SparklineGroupCollection

SparklineGroupCollection se accede como ws.sparkline_groups. Contiene todos los grupos de sparkline en una hoja de cálculo.

Examples

agregar 

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

Crea un nuevo grupo y, opcionalmente, lo rellena con sparklines derivados de data_range (filas o columnas según is_vertical) colocados en celdas descritas por location_range. Devuelve el nuevo SparklineGroup.

ExamplesExamplesExamples
sparkline_typeSparklineTypeFormato visual de los sparklines.
data_range`strNone`
is_verticalboolExamples True, cada columna en data_range alimenta una sparkline; cuando False, cada fila lo hace.
location_range`strNone`

add_group 

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

Crea un grupo vacío del tipo especificado. Las sparklines deben añadirse individualmente con group.add_sparkline(...).

Propiedades e Iteración

ExamplesExamples
countNúmero de grupos de sparklines en esta hoja de cálculo (solo lectura).
__len__()Examples count.
__iter__()Itera sobre todos SparklineGroup objetos.
__getitem__(index)Devuelve el SparklineGroup en base cero index.

Examples

El siguiente ejemplo escribe datos de ingresos mensuales para tres regiones y agrega un sparkline de línea para cada fila.

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

Ver también

 Español