ReportLabを使用すると、Pythonを使用してPDFに棒グラフを挿入することができます。
本記事では、ReportLabを使用した、PDFに棒グラフを挿入する方法について、詳しくご説明します。
ReportLabとは
ReportLabは、Pythonを使用してPDFを操作するための外部ライブラリの1つです。
PDF操作用ライブラリは他にも、PyPDF4やPDFMinerなどいくつか存在します。
それぞれのライブラリの用途は、以下の通りです。
ライブラリ | 用途 |
---|---|
ReportLab | ・PDFの新規作成 |
PDFMiner | ・テキストの抽出 |
PyPDF4 | ・画像の抽出 ・PDFファイルの結合や分割 ・しおり(目次)の追加 |
本記事では、ReportLabによる、PDFに棒グラフを挿入する方法をご紹介します。
ReportLabのインストール
「ReportLab」は、以下コマンドを入力することで、インストールすることができます。
コマンドの入力は、コマンドプロンプトあるいはターミナルから行います。
pip install reportlab
動作確認として、試しに以下を入力します。
from reportlab.pdfgen import canvas
上記を入力してもエラーが発生しなければ、正常にインストールされています。
PDFに棒グラフを挿入する
「reportlab.pdfgen」クラスのcanvas.Canvas()で用意したPDFに対して、「reportlab.graphics.charts.barcharts」クラスのVerticalBarChart()関数を使用することで、指定データを棒グラフとして描画することができます。
また「reportlab.graphics」クラスのrenderPDFを使用することで、PDFに挿入することができます。
上記関数を使用して、PDFに棒グラフを挿入してみます。
#input
from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import A5, portrait, landscape
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.cidfonts import UnicodeCIDFont
from reportlab.lib.units import mm
import os
from reportlab.lib import colors
from reportlab.graphics.shapes import Drawing
from reportlab.graphics.charts.barcharts import VerticalBarChart
from reportlab.graphics import renderPDF
# A5(横)の新規PDFファイルを作成
p = canvas.Canvas("sample.pdf", pagesize=landscape(A5))
# 棒グラフデータの指定
drawing = Drawing(50, 100)
data = [(30, 40, 20, 10, 40),
(10, 20, 25, 30, 35)
]
bc = VerticalBarChart()
bc.x = x = 15*mm
bc.y = y = 10*mm
bc.height = 110*mm
bc.width = 150*mm
bc.data = data
bc.strokeColor = colors.black
bc.valueAxis.valueMin = 0
bc.valueAxis.valueMax = 50
bc.valueAxis.valueStep = 5
bc.categoryAxis.labels.boxAnchor = 'ne'
bc.categoryAxis.labels.dx = 8
bc.categoryAxis.labels.dy = -2
bc.bars[0].fillColor = colors.blue
bc.bars[1].fillColor = colors.red
bc.categoryAxis.categoryNames = ['Jan','Feb','Mar','Apr','May']
drawing.add(bc)
# 棒グラフの挿入
renderPDF.draw(drawing, p, x, y, showBoundary=False)
# 保存
p.showPage()
p.save()
各データ2列の棒グラフを挿入しました。
棒グラフの塗りつぶしの色は、左側はbars[0].fillColorで、右側はbars[1].fillColorで指定しています。
グラフ背景の色は、fillColorで指定することができます。以下試してみます。
#input
from reportlab.pdfgen import canvas
from reportlab.lib.pagesizes import A5, portrait, landscape
from reportlab.pdfbase import pdfmetrics
from reportlab.pdfbase.cidfonts import UnicodeCIDFont
from reportlab.lib.units import mm
import os
from reportlab.lib import colors
from reportlab.graphics.shapes import Drawing
from reportlab.graphics.charts.barcharts import VerticalBarChart
from reportlab.graphics import renderPDF
# A5(横)の新規PDFファイルを作成
p = canvas.Canvas("sample.pdf", pagesize=landscape(A5))
# 棒グラフデータの指定
drawing = Drawing(50, 100)
data = [(30, 40, 20, 10, 40),
(10, 20, 25, 30, 35)
]
bc = VerticalBarChart()
bc.x = x = 15*mm
bc.y = y = 10*mm
bc.height = 110*mm
bc.width = 150*mm
bc.data = data
bc.strokeColor = colors.black
bc.valueAxis.valueMin = 0
bc.valueAxis.valueMax = 50
bc.valueAxis.valueStep = 5
bc.categoryAxis.labels.boxAnchor = 'ne'
bc.categoryAxis.labels.dx = 8
bc.categoryAxis.labels.dy = -2
bc.fillColor = colors.lightgrey
bc.bars[0].fillColor = colors.blue
bc.bars[1].fillColor = colors.red
bc.categoryAxis.categoryNames = ['Jan','Feb','Mar','Apr','May']
drawing.add(bc)
# 棒グラフの挿入
renderPDF.draw(drawing, p, x, y, showBoundary=False)
# 保存
p.showPage()
p.save()
グラフの背景をlightgrayに着色しました。
まとめ
この記事では、ReportLabを使用した、PDFに棒グラフを挿入する方法について、ご説明しました。
本記事を参考に、ぜひ試してみて下さい。
参考
Python学習用おすすめ教材
Pythonの基本を学びたい方向け
統計学基礎を学びたい方向け
Pythonの統計解析を学びたい方向け
おすすめプログラミングスクール
Pythonをはじめ、プログラミングを学ぶなら、TechAcademy(テックアカデミー)がおすすめです。
私も入っていますが、好きな時間に気軽にオンラインで学べますので、何より楽しいです。
現役エンジニアからマンツーマンで学べるので、一人では中々続かない人にも、向いていると思います。
無料体験ができますので、まずは試してみてください!