create-charts-in-word-documents-using-python

チャートは情報を明確かつ簡潔に伝えるための強力なツールです。レポートの生成には、データを視覚的に表示することがよくあります。Wordドキュメントにチャートを組み込むことで、データの表示と理解が大幅に向上します。Microsoft Wordには組み込みのチャート機能がありますが、Aspose.Words for Pythonは、Wordドキュメント内でチャートを生成および統合するためのプログラム制御を提供します。このブログ記事では、Pythonを使用してWordドキュメントにチャートを作成する方法を学びます。

この記事では、以下のトピックをカバーします:

Wordドキュメントにチャートを作成するためのPython API

Wordドキュメントにさまざまな種類のチャートを作成するためにAspose.Words for Pythonを使用します。これは、プログラムでWordドキュメントを作成、操作、変換する強力なライブラリです。Wordドキュメント内でチャートを作成およびカスタマイズするための堅牢なAPIを提供し、動的なデータ視覚化をドキュメント生成ワークフローに統合する必要がある開発者にとって優れたツールです。これは、レポートや動的なデータ視覚化を含むドキュメントを生成する必要がある開発者に特に役立ちます。

チャートを作成する前に、開発環境をセットアップする必要があります。必要なパッケージをインストールする手順に従ってください:

1. Aspose.Words for Pythonをインストール

ダウンロードからパッケージをダウンロードするか、以下のpipコマンドをコンソールで実行してPyPIからインストールしてください:

pip install aspose-words

2. 必要なライブラリをインポート

import aspose.words as aw

from aspose.words import Document, DocumentBuilder, SaveFormat
from aspose.words.drawing import Shape
from aspose.words.drawing.charts import ChartType

Wordにカラムチャートを作成する方法

カラムチャートは、カテゴリ間のデータポイントを比較するのに理想的です。以下の手順に従って、Wordドキュメントにカラムチャートを簡単に作成できます:

  1. Documentクラスのインスタンスを作成します。
  2. DocumentBuilderクラスを使用してドキュメントを作成します。
  3. **insert_chart()**メソッドを使用して、COLUMN ChartType、height、および_width_を引数としてチャートを追加します。
  4. 結果をShapeクラスオブジェクトに取得します。
  5. Chartクラスのインスタンスを作成します。
  6. chart.seriesを使用してチャートシリーズコレクションを取得します。
  7. その後、データを定義し、**add()**メソッドを使用してチャートシリーズを追加します。
  8. 最後に、**save()**メソッドを呼び出してファイルを保存します。

以下のコードサンプルは、Pythonを使用してWordドキュメントにカラムチャートを作成する方法を示しています。

# This code example demonstrates how to create a columns chart in a Word document using Python.
# Create a document
doc = Document()
builder = DocumentBuilder(doc)
# Add chart with default data. You can specify different chart types and sizes.
shape = builder.insert_chart(ChartType.COLUMN, 432, 252)
# Chart property of Shape contains all chart related options.
chart = shape.chart
# Get chart series collection.
series_coll = chart.series
# Check series count.
print(series_coll.count)
# Delete default generated series.
series_coll.clear()
# Create category names array, in this example we have two categories.
categories = ["AW Category 1", "AW Category 2"]
# Adding new series. Please note, data arrays must not be empty and arrays must be the same size.
series_coll.add("AW Series 1", categories, [1, 2])
series_coll.add("AW Series 2", categories, [3, 4])
series_coll.add("AW Series 3", categories, [5, 6])
series_coll.add("AW Series 4", categories, [7, 8])
series_coll.add("AW Series 5", categories, [9, 10])
# Save the document
doc.save("ColumnsChart.docx")
Create Column Charts in Word Documents using Python.

Create Column Charts in Word Documents using Python

Pythonを使用してWordドキュメントに散布図を作成する

散布図は、2つの変数間の関係を示すのに役立ちます。上記の手順に従うことで、Wordドキュメントに散布図を挿入できます。ただし、insert_chart()メソッドでChartType.SCATTERを設定する必要があります。

