Warum die Programmierung von Diagrammen?
Automatische Berichterstattungspipeline benötigen oft in Excel-Arbeitsmappen eingebettete Diagramme, wie beispielsweise vierteljährliche Zusammenfassungen, ML-Ergebnisdashboards oder betriebliche Metriken. Das ohne Microsoft Excel bedeutet keine Lizenzkosten und keine GUI-Interaktion.
Aspose.Cells FOSS for Python bietet eine saubere, pythonische Chart-API: eine Methode pro Diagrammtyp, ein einfaches String für den Titel und eine Keyword-Argument-basierte Serienkonfiguration. Die gesamte API wird unten behandelt.
Installieren
pip install aspose-cells-foss
Importieren Sie die benötigten Klassen:
from aspose.cells_foss import Workbook, Cell
Die Diagramme sind über die Internetseite des ws.charts; kein separater Import von Diagrammmodulen erforderlich.
Die Chart-API auf einen Blick
| Was du willst . | Wie soll man das machen ? |
|---|---|
| Ein Spaltendiagramm hinzufügen | ws.charts.add_bar(top_row, left_col, bottom_row, right_col) |
| Hinzufügen einer Zeichentyp-Tabelle | ws.charts.add_line(top_row, left_col, bottom_row, right_col) |
| Hinzufügen eines Balkendiagramms | ws.charts.add_bar(top_row, left_col, bottom_row, right_col) |
| Ein Kuchendiagramm hinzufügen | ws.charts.add_pie(top_row, left_col, bottom_row, right_col) |
| Titel einstellen | chart.title = "My Chart" (einfache Schnur; nicht .title.text) |
| Kategorie der x-Achse festlegen | chart.category_data = "A2:A6" |
| Einen benannten Serien hinzufügen | chart.n_series.add("B2:B6", category_data="A2:A6", name="Revenue") |
| Show-Legende | chart.show_legend = True |
| Legendeposition einstellen | chart.legend_position = "bottom" |
Alle Zeilen- und Spaltenindizes sind: auf Nullbasis.Die . add_* Die Methoden geben die Chart Objekt direkt (nicht ein Index).
Spaltendiagramm: Schritt für Schritte
Erstellen wir ein Spaltendiagramm, das Quartals-Einnahmen und -Ausgaben zeigt.
Schritt 1: Erstellen der Arbeitsmappe und Datenschreiben
from aspose.cells_foss import Workbook, Cell
wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Q1-Q4 Report"
##Headers
ws.cells["A1"].value = "Quarter"
ws.cells["B1"].value = "Revenue"
ws.cells["C1"].value = "Expenses"
##Data
quarters = ["Q1", "Q2", "Q3", "Q4"]
revenue = [50000, 62000, 71000, 89000]
expenses = [32000, 38000, 41000, 47000]
for i, (q, r, e) in enumerate(zip(quarters, revenue, expenses), start=2):
ws.cells[f"A{i}"].value = q
ws.cells[f"B{i}"].value = r
ws.cells[f"C{i}"].value = e
Schritt 2: Hinzufügen der Tabelle
Die Grafik unter den Daten (Reihe 7 und weiter, Spalten 0-8):
chart = ws.charts.add_bar(6, 0, 22, 8)
Schritt 3: Titel und Legende konfigurieren
chart.title = "Quarterly Revenue vs Expenses"
chart.show_legend = True
chart.legend_position = "bottom"
Schritt 4: Hinzufügen von Datenreihen
Jede Reihe benötigt einen Wertbereich, eine Kategorie und einen Namen:
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")
chart.n_series.add("C2:C5", category_data="A2:A5", name="Expenses")
Schritt 5: Speichern
wb.save("quarterly_report.xlsx")
print("Chart saved to quarterly_report.xlsx")
Vollständige Beispiele in einem Block:
from aspose.cells_foss import Workbook, Cell
wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Q1-Q4 Report"
##Data
ws.cells["A1"].value = "Quarter"
ws.cells["B1"].value = "Revenue"
ws.cells["C1"].value = "Expenses"
data = [("Q1", 50000, 32000), ("Q2", 62000, 38000),
("Q3", 71000, 41000), ("Q4", 89000, 47000)]
for i, (q, r, e) in enumerate(data, start=2):
ws.cells[f"A{i}"].value = q
ws.cells[f"B{i}"].value = r
ws.cells[f"C{i}"].value = e
chart = ws.charts.add_bar(6, 0, 22, 8)
chart.title = "Quarterly Revenue vs Expenses"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue")
chart.n_series.add("C2:C5", category_data="A2:A5", name="Expenses")
chart.show_legend = True
chart.legend_position = "bottom"
wb.save("quarterly_report.xlsx")
Liniendiagramm: Monatlicher Trend
Das gleiche Muster funktioniert für add_line():
from aspose.cells_foss import Workbook, Cell
wb = Workbook()
ws = wb.worksheets[0]
months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
actuals = [42000, 47500, 53000, 49000, 61000, 68000]
targets = [45000, 45000, 50000, 55000, 60000, 65000]
ws.cells["A1"].value = "Month"
ws.cells["B1"].value = "Actual"
ws.cells["C1"].value = "Target"
for i, (m, a, t) in enumerate(zip(months, actuals, targets), start=2):
ws.cells[f"A{i}"].value = m
ws.cells[f"B{i}"].value = a
ws.cells[f"C{i}"].value = t
chart = ws.charts.add_line(8, 0, 24, 8)
chart.title = "Monthly Revenue: Actual vs Target"
chart.category_data = "A2:A7"
chart.n_series.add("B2:B7", category_data="A2:A7", name="Actual")
chart.n_series.add("C2:C7", category_data="A2:A7", name="Target")
chart.show_legend = True
chart.legend_position = "right"
wb.save("monthly_trend.xlsx")
Marktanteil: Die Ergebnisse der ersten beiden Quellen sind in diesem Zusammenhang zu ermitteln.
from aspose.cells_foss import Workbook, Cell
wb = Workbook()
ws = wb.worksheets[0]
segments = ["Product A", "Product B", "Product C", "Product D"]
shares = [40, 25, 20, 15]
ws.cells["A1"].value = "Segment"
ws.cells["B1"].value = "Share %"
for i, (s, v) in enumerate(zip(segments, shares), start=2):
ws.cells[f"A{i}"].value = s
ws.cells[f"B{i}"].value = v
chart = ws.charts.add_pie(6, 0, 20, 7)
chart.title = "Market Share by Product"
chart.category_data = "A2:A5"
chart.n_series.add("B2:B5", category_data="A2:A5", name="Share")
chart.show_legend = True
chart.legend_position = "right"
wb.save("market_share.xlsx")
Häufige Fehler, die vermieden werden sollten
| Falsch . | - Ja . |
|---|---|
ws.charts.add(ChartType.COLUMN, 5, 0, 15, 5) | ws.charts.add_bar(5, 0, 15, 5) |
chart.title.text = "Revenue" | chart.title = "Revenue" |
chart.n_series.add("B2:B5", True) (Positionsberechtigte) | chart.n_series.add("B2:B5", category_data="A2:A5", name="Revenue") |
from aspose.cells.charts import ChartType | Nicht erforderlich; Verwendung ws.charts.add_bar() direkt |
chart.n_series.category_data = "A2:A5" | chart.category_data = "A2:A5" (Karteebene) |
Mittel und Ressourcen
- Aspose.Cells FOSS for Python: Installation
- Entwicklerhandbuch: Arbeiten mit Diagrammen
- API-Referenz: ChartCollection, Diagramm und NSerien
- Wissensbasis: Wie man Charts in Python erstellt
- Übersicht über das Produkt: Zusammenfassung der Merkmale und Fähigkeiten
- Blog: Einführung von Aspose.Cells FOSS: Übersicht über die Bibliothek und schneller Start
- GitHub-Repository (Github-Speicher)