数据散点图生成技能

功能描述

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

核心功能

1. 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行 | 最大限制值 |

散点图标题命名规则

标题格式：{第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.getscatterconfigs()

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 配置对象

参数	类型	必填	说明
itemname	str	是	第1列的Item名称
columntitle

str | 是 | 对应列的列标题 | | y_label | str | 否 | Y轴标签（默认取Limit Unit） | | min_limit | float | 否 | Min Limit值 | | max_limit | float | 否 | Max Limit值 | | result_data | List[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. 1. 空值处理：Result行中的空值会被自动跳过
2. Limit行识别：通过固定行名Min Limit和Max Limit识别
3. 文件编码：CSV文件支持 UTF-8、GBK、GB2312、Latin1 自动识别
4. 依赖安装：pip install -r requirements.txt

依赖清单

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