7.Pyecharts:全局配置项1
Pyecharts视图的全局配置项文件位于\Anaconda3\Lib\site-packages\pyecharts\options下的global_options.py文档中,可以通过set_global_options()方法设置。
一 基本元素配置项
主要包括InitOpts、ToolBoxFeatureOpts、ToolboxOpts、TitleOpts、DataZoomOpts、LegendOpts、VisualMapOpts、TooltipOpts。
1.InitOpts
1.作用
通过init_opts
可以预定义图表的宽度、高度、主题颜色、背景、渲染方式等属性,确保图表在生成时具有统一的风格和布局,避免重复设置样式。
避免在多个图表中重复设置样式。确保图表在宽度、主题、颜色等方面的一致性。通过参数快速修改图表外观,无需重写大量代码。
2.配置项及说明
# 添加数据
bar.add_xaxis(["A", "B", "C", "D"])
bar.add_yaxis("销量", [10, 20, 30, 40])
bar.add_xaxis(["A", "B", "C", "D"]):
添加 X 轴的数据,表示柱状图的分类(横轴标签)。这里设置了 4 个类别:"A"
、"B"
、"C"
和 "D"
。
bar.add_yaxis("销量", [10, 20, 30, 40]):
添加 Y 轴的数据,表示每个类别对应的数值(纵轴数据)。第一个参数 "销量"
是数据系列的名称,会显示在图例中。第二个参数 [10, 20, 30, 40]
是具体的数值,与 X 轴的类别一一对应。
# 设置全局配置项(可选,这里可以单独设置其他选项)
bar.set_global_opts(title_opts=opts.TitleOpts(title="柱状图示例"))
bar.set_global_opts(...)
:设置图表的全局配置选项,例如标题、图例、工具提示等。
title_opts=opts.TitleOpts(title="柱状图示例")
:使用 TitleOpts
设置图表的标题:title="柱状图示例"
:设置图表的主标题为 "柱状图示例"
。
# 渲染图表
bar.render("bar_chart.html")
bar.render("bar_chart.html"):
将生成的柱状图渲染为 HTML 文件,并保存到当前目录下,文件名为 "bar_chart.html"
。渲染后的 HTML 文件可以直接在浏览器中打开查看图表。
2.ToolBoxFeatureOpts和ToolboxOpts
1.作用
ToolBoxFeatureOpts:用于配置工具箱中特定功能项的行为和外观,例如数据缩放、保存为图片、数据视图等。
ToolboxOpts:用于配置图表工具箱的整体行为和外观,例如工具箱的显示、位置、排列方向等。
2.配置项及说明
ToolBoxFeatureOpts:
feature=opts.ToolBoxFeatureOpts(save_as_image=opts.ToolBoxFeatureSaveAsImageOpts(is_show=True), # 保存为图片data_zoom=opts.ToolBoxFeatureDataZoomOpts(is_show=True), # 数据缩放data_view=opts.ToolBoxFeatureDataViewOpts(is_show=True), # 数据视图restore=opts.ToolBoxFeatureRestoreOpts(is_show=True), # 还原magic_type=opts.ToolBoxFeatureMagicTypeOpts(type_=["line", "bar"]) # 动态类型切换
)
ToolboxOpts:
toolbox_opts=opts.ToolboxOpts(is_show=True, # 显示工具箱orient="vertical", # 垂直排列按钮pos_left="2%", # 工具箱距离左侧 2%pos_top="20%", # 工具箱距离顶部 20%feature={} # 具体功能项配置(通过 ToolBoxFeatureOpts)
)
3.两者关系
ToolboxOpts
负责工具箱的整体设置(如显示、位置、排列方向)。
ToolBoxFeatureOpts
是 ToolboxOpts
的一部分,用于进一步细化工具箱中每个功能项的配置(如保存为图片、数据缩放等)。
ToolboxOpts
:控制工具箱的整体行为和外观。
ToolBoxFeatureOpts
:配置工具箱中具体功能项的行为和外观。
3.TitleOpts
1.作用
通过传递不同的参数来调整标题的行为和样式。
设置主标题和副标题,控制标题位置和样式,增强交互性,为标题和副标题添加跳转链接。
2.配置项及说明
点击主标题柱状图示例即可跳转页面。
4.DataZoomOpts
1.作用
DataZoomOpts 可用于在图表中添加数据的缩放和漫游功能。当图表数据较多时,用户可以通过缩放功能查看局部数据的细节,通过漫游功能浏览不同区域的数据。
2.配置项及说明
5.LegendOpts
1.作用
控制图例显示,控制图例在图表中的位置,设置图例的排列方向(水平或垂直),自定义图例样式(设置图例文本的字体、颜色、大小等样式),控制图例的选择模式(单选、多选或关闭)。
2.配置项及说明
6.VisualMapOpts
1.作用
用于配置视觉映射组件的具体行为和外观,通过传递不同的参数调整视觉映射组件的行为和样式。
根据数据值范围,动态调整图表中数据点的颜色、大小等视觉属性。通过视觉差异,帮助用户快速理解数据的分布和趋势。
2.配置项及说明
3.连续型视觉映射
将数据值映射到一个连续的视觉范围(如颜色渐变)。
适用于连续型数据(如温度、时间等)。
4.分段型视觉映射
适用于将数据分成若干段,并为每段指定不同的样式(如颜色、标签等)。
适用于离散型数据或需要明确分段的数据(如成绩等级、收入区间等)。
7.TooltipOpts
1.作用
用于控制图表中提示框(Tooltip)的行为和样式。当用户将鼠标悬停在图表上的某个数据点或区域时,提示框会显示与该点或区域相关的详细信息。
2.配置项及说明
二 坐标轴配置项
Pyecharts的坐标轴配置项主要包括AxisLineOpts、AxisTickOpts、AxisPointerOpts、AxisOpts、SingleAxisOpts五个配置。
1.AxisLineOpts 轴线
1.作用
控制轴线的显示与隐藏:决定是否显示坐标轴线。
设置轴线的样式:配置轴线的宽度、颜色、线型(实线、虚线等)。
2.配置项及说明
2.AxisTickOpts 刻度线
1.作用
设置坐标轴线的刻度显示和隐藏,并且可定义刻度线的长度、颜色、宽度等方面的样式设置。
2.配置项及说明
3.AxisPointerOpts
1.作用
控制提示框的显示内容:决定提示框中显示哪些信息,如数据值、坐标轴标签等。
设置提示框的样式:配置提示框的背景色、边框颜色、边框宽度等。
2.配置项及说明
4.AxisOpts
1.作用
设置坐标轴的类型:决定坐标轴是数值轴('value'
)、类目轴('category'
)还是其他类型。
设置坐标轴的显示名称:为坐标轴添加名称,以便用户更好地理解图表内容。
配置刻度标签的样式:设置刻度标签的显示内容、字体样式、颜色等。
控制坐标轴线和刻度线的样式:配置坐标轴线和刻度线的颜色、宽度、样式等。
2.配置项及说明
5.SingleAxisOpts
1.作用
设置坐标轴的类型:决定坐标轴是数值轴('value'
)、类目轴('category'
)还是其他类型。
设置坐标轴的显示名称:为坐标轴添加名称,以便用户更好地理解图表内容。
配置坐标轴名称的位置:设置坐标轴名称的显示位置,如 'start'
(起始位置)、'center'
(居中位置)、'end'
(结束位置)等。
控制轴线和标签的样式:配置轴线的颜色、宽度、样式。设置标签的字体样式、颜色、旋转角度。
2.配置项及说明
6.这五个的区别
1. AxisLineOpts
用途:用于设置坐标轴线的颜色、宽度和样式,使轴线更加美观。
2. AxisTickOpts
用途:用于设置刻度线的显示状态、长度、颜色和宽度,使刻度线更加清晰。
3. AxisPointerOpts
用途:用于设置鼠标指针移动到图表上时的提示框样式,使提示框更加美观和个性化。
4. AxisOpts
用途:用于综合配置坐标轴的类型、名称、刻度标签、轴线和刻度线的样式,是坐标轴配置的核心选项类。
5. SingleAxisOpts
用途:用于对单轴进行全面的样式配置,包括类型、名称、名称位置、轴线和标签的样式,适用于需要单独配置某个坐标轴的情况。