Chart — Aspose.Cells FOSS for Python API Reference

aspose-cells-foss prend en charge l’intégration de graphiques dans les feuilles de calcul. Les graphiques sont gérés via ws.charts, un ChartCollection attaché à chaque Worksheet. Les données de série sont ajoutées via chart.n_series, un NSeries collection.

ColladaSaveOptions: aspose.cells_foss

from aspose.cells_foss import ChartType

ChartType

ChartType est un IntEnum qui identifie le type de graphique.

ColladaSaveOptions

Chart les objets ne sont pas construits directement. Utilisez ws.charts.add(...) ou les méthodes de commodité typées (add_bar(), add_line(), add_pie(), add_area()).

ColladaSaveOptions

ChartCollection

ChartCollection est accessible comme ws.charts. Il contient tous les graphiques intégrés dans une feuille de calcul.

ColladaSaveOptions

add

ws.charts.add(
    chart_type: ChartType,
    upper_left_row: int,
    upper_left_column: int,
    lower_right_row: int,
    lower_right_column: int
) -> Chart

Ajoute un graphique du type spécifié. Tous les arguments de position sont des indices de ligne/colonne à partir de 0.

add_bar

ws.charts.add_bar(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

Raccourci pour add(ChartType.BAR, ...).

add_line

ws.charts.add_line(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

Raccourci pour add(ChartType.LINE, ...).

add_pie

ws.charts.add_pie(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

Raccourci pour add(ChartType.PIE, ...).

add_area

ws.charts.add_area(upper_left_row, upper_left_column, lower_right_row, lower_right_column) -> Chart

Raccourci pour add(ChartType.AREA, ...).

Propriétés et itération

NSeries

NSeries est accessible via chart.n_series. Il gère les séries de données appartenant à un graphique.

ColladaSaveOptions

add

chart.n_series.add(
    area: str,
    is_vertical: bool = False,
    category_data: str | None = None,
    name: str | None = None,
    chart_type: ChartType | None = None
) -> ChartSeries

Ajoute une série de données. area est une chaîne de plage telle que "Sheet1!B1:B5". Définir is_vertical=True lorsque les données sont organisées en colonnes. chart_type remplace le type de graphique parent pour cette série (utilisé dans les graphiques combinés).

Propriétés et itération

ChartSeries

ChartSeries représente une série de données unique dans un graphique. Obtenue via chart.n_series[index].

ColladaSaveOptions

ColladaSaveOptions

add_error_bars

series.add_error_bars(
    direction='y',
    bar_type='both',
    val_type='fixedVal',
    val=1.0,
    no_end_cap=False
) -> ChartErrorBars

Ajoute des barres d’erreur à cette série et renvoie le ChartErrorBars objet.

ChartAxis

ChartAxis est accessible via chart.axes[index].

ColladaSaveOptions

ChartView3D

ChartView3D est accessible via chart.view_3d. S’applique uniquement lorsque chart.is_3d est True.

ColladaSaveOptions

ChartErrorBars

ChartErrorBars est accessible via series.error_bars.Créer avec series.add_error_bars(...).

ColladaSaveOptions

ColladaSaveOptions

L’exemple suivant écrit des données de revenu mensuel, crée un graphique à barres groupées avec un titre et deux séries de données, puis enregistre le classeur.

from aspose.cells_foss import Workbook, ChartType

wb = Workbook()
ws = wb.worksheets[0]
ws.name = "Revenue"

# Write headers and data
headers = ["Month", "Product A", "Product B"]
data = [
    ["Jan", 12000, 9500],
    ["Feb", 14500, 11000],
    ["Mar", 13200, 12800],
    ["Apr", 15800, 14100],
]
for col, h in enumerate(headers):
    ws.cells[0][col].put_value(h)
for row, row_data in enumerate(data, start=1):
    for col, val in enumerate(row_data):
        ws.cells[row][col].put_value(val)

# Add a bar chart covering rows 6-20, columns 0-6
chart = ws.charts.add_bar(6, 0, 20, 6)
chart.title = "Monthly Revenue by Product"
chart.bar_direction = "col"   # vertical (column chart)
chart.grouping = "clustered"

# Series: Product A and Product B
chart.n_series.add("Revenue!B2:B5", is_vertical=True, category_data="Revenue!A2:A5", name="Product A")
chart.n_series.add("Revenue!C2:C5", is_vertical=True, category_data="Revenue!A2:A5", name="Product B")

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

wb.save("revenue_chart.xlsx")

Voir aussi

• Cells Python Référence API accueil
• Référence de la classe Workbook
• Référence de la classe Worksheet
• Premiers pas
• Guide du développeur