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, SparklineGroupSparklineType
SparklineType एक है IntEnum स्पार्कलाइन समूह के दृश्य रूप की पहचान करता है।.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
LINE | 0 | लाइन स्पार्कलाइन — डेटा को एक जुड़ी हुई रेखा के रूप में प्रस्तुत करता है।. |
COLUMN | 1 | कॉलम स्पार्कलाइन — डेटा को लंबवत बार के रूप में प्रस्तुत करता है।. |
WIN_LOSS | 2 | विन/लॉस स्पार्कलाइन — प्रत्येक मान को सकारात्मक या नकारात्मक ब्लॉक के रूप में दिखाया जाता है।. |
SparklineEmptyCells
SparklineEmptyCells एक है IntEnum स्पार्कलाइन के भीतर खाली कोशिकाओं को कैसे संभाला जाए, इसे नियंत्रित करता है।.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
ZERO | 0 | खाली कोशिकाओं को शून्य मानता है।. |
GAP | 1 | जहाँ कोशिकाएँ खाली हैं, वहाँ एक अंतराल छोड़ता है (रेखा टूट जाती है)।. |
CONNECTED | 2 | सन्निकट गैर-खाली मानों को जोड़ता है, अंतराल को छोड़ते हुए।. |
ImageRenderOptions
एक Sparkline एकल डेटा रेंज को एकल कोशिका स्थान से बाइंड करता है।.
ImageRenderOptions
Sparkline(data_range: str, cell_reference: str)| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
data_range | str | A1-style रेंज जिसमें sparkline source data शामिल है (उदाहरण के लिए,., "Sheet1!B2:G2"). |
cell_reference | str | स्पार्कलाइन जहाँ प्रदर्शित होती है, उसका A1-शैली सेल पता (उदाहरण के लिए,., "H2"). |
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
data_range | str | स्रोत डेटा रेंज।. |
cell_reference | str | प्रदर्शन सेल पता।. |
SparklineGroup
A SparklineGroup एक सेट स्पार्कलाइन के लिए साझा दृश्य सेटिंग्स (प्रकार, रंग, खाली-सेल हैंडलिंग) को परिभाषित करता है।. SparklineGroup ऑब्जेक्ट्स को सीधे निर्मित नहीं किया जाता — उपयोग करें ws.sparkline_groups.add(...) या ws.sparkline_groups.add_group(...).
ImageRenderOptions
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
type | SparklineType | स्पार्कलाइन फ़ॉर्म: LINE, COLUMN, या WIN_LOSS. |
display_empty_cells_as | SparklineEmptyCells | डेटा रेंज में खाली सेल्स को कैसे संभालें।. |
color_series | str | मुख्य स्पार्कलाइन लाइन/बार के लिए रंग, RRGGBB हेक्स के रूप में।. |
color_negative | str | नकारात्मक मान वाले बार (WIN_LOSS और COLUMN) के लिए रंग, RRGGBB हेक्स के रूप में।. |
color_axis | str | शून्य-अक्ष लाइन का रंग, RRGGBB हेक्स के रूप में।. |
color_markers | str | लाइन स्पार्कलाइन पर डेटा-पॉइंट मार्करों का रंग, RRGGBB हेक्स के रूप में।. |
color_first | str | पहले डेटा पॉइंट के लिए हाइलाइट रंग, RRGGBB हेक्स के रूप में।. |
color_last | str | अंतिम डेटा पॉइंट के लिए हाइलाइट रंग, RRGGBB हेक्स के रूप में।. |
color_high | str | सबसे उच्च डेटा बिंदु के लिए हाइलाइट रंग, RRGGBB हेक्स के रूप में।. |
color_low | str | न्यूनतम डेटा बिंदु के लिए हाइलाइट रंग, RRGGBB हेक्स के रूप में।. |
sparklines | list[Sparkline] | इस समूह में व्यक्तिगत स्पार्कलाइन की केवल‑पढ़ने योग्य सूची।. |
count | int | इस समूह में स्पार्कलाइन की संख्या (केवल‑पढ़ने योग्य)।. |
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.
| ImageRenderOptions | ImageRenderOptions | ImageRenderOptions |
|---|---|---|
sparkline_type | SparklineType | स्पार्कलाइन का दृश्य रूप।. |
data_range | `str | None` |
is_vertical | bool | ImageRenderOptions True, प्रत्येक स्तंभ में data_range एक स्पार्कलाइन को फीड करता है; जब False, प्रत्येक पंक्ति ऐसा करती है।. |
location_range | `str | None` |
add_group
ws.sparkline_groups.add_group(sparkline_type=SparklineType.LINE) -> SparklineGroupदिए गए प्रकार का एक खाली समूह बनाता है। स्पार्कलाइन्स को व्यक्तिगत रूप से के साथ जोड़ा जाना चाहिए group.add_sparkline(...).
गुणधर्म और पुनरावृत्ति
| ImageRenderOptions | ImageRenderOptions |
|---|---|
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")