data-scatter-plot — 数据散点图

数据散点图生成技能 功能描述 本技能用于处理数据文件（Excel/CSV），自动识别数据格式，并生成基于指定标题的散点图。 核心功能 智能数据解析：自动识别Item列、Result数据行、Min/Max Limit行 动态散点图生成：根据指定标题组合生成散点图 Limit线绘制：自动从数据中提取Min/Max Limit值并绘制参考线 批量导出：支持批量生成并保存为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 等） 使用方法 基本用法 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) 命令行用法 python -m scripts.main --input Test.xls --output-dir output/plots 配置参数 ScatterConfig 配置对象 参数 类型 必填 说明 item_name str 是 第1列的Item名称 column_title 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"）自动提取数值部分 注意事项 空值处理：Result行中的空值会被自动跳过 Limit行识别：通过固定行名"Min Limit"和"Max Limit"识别 文件编码：CSV文件支持 UTF-8、GBK、GB2312、Latin1 自动识别 依赖安装：pip install -r requirements.txt 依赖清单 pandas>=1.5.0 matplotlib>=3.5.0 openpyxl>=3.0.0 xlrd>=2.0.0