Cells
Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

스파크라인은 개별 셀에 삽입된 소형 차트로, Excel 2010에서 도입되었습니다. aspose-cells-foss는 스파크라인을 통해 관리합니다 SparklineGroup 및 SparklineGroupCollection (ws.sparkline_groups). 각 그룹은 하나 이상의 Sparkline 동일한 유형 및 색상 설정을 공유하는 개체들.

ImageRenderOptions: aspose.cells_foss

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

SparklineType

SparklineType 은(는) IntEnum 스파크라인 그룹의 시각적 형태를 식별합니다.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
LINE0라인 스파크라인 — 데이터를 연결된 선으로 표시합니다.
COLUMN1컬럼 스파크라인 — 데이터를 수직 막대로 표시합니다.
WIN_LOSS2승/패 스파크라인 — 각 값이 양수 또는 음수 블록으로 표시됩니다.

SparklineEmptyCells

SparklineEmptyCells 은(는) IntEnum 스파크라인 내에서 빈 셀을 처리하는 방식을 제어합니다.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
ZERO0빈 셀을 0으로 처리합니다.
GAP1셀에 값이 없을 경우 공백을 남깁니다(선이 끊깁니다).
CONNECTED2인접한 비어 있지 않은 값을 연결하고, 공백을 건너뜁니다.

ImageRenderOptions

A Sparkline 단일 데이터 범위를 단일 셀 위치에 바인딩합니다.

ImageRenderOptions 

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestr스파크라인 원본 데이터를 포함하는 A1 스타일 범위 (예:., "Sheet1!B2:G2").
cell_referencestr스파크라인이 표시되는 A1 스타일 셀 주소 (예:., "H2").

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestr원본 데이터 범위.
cell_referencestr표시 셀 주소.

SparklineGroup

A SparklineGroup 스파크라인 집합에 대한 공유 시각 설정(유형, 색상, 빈 셀 처리)을 정의합니다. SparklineGroup 객체는 직접 생성되지 않습니다 — 사용하세요 ws.sparkline_groups.add(...) 또는 ws.sparkline_groups.add_group(...).

ImageRenderOptions

ImageRenderOptionsImageRenderOptionsImageRenderOptions
typeSparklineType스파크라인 형식: LINE, COLUMN, 또는 WIN_LOSS.
display_empty_cells_asSparklineEmptyCells데이터 범위에서 빈 셀을 처리하는 방법.
color_seriesstr주 스파크라인 선/막대의 색상, RRGGBB 16진수 형식.
color_negativestr음수 값 막대(WIN_LOSS 및 COLUMN)의 색상, RRGGBB 16진수 형식.
color_axisstr제로 축 선의 색상, RRGGBB 16진수 형식.
color_markersstr라인 스파크라인의 데이터 포인트 마커 색상, RRGGBB 16진수 형식.
color_firststr첫 번째 데이터 포인트의 강조 색상, RRGGBB 16진수 형식.
color_laststr마지막 데이터 포인트의 강조 색상, RRGGBB 16진수 형식.
color_highstr가장 높은 데이터 포인트의 강조 색상, RRGGBB 16진수 형식.
color_lowstr가장 낮은 데이터 포인트의 강조 색상, RRGGBB 16진수 형식.
sparklineslist[Sparkline]이 그룹의 개별 스파크라인에 대한 읽기 전용 목록.
countint이 그룹의 스파크라인 수 (읽기 전용).

ImageRenderOptions

add_sparkline 

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

이 그룹에 개별 스파크라인을 추가하고 새 Sparkline 객체를 반환합니다.

SparklineGroupCollection

SparklineGroupCollection 은(는) 다음과 같이 접근합니다. ws.sparkline_groups. 워크시트에 있는 모든 스파크라인 그룹을 포함합니다.

ImageRenderOptions

추가 

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

새 그룹을 만들고 선택적으로 스파크라인을 다음에서 파생된 데이터로 채웁니다. data_range (행 또는 열에 따라 is_vertical) 설명된 셀에 배치됩니다. location_range. 새 SparklineGroup.

ImageRenderOptionsImageRenderOptionsImageRenderOptions
sparkline_typeSparklineType스파크라인의 시각적 형태.
data_range`strNone`
is_verticalboolImageRenderOptions True, 각 열은 data_range 하나의 스파크라인에 공급합니다; 언제 False, 각 행도 마찬가지입니다.
location_range`strNone`

add_group 

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

주어진 유형의 빈 그룹을 생성합니다. 스파크라인은 개별적으로 다음을 사용하여 추가해야 합니다. group.add_sparkline(...).

속성 및 반복

ImageRenderOptionsImageRenderOptions
count이 워크시트의 스파크라인 그룹 수(읽기 전용).
__len__()ImageRenderOptions count.
__iter__()모든 항목을 반복합니다. SparklineGroup 객체.
__getitem__(index)반환합니다. SparklineGroup 0 기반에서 index.

ImageRenderOptions

다음 예제는 세 지역에 대한 월별 매출 데이터를 작성하고 각 행에 라인 스파크라인을 추가합니다.

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

참고

 한국어