Aspose.Cells FOSS
Python
Vodič za programere
Rad sa grafikonima

Rad sa grafikonima

Pregled

Aspose.Cells FOSS koristi API po metodi za svaki tip grafikona. Umesto generičkog
add(ChartType.X, ...) poziva, svaki tip grafikona ima svoju posvećenu metodu u
kolekciji charts radnog lista:

MethodChart type
ws.charts.add_bar(top_row, left_col, bottom_row, right_col)Grupisani stubac (traka grafikon)
ws.charts.add_line(top_row, left_col, bottom_row, right_col)Linija
ws.charts.add_pie(top_row, left_col, bottom_row, right_col)Kolač
ws.charts.add_area(top_row, left_col, bottom_row, right_col)Oblast

Sva četiri položajna parametra opisuju pravougaono područje u listu gde će grafikon biti umetnut. Indeksi redova i kolona su zero-based. Svaka metoda vraća Chart objekat koji dalje konfigurišete pre nego što ga sačuvate.

Ограничење: Само типови графика LINE, BAR, PIE, AREA и STOCK могу се сачувати у XLSX. Позив wb.save() са радном књигом која садржи било који други тип графика (нпр., SCATTER, WATERFALL, RADAR, TREEMAP, HISTOGRAM) ће изазвати NotImplementedError.

Dodavanje stubičastog grafikona

Primer ispod zapisuje mali skup podataka o prihodu po proizvodu i zatim dodaje stubičasti grafikon postavljen ispod podataka.

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

##--- Data ---
ws.cells["A1"].value = "Product"
ws.cells["B1"].value = "Revenue"

products = ["Widget A", "Widget B", "Widget C", "Widget D", "Widget E"]
revenues = [12_500, 18_200, 9_800, 21_400, 15_600]

for i, (product, revenue) in enumerate(zip(products, revenues), start=2):
    ws.cells[f"A{i}"].value = product
    ws.cells[f"B{i}"].value = revenue

##--- Chart (rows 7–22, columns A–H, all zero-based) ---
##top_row=6, left_col=0, bottom_row=22, right_col=7
chart = ws.charts.add_bar(6, 0, 22, 7)

chart.title = "Revenue by Product"
chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue (USD)")
chart.show_legend = True
chart.legend_position = "bottom"

workbook.save("column_chart.xlsx")
print("Saved column_chart.xlsx")

Podaci zauzimaju redove 1–6 (redovi bazirani na nuli 0–5), pa top_row=6 postavlja grafikon odmah ispod, bez preklapanja podataka.

Dodavanje linijskog grafikona

Linijski grafikoni dobro funkcionišu za prikazivanje trendova tokom vremena. Potpis poziva je identičan add_bar — samo se menja naziv metode.

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

##--- Monthly trend data ---
ws.cells["A1"].value = "Month"
ws.cells["B1"].value = "Page Views"
ws.cells["C1"].value = "Conversions"

months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
page_views   = [4_200, 5_100, 4_800, 6_300, 7_100, 6_800]
conversions  = [  210,   255,   230,   340,   390,   360]

for i, (month, pv, cv) in enumerate(zip(months, page_views, conversions), start=2):
    ws.cells[f"A{i}"].value = month
    ws.cells[f"B{i}"].value = pv
    ws.cells[f"C{i}"].value = cv

##--- Line chart below the data ---
chart = ws.charts.add_line(8, 0, 24, 8)

chart.title = "Monthly Website Metrics"
chart.n_series.add("B2:B7", category_data="A2:A7", name="Page Views")
chart.n_series.add("C2:C7", category_data="A2:A7", name="Conversions")
chart.show_legend = True
chart.legend_position = "bottom"

workbook.save("line_chart.xlsx")
print("Saved line_chart.xlsx")

Naslov grafikona i legenda

Postavite naslov grafikona dodeljivanjem običnog stringa direktno u chart.title. Svojstvo prihvata str — ne pokušavajte da pristupite pod‑svojstvu kao što je .title.text, koje ne postoji u ovoj biblioteci.

##Correct
chart.title = "Quarterly Sales"

##Wrong — raises AttributeError
##chart.title.text = "Quarterly Sales"

Vidljivost i položaj legende kontrolisani su pomoću dva svojstva:

chart.show_legend = True          # display the legend
chart.legend_position = "bottom"  # "bottom", "top", "left", "right"

Da biste sakrili legendu u potpunosti, postavite chart.show_legend = False. Vrednost legend_position se ignoriše kada je legenda sakrivena.

Konfiguracija serije podataka

Koristite chart.n_series.add() da prikačite opsege podataka na grafikon. Prosledite sve argumente kao keyword arguments da izbegnete zabunu zbog redosleda pozicioniranja:

chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue")

Možete dodati više serija u jedan grafikon pozivanjem n_series.add više puta. Svaki poziv dodaje novu seriju:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

