Pythonでチャートシリーズを管理する

概要

このドキュメントでは、Aspose.Slides for Python における ChartSeries の役割について説明し、プレゼンテーション内でデータがどのように構造化・可視化されるかに焦点を当てます。これらのオブジェクトは、チャート内の個々のデータポイント、カテゴリ、および外観パラメータを定義する基礎要素を提供します。ChartSeries を使用することで、開発者は基になるデータソースをシームレスに統合し、情報の表示方法を完全に制御でき、インサイトや分析を明確に伝える動的でデータ駆動型のプレゼンテーションを実現できます。

シリーズは、チャートにプロットされる数値の行または列です。

チャートシリーズ PowerPoint

シリーズのオーバーラップ設定

ChartSeries.overlap プロパティは、2D チャート内の棒や列の重なり具合を -100 から 100 の範囲で指定して制御します。このプロパティは個々のチャートシリーズではなくシリーズグループに関連付けられているため、シリーズレベルでは読み取り専用です。オーバーラップ値を設定するには、parent_series_group.overlap の読み書き可能なプロパティを使用し、指定したオーバーラップをそのグループ内のすべてのシリーズに適用します。

以下は、プレゼンテーションを作成し、クラスター化列チャートを追加し、最初のチャートシリーズにアクセスしてオーバーラップ設定を構成し、結果を PPTX ファイルとして保存する Python の例です。

import aspose.slides as slides
import aspose.slides.charts as charts

series_overlap = 30

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # デフォルトデータでクラスター化列チャートを追加します。
    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    series = chart.chart_data.series[0]
    if series.overlap == 0:
        # シリーズのオーバーラップを設定します。
        series.parent_series_group.overlap = series_overlap

    # プレゼンテーションファイルをディスクに保存します。
    presentation.save("series_overlap.pptx", slides.export.SaveFormat.PPTX)

結果:

シリーズのオーバーラップ

シリーズの塗りつぶし色の変更

Aspose.Slides を使用すると、チャートシリーズの塗りつぶし色を簡単にカスタマイズでき、特定のデータポイントを強調したり、視覚的に魅力的なチャートを作成したりできます。これは、さまざまな塗りつぶしタイプ、カラー設定、その他高度なスタイリングオプションをサポートする Format オブジェクトを介して実現します。スライドにチャートを追加し、目的のシリーズにアクセスしたら、シリーズを取得して適切な塗りつぶし色を適用するだけです。単色塗りつぶしに加えて、グラデーションやパターン塗りつぶしも活用でき、デザインの柔軟性が向上します。要件に合わせて色を設定したら、プレゼンテーションを保存して外観を確定します。

以下の Python コード例は、最初のシリーズの色を変更する方法を示しています。

import aspose.slides as slides
import aspose.slides.charts as charts
import aspose.pydrawing as draw

series_color = draw.Color.blue

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # デフォルトデータでクラスター化列チャートを追加します。
    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    # 最初のシリーズの色を設定します。
    series = chart.chart_data.series[0]
    series.format.fill.fill_type = slides.FillType.SOLID
    series.format.fill.solid_fill_color.color = series_color

    # プレゼンテーションファイルをディスクに保存します。
    presentation.save("series_color.pptx", slides.export.SaveFormat.PPTX)

結果:

シリーズの色

シリーズの名前変更

Aspose.Slides は、チャートシリーズの名前を簡単に変更できる機能を提供し、データに対して明確かつ意味のあるラベル付けを容易にします。チャートデータ内の該当ワークシートのセルにアクセスすることで、開発者はデータの提示方法をカスタマイズできます。この変更は、シリーズ名をデータのコンテキストに基づいて更新または明確化する必要がある場合に特に有用です。シリーズの名前を変更した後、プレゼンテーションを保存して変更を永続化できます。

以下は、このプロセスを実際に示す Python コードスニペットです。

import aspose.slides as slides
import aspose.slides.charts as charts

