使用python-pptx库创建和定制PowerPoint图表完全指南-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00197/article/details/148758701

使用python-pptx库创建和定制PowerPoint图表完全指南

python-pptx Create Open XML PowerPoint documents in Python 项目地址: https://gitcode.com/gh_mirrors/py/python-pptx

概述

python-pptx是一个强大的Python库，用于创建和操作PowerPoint演示文稿。本文将重点介绍如何使用该库在PPT中添加和定制各种类型的图表。图表是数据可视化的重要工具，能够帮助观众快速理解复杂数据。

基础图表创建

创建柱状图

创建一个基本的柱状图需要以下几个步骤：

创建演示文稿和幻灯片
定义图表数据
添加图表到幻灯片
保存演示文稿

from pptx import Presentation
from pptx.chart.data import CategoryChartData
from pptx.enum.chart import XL_CHART_TYPE
from pptx.util import Inches

# 创建演示文稿和幻灯片
prs = Presentation()
slide = prs.slides.add_slide(prs.slide_layouts[5])

# 定义图表数据
chart_data = CategoryChartData()
chart_data.categories = ['东部', '西部', '中西部']
chart_data.add_series('系列1', (19.2, 21.4, 16.7))

# 添加图表到幻灯片
x, y, cx, cy = Inches(2), Inches(2), Inches(6), Inches(4.5)
slide.shapes.add_chart(
    XL_CHART_TYPE.COLUMN_CLUSTERED, x, y, cx, cy, chart_data
)

prs.save('chart-01.pptx')

多系列图表

在实际应用中，我们经常需要展示多个数据系列。创建多系列图表与单系列类似，只需添加更多数据系列：

chart_data = ChartData()
chart_data.categories = ['东部', '西部', '中西部']
chart_data.add_series('第一季度销售', (19.2, 21.4, 16.7))
chart_data.add_series('第二季度销售', (22.3, 28.6, 15.2))
chart_data.add_series('第三季度销售', (20.4, 26.3, 14.2))

graphic_frame = slide.shapes.add_chart(
    XL_CHART_TYPE.COLUMN_CLUSTERED, x, y, cx, cy, chart_data
)

chart = graphic_frame.chart

高级图表类型

XY散点图和气泡图

对于科学和工程数据，我们经常需要使用XY散点图或气泡图：

# XY散点图示例
chart_data = XyChartData()

series_1 = chart_data.add_series('模型1')
series_1.add_data_point(0.7, 2.7)
series_1.add_data_point(1.8, 3.2)
series_1.add_data_point(2.6, 0.8)

chart = slide.shapes.add_chart(
    XL_CHART_TYPE.XY_SCATTER, x, y, cx, cy, chart_data
).chart

# 气泡图示例
chart_data = BubbleChartData()

series_1 = chart_data.add_series('系列1')
series_1.add_data_point(0.7, 2.7, 10)  # x, y, 气泡大小
series_1.add_data_point(1.8, 3.2, 4)
series_1.add_data_point(2.6, 0.8, 8)

图表元素定制

坐标轴定制

我们可以精细控制图表的坐标轴显示：

from pptx.enum.chart import XL_TICK_MARK
from pptx.util import Pt

# 分类轴设置
category_axis = chart.category_axis
category_axis.has_major_gridlines = True  # 显示主要网格线
category_axis.minor_tick_mark = XL_TICK_MARK.OUTSIDE  # 次要刻度线位置
category_axis.tick_labels.font.italic = True  # 斜体标签
category_axis.tick_labels.font.size = Pt(24)  # 字体大小

# 数值轴设置
value_axis = chart.value_axis
value_axis.maximum_scale = 50.0  # 最大值
value_axis.minor_tick_mark = XL_TICK_MARK.OUTSIDE
value_axis.has_minor_gridlines = True  # 显示次要网格线
value_axis.tick_labels.number_format = '0"%"'  # 数字格式

数据标签

添加数据标签可以让图表更清晰：

from pptx.dml.color import RGBColor
from pptx.enum.chart import XL_LABEL_POSITION

plot = chart.plots[0]
plot.has_data_labels = True
data_labels = plot.data_labels

data_labels.font.size = Pt(13)  # 字体大小
data_labels.font.color.rgb = RGBColor(0x0A, 0x42, 0x80)  # 字体颜色
data_labels.position = XL_LABEL_POSITION.INSIDE_END  # 标签位置

图例设置

图例帮助识别不同数据系列：

from pptx.enum.chart import XL_LEGEND_POSITION

chart.has_legend = True
chart.legend.position = XL_LEGEND_POSITION.RIGHT  # 图例位置
chart.legend.include_in_layout = False  # 不计入布局空间

其他图表类型

折线图

折线图适合展示趋势变化：

chart_data = ChartData()
chart_data.categories = ['第一季度', '第二季度', '第三季度']
chart_data.add_series('西部', (32.2, 28.4, 34.7))
chart_data.add_series('东部', (24.3, 30.6, 20.2))

chart = slide.shapes.add_chart(
    XL_CHART_TYPE.LINE, x, y, cx, cy, chart_data
).chart

chart.series[0].smooth = True  # 平滑曲线

饼图

饼图展示部分与整体的关系：

chart_data = ChartData()
chart_data.categories = ['西部', '东部', '北部', '南部', '其他']
chart_data.add_series('系列1', (0.135, 0.324, 0.180, 0.235, 0.126))

chart = slide.shapes.add_chart(
    XL_CHART_TYPE.PIE, x, y, cx, cy, chart_data
).chart

chart.plots[0].has_data_labels = True
data_labels = chart.plots[0].data_labels
data_labels.number_format = '0%'  # 百分比格式
data_labels.position = XL_LABEL_POSITION.OUTSIDE_END  # 标签位置