SuperAPI AI 工具集

chart-builder

数据与分析

查看项目

更新于 10-16 06:47

技能介绍

用途:当用户要求对 CSV、表格或 DataFrame 中的数据进行可视化、绘图或制图(柱状图、折线图、散点图、直方图、饼图)时使用本技能。它通过内置的 scripts/charts.py 工具包生成图表。

主要能力:每个函数接收 DataFrame 或文件路径,以及要绘制的列,保存 PNG 并返回路径。工具包处理主题、图形尺寸、标签旋转、NaN 丢弃、图例位置和保存。提供六个图表函数:bar(data, x, y)(每类一个值,horizontal=True 为条形图);grouped_bar(data, x, y, group)(按组拆分,stacked=True 堆叠);line(data, x, y, group=None)(有序轴上的值,每组一条线);scatter(data, x, y, group=None, size=None)(两个数值列);histogram(data, y, bins=20, group=None)(单列分布);pie(data, x, y, donut=False)(各类别占比)。

使用方式:数据源可为 pandas DataFrame,或 .csv / .tsv / .json 文件路径。可导入调用,如:from charts import bar, line, pie;bar("sales.csv", x="region", y="revenue", title="Revenue by region", out="revenue.png")。也可用 CLI:python scripts/charts.py grouped_bar sales.csv --x region --y revenue --group quarter --stacked --out by_quarter.png。

通用可选参数:title、xlabel、ylabel(省略时由列名推导)、out(默认 "chart.png",传 None 跳过保存)、dpi(默认 150)、figsize、palette。函数返回保存的图像路径。

配套文件:scripts/charts.py(工具包:load_data、apply_theme、save_fig 及六个图表函数和 CLI,依赖 matplotlib 和 pandas,无头运行);references/cheatsheet.md(图表选择表、完整签名和可直接复制的 CLI 示例);assets/sample_sales.csv(演示数据集)。

默认行为:使用色盲友好调色板和共享主题;图形尺寸、x 轴标签旋转和图例位置随数据自适应;绘制前列中缺失值的行会被丢弃;默认以 150 DPI 保存 PNG(可通过 out 和 dpi 覆盖)。

限制:依赖 matplotlib 和 pandas;输出为 PNG;具体安装步骤、收费或平台信息暂未提供。