以下のコードサンプルは、Pythonを使用してWordドキュメントに散布図を作成する方法を示しています。

# This code example demonstrates how to create a scatter chart in a Word document using Python.
# Create a new document
doc = Document();
builder = DocumentBuilder(doc);
# Insert Scatter chart.
shape = builder.insert_chart(ChartType.SCATTER, 432, 252);
chart = shape.chart;
# Use this overload to add series to any type of Scatter charts.
chart.series.add_double("Aspose Series 1", [ 0.7, 1.8, 2.6 ], [ 2.7, 3.2, 0.8 ])
# Save the document
doc.save("ScatterChart.docx");
Create Scatter Charts in Word Documents using Python.

Create Scatter Charts in Word Documents using Python

Pythonを使用してWordドキュメントにエリアチャートを挿入する

エリアチャートは、時間の経過に伴う変化の大きさを強調します。上記の手順に従うことで、Wordドキュメントにエリアチャートを簡単に作成できます。ただし、insert_chart()メソッドでChartType.AREAを設定する必要があります。

以下のコードサンプルは、Pythonを使用してWordドキュメントにエリアチャートを作成する方法を示しています。

# This code example demonstrates how to create a area chart in a Word document using Python.
# Create a new document
doc = Document();
builder = DocumentBuilder(doc);
# Insert Area chart.
shape = builder.insert_chart(ChartType.AREA, 432, 252);
chart = shape.chart;
# Use this overload to add series to any type of Area, Radar and Stock charts.
chart.series.add_date("Aspose Series 1",
[ date(2002, 5, 1), date(2002, 6, 1), date(2002, 7, 1), date(2002, 8, 1), date(2002, 9, 1) ],
[ 32, 32, 28, 12, 15 ])
# Save the document
doc.save("AreaChart.docx");
Insert Area Charts in Word Documents using Python.

Insert Area Charts in Word Documents using Python

Pythonを使用してWordドキュメントにバブルチャートを挿入する

バブルチャートは、3次元のデータを表示するのに効果的です。上記の手順に従うことで、Wordドキュメントにバブルチャートを簡単

に作成できます。ただし、insert_chart()メソッドでChartType.BUBBLEを設定する必要があります。

以下のコードサンプルは、Pythonを使用してWordドキュメントにバブルチャートを作成する方法を示しています。

# This code example demonstrates how to create a bubble chart in a Word document using Python.
# Create a new document
doc = Document()
builder = DocumentBuilder(doc)
# Insert Bubble chart.
shape = builder.insert_chart(ChartType.BUBBLE, 432, 252)
# Add series
chart = shape.chart
chart.series.add("Aspose Series 1", [ 0.7, 1.8, 2.6 ], [ 2.7, 3.2, 0.8 ], [ 10, 4, 8 ])
# Save the document
doc.save("BubbleChart.docx")
Insert Bubble Charts in Word Documents using Python.

Insert Bubble Charts in Word Documents using Python

無料ライセンスを取得する

Aspose.Words for Pythonの全機能を活用しましょう!今すぐ無料の一時ライセンスを入手してください。制限なしで、あなたの指先で純粋なドキュメント操作の魔法を体験してください。

Wordドキュメントのチャート – 有用なリソース

Wordドキュメントでのチャート操作に加えて、以下のリソースを使用してAspose.Words for Pythonのさまざまな機能をさらにカスタマイズできます:

結論

この記事では、Pythonを使用してWordドキュメントにカラム、散布図、エリア、バブルチャートなどさまざまなタイプのチャートを作成する手順をカバーしました。Aspose.Words for Pythonを使用してWordドキュメントでさまざまな種類のチャートを作成する方法を示しました。この記事で概説した手順に従うことで、Wordドキュメントに視覚的に魅力的なチャートをシームレスに統合し、データ分析とプレゼンテーションを効果的に行うことができます。

何か不明点がある場合は、無料サポートフォーラムでお気軽にお問い合わせください。

関連リンク