series_name = "New name"

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # デフォルトデータでクラスター化列チャートを追加します。
    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)
    
    # 最初のシリーズの名前を設定します。
    series_cell = chart.chart_data.chart_data_workbook.get_cell(0, 0, 1)
    series_cell.value = series_name
    
    # プレゼンテーションファイルをディスクに保存します。
    presentation.save("series_name.pptx", slides.export.SaveFormat.PPTX)

別の方法でシリーズ名を変更する Python コードは次のとおりです。

import aspose.slides as slides
import aspose.slides.charts as charts

series_name = "New name"

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # デフォルトデータでクラスター化列チャートを追加します。
    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)
    series = chart.chart_data.series[0]
    
    # 最初のシリーズの名前を設定します。
    series.name.as_cells[0].value = series_name

    # プレゼンテーションファイルをディスクに保存します。
    presentation.save("series_name.pptx", slides.export.SaveFormat.PPTX)

結果:

シリーズ名

自動シリーズ塗りつぶしカラーの取得

Aspose.Slides for Python を使用すると、プロット領域内のチャートシリーズの自動塗りつぶしカラーを取得できます。Presentation クラスのインスタンスを作成した後、インデックスで目的のスライドへの参照を取得し、好みのタイプ（たとえば ChartType.CLUSTERED_COLUMN）でチャートを追加します。チャート内のシリーズにアクセスすれば、自動塗りつぶしカラーを取得できます。

以下の Python コードは、このプロセスを詳細に示しています。

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    # デフォルトデータでクラスター化列チャートを追加します。
    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    for i in range(len(chart.chart_data.series)):
        # シリーズの塗りつぶし色を取得します。
        color = chart.chart_data.series[i].get_automatic_series_color()
        print(f"Series {i} color: {color.name}")

サンプル出力:

Series 0 color: ff4f81bd
Series 1 color: ffc0504d
Series 2 color: ff9bbb59

シリーズの反転塗りつぶしカラー設定

シリーズに正と負の両方の値が含まれる場合、すべての列や棒を同じ色で塗るとチャートが読みづらくなります。Aspose.Slides for Python では、負の値に対して自動的に適用される別個の塗りつぶし（反転塗りつぶしカラー）を割り当てることができ、負の値が一目で際立ちます。このセクションでは、そのオプションを有効にし、適切なカラーを選択し、更新されたプレゼンテーションを保存する方法を学びます。

以下のコード例は操作を示しています。

import aspose.slides as slides
import aspose.slides.charts as charts
import aspose.pydrawing as draw

invert_color = draw.Color.red

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)
    workBook = chart.chart_data.chart_data_workbook

    chart.chart_data.series.clear()
    chart.chart_data.categories.clear()

    # 新しいカテゴリを追加します。
    chart.chart_data.categories.add(workBook.get_cell(0, 1, 0, "Category 1"))
    chart.chart_data.categories.add(workBook.get_cell(0, 2, 0, "Category 2"))
    chart.chart_data.categories.add(workBook.get_cell(0, 3, 0, "Category 3"))

    # 新しいシリーズを追加します。
    series = chart.chart_data.series.add(workBook.get_cell(0, 0, 1, "Series 1"), chart.type)

    # シリーズのデータを設定します。
    series.data_points.add_data_point_for_bar_series(workBook.get_cell(0, 1, 1, -20))
    series.data_points.add_data_point_for_bar_series(workBook.get_cell(0, 2, 1, 50))
    series.data_points.add_data_point_for_bar_series(workBook.get_cell(0, 3, 1, -30))

    # シリーズの色設定を行います。
    series_color = series.get_automatic_series_color()
    series.invert_if_negative = True
    series.format.fill.fill_type = slides.FillType.SOLID
    series.format.fill.solid_fill_color.color = series_color
    series.inverted_solid_fill_color.color = invert_color
    presentation.save("inverted_solid_fill_color.pptx", slides.export.SaveFormat.PPTX)

