图表函数
1 zc_BubbleChart (气泡图)
根据表格数据绘制多维气泡图
Excel 调用语法：
=zc_BubbleChart(data, x, y, [bubble_size], [category], [label], [title])
参数说明：
data 必须选择包含表头的二维表格区域（如”A1:F200”）
x X轴字段名，必须是表头存在的列名（如”销售额”）
y Y轴字段名，必须是表头存在的列名（如”利润”)
bubble_size (可选) 指定气泡大小对应的数值列（如”市场规模”）
category (可选) 分类字段名，不同类别用颜色区分（如”区域”）
label (可选) 显示在气泡上的标签字段（如”产品线”）
title (可选) 图表标题文本（如”销售分析图”）
示例：
=zc_BubbleChart(B2:G150, "X轴", "Y轴", "规模", , "名称")
2 zc_Sankey (桑基图)
绘制资源流动关系图
Excel 调用语法：
=zc_Sankey(nodes, connections, [title], [browser])
参数说明：
nodes 节点定义区域（需2列）：
第1列：节点名称（如”北美”）
第2列：节点类型（如”收入”）
connections 连接关系区域（至少3列）：
源节点名称
目标节点名称
连接值
同比（可选）
title (可选) 图表标题（如”资金流向图”）
browser (可选，默认FALSE) 设为TRUE时在浏览器打开交互图表
示例：
=zc_Sankey(A1:B10, D1:G50, , TRUE)
3 zc_Scatter (散点图)
绘制二维散点图
Excel 调用语法：
=zc_Scatter(data_frame, [query], [browser], kwargs)
参数说明：
data_frame 包含坐标数据的表格区域（如”A1:E100”）
query (可选) 数据过滤条件（如”销售额>1000”）
browser (默认FALSE) TRUE输出交互式网页图表
kwargs 两列参数设置区域，常用参数：
参数名
说明
x
X轴字段名
y
Y轴字段名
color
颜色映射字段
symbol
形状分类字段
示例：
=zc_Scatter(A1:D200, , TRUE, B1:C3)
/* kwargs区域内容：
x 经度
y 纬度
color 城市等级
*/
4 zc_Scatter3d (三维散点图)
绘制三维空间散点图
Excel 调用语法：
=zc_Scatter3d(data_frame, [query], [browser], kwargs)
特殊参数要求：
必须通过kwargs指定z轴字段：
z 海拔高度
示例：
=zc_Scatter3d(A1:F500, , TRUE, B1:C4)
/* kwargs：
x 温度
y 湿度
z 气压
*/
5 zc_Line (折线图)
绘制趋势折线图
Excel 调用语法：
=zc_Line(data_frame, [query], [browser], kwargs)
特殊参数：
通过kwargs设置日期字段：
x 日期
y 指标值
line_dash 线型（solid/dash/dot）
示例：
=zc_Line(A1:C365, "年份=2023", , B1:C3)
/* kwargs：
x 日期
y 销售额
*/
6 c_Bar (条形图)
绘制分类对比条形图
Excel 调用语法：
=zc_Bar(data_frame, [query], [browser], kwargs)
特殊参数：
需指定分类字段和数值字段：
x 类别字段
y 数值字段
barmode group/stack（分组/堆叠）
示例：
=zc_Bar(A1:D50, , , B1:C2)
/* kwargs：
x 产品类型
y 销量
*/
7 zc_Pie (饼图)
绘制比例分布饼图
Excel 调用语法：
=zc_Pie(data_frame, [query], [browser], kwargs)
参数要求：
必须包含分类字段和数值字段：
names 分类字段
values 数值字段
示例：
=zc_Pie(A1:B10, , , B1:C2)
/* kwargs：
names 省份
values 人口占比
*/
8 zc_WordCloud (词云图)
生成文本数据词云
Excel 调用语法：
=zc_WordCloud(data_frame, word_column, weight_column)
参数说明：
data_frame 包含词语和权重的表格（如”A1:B100”）
word_column 词语字段名（默认”词语”）
weight_column 权重字段名（默认”权重”）
示例：
=zc_WordCloud(D1:E200, "关键词", "出现频次")
9 zc_Histogram (直方图)
绘制数值分布直方图
Excel 调用语法：
=zc_Histogram(data_frame, [query], [browser], kwargs)
特殊参数：
需指定数值字段：
x 数值字段
nbins 分箱数量（默认自动）
示例：
=zc_Histogram(A1:C1000, , , B1:C2)
/* kwargs：
x 考试成绩
nbins 20
*/