查看: 99|回复: 3

Python Spire.XLS给Excel图表加数据标签和误差线

[复制链接]
发表于 半小时前 | 显示全部楼层 |阅读模式
Excel图表用于表达趋势时,读者往往还需要两类信息:每个数据点具体是多少,以及该数值的波动范围有多大。数据标签把数值直接标在图形旁边,误差线用短线表示不确定性。两者不改变图表的数据结构,只是把“看图估计”变成“看图读数”。在Excel界面中,这两项功能分别位于“添加数据标签”和“误差线”菜单;当图表由Python脚本生成时,同样可以通过代码设置。本文围绕Spire.XLS for Python,演示为图表系列设置数据标签、为单个数据点自定义标签文字,以及添加百分比和标准差误差线。

环境准备:安装Spire.XLS并引入模块。
  1. pip install Spire.XLS
  2. from spire.xls import *
  3. from spire.xls.common import *
复制代码

先创建基础图表。数据标签和误差线都挂在系列上,因此图表和数据源需要先建立。下面的代码准备“计划”和“实际”的月度数据,生成簇状柱形图,并把图表放在数据区下方,避免遮挡。
  1. from spire.xls import *
  2. from spire.xls.common import *
  3. workbook = Workbook()
  4. workbook.CreateEmptySheets(1)
  5. sheet = workbook.Worksheets[0]
  6. months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
  7. planned = [3.3, 2.5, 2.0, 3.7, 4.5, 4.0]
  8. actual = [3.8, 3.2, 1.7, 3.5, 4.5, 4.3]
  9. sheet.Range["A1"].Value = "Month"
  10. sheet.Range["B1"].Value = "Planned"
  11. sheet.Range["C1"].Value = "Actual"
  12. for i in range(len(months)):
  13.     sheet.Range[i + 2, 1].Value = months[i]
  14.     sheet.Range[i + 2, 2].NumberValue = planned[i]
  15.     sheet.Range[i + 2, 3].NumberValue = actual[i]
  16. chart = sheet.Charts.Add(ExcelChartType.ColumnClustered)
  17. chart.DataRange = sheet.Range["B1:C7"]
  18. chart.SeriesDataFromRange = False
  19. chart.ChartTitle = "Monthly Results"
  20. for series in chart.Series:
  21.     series.CategoryLabels = sheet.Range["A2:A7"]
  22. # Place the chart below the data
  23. chart.TopRow = 10
  24. chart.BottomRow = 28
  25. chart.LeftColumn = 1
  26. chart.RightColumn = 10
  27. workbook.SaveToFile("AnnotatedChart.xlsx", ExcelVersion.Version2013)
  28. workbook.Dispose()
复制代码

这里的关键点包括:DataRange指定数据区域,SeriesDataFromRange设为False,CategoryLabels把分类轴绑定到月份列;TopRow、BottomRow、LeftColumn、RightColumn用行号和列号确定图表位置与大小。

显示数值标签时,数据标签设置在系列的DataPoints.DefaultDataPoint.DataLabels上。DefaultDataPoint表示该系列所有数据点的默认标签,修改一次即可作用于整个系列。
  1. from spire.xls import *
  2. from spire.xls.common import *
  3. workbook = Workbook()
  4. workbook.LoadFromFile("AnnotatedChart.xlsx")
  5. sheet = workbook.Worksheets[0]
  6. chart = sheet.Charts[0]
  7. # Show the value on every data point
  8. for series in chart.Series:
  9.     labels = series.DataPoints.DefaultDataPoint.DataLabels
  10.     labels.HasValue = True
  11.     labels.HasLegendKey = False
  12.     labels.Position = DataLabelPositionType.Outside
  13.     labels.Size = 9
  14. workbook.SaveToFile("DataLabels.xlsx", ExcelVersion.Version2013)
  15. workbook.Dispose()
复制代码

几个属性需要区分:HasValue控制是否显示数值,是数据标签最基础的内容;HasLegendKey控制是否附带图例符号,报表中通常设为False,避免标签里出现多余的小色块;Position指定标签位置,柱形图常用Outside,折线图可用Above;Size是标签字号,默认字号在密集图表中容易挤在一起。

