简介电力漏电用户自动识别Python源码包面向电力数据挖掘与智能用电分析方向的开发者与学生聚焦从用电数据中自动识别漏电用户这一典型分析场景。压缩包共15个文件大小约49KB包含完整的Python脚本.py、数据集.xls、.npy、模型文件.pkl、.model、可视化结果.png及导入说明文本.txt。其中npy文件存储预处理后的数值数组xls为原始及处理后数据表pkl/model为训练得到的树模型与网络模型png则为识别结果可视化图整体涵盖数据导入、预处理、建模、评估与展示的完整链路。已有213人学习适合正在练手数据挖掘算法、需要参考漏电用户识别完整代码与模型文件的初学者或工程师。通过这份源码可快速了解数据挖掘算法在本场景的参数选择、模式提取与模型应用过程并基于自带数据集直接运行验证节省从零搭建环境的时间。1. 项目概述这个工具到底解决什么问题先说结论这是一个基于Python开发的电力漏电用户自动识别工具核心流程是从用电数据里找出疑似漏电的用户批量输出结果省掉大量人工核对的时间。我最早接触这个需求是因为一个做台区线损治理的朋友吐槽每个月都要手动拉一堆用电数据然后用Excel筛选异常眼睛都快瞎了。漏电用户识别这事看起来简单实际做起来相当麻烦——一个台区几百户数据维度又多人工筛一遍至少要半天还容易漏。后来我帮他写了个Python脚本把整个流程自动化效果很理想。今天把我这套实现思路完整拆出来包含源码结构和关键算法供有类似需求的朋友参考。这个项目适合谁三类人电力行业从业者尤其是做台区线损、用电检查、反窃电方向的技术人员Python数据分析爱好者想找一个真实的业务分析案例练手需要批量处理结构化表格数据、做异常识别的开发者项目本身不复杂核心就是数据清洗、特征计算、阈值判断三步但每一步都有不少细节坑我会在下面逐一说明。2. 整体设计思路为什么选Python 为什么这样判断漏电2.1 技术选型的逻辑漏电识别这个场景本质上是一个“基于规则的异常检测”问题。市面上有很多重型方案比如训练一个机器学习模型来做用户行为分类但实际落地时性价比很低——样本标签难获取、模型训练成本高、业务解释性差。相反电力行业积累了非常成熟的物理判断经验这些经验完全可以转成显式的判定规则用Python实现又快又准。选Python而不是其他语言的原因很直接pandas处理表格数据极其方便尤其适合读取、清洗、聚合这种场景判定逻辑以数值计算为主Python的向量化操作性能足够后续如果要扩展现成模型、可视化分析Python生态无缝衔接我见过有人用C#或者Java写类似的工具代码量能多出两三倍而且改规则特别麻烦。Python在这个场景下就是最省力的选项。2.2 漏电判定的核心逻辑漏电用户识别的基本原理是依托台区总表和用户分表之间的关系。正常情况下台区总电量应该等于所有用户分表电量之和加上固定线损。一旦某个用户存在漏电他的分表计量会低于实际用电量导致台区统计线损明显偏高。具体到判定规则我常用的有三个维度电流平衡异常单相用户火线电流与零线电流的差值超过设定阈值说明存在对地泄漏电流。这个特征最直接但前提是采集数据里有零线电流字段。电量波动异常用户在某个时间段内用电量明显低于自身历史水平同时台区线损率同步上升。这种情况大概率是漏电导致计量偏低。分时分相对比异常三相用户可以对比三相电流的平衡度如果某一相电流明显异常结合其他两相判断是否存在单相漏电。三个维度可以单独用也可以组合加权。实际项目中我建议至少两个维度同时命中才判定为疑似漏电否则误报率会很高。2.3 为什么不做“一刀切”的固定阈值这里有个非常重要的经验不要用一个固定阈值打天下。不同台区、不同季节、不同用户类型的用电特征差异巨大。比如夏天农排用户用电量很大冬天的空房用户几乎不用电同样的阈值判断结果完全是两回事。所以我的方案里把判定参数全部做成可配置的同时内置了一套默认经验值用户可以根据自己的实际数据调整。这个设计一开始就要想好否则后面调参的时候会特别痛苦。3. 源码结构详解每个文件干了什么整个项目的源码结构非常清晰主程序加两个辅助模块总共没几个文件power_leakage_detector/ ├── main.py # 主入口调度整个流程 ├── data_loader.py # 数据加载与清洗模块 ├── detector.py # 漏电判定核心算法模块 ├── report.py # 结果导出模块 ├── config.yaml # 判定参数配置 ├── requirements.txt # 依赖包清单 └── README.md # 使用说明3.1 data_loader.py数据清洗是重头戏这个模块负责读取用户上传的用电数据支持Excel和CSV两种格式并完成数据清洗。数据清洗之所以放在最前面是因为实际拿到的数据往往非常脏不处理的话后面全是错。# data_loader.py 核心代码片段 import pandas as pd def load_electricity_data(file_path): 加载用电数据文件支持Excel和CSV if file_path.endswith(.xlsx) or file_path.endswith(.xls): df pd.read_excel(file_path) elif file_path.endswith(.csv): df pd.read_csv(file_path) else: raise ValueError(不支持的文件格式请使用Excel或CSV文件) df clean_data(df) return df def clean_data(df): 数据清洗处理缺失值、重复值、异常值 # 1. 删除完全重复的行 df.drop_duplicates(inplaceTrue) # 2. 处理缺失值用户编号和抄表日期必须存在否则删行 df.dropna(subset[用户编号, 抄表日期], inplaceTrue) # 3. 电量字段缺失用0填充代表该月未用电 df[用电量].fillna(0, inplaceTrue) # 4. 用电量负数直接置为0 df.loc[df[用电量] 0, 用电量] 0 # 5. 日期字段统一格式 df[抄表日期] pd.to_datetime(df[抄表日期], errorscoerce) return df清洗逻辑里有几个细节需要注意。填充缺失电量用0是基于“未用电”的假设但对于长期零电量的用户反而可能是采集失败或漏电的迹象所以后面算法里专门有一个指标来处理这种情况。日期解析用errorscoerce是为了防止脏数据导致程序崩溃但解析成NaT的行要单独标记出来在判定阶段排除掉。3.2 detector.py判定算法的核心实现这是整个项目的灵魂。基于前面说的三个判定维度我实现了一个综合评分机制每个维度打一个可疑分最后加权求和超过阈值判定为疑似漏电用户。# detector.py 核心代码片段 import pandas as pd import numpy as np def detect_leakage_users(df, config): 漏电用户识别主算法 :param df: 清洗后的用电数据 :param config: 配置参数 :return: 疑似漏电用户列表及详情 results [] # 按用户分组处理 for user_id, group in df.groupby(用户编号): score 0 reasons [] # 维度1电流不平衡检测 if 火线电流 in group.columns and 零线电流 in group.columns: current_diff abs(group[火线电流] - group[零线电流]) if current_diff.max() config[current_diff_threshold]: score 40 reasons.append(f电流不平衡最大差值{current_diff.max():.2f}A) # 维度2用电量波动检测 mean_consumption group[用电量].mean() recent_consumption group[用电量].iloc[-3:].mean() if mean_consumption 0: drop_ratio (mean_consumption - recent_consumption) / mean_consumption if drop_ratio config[drop_ratio_threshold]: score 30 reasons.append(f电量下降{drop_ratio*100:.1f}%) # 维度3连续零电量检测 zero_count (group[用电量] 0).sum() if zero_count config[max_zero_count]: score 30 reasons.append(f连续{zero_count}个月零电量) # 判断是否疑似漏电 if score config[score_threshold]: results.append({ 用户编号: user_id, 可疑得分: score, 可疑原因: ; .join(reasons), 平均用电量: mean_consumption }) return pd.DataFrame(results)这个评分机制是我在实际项目中反复调出来的关键点在于电流不平衡权重最高40分因为这是漏电最直接的物理特征电量波动和连续零电量的权重略低各30分作为辅助判断综合得分70分以上才判定为疑似漏电有效降低误报不要小看这个评分机制的设计。单纯用“与”逻辑做判断条件太多会导致漏报条件太少会导致误报。评分制的好处是可以灵活调整各个特征的权重适配不同场景。3.3 report.py结果输出要让人看得懂算法跑完之后结果输出同样重要。我做了两种输出格式# report.py 核心代码片段 import pandas as pd from datetime import datetime def export_result(results_df, output_formatexcel): 导出识别结果 timestamp datetime.now().strftime(%Y%m%d_%H%M%S) if output_format excel: output_path fleakage_users_{timestamp}.xlsx with pd.ExcelWriter(output_path) as writer: results_df.to_excel(writer, sheet_name疑似漏电用户, indexFalse) return output_path elif output_format csv: output_path fleakage_users_{timestamp}.csv results_df.to_csv(output_path, indexFalse, encodingutf-8-sig) return output_path这里有一个细节CSV输出必须用utf-8-sig编码不然用Excel打开中文会乱码。很多人踩过这个坑我特意写在这里提醒一下。另外我还在结果里额外加了两列辅助字段嫌疑度排序和复核建议。嫌疑度按得分从高到低排列复核建议根据得分区间给出“现场核查”“重点监测”“加强抄表”等不同操作指引。这样业务人员拿到结果就能直接安排工作不用再自己分析。4. 完整实操流程从原始数据到识别报告4.1 环境准备首先需要安装Python环境建议用3.8以上版本。然后安装依赖包pip install pandas openpyxl pyyaml这里说明一下为什么需要这几个包pandas数据处理的核心库读取Excel、做分组聚合全靠它openpyxlpandas读取Excel文件的后端引擎必须安装pyyaml解析config.yaml配置文件用建议创建一个虚拟环境来安装这些依赖避免污染系统Python环境。用venv或者conda都行看个人习惯。4.2 配置文件详解config.yaml是整个工具灵活性的关键我不建议把参数硬编码在代码里。下面是我默认的配置# config.yaml # 判定参数配置 current_diff_threshold: 0.5 # 电流不平衡阈值安培 drop_ratio_threshold: 0.5 # 用电量下降比例阈值 max_zero_count: 6 # 连续零电量月份数阈值 score_threshold: 70 # 判定疑似漏电的综合得分阈值 # 数据字段映射 field_mapping: 用户编号: 用户编号 抄表日期: 抄表日期 用电量: 用电量 火线电流: 火线电流 零线电流: 零线电流这些默认值怎么来的我拿真实台区数据跑过很多次统计正常用户和已知异常用户的特征分布取了一个区分度比较高的分界点。比如电流不平衡阈值0.5A意味着火零线电流差半安培以上才认为异常。正常情况下单相用户火零线电流几乎是一致的差0.5A说明大约有110瓦左右的功率泄漏到地上了这已经足够引起注意。配置里还加了字段映射。因为不同电力局的表格字段命名可能不一样有的叫“用户号”、有的叫“户号”加上映射层之后只需要改配置文件不用改代码实用性提升不少。4.3 主流程执行步骤第一步准备数据。把从营销系统导出的用户用电数据整理成统一格式至少包含用户编号、抄表日期、用电量三个字段。如果有电流数据就一并放进去判定会更准确。第二步运行main.py。直接命令行执行python main.py --input 用户用电数据.xlsx --config config.yamlmain.py内部会按顺序调用三个模块先清洗数据再执行判定最后导出结果。执行期间会在控制台打印进度和关键统计信息。第三步查看结果。程序运行完会生成一个带时间戳的Excel文件里面是识别出的疑似漏电用户名单按嫌疑度从高到低排列。4.4 参数计算示例为了让大家更直观理解判定过程我模拟一个案例。假设台区有100个用户某月线损率高达12%明显偏高。提取用户的数据后发现用户编号为“BJ-1023”的一户火线电流长期在5A左右零线电流只有2.5A差值2.5A远超0.5A阈值前6个月平均用电量180度最近3个月平均只有60度下降67%近两个月用电量为0这个用户的三个维度全部命中得分403030100分直接判定为高度疑似漏电用户。现场核查后发现这户的厨房插座线路老化破损对地泄漏严重每个月泄漏约90度的电量。这个案例说明多维度的交叉验证确实有用单一维度的判断很容易漏掉真实异常。5. 常见问题与排查技巧实录5.1 问题一pandas读取Excel时报错这个太常见了。报错信息大概是ModuleNotFoundError: No module named openpyxl或者ImportError。原因很简单openpyxl没装。解决方案pip install openpyxl另外一个坑是文件路径带中文有些环境会报编码错误。解决办法是在代码开头加import sys sys.path.append(r文件所在目录路径)或者在读取文件时用绝对路径。5.2 问题二判定结果误报率高先用上线的第一周做验证。我自己的经验是拿到最初识别结果后抽10%的用户去现场核查根据核查结果动态调整config.yaml里的阈值。比如默认电流差阈值是0.5A如果核查发现不少正常用户也超过了这个值就适当调高到0.8A或1.0A反之如果漏报了就调低。调整周期大概持续两三轮就能找到适合自己台区特征的参数组合。不同地区的用电习惯、线路状况差异很大所以这个调参过程不可省略。5.3 问题三数据量太大程序跑得慢几千用户的数据量pandas处理起来毫无压力但如果数据量上到几十万行groupby操作会开始变慢。我的优化方案是先按台区切分每个台区单独一个DataFrame并行处理。用Python自带的concurrent.futures模块就能实现简单的多进程并行from concurrent.futures import ProcessPoolExecutor def process_batch(area_data): return detect_leakage_users(area_data, config) with ProcessPoolExecutor(max_workers4) as executor: results executor.map(process_batch, area_groups)实测下来四进程并行处理百万行数据能从半小时压缩到几分钟效果非常明显。5.4 问题四判定标准过于单一有些用户漏电特征不明显单靠这三个维度可能识别不出来。我建议在二级开发时加入更多维度台区线损率日变化曲线漏电用户会导致线损率突然升高检测突变点用户用电量与变压器容量的比值异常相邻月份用电量波动与季节因子的偏离程度每个维度对应加一个打分项权重根据实际效果调整。这样整个识别系统的覆盖面更广准确率也能进一步提升。6. 项目扩展方向从漏电识别到用电异常分析这个项目的架构非常有弹性改一改判定规则和特征维度就能从漏电识别扩展成更广的用电异常分析工具。比如反窃电场景。窃电用户的行为特征是用电量长期偏低、偶尔出现大幅波动、三相电流长期严重不平衡。只需要调整detector.py里的特征计算逻辑和评分权重就能识别出疑似窃电用户。我在实际项目中做过同样的改造准确率还不错。再比如台区线损精细化治理。把每个台区的线损率按日计算结合天气、季节等外部因素做回归分析可以发现哪些台区的线损异常偏高然后结合用户级判定结果定位到具体异常用户。这是从“发现问题”到“定位问题”的完整闭环。改造的核心点在于数据加载和清洗模块基本不用动判定算法模块需要重写特征逻辑报告输出模块可以增加更多可视化图表。整个框架的重用价值很高。还有一个实用的扩展是接入实时数据。如果用电数据采集中有实时接口可以把这个脚本改成周期性任务每隔几小时自动跑一次结果推送到工作群或者生成日报。这样漏电识别就从“事后分析”变成了“实时预警”业务价值完全不一样。最后再分享一个实际操作中积累的经验这个工具上线后不要指望它一次调通就能长期稳定运行。电力数据的特点是季节性很强春秋两个季度的用电特征和冬夏完全不一样这会直接影响判定阈值的有效性。所以每过一个季度就要重新做一次阈值校准确保模型始终贴合当前的数据分布。这听起来麻烦但确实是保证长期准确率的必要动作。本文还有配套的精品资源点击获取 用Python实现漏电用户自动识别：基于数据清洗与阈值判断的异常检测实践
简介电力漏电用户自动识别Python源码包面向电力数据挖掘与智能用电分析方向的开发者与学生聚焦从用电数据中自动识别漏电用户这一典型分析场景。压缩包共15个文件大小约49KB包含完整的Python脚本.py、数据集.xls、.npy、模型文件.pkl、.model、可视化结果.png及导入说明文本.txt。其中npy文件存储预处理后的数值数组xls为原始及处理后数据表pkl/model为训练得到的树模型与网络模型png则为识别结果可视化图整体涵盖数据导入、预处理、建模、评估与展示的完整链路。已有213人学习适合正在练手数据挖掘算法、需要参考漏电用户识别完整代码与模型文件的初学者或工程师。通过这份源码可快速了解数据挖掘算法在本场景的参数选择、模式提取与模型应用过程并基于自带数据集直接运行验证节省从零搭建环境的时间。1. 项目概述这个工具到底解决什么问题先说结论这是一个基于Python开发的电力漏电用户自动识别工具核心流程是从用电数据里找出疑似漏电的用户批量输出结果省掉大量人工核对的时间。我最早接触这个需求是因为一个做台区线损治理的朋友吐槽每个月都要手动拉一堆用电数据然后用Excel筛选异常眼睛都快瞎了。漏电用户识别这事看起来简单实际做起来相当麻烦——一个台区几百户数据维度又多人工筛一遍至少要半天还容易漏。后来我帮他写了个Python脚本把整个流程自动化效果很理想。今天把我这套实现思路完整拆出来包含源码结构和关键算法供有类似需求的朋友参考。这个项目适合谁三类人电力行业从业者尤其是做台区线损、用电检查、反窃电方向的技术人员Python数据分析爱好者想找一个真实的业务分析案例练手需要批量处理结构化表格数据、做异常识别的开发者项目本身不复杂核心就是数据清洗、特征计算、阈值判断三步但每一步都有不少细节坑我会在下面逐一说明。2. 整体设计思路为什么选Python 为什么这样判断漏电2.1 技术选型的逻辑漏电识别这个场景本质上是一个“基于规则的异常检测”问题。市面上有很多重型方案比如训练一个机器学习模型来做用户行为分类但实际落地时性价比很低——样本标签难获取、模型训练成本高、业务解释性差。相反电力行业积累了非常成熟的物理判断经验这些经验完全可以转成显式的判定规则用Python实现又快又准。选Python而不是其他语言的原因很直接pandas处理表格数据极其方便尤其适合读取、清洗、聚合这种场景判定逻辑以数值计算为主Python的向量化操作性能足够后续如果要扩展现成模型、可视化分析Python生态无缝衔接我见过有人用C#或者Java写类似的工具代码量能多出两三倍而且改规则特别麻烦。Python在这个场景下就是最省力的选项。2.2 漏电判定的核心逻辑漏电用户识别的基本原理是依托台区总表和用户分表之间的关系。正常情况下台区总电量应该等于所有用户分表电量之和加上固定线损。一旦某个用户存在漏电他的分表计量会低于实际用电量导致台区统计线损明显偏高。具体到判定规则我常用的有三个维度电流平衡异常单相用户火线电流与零线电流的差值超过设定阈值说明存在对地泄漏电流。这个特征最直接但前提是采集数据里有零线电流字段。电量波动异常用户在某个时间段内用电量明显低于自身历史水平同时台区线损率同步上升。这种情况大概率是漏电导致计量偏低。分时分相对比异常三相用户可以对比三相电流的平衡度如果某一相电流明显异常结合其他两相判断是否存在单相漏电。三个维度可以单独用也可以组合加权。实际项目中我建议至少两个维度同时命中才判定为疑似漏电否则误报率会很高。2.3 为什么不做“一刀切”的固定阈值这里有个非常重要的经验不要用一个固定阈值打天下。不同台区、不同季节、不同用户类型的用电特征差异巨大。比如夏天农排用户用电量很大冬天的空房用户几乎不用电同样的阈值判断结果完全是两回事。所以我的方案里把判定参数全部做成可配置的同时内置了一套默认经验值用户可以根据自己的实际数据调整。这个设计一开始就要想好否则后面调参的时候会特别痛苦。3. 源码结构详解每个文件干了什么整个项目的源码结构非常清晰主程序加两个辅助模块总共没几个文件power_leakage_detector/ ├── main.py # 主入口调度整个流程 ├── data_loader.py # 数据加载与清洗模块 ├── detector.py # 漏电判定核心算法模块 ├── report.py # 结果导出模块 ├── config.yaml # 判定参数配置 ├── requirements.txt # 依赖包清单 └── README.md # 使用说明3.1 data_loader.py数据清洗是重头戏这个模块负责读取用户上传的用电数据支持Excel和CSV两种格式并完成数据清洗。数据清洗之所以放在最前面是因为实际拿到的数据往往非常脏不处理的话后面全是错。# data_loader.py 核心代码片段 import pandas as pd def load_electricity_data(file_path): 加载用电数据文件支持Excel和CSV if file_path.endswith(.xlsx) or file_path.endswith(.xls): df pd.read_excel(file_path) elif file_path.endswith(.csv): df pd.read_csv(file_path) else: raise ValueError(不支持的文件格式请使用Excel或CSV文件) df clean_data(df) return df def clean_data(df): 数据清洗处理缺失值、重复值、异常值 # 1. 删除完全重复的行 df.drop_duplicates(inplaceTrue) # 2. 处理缺失值用户编号和抄表日期必须存在否则删行 df.dropna(subset[用户编号, 抄表日期], inplaceTrue) # 3. 电量字段缺失用0填充代表该月未用电 df[用电量].fillna(0, inplaceTrue) # 4. 用电量负数直接置为0 df.loc[df[用电量] 0, 用电量] 0 # 5. 日期字段统一格式 df[抄表日期] pd.to_datetime(df[抄表日期], errorscoerce) return df清洗逻辑里有几个细节需要注意。填充缺失电量用0是基于“未用电”的假设但对于长期零电量的用户反而可能是采集失败或漏电的迹象所以后面算法里专门有一个指标来处理这种情况。日期解析用errorscoerce是为了防止脏数据导致程序崩溃但解析成NaT的行要单独标记出来在判定阶段排除掉。3.2 detector.py判定算法的核心实现这是整个项目的灵魂。基于前面说的三个判定维度我实现了一个综合评分机制每个维度打一个可疑分最后加权求和超过阈值判定为疑似漏电用户。# detector.py 核心代码片段 import pandas as pd import numpy as np def detect_leakage_users(df, config): 漏电用户识别主算法 :param df: 清洗后的用电数据 :param config: 配置参数 :return: 疑似漏电用户列表及详情 results [] # 按用户分组处理 for user_id, group in df.groupby(用户编号): score 0 reasons [] # 维度1电流不平衡检测 if 火线电流 in group.columns and 零线电流 in group.columns: current_diff abs(group[火线电流] - group[零线电流]) if current_diff.max() config[current_diff_threshold]: score 40 reasons.append(f电流不平衡最大差值{current_diff.max():.2f}A) # 维度2用电量波动检测 mean_consumption group[用电量].mean() recent_consumption group[用电量].iloc[-3:].mean() if mean_consumption 0: drop_ratio (mean_consumption - recent_consumption) / mean_consumption if drop_ratio config[drop_ratio_threshold]: score 30 reasons.append(f电量下降{drop_ratio*100:.1f}%) # 维度3连续零电量检测 zero_count (group[用电量] 0).sum() if zero_count config[max_zero_count]: score 30 reasons.append(f连续{zero_count}个月零电量) # 判断是否疑似漏电 if score config[score_threshold]: results.append({ 用户编号: user_id, 可疑得分: score, 可疑原因: ; .join(reasons), 平均用电量: mean_consumption }) return pd.DataFrame(results)这个评分机制是我在实际项目中反复调出来的关键点在于电流不平衡权重最高40分因为这是漏电最直接的物理特征电量波动和连续零电量的权重略低各30分作为辅助判断综合得分70分以上才判定为疑似漏电有效降低误报不要小看这个评分机制的设计。单纯用“与”逻辑做判断条件太多会导致漏报条件太少会导致误报。评分制的好处是可以灵活调整各个特征的权重适配不同场景。3.3 report.py结果输出要让人看得懂算法跑完之后结果输出同样重要。我做了两种输出格式# report.py 核心代码片段 import pandas as pd from datetime import datetime def export_result(results_df, output_formatexcel): 导出识别结果 timestamp datetime.now().strftime(%Y%m%d_%H%M%S) if output_format excel: output_path fleakage_users_{timestamp}.xlsx with pd.ExcelWriter(output_path) as writer: results_df.to_excel(writer, sheet_name疑似漏电用户, indexFalse) return output_path elif output_format csv: output_path fleakage_users_{timestamp}.csv results_df.to_csv(output_path, indexFalse, encodingutf-8-sig) return output_path这里有一个细节CSV输出必须用utf-8-sig编码不然用Excel打开中文会乱码。很多人踩过这个坑我特意写在这里提醒一下。另外我还在结果里额外加了两列辅助字段嫌疑度排序和复核建议。嫌疑度按得分从高到低排列复核建议根据得分区间给出“现场核查”“重点监测”“加强抄表”等不同操作指引。这样业务人员拿到结果就能直接安排工作不用再自己分析。4. 完整实操流程从原始数据到识别报告4.1 环境准备首先需要安装Python环境建议用3.8以上版本。然后安装依赖包pip install pandas openpyxl pyyaml这里说明一下为什么需要这几个包pandas数据处理的核心库读取Excel、做分组聚合全靠它openpyxlpandas读取Excel文件的后端引擎必须安装pyyaml解析config.yaml配置文件用建议创建一个虚拟环境来安装这些依赖避免污染系统Python环境。用venv或者conda都行看个人习惯。4.2 配置文件详解config.yaml是整个工具灵活性的关键我不建议把参数硬编码在代码里。下面是我默认的配置# config.yaml # 判定参数配置 current_diff_threshold: 0.5 # 电流不平衡阈值安培 drop_ratio_threshold: 0.5 # 用电量下降比例阈值 max_zero_count: 6 # 连续零电量月份数阈值 score_threshold: 70 # 判定疑似漏电的综合得分阈值 # 数据字段映射 field_mapping: 用户编号: 用户编号 抄表日期: 抄表日期 用电量: 用电量 火线电流: 火线电流 零线电流: 零线电流这些默认值怎么来的我拿真实台区数据跑过很多次统计正常用户和已知异常用户的特征分布取了一个区分度比较高的分界点。比如电流不平衡阈值0.5A意味着火零线电流差半安培以上才认为异常。正常情况下单相用户火零线电流几乎是一致的差0.5A说明大约有110瓦左右的功率泄漏到地上了这已经足够引起注意。配置里还加了字段映射。因为不同电力局的表格字段命名可能不一样有的叫“用户号”、有的叫“户号”加上映射层之后只需要改配置文件不用改代码实用性提升不少。4.3 主流程执行步骤第一步准备数据。把从营销系统导出的用户用电数据整理成统一格式至少包含用户编号、抄表日期、用电量三个字段。如果有电流数据就一并放进去判定会更准确。第二步运行main.py。直接命令行执行python main.py --input 用户用电数据.xlsx --config config.yamlmain.py内部会按顺序调用三个模块先清洗数据再执行判定最后导出结果。执行期间会在控制台打印进度和关键统计信息。第三步查看结果。程序运行完会生成一个带时间戳的Excel文件里面是识别出的疑似漏电用户名单按嫌疑度从高到低排列。4.4 参数计算示例为了让大家更直观理解判定过程我模拟一个案例。假设台区有100个用户某月线损率高达12%明显偏高。提取用户的数据后发现用户编号为“BJ-1023”的一户火线电流长期在5A左右零线电流只有2.5A差值2.5A远超0.5A阈值前6个月平均用电量180度最近3个月平均只有60度下降67%近两个月用电量为0这个用户的三个维度全部命中得分403030100分直接判定为高度疑似漏电用户。现场核查后发现这户的厨房插座线路老化破损对地泄漏严重每个月泄漏约90度的电量。这个案例说明多维度的交叉验证确实有用单一维度的判断很容易漏掉真实异常。5. 常见问题与排查技巧实录5.1 问题一pandas读取Excel时报错这个太常见了。报错信息大概是ModuleNotFoundError: No module named openpyxl或者ImportError。原因很简单openpyxl没装。解决方案pip install openpyxl另外一个坑是文件路径带中文有些环境会报编码错误。解决办法是在代码开头加import sys sys.path.append(r文件所在目录路径)或者在读取文件时用绝对路径。5.2 问题二判定结果误报率高先用上线的第一周做验证。我自己的经验是拿到最初识别结果后抽10%的用户去现场核查根据核查结果动态调整config.yaml里的阈值。比如默认电流差阈值是0.5A如果核查发现不少正常用户也超过了这个值就适当调高到0.8A或1.0A反之如果漏报了就调低。调整周期大概持续两三轮就能找到适合自己台区特征的参数组合。不同地区的用电习惯、线路状况差异很大所以这个调参过程不可省略。5.3 问题三数据量太大程序跑得慢几千用户的数据量pandas处理起来毫无压力但如果数据量上到几十万行groupby操作会开始变慢。我的优化方案是先按台区切分每个台区单独一个DataFrame并行处理。用Python自带的concurrent.futures模块就能实现简单的多进程并行from concurrent.futures import ProcessPoolExecutor def process_batch(area_data): return detect_leakage_users(area_data, config) with ProcessPoolExecutor(max_workers4) as executor: results executor.map(process_batch, area_groups)实测下来四进程并行处理百万行数据能从半小时压缩到几分钟效果非常明显。5.4 问题四判定标准过于单一有些用户漏电特征不明显单靠这三个维度可能识别不出来。我建议在二级开发时加入更多维度台区线损率日变化曲线漏电用户会导致线损率突然升高检测突变点用户用电量与变压器容量的比值异常相邻月份用电量波动与季节因子的偏离程度每个维度对应加一个打分项权重根据实际效果调整。这样整个识别系统的覆盖面更广准确率也能进一步提升。6. 项目扩展方向从漏电识别到用电异常分析这个项目的架构非常有弹性改一改判定规则和特征维度就能从漏电识别扩展成更广的用电异常分析工具。比如反窃电场景。窃电用户的行为特征是用电量长期偏低、偶尔出现大幅波动、三相电流长期严重不平衡。只需要调整detector.py里的特征计算逻辑和评分权重就能识别出疑似窃电用户。我在实际项目中做过同样的改造准确率还不错。再比如台区线损精细化治理。把每个台区的线损率按日计算结合天气、季节等外部因素做回归分析可以发现哪些台区的线损异常偏高然后结合用户级判定结果定位到具体异常用户。这是从“发现问题”到“定位问题”的完整闭环。改造的核心点在于数据加载和清洗模块基本不用动判定算法模块需要重写特征逻辑报告输出模块可以增加更多可视化图表。整个框架的重用价值很高。还有一个实用的扩展是接入实时数据。如果用电数据采集中有实时接口可以把这个脚本改成周期性任务每隔几小时自动跑一次结果推送到工作群或者生成日报。这样漏电识别就从“事后分析”变成了“实时预警”业务价值完全不一样。最后再分享一个实际操作中积累的经验这个工具上线后不要指望它一次调通就能长期稳定运行。电力数据的特点是季节性很强春秋两个季度的用电特征和冬夏完全不一样这会直接影响判定阈值的有效性。所以每过一个季度就要重新做一次阈值校准确保模型始终贴合当前的数据分布。这听起来麻烦但确实是保证长期准确率的必要动作。本文还有配套的精品资源点击获取