結果:

反転した単色塗りつぶしカラー

単一のデータポイントだけに反転塗りつぶしカラーを適用することもできます。目的の ChartDataPoint にアクセスし、その invert_if_negative プロパティを True に設定してください。

この操作を示すコード例は次のとおりです。

import aspose.slides as slides
import aspose.slides.charts as charts
import aspose.pydrawing as draw

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

	chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200, True)
	chart.chart_data.series.clear()

	series = series.add(chart.chart_data.chart_data_workbook.get_cell(0, "B1"), chart.type)

	series.data_points.add_data_point_for_bar_series(chart.chart_data.chart_data_workbook.get_cell(0, "B2", -5))
	series.data_points.add_data_point_for_bar_series(chart.chart_data.chart_data_workbook.get_cell(0, "B3", 3))
	series.data_points.add_data_point_for_bar_series(chart.chart_data.chart_data_workbook.get_cell(0, "B4", -3))
	series.data_points.add_data_point_for_bar_series(chart.chart_data.chart_data_workbook.get_cell(0, "B5", 1))

	series.invert_if_negative = False
	series.data_points[2].invert_if_negative = True

	presentation.save("data_point_invert_color_if_negative.pptx", slides.export.SaveFormat.PPTX)

特定データポイントのデータクリア

チャートにテスト値、外れ値、または古いエントリが含まれていて、シリーズ全体を再構築せずに削除したい場合があります。Aspose.Slides for Python を使用すると、インデックスで任意のデータポイントを指定し、その内容をクリアし、残りのポイントが自動的にシフトして軸が再スケールされるようにすぐにプロットを更新できます。

以下のコード例が操作を示しています。

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation("test_chart.pptx") as presentation:
    slide = presentation.slides[0]
    chart = slide.shapes[0]
    series = chart.chart_data.series[0]

    for data_point in series.data_points:
        data_point.x_value.as_cell.value = None
        data_point.y_value.as_cell.value = None

    series.data_points.clear()

    presentation.save("clear_data_points.pptx", slides.export.SaveFormat.PPTX)

シリーズのギャップ幅設定

ギャップ幅は隣接する列や棒の間の空白量を制御します。ギャップが広いと個々のカテゴリが強調され、狭いと密集したコンパクトな外観になります。Aspose.Slides for Python を使用すると、シリーズ全体のこのパラメータを微調整でき、基になるデータを変更せずにプレゼンテーションに必要な視覚的バランスを実現できます。

以下のコード例は、シリーズのギャップ幅を設定する方法を示しています。

import aspose.slides as slides
import aspose.slides.charts as charts

gap_width = 30

# 空のプレゼンテーションを作成します。
with slides.Presentation() as presentation:

    # 最初のスライドにアクセスします。
    slide = presentation.slides[0]

    # デフォルトデータでチャートを追加します。
    chart = slide.shapes.add_chart(charts.ChartType.STACKED_COLUMN, 20, 20, 500, 200)

    # プレゼンテーションをディスクに保存します。
    presentation.save("default_gap_width.pptx", slides.export.SaveFormat.PPTX)

    # gap_width の値を設定します。
    series = chart.chart_data.series[0]
    series.parent_series_group.gap_width = gap_width

    # プレゼンテーションをディスクに保存します。
    presentation.save("gap_width_30.pptx", slides.export.SaveFormat.PPTX)

結果:

ギャップ幅

FAQ

1つのチャートに含められるシリーズの数に上限はありますか？

Aspose.Slides にはシリーズ数の固定上限はありません。実際の上限はチャートの可読性とアプリケーションで利用可能なメモリによって決まります。

クラスター内の列が互いに近すぎる、または遠すぎる場合はどうすればよいですか？

そのシリーズ（または親シリーズグループ）の gap_width 設定を調整してください。値を大きくすると列間のスペースが広がり、値を小さくすると列が近づきます。