除了数值,标签还可以组合系列名和分类名,三者之间的分隔符由Delimiter指定。下面的示例把标签做成“系列. 月份. 数值”的形式,并统一为红色加粗小字。
  1. from spire.xls import *
  2. from spire.xls.common import *
  3. workbook = Workbook()
  4. workbook.LoadFromFile("AnnotatedChart.xlsx")
  5. sheet = workbook.Worksheets[0]
  6. chart = sheet.Charts[0]
  7. # Labels with series name, category name, and value
  8. labels = chart.Series[0].DataPoints.DefaultDataPoint.DataLabels
  9. labels.HasValue = True
  10. labels.HasSeriesName = True
  11. labels.HasCategoryName = True
  12. labels.Delimiter = ". "
  13. labels.Position = DataLabelPositionType.Outside
  14. labels.Size = 8
  15. labels.IsBold = True
  16. labels.Color = Color.get_Red()
  17. workbook.SaveToFile("DataLabelDetails.xlsx", ExcelVersion.Version2013)
  18. workbook.Dispose()
复制代码

HasSeriesName与HasCategoryName分别打开系列名和分类名;Delimiter决定三段文字之间用什么连接,这里用“. ”得到一个类似“Planned. May. 4.5”的标签。字号、加粗和颜色由Size、IsBold、Color控制,作用对象是整个系列的默认标签。

如果只需要给某一个点加说明,例如标注新品上市的第一个月,可以通过DataPoints集合按索引访问单个点,并用它的DataLabels.Text覆盖默认标签。
  1. from spire.xls import *
  2. from spire.xls.common import *
  3. workbook = Workbook()
  4. workbook.LoadFromFile("DataLabels.xlsx")
  5. sheet = workbook.Worksheets[0]
  6. chart = sheet.Charts[0]
  7. # Replace the label of a single data point
  8. point_label = chart.Series[0].DataPoints[0].DataLabels
  9. point_label.Text = "Launch"
  10. point_label.HasValue = True
  11. point_label.IsBold = True
  12. point_label.Color = Color.get_Red()
  13. workbook.SaveToFile("CustomLabel.xlsx", ExcelVersion.Version2013)
  14. workbook.Dispose()
复制代码

DataPoints[0]是系列里的第一个点。设置Text后,这个点显示自定义文字,同系列其他点仍保留默认数值标签。把Text与HasValue一起打开,可以在自定义文字后继续显示原始数值。

误差线由系列的ErrorBar()方法添加,四个参数依次是:是否显示、方向、类型和数值。方向使用ErrorBarIncludeType,常见取值有Plus、Minus、Both;类型决定误差量如何计算:Percentage按数值的百分比计算,20.0表示正负20%;StandardDeviation按标准差倍数计算,1.0表示一个标准差;StandardError按标准误计算,误差量参数不再使用,传0.0即可;Fixed表示固定数值,适合已知误差范围的测量数据。

下面的示例给“计划”系列加20%的单侧误差线,给“实际”系列加1倍标准差的双侧误差线。
  1. from spire.xls import *
  2. from spire.xls.common import *
  3. workbook = Workbook()
  4. workbook.LoadFromFile("DataLabels.xlsx")
  5. sheet = workbook.Worksheets[0]
  6. chart = sheet.Charts[0]
  7. # Percentage error bars on the Planned series
  8. chart.Series[0].ErrorBar(
  9.     True,
  10.     ErrorBarIncludeType.Plus,
  11.     ErrorBarType.Percentage,
  12.     20.0,
  13. )
  14. # Standard deviation error bars on the Actual series
  15. chart.Series[1].ErrorBar(
  16.     True,
  17.     ErrorBarIncludeType.Both,
  18.     ErrorBarType.StandardDeviation,
  19.     1.0,
  20. )
  21. workbook.SaveToFile("ErrorBars.xlsx", ExcelVersion.Version2013)
  22. workbook.Dispose()
复制代码

误差线方向在视觉上有明确含义:Plus只向上画,适合“最多可能高多少”的场景;Minus只向下画;Both则在点的两侧各画一段。配合数据标签一起使用,图表既给出数值,也给出该数值的不确定范围。

实际编写报表脚本时,可以注意以下几点:先建系列再加标注,因为数据标签和误差线都挂在Series上;默认标签改一次即可,DefaultDataPoint作用于整个系列;标签位置按图型选择,柱形图用Outside,折线图用Above,饼图可用Center;设置HasLegendKey = False可以让标签更干净,系列信息已由图例承担;单点标签用索引访问,DataPoints[0]从0开始,对应数据区域的第一个点;误差量参数因类型而异,百分比与标准差需要传数值,标准误忽略该参数;每个工作簿用完调用Dispose()释放资源。

从代码实现角度看,这套接口把Excel界面中的标注操作拆成了系列级别的默认设置、数据点级别的覆盖,以及误差线参数组合。把这些设置写进报表脚本后,图表就能在展示趋势的同时,把具体数值和波动范围一起交代清楚。
回复

使用道具 举报

发表于 25 分钟前 | 显示全部楼层

