Sparkline

Sparkline — Aspose.Cells FOSS for Python API Reference

स्पार्कलाइन छोटे चार्ट होते हैं जो व्यक्तिगत कोशिकाओं में एम्बेड किए जाते हैं, Excel 2010 में प्रस्तुत किए गए। aspose-cells-foss स्पार्कलाइन को through के माध्यम से प्रबंधित करता है 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खाली कोशिकाओं को शून्य मानता है।.
GAP1जहाँ कोशिकाएँ खाली हैं, वहाँ एक अंतराल छोड़ता है (रेखा टूट जाती है)।.
CONNECTED2सन्निकट गैर-खाली मानों को जोड़ता है, अंतराल को छोड़ते हुए।.

ImageRenderOptions

एक Sparkline एकल डेटा रेंज को एकल कोशिका स्थान से बाइंड करता है।.

ImageRenderOptions

Sparkline(data_range: str, cell_reference: str)
ImageRenderOptionsImageRenderOptionsImageRenderOptions
data_rangestrA1-style रेंज जिसमें sparkline source data शामिल है (उदाहरण के लिए,., "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 हेक्स के रूप में।.
color_negativestrनकारात्मक मान वाले बार (WIN_LOSS और COLUMN) के लिए रंग, RRGGBB हेक्स के रूप में।.
color_axisstrशून्य-अक्ष लाइन का रंग, RRGGBB हेक्स के रूप में।.
color_markersstrलाइन स्पार्कलाइन पर डेटा-पॉइंट मार्करों का रंग, RRGGBB हेक्स के रूप में।.
color_firststrपहले डेटा पॉइंट के लिए हाइलाइट रंग, RRGGBB हेक्स के रूप में।.
color_laststrअंतिम डेटा पॉइंट के लिए हाइलाइट रंग, RRGGBB हेक्स के रूप में।.
color_highstrसबसे उच्च डेटा बिंदु के लिए हाइलाइट रंग, RRGGBB हेक्स के रूप में।.
color_lowstrन्यूनतम डेटा बिंदु के लिए हाइलाइट रंग, RRGGBB हेक्स के रूप में।.
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 शून्य‑आधारित पर index.

ImageRenderOptions

निम्न उदाहरण तीन क्षेत्रों के लिए मासिक राजस्व डेटा लिखता है और प्रत्येक पंक्ति के लिए एक लाइन sparkline जोड़ता है।.

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

संबंधित देखें

 हिन्दी