##Headers
ws.cells["A1"].value = "Quarter"
ws.cells["B1"].value = "North"
ws.cells["C1"].value = "South"
ws.cells["D1"].value = "East"

data = [
    ("Q1", 8_400, 6_100, 7_200),
    ("Q2", 9_200, 7_400, 8_100),
    ("Q3", 10_500, 8_900, 9_600),
    ("Q4", 11_800, 9_300, 10_200),
]

for i, row in enumerate(data, start=2):
    ws.cells[f"A{i}"].value = row[0]
    ws.cells[f"B{i}"].value = row[1]
    ws.cells[f"C{i}"].value = row[2]
    ws.cells[f"D{i}"].value = row[3]

chart = ws.charts.add_bar(6, 0, 22, 8)
chart.title = "Regional Sales by Quarter"

chart.n_series.add("B2:B5", category_data="A2:A5", name="North")
chart.n_series.add("C2:C5", category_data="A2:A5", name="South")
chart.n_series.add("D2:D5", category_data="A2:A5", name="East")

chart.show_legend = True
chart.legend_position = "bottom"

workbook.save("multi_series_chart.xlsx")
print("Saved multi_series_chart.xlsx")

Podaci o kategoriji

Oznake kategorija mogu se postaviti na nivou grafikona ili na nivou pojedinačne serije.

Chart-level category data se primenjuje na sve serije po podrazumevanju:

chart.category_data = "A2:A5"

Podaci o kategoriji na nivou serije (preko ključnog argumenta category_data za n_series.add) prepisuju postavku na nivou grafikona za tu konkretnu seriju:

chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")

Kada sve serije dele isti opseg kategorija, postavljanje chart.category_data jednom je konciznije. Kada serije imaju različite opsege kategorija — na primer, dva skupa podataka s različitim vremenskim periodima — koristite argument ključne reči po seriji.

Pozicioniranje grafikona

Četiri pozicijska parametra svakog add_* metoda definišu ograničavajući pravougaonik u listu, izmerene u indeksima redova i kolona koji počinju od nule:

add_bar(top_row, left_col, bottom_row, right_col)
ParametarZnačenje
top_rowIndeks koji počinje od nule prvog reda koji zauzima grafikon
left_colIndeks koji počinje od nule najlevije kolone
bottom_rowIndeks koji počinje od nule poslednjeg reda koji zauzima grafikon
right_colIndeks koji počinje od nule najdesnije kolone

Uobičajen obrazac je da se grafikon postavi direktno ispod podataka. Ako se vaši podaci završavaju u Excel redu 6 (indeks reda nula‑baziran je 5), započnite grafikon na top_row=6:

from aspose.cells_foss import Workbook, Cell

workbook = Workbook()
ws = workbook.worksheets[0]

##Data in rows 1–5 (zero-based 0–4)
labels = ["Alpha", "Beta", "Gamma", "Delta", "Epsilon"]
values = [30, 45, 28, 60, 52]

ws.cells["A1"].value = "Category"
ws.cells["B1"].value = "Score"

for i, (label, val) in enumerate(zip(labels, values), start=2):
    ws.cells[f"A{i}"].value = label
    ws.cells[f"B{i}"].value = val

##Data ends at zero-based row 5 (Excel row 6).
##Place chart from row 6 to row 22, columns A–H (0–7).
chart = ws.charts.add_bar(6, 0, 22, 7)
chart.title = "Category Scores"
chart.n_series.add("B2:B6", category_data="A2:A6", name="Score")
chart.show_legend = False

workbook.save("positioned_chart.xlsx")
print("Saved positioned_chart.xlsx")

Napravite grafikon dovoljno visokim da bude čitljiv: visina od najmanje 15 redova
(bottom_row - top_row >= 15) i širina od najmanje 6 kolona je razumna
početna tačka.

Уобичајене грешке

WrongRightWhy
ws.charts.add(ChartType.COLUMN, ...)ws.charts.add_bar(...)Не позивајте ws.charts.add(ChartType.X, ...) директно за неподржане типове — то ће изазвати NotImplementedError за 11 од 16 типова графика. Уместо тога користите add_bar(), add_line(), add_pie(), add_area() или add_stock().
chart.title.text = "My Chart"chart.title = "My Chart"chart.title је обична стринг својина, а не објекат са под‑својином .text.
chart.n_series.add("B2:B5", "A2:A5", "Revenue")chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")Други и трећи параметар морају бити прослеђени као кључни аргументи да би се избегла двосмисленост.
chart = ws.charts.add_bar(0, 0, 15, 7) (overlaps data)Place top_row below last data rowПоставите top_row испод последњег реда података. График који прекрива податке сакрива вредности и изазива збуњене распореде.
chart.legend_position = "bottom" without chart.show_legend = TrueSet chart.show_legend = True firstlegend_position нема ефекта када је show_legend False.

Vidi takođe

 Српски