Re: Python Spire.XLS给Excel图表加数据标签和误差线

感谢分享,前面环境准备和建图部分写得很清楚,尤其是 DataRange 配合 SeriesDataFromRange=False、再用 CategoryLabels 绑定月份列这个流程,对刚开始用 Spire.XLS 画图的人挺友好。图表位置用 TopRow/BottomRow/LeftColumn/RightColumn 按行列号来定,也比反复试坐标省事。 数据标签这段里几个属性的区分讲得实用:HasValue 控制数值显示、HasLegendKey 关掉图例小色块、Position 在柱形图用 Outside 而折线图用 Above,还有 Size 调小避免密集图表里标签挤成一团,这些都是实际出报表时会踩到的点。DefaultDataPoint 作用于整个系列这一点也点明了,改一次就能统一全系列,省得逐个数据点去设置。 不过帖子好像到 labels.HasValue = Tr 这里就断了,标题里提到的“单个数据点自定义标签文字”和“百分比、标准差误差线”还没展开。单点标签我猜是对 DataPoints 里具体某个点单独设置,和 DefaultDataPoint 的默认值区分开,这块如果能补上示例会更完整;误差线部分也期待楼主继续写,百分比和标准差两种类型在代码里分别怎么指定,应该是很多人关心的。
回复 支持 反对

使用道具 举报

发表于 25 分钟前 | 显示全部楼层

Re: Python Spire.XLS给Excel图表加数据标签和误差线

感谢分享,前面这部分写得很清楚,基础图表的搭建和数据标签的设置都分步骤讲明白了,尤其是 HasValue、HasLegendKey、Position 这几个属性的区别,平时写脚本时确实容易混。用 Outside 给柱形图、Above 给折线图这个选择也很实用。 不过帖子的后半段好像被截断了,最后的代码停在 labels.HasValue = Tr,后面的系列名、分类名、分隔符部分没有写完,误差线(百分比和标准差)的内容也还没出现。如果方便的话,希望楼主把剩余部分补全,尤其是在同一系列上分别给几个数据点自定义标签文字的做法,以及误差线是按系列设置还是按数据点设置,这部分我比较想看看完整写法。 另外提两处可以顺带说明的:一是 chart.Series 遍历时给每个系列都设 CategoryLabels,其实设一次也行,写成循环也没问题,主要是让读者知道分类轴绑定一次就够;二是脚本里用 workbook.Dispose() 释放资源很好,如果是在循环里批量处理多个工作簿,建议配合 try 来确保例外时也能释放。再次感谢,数据标签这部分的细节已经可以直接拿来用了。
回复 支持 反对

使用道具 举报

发表于 25 分钟前 | 显示全部楼层

Re: Python Spire.XLS给Excel图表加数据标签和误差线

这篇帖子挺实用的,把 Excel 界面里的“添加数据标签”“误差线”对应到 Spire.XLS 的代码操作,思路很清楚。尤其几个地方讲得到位:DataRange 和 SeriesDataFromRange 配合 CategoryLabels 绑定分类轴,这个对新手来说容易踩坑;用 DefaultDataPoint.DataLabels 一次性改整个系列的标签,比逐个数据点设置省事很多;还有 HasLegendKey 设为 False 避免标签里冒小色块,以及 Position 在柱形图和折线图里的不同选择,都是实际做报表时会遇到的细节。 组合标签那段用 Delimiter 把系列名、分类名和数值拼起来,也很有参考价值,统一成红色加粗小字对出图美观度有帮助。不过正文到 labels.HasValue = Tr 这里好像截断了,后面设置误差线的部分没看到。挺想看看百分比误差线和标准差误差线具体是怎么挂到系列上的,是设置 ErrorBar 类型和方向,还是需要指定误差量或百分比值?如果楼主方便的话,期待把最后这部分补全,尤其是 ExcelChartErrorBarType 的用法和自定义误差量怎么写,这样整篇就更完整了。
回复 支持 反对

使用道具 举报

您需要登录后才可以回帖 登录 | 注册

本版积分规则

指导单位

江苏省公安厅

江苏省通信管理局

浙江省台州刑侦支队

DEFCON GROUP 86025

Hacking Group 021A

旗下站点

态势感知中心

应急响应中心

红盟安全

联系我们

官方QQ群:112851260

官方邮箱:security#ihonker.org(#改成@)

官方核心成员

关注微信公众号

Archiver|手机版|小黑屋| ( 沪ICP备2021026908号 )

GMT+8, 2026-11-23 06:30 , Processed in 0.024389 second(s), 18 queries , Gzip On, Redis On.

Powered by ihonker.com

Copyright © 2015-现在.

  • 返回顶部