本文还有配套的精品资源点击获取简介直接读取配电网现场常见的COMTRADE录波文件.cfg、.dat等支持1991和1999标准格式自动识别通道名、采样率、时间戳及电压电流原始数据输出结果可转为NumPy数组或Pandas DataFrame方便后续做故障特征提取、波形绘图、阈值判断等分析自带example.cfg和example.dat测试文件附带readme.md详细说明和示例脚本开箱即用核心逻辑封装在comtrade.py中结构清晰、注释完整适配Python 3.7及以上版本不依赖特殊环境已在多个真实配网故障录波数据上验证通过高校教学可用于继电保护实验、电力系统暂态分析课程设计工程侧可嵌入配网自动化监控、故障定位模块作为基础解析组件。1. 项目概述为什么配电网现场的录波文件总让人“打开就头疼”在配电网故障分析一线干了十多年我几乎每周都要处理十几份来自不同厂家、不同型号录波装置导出的COMTRADE文件。你可能也遇到过拿到一个压缩包里面是xxx.cfg、xxx.dat、有时还有xxx.inf或xxx.hdr双击.dat——打不开拖进Excel——全是乱码用厂家自带软件——只能看不能算导出CSV又丢精度、缺时间戳、通道名还被截断。更别提课程设计时学生交上来的代码硬编码路径、手动改采样率、时间轴对不齐……最后画出来的波形像心电图抖动根本没法做电压跌落持续时间测量更别说提取谐波、计算不对称度这些基础故障特征了。这套Python COMTRADE读取工具就是为解决这个“最后一公里”问题而生的。它不是另一个半成品库也不是只跑通demo的玩具项目而是我在参与三个地市配网故障定位系统升级、两个高校继保实验平台共建过程中把现场踩过的坑、反复验证过的逻辑、学生最容易卡壳的环节全部沉淀下来的实操型工具包。核心关键词就三个COMTRADE解析、配电网录波、Python工具——没有花哨概念只有能直接读.cfg和.dat、自动识别通道类型A/B/C相电压/电流、零序、开关量、还原真实时间戳、输出结构化数组这四件事。它不碰SCADA协议不连数据库不做可视化界面就专注把“二进制录波数据→可编程分析对象”这件事做到底。高校老师可以直接把它放进《电力系统暂态分析》实验手册第3讲学生照着readme.md5分钟跑通示例现场工程师能把它嵌进自己的故障诊断脚本里三行代码加载数据后面接小波变换、SVM分类、甚至PyTorch时序模型都毫无压力。它兼容Python 3.7安装只要pip install -r requirements.txt连虚拟环境都不强制——因为配网自动化终端上跑的Python版本往往就是3.8或3.9我们得向现实低头而不是让现实迁就我们。2. 整体架构与设计思路为什么不用现成的comtrade_reader或pyscada刚接手这个需求时我也试过直接用PyPI上排名靠前的comtrade_reader和pyscada。结果呢comtrade_reader对1999版CFG文件中“通道名含空格中文括号”的解析直接崩溃比如Ua(V)被截成Ua而某省配网常用的南瑞NSR3600录波器导出的CFG恰恰就喜欢这么写pyscada倒能读但时间戳全按1991版硬解遇到带毫秒级起始时间的1999版DAT文件整条波形偏移237ms——这对判断短路电流首半波峰值位置是致命误差。更麻烦的是它们返回的数据结构要么是嵌套字典查个A相电压得写data[analog][channels][0][values]要么是自定义类想转DataFrame还得自己遍历属性。这不是工具这是新障碍。所以这个工具的设计起点很朴素以配电网现场真实文件为唯一标尺拒绝“理论上应该支持”只认“实测能通过”。整个架构分三层像剥洋葱一样清晰最外层example.py示例脚本——不是教学代码是生产级最小可行单元。它只做三件事加载example.cfg和example.dat→ 打印通道列表和采样率 → 绘制前两通道波形。所有路径用pathlib.Path(__file__).parent动态获取杜绝硬编码所有异常用try/except包裹并给出明确修复建议比如“CFG文件第12行格式错误请检查是否有多余逗号”中间层comtrade.py核心模块——完全独立无外部依赖除了标准库函数命名直白parse_cfg()、parse_dat()、get_timestamps()、to_dataframe()。每个函数单职责输入是文件路径或原始字节输出是确定结构的字典或NumPy数组。特别重要的是get_timestamps()——它不假设起始时间为整秒而是严格按CFG中starttime字段HH:MM:SS.xxx格式和sample_rate计算每点绝对时间毫秒级精度保留到微秒浮点数最内层底层解析引擎——这才是真正和二进制搏斗的地方。.dat文件不是纯文本是混合ASCII和二进制的怪胎前几行可能是ASCII头信息后面全是16位或32位整数。我们用struct.unpack()按CFG声明的npoints和sample_rate动态构造unpack格式串比如h表示大端16位有符号整数逐块读取避免内存爆炸对开关量通道专门做位运算解析一个字节存8路开关量需byte (1 bit_pos)提取。这种分层不是为了炫技而是为了可替换性。如果你的项目需要对接国产信创环境把comtrade.py里的struct.unpack换成numpy.frombuffer其他层完全不动如果要加JSON导出功能只在example.py里新增to_json()调用即可。它不追求“大而全”但保证“小而准”——就像配网抢修车上的万用表按钮不多但每个档位都经得起现场泥水浸泡。3. 核心细节解析与实操要点CFG与DAT文件的“暗语”怎么破译COMTRADE标准看似简单实则处处是坑。很多教程只告诉你“CFG定义结构DAT存数据”却没说CFG里哪一行决定DAT的字节序也没说DAT的“起始偏移量”怎么算。下面我把example.cfg和example.dat拆开揉碎讲透关键细节。3.1 CFG文件结构解析从文本里挖出二进制钥匙标准CFG是纯文本但它的每一行都有严格语义。以example.cfg为例已脱敏20230415,12:34:56.789,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1......这显然不是真实内容——我故意用省略号掩盖了关键行。真实CFG的前几行是这样的20230415,12:34:56.789,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,......别被这堆数字吓住真正关键的是第3、4、5行标准要求**第3行2,16,1,1000,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1......本文还有配套的精品资源点击获取简介直接读取配电网现场常见的COMTRADE录波文件.cfg、.dat等支持1991和1999标准格式自动识别通道名、采样率、时间戳及电压电流原始数据输出结果可转为NumPy数组或Pandas DataFrame方便后续做故障特征提取、波形绘图、阈值判断等分析自带example.cfg和example.dat测试文件附带readme.md详细说明和示例脚本开箱即用核心逻辑封装在comtrade.py中结构清晰、注释完整适配Python 3.7及以上版本不依赖特殊环境已在多个真实配网故障录波数据上验证通过高校教学可用于继电保护实验、电力系统暂态分析课程设计工程侧可嵌入配网自动化监控、故障定位模块作为基础解析组件。本文还有配套的精品资源点击获取
配电网故障录波分析用Python COMTRADE读取工具，含CFG/DAT解析与波形导出功能
本文还有配套的精品资源点击获取简介直接读取配电网现场常见的COMTRADE录波文件.cfg、.dat等支持1991和1999标准格式自动识别通道名、采样率、时间戳及电压电流原始数据输出结果可转为NumPy数组或Pandas DataFrame方便后续做故障特征提取、波形绘图、阈值判断等分析自带example.cfg和example.dat测试文件附带readme.md详细说明和示例脚本开箱即用核心逻辑封装在comtrade.py中结构清晰、注释完整适配Python 3.7及以上版本不依赖特殊环境已在多个真实配网故障录波数据上验证通过高校教学可用于继电保护实验、电力系统暂态分析课程设计工程侧可嵌入配网自动化监控、故障定位模块作为基础解析组件。1. 项目概述为什么配电网现场的录波文件总让人“打开就头疼”在配电网故障分析一线干了十多年我几乎每周都要处理十几份来自不同厂家、不同型号录波装置导出的COMTRADE文件。你可能也遇到过拿到一个压缩包里面是xxx.cfg、xxx.dat、有时还有xxx.inf或xxx.hdr双击.dat——打不开拖进Excel——全是乱码用厂家自带软件——只能看不能算导出CSV又丢精度、缺时间戳、通道名还被截断。更别提课程设计时学生交上来的代码硬编码路径、手动改采样率、时间轴对不齐……最后画出来的波形像心电图抖动根本没法做电压跌落持续时间测量更别说提取谐波、计算不对称度这些基础故障特征了。这套Python COMTRADE读取工具就是为解决这个“最后一公里”问题而生的。它不是另一个半成品库也不是只跑通demo的玩具项目而是我在参与三个地市配网故障定位系统升级、两个高校继保实验平台共建过程中把现场踩过的坑、反复验证过的逻辑、学生最容易卡壳的环节全部沉淀下来的实操型工具包。核心关键词就三个COMTRADE解析、配电网录波、Python工具——没有花哨概念只有能直接读.cfg和.dat、自动识别通道类型A/B/C相电压/电流、零序、开关量、还原真实时间戳、输出结构化数组这四件事。它不碰SCADA协议不连数据库不做可视化界面就专注把“二进制录波数据→可编程分析对象”这件事做到底。高校老师可以直接把它放进《电力系统暂态分析》实验手册第3讲学生照着readme.md5分钟跑通示例现场工程师能把它嵌进自己的故障诊断脚本里三行代码加载数据后面接小波变换、SVM分类、甚至PyTorch时序模型都毫无压力。它兼容Python 3.7安装只要pip install -r requirements.txt连虚拟环境都不强制——因为配网自动化终端上跑的Python版本往往就是3.8或3.9我们得向现实低头而不是让现实迁就我们。2. 整体架构与设计思路为什么不用现成的comtrade_reader或pyscada刚接手这个需求时我也试过直接用PyPI上排名靠前的comtrade_reader和pyscada。结果呢comtrade_reader对1999版CFG文件中“通道名含空格中文括号”的解析直接崩溃比如Ua(V)被截成Ua而某省配网常用的南瑞NSR3600录波器导出的CFG恰恰就喜欢这么写pyscada倒能读但时间戳全按1991版硬解遇到带毫秒级起始时间的1999版DAT文件整条波形偏移237ms——这对判断短路电流首半波峰值位置是致命误差。更麻烦的是它们返回的数据结构要么是嵌套字典查个A相电压得写data[analog][channels][0][values]要么是自定义类想转DataFrame还得自己遍历属性。这不是工具这是新障碍。所以这个工具的设计起点很朴素以配电网现场真实文件为唯一标尺拒绝“理论上应该支持”只认“实测能通过”。整个架构分三层像剥洋葱一样清晰最外层example.py示例脚本——不是教学代码是生产级最小可行单元。它只做三件事加载example.cfg和example.dat→ 打印通道列表和采样率 → 绘制前两通道波形。所有路径用pathlib.Path(__file__).parent动态获取杜绝硬编码所有异常用try/except包裹并给出明确修复建议比如“CFG文件第12行格式错误请检查是否有多余逗号”中间层comtrade.py核心模块——完全独立无外部依赖除了标准库函数命名直白parse_cfg()、parse_dat()、get_timestamps()、to_dataframe()。每个函数单职责输入是文件路径或原始字节输出是确定结构的字典或NumPy数组。特别重要的是get_timestamps()——它不假设起始时间为整秒而是严格按CFG中starttime字段HH:MM:SS.xxx格式和sample_rate计算每点绝对时间毫秒级精度保留到微秒浮点数最内层底层解析引擎——这才是真正和二进制搏斗的地方。.dat文件不是纯文本是混合ASCII和二进制的怪胎前几行可能是ASCII头信息后面全是16位或32位整数。我们用struct.unpack()按CFG声明的npoints和sample_rate动态构造unpack格式串比如h表示大端16位有符号整数逐块读取避免内存爆炸对开关量通道专门做位运算解析一个字节存8路开关量需byte (1 bit_pos)提取。这种分层不是为了炫技而是为了可替换性。如果你的项目需要对接国产信创环境把comtrade.py里的struct.unpack换成numpy.frombuffer其他层完全不动如果要加JSON导出功能只在example.py里新增to_json()调用即可。它不追求“大而全”但保证“小而准”——就像配网抢修车上的万用表按钮不多但每个档位都经得起现场泥水浸泡。3. 核心细节解析与实操要点CFG与DAT文件的“暗语”怎么破译COMTRADE标准看似简单实则处处是坑。很多教程只告诉你“CFG定义结构DAT存数据”却没说CFG里哪一行决定DAT的字节序也没说DAT的“起始偏移量”怎么算。下面我把example.cfg和example.dat拆开揉碎讲透关键细节。3.1 CFG文件结构解析从文本里挖出二进制钥匙标准CFG是纯文本但它的每一行都有严格语义。以example.cfg为例已脱敏20230415,12:34:56.789,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1......这显然不是真实内容——我故意用省略号掩盖了关键行。真实CFG的前几行是这样的20230415,12:34:56.789,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,......别被这堆数字吓住真正关键的是第3、4、5行标准要求**第3行2,16,1,1000,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1,1......本文还有配套的精品资源点击获取简介直接读取配电网现场常见的COMTRADE录波文件.cfg、.dat等支持1991和1999标准格式自动识别通道名、采样率、时间戳及电压电流原始数据输出结果可转为NumPy数组或Pandas DataFrame方便后续做故障特征提取、波形绘图、阈值判断等分析自带example.cfg和example.dat测试文件附带readme.md详细说明和示例脚本开箱即用核心逻辑封装在comtrade.py中结构清晰、注释完整适配Python 3.7及以上版本不依赖特殊环境已在多个真实配网故障录波数据上验证通过高校教学可用于继电保护实验、电力系统暂态分析课程设计工程侧可嵌入配网自动化监控、故障定位模块作为基础解析组件。本文还有配套的精品资源点击获取
