数据散点图生成技能#

功能描述#

本技能用于处理数据文件（Excel/CSV），自动识别数据格式，并生成基于指定标题的散点图。

核心功能#

1. 智能数据解析：自动识别Item列、Result数据行、Min/Max Limit行
2. 动态散点图生成：根据指定标题组合生成散点图
3. Limit线绘制：自动从数据中提取Min/Max Limit值并绘制参考线
4. 批量导出：支持批量生成并保存为PNG图片

数据格式说明#

输入文件格式（支持 .csv, .xls, .xlsx）#

结构说明第1列Item名称（如 LESD3Z5.0CMT1HG）其他列列标题（如 1 CONT2(V)）Result行散点图的数值数据来源Min Limit行最小限制值Max Limit行最大限制值

散点图标题命名规则#

text

标题格式：'{第1列Item名称} + {对应列的列标题}'
示例：'LESD3Z5.0CMT1HG + 1 CONT2(V)'

Y轴标签#

• 取自对应列的 Limit Unit（如 mV, V, mA 等）

使用方法#

基本用法#

python

from scripts.data_loader import ExcelDataLoader
from scripts.scatter_generator import ScatterPlotGenerator

# 1. 加载数据
loader = ExcelDataLoader('path/to/Test.xls')
data = loader.load()

# 2. 获取可用的散点图配置
configs = loader.get_scatter_configs()

# 3. 生成散点图
generator = ScatterPlotGenerator(output_dir='output/plots')
for config in configs:
    generator.generate(data, config)

命令行用法#

bash

python -m scripts.main --input Test.xls --output-dir output/plots

配置参数#

ScatterConfig 配置对象#

参数类型必填说明item_namestr是第1列的Item名称column_titlestr是对应列的列标题y_labelstr否Y轴标签（默认取Limit Unit）min_limitfloat否Min Limit值max_limitfloat否Max Limit值result_dataList[float]是Result行数据

命令行参数#

参数简写说明默认值--input``-i输入数据文件路径（支持.csv/.xls/.xlsx）必需--output-dir``-o输出图片目录./plots``--format``-f输出格式png``--dpi-图片分辨率1200

输出示例#

生成的散点图包含：

• 16:9 宽屏比例

• 主数据散点（蓝色圆点）

• 智能Limit线绘制：

  • 只有Min Limit → 仅绘制Min Limit线
  • 只有Max Limit → 仅绘制Max Limit线
  • 两者都有 → 绘制两条线
  • 两者都没有 → 只绘制散点图

• Min Limit水平线（红色虚线，标注"Min Limit"）

• Max Limit水平线（红色虚线，标注"Max Limit"）

• X轴：数据点索引

• Y轴：对应Limit Unit

• 标题：'{Item名称} + {列标题}'

数据格式要求#

• Result行及以下数据必须为 数值格式（不支持文本格式）
• 支持带单位格式（如 "5mV"）自动提取数值部分

注意事项#

1. 空值处理：Result行中的空值会被自动跳过
2. Limit行识别：通过固定行名"Min Limit"和"Max Limit"识别
3. 文件编码：CSV文件支持 UTF-8、GBK、GB2312、Latin1 自动识别
4. 依赖安装： pip install -r requirements.txt

依赖清单#

text

pandas>=1.5.0
matplotlib>=3.5.0
openpyxl>=3.0.0
xlrd>=2.0.0