Excel图表用于表达趋势时,读者往往还需要两类信息:每个数据点具体是多少,以及该数值的波动范围有多大。数据标签把数值直接标在图形旁边,误差线用短线表示不确定性。两者不改变图表的数据结构,只是把“看图估计”变成“看图读数”。在Excel界面中,这两项功能分别位于“添加数据标签”和“误差线”菜单;当图表由Python脚本生成时,同样可以通过代码设置。本文围绕Spire.XLS for Python,演示为图表系列设置数据标签、为单个数据点自定义标签文字,以及添加百分比和标准差误差线。
环境准备:安装Spire.XLS并引入模块。
- pip install Spire.XLS
- from spire.xls import *
- from spire.xls.common import *
复制代码
先创建基础图表。数据标签和误差线都挂在系列上,因此图表和数据源需要先建立。下面的代码准备“计划”和“实际”的月度数据,生成簇状柱形图,并把图表放在数据区下方,避免遮挡。
- from spire.xls import *
- from spire.xls.common import *
- workbook = Workbook()
- workbook.CreateEmptySheets(1)
- sheet = workbook.Worksheets[0]
- months = ["Jan", "Feb", "Mar", "Apr", "May", "Jun"]
- planned = [3.3, 2.5, 2.0, 3.7, 4.5, 4.0]
- actual = [3.8, 3.2, 1.7, 3.5, 4.5, 4.3]
- sheet.Range["A1"].Value = "Month"
- sheet.Range["B1"].Value = "Planned"
- sheet.Range["C1"].Value = "Actual"
- for i in range(len(months)):
- sheet.Range[i + 2, 1].Value = months[i]
- sheet.Range[i + 2, 2].NumberValue = planned[i]
- sheet.Range[i + 2, 3].NumberValue = actual[i]
- chart = sheet.Charts.Add(ExcelChartType.ColumnClustered)
- chart.DataRange = sheet.Range["B1:C7"]
- chart.SeriesDataFromRange = False
- chart.ChartTitle = "Monthly Results"
- for series in chart.Series:
- series.CategoryLabels = sheet.Range["A2:A7"]
- # Place the chart below the data
- chart.TopRow = 10
- chart.BottomRow = 28
- chart.LeftColumn = 1
- chart.RightColumn = 10
- workbook.SaveToFile("AnnotatedChart.xlsx", ExcelVersion.Version2013)
- workbook.Dispose()
复制代码
这里的关键点包括:DataRange指定数据区域,SeriesDataFromRange设为False,CategoryLabels把分类轴绑定到月份列;TopRow、BottomRow、LeftColumn、RightColumn用行号和列号确定图表位置与大小。
显示数值标签时,数据标签设置在系列的DataPoints.DefaultDataPoint.DataLabels上。DefaultDataPoint表示该系列所有数据点的默认标签,修改一次即可作用于整个系列。
- from spire.xls import *
- from spire.xls.common import *
- workbook = Workbook()
- workbook.LoadFromFile("AnnotatedChart.xlsx")
- sheet = workbook.Worksheets[0]
- chart = sheet.Charts[0]
- # Show the value on every data point
- for series in chart.Series:
- labels = series.DataPoints.DefaultDataPoint.DataLabels
- labels.HasValue = True
- labels.HasLegendKey = False
- labels.Position = DataLabelPositionType.Outside
- labels.Size = 9
- workbook.SaveToFile("DataLabels.xlsx", ExcelVersion.Version2013)
- workbook.Dispose()
复制代码
几个属性需要区分:HasValue控制是否显示数值,是数据标签最基础的内容;HasLegendKey控制是否附带图例符号,报表中通常设为False,避免标签里出现多余的小色块;Position指定标签位置,柱形图常用Outside,折线图可用Above;Size是标签字号,默认字号在密集图表中容易挤在一起。
除了数值,标签还可以组合系列名和分类名,三者之间的分隔符由Delimiter指定。下面的示例把标签做成“系列. 月份. 数值”的形式,并统一为红色加粗小字。
- from spire.xls import *
- from spire.xls.common import *
- workbook = Workbook()
- workbook.LoadFromFile("AnnotatedChart.xlsx")
- sheet = workbook.Worksheets[0]
- chart = sheet.Charts[0]
- # Labels with series name, category name, and value
- labels = chart.Series[0].DataPoints.DefaultDataPoint.DataLabels
- labels.HasValue = True
- labels.HasSeriesName = True
- labels.HasCategoryName = True
- labels.Delimiter = ". "
- labels.Position = DataLabelPositionType.Outside
- labels.Size = 8
- labels.IsBold = True
- labels.Color = Color.get_Red()
- workbook.SaveToFile("DataLabelDetails.xlsx", ExcelVersion.Version2013)
- workbook.Dispose()
复制代码
HasSeriesName与HasCategoryName分别打开系列名和分类名;Delimiter决定三段文字之间用什么连接,这里用“. ”得到一个类似“Planned. May. 4.5”的标签。字号、加粗和颜色由Size、IsBold、Color控制,作用对象是整个系列的默认标签。
如果只需要给某一个点加说明,例如标注新品上市的第一个月,可以通过DataPoints集合按索引访问单个点,并用它的DataLabels.Text覆盖默认标签。
- from spire.xls import *
- from spire.xls.common import *
- workbook = Workbook()
- workbook.LoadFromFile("DataLabels.xlsx")
- sheet = workbook.Worksheets[0]
- chart = sheet.Charts[0]
- # Replace the label of a single data point
- point_label = chart.Series[0].DataPoints[0].DataLabels
- point_label.Text = "Launch"
- point_label.HasValue = True
- point_label.IsBold = True
- point_label.Color = Color.get_Red()
- workbook.SaveToFile("CustomLabel.xlsx", ExcelVersion.Version2013)
- 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倍标准差的双侧误差线。
- from spire.xls import *
- from spire.xls.common import *
- workbook = Workbook()
- workbook.LoadFromFile("DataLabels.xlsx")
- sheet = workbook.Worksheets[0]
- chart = sheet.Charts[0]
- # Percentage error bars on the Planned series
- chart.Series[0].ErrorBar(
- True,
- ErrorBarIncludeType.Plus,
- ErrorBarType.Percentage,
- 20.0,
- )
- # Standard deviation error bars on the Actual series
- chart.Series[1].ErrorBar(
- True,
- ErrorBarIncludeType.Both,
- ErrorBarType.StandardDeviation,
- 1.0,
- )
- workbook.SaveToFile("ErrorBars.xlsx", ExcelVersion.Version2013)
- workbook.Dispose()
复制代码
误差线方向在视觉上有明确含义:Plus只向上画,适合“最多可能高多少”的场景;Minus只向下画;Both则在点的两侧各画一段。配合数据标签一起使用,图表既给出数值,也给出该数值的不确定范围。
实际编写报表脚本时,可以注意以下几点:先建系列再加标注,因为数据标签和误差线都挂在Series上;默认标签改一次即可,DefaultDataPoint作用于整个系列;标签位置按图型选择,柱形图用Outside,折线图用Above,饼图可用Center;设置HasLegendKey = False可以让标签更干净,系列信息已由图例承担;单点标签用索引访问,DataPoints[0]从0开始,对应数据区域的第一个点;误差量参数因类型而异,百分比与标准差需要传数值,标准误忽略该参数;每个工作簿用完调用Dispose()释放资源。
从代码实现角度看,这套接口把Excel界面中的标注操作拆成了系列级别的默认设置、数据点级别的覆盖,以及误差线参数组合。把这些设置写进报表脚本后,图表就能在展示趋势的同时,把具体数值和波动范围一起交代清楚。 |