风力机缺陷检测数据集3687张图：VOC+YOLO双格式与YOLOv8训练实践

简介面向风力机叶片缺陷检测任务这份VOCYOLO双格式数据集适合计算机视觉入门者、风机巡检算法研发工程师及目标检测方向研究生使用。数据集说明包含3687张风机图片每张均配套Pascal VOC格式xml与YOLO格式txt标注统一为defect单一类别矩形框总数为12220个标注工具为labelImg按类别画矩形框规则明确可直接用于YOLO、Faster R-CNN等模型训练与评估。压缩包文件列表统计共2000个文件以xml标注文件为主1999个xml另含1个txt说明整体90.46MB解压使用方便未提供分割路径可按需自行划分训练集与验证集。已有581人学习浏览尤其适合需要风机缺陷数据集快速搭建实验、进行数据格式转换或复现检测流程的开发者。需要说明的是资料提供准确合理的标注但对训练所得模型权重精度不作保证。1. 风力机缺陷检测数据集3687张图、1个类别为什么双格式是关键风力机缺陷检测损伤检测数据集VOCYOLO格式3687张1类别听起来是个普通的物资包但真正在无人机巡检、叶片外观检测里做过落地的人会明白这个组合是风电场视觉检测最缺的东西现场真实图、一致的标注框、开箱即用的双格式标签。它不是一堆图片而是一份能让检测模型从零起步的训练资产。风机缺陷图像和通用目标检测数据的最大区别是背景乱、目标小、缺陷稀疏。叶片可能占满整图一道裂纹只有几十个像素塔筒锈蚀和背景锈斑混在一起人眼都要贴近看。所以3687张只配1个类别比7个类别每类500张更实用——模型只需要区分“损伤区域”和“正常表面”边界清晰收敛也快。适合刚开始做工业缺陷检测的学生和工程师也适合用少量数据快速验证YOLO流程的团队。2. 把7z包变成可用训练集解压、目录检查与数据体检2.1 Linux 下解压 7z 的标准姿势拿到“风力机缺陷检测损伤检测数据集VOCYOLO格式3687张1类别.7z”这种压缩包第一步不是急着看图片而是把它解到一个结构干净的目录里。常见做法是建一个wind_turbine_defect/工作目录压缩包放进去然后统一解压。这里先要确认系统装了 p7zip因为很多轻量 Linux 环境默认只带unzip遇到 7z 会直接懵。先确认系统有没有装 p7zip# Debian/Ubuntu 系安装 7z 工具 sudo apt update sudo apt install -y p7zip-full # CentOS/RHEL 系安装 # sudo yum install -y p7zip p7zip-plugins安装后验证7z --help | head -10输出里有7-Zip [64]或类似版本信息就说明可用。注意p7zip不带 full只支持解压 7z不支持创建和部分加密特性务必装p7zip-full后续如果要把数据集重新压缩成 7z 发给队友也要靠它。装好后执行解压7z x wind_turbine_defect_3687.7z -o./wind_turbine_defect # -o 后不要写空格逻辑说明x是解压并保留目录结构-o指定输出目录。为什么强调-o和参数之间不能有空格很多新手在这里把目录名写进了选项导致 7z 把压缩包解到当前目录文件散落一地。如果作者在发布页单独给了解压密码用-p传入没有密码就正常解压不需要理会“7z 必须加密码”的说法。解压完成后先别急着删压缩包留着它做完整性比对后文避坑章节会细说原因。2.2 解压后的目录体检VOC 和 YOLO 文件夹长什么样解压完成后先看顶层目录结构cd wind_turbine_defect find . -maxdepth 2 -type d | sort一个合理的双格式数据集通常会同时存在VOC系列目录和YOLO系列目录。VOC 一侧是JPEGImages图片、AnnotationsXML 标注、ImageSets/Maintrain/val/test 划分文件YOLO 一侧是images、labels以及可选的train.txt、val.txt。如果只有图片加一个标注 CSV那就是单格式需要按后面一章的脚本自行转换。接着做两项体检。一是图片与标注数量对齐echo 图片总数: $(ls JPEGImages/*.jpg | wc -l) echo 标注总数: $(ls Annotations/*.xml | wc -l) echo YOLO标注总数: $(ls labels/*.txt | wc -l)二是检查 YOLO 格式里有没有空标注文件。空文件代表“这张图里没有目标”如果几十张图都是空的会影响训练时正负样本平衡。工业数据里负样本图有它的价值但数量要心里有数find labels -name *.txt -size 0 | wc -l逻辑说明这两步能提前揪出“图片有但标签丢”“标注框全废”这类问题。工业数据集经常是反复拷贝转存后漏文件全部对齐后再进行下一步格式处理最稳妥。数据没有经过这一步检查就进训练后面 loss 曲线异常时你会分不清是数据问题还是网络问题。如果发现ImageSets/Main里的train.txt数量和解压目录下的图片总数对不上还要继续查是不是划分文件写的是旧文件名。2.3 可视化抽查标注质量结构体检通过后推荐用 OpenCV 把标注框画回图上人工抽查 50 张。这一步能发现缩放比例错、框外溢出、类别标错这三类标注问题。训练一个目标检测模型的成本很高但 50 张可视化检查只要几分钟这是性价比最高的质量门。import cv2, glob, os for img_path in glob.glob(JPEGImages/*.jpg): xml_path img_path.replace(JPEGImages, Annotations).replace(.jpg, .xml) # 跳过没有对应 XML 的图 if not os.path.exists(xml_path): continue img cv2.imread(img_path) from lxml import etree root etree.parse(xml_path).getroot() for obj in root.findall(object): bnd obj.find(bndbox) xmin int(float(bnd.find(xmin).text)) ymin int(float(bnd.find(ymin).text)) w int(float(bnd.find(xmax).text)) - xmin h int(float(bnd.find(ymax).text)) - ymin cv2.rectangle(img, (xmin, ymin), (xmin w, ymin h), (0, 0, 255), 2) out check/ os.path.basename(img_path) os.makedirs(check, exist_okTrue) cv2.imwrite(out, img)这段代码把每个 VOC 标注框画到原图上输出到check/目录。参数说明(0, 0, 255)是 BGR 颜色笔宽 2 像素如果图片分辨率大可以cv2.resize后再画否则 4K 图肉眼看不清楚。抽查标准是框是否紧贴缺陷区域、有没有框到背景大面积区域、有没有把叶片前缘腐蚀框成整片叶片。实际项目里我就遇到过把整个叶片根部框进去的标注模型训练出来预测框全是半片叶片这就是标注噪声的典型后果。提示如果画出的大量框都偏大说明原始标注用的多边形被转换成了外接矩形这在 1 类别缺陷检测里是可接受的但如果后续要做分割任务就得回到原始标注。3. VOC 与 YOLO 格式转换3687 张图的脚本与四个边界坑3.1 为什么双格式值得保留标题里“VOCYOLO格式”不是多余信息。VOC 用 XML 记录目标框人和机器都读得懂YOLO 用归一化坐标的 TXT训练时逐行读取。很多算法库只认其中一种比如 YOLOv8 的ultralytics原生吃 YOLO TXT而老牌检测框架和部分公开评测脚本只认 VOC XML。双格式的意义就是让你免掉“换个框架重标一遍”的重复劳动一份 7z 包内两种格式并存是做数据集的人给使用者留的后悔药。VOC 和 YOLO 坐标差异只在一点VOC 存的是绝对像素坐标xmin, ymin, xmax, ymaxYOLO 存的是归一化相对坐标center_x, center_y, width, height四个值都在 01 之间。转换公式就是简单的四则运算但真正让转换脚本翻车的是下面四个边界坑。3.2 完整的 VOC→YOLO 转换脚本import os from lxml import etree def voc2yolo(xml_path, img_dir, out_dir, class_list): root etree.parse(xml_path).getroot() # 图片宽高从 xml 的 size 节点读取不要自己去 cv2.imread size root.find(size) img_w, img_h int(size.find(width).text), int(size.find(height).text) img_name root.find(filename).text # 处理文件名带中文或带空格的情况 base os.path.splitext(img_name)[0] lines [] for obj in root.findall(object): name obj.find(name).text # 类别不在 class_list 时宁可跳过不写 unknown if name not in class_list: continue bnd obj.find(bndbox) xmin max(0, float(bnd.find(xmin).text)) ymin max(0, float(bnd.find(ymin).text)) xmax min(img_w, float(bnd.find(xmax).text)) ymax min(img_h, float(bnd.find(ymax).text)) # 框退化检查面积为零直接丢弃 if xmax xmin or ymax ymin: continue x_center (xmin xmax) / 2.0 / img_w y_center (ymin ymax) / 2.0 / img_h w (xmax - xmin) / img_w h (ymax - ymin) / img_h lines.append(f{class_list.index(name)} {x_center:.6f} {y_center:.6f} {w:.6f} {h:.6f}) out_path os.path.join(out_dir, base .txt) with open(out_path, w) as f: f.write(\n.join(lines))逻辑说明脚本里最关键的一行是宽高读取走 XML 的size节点而不是自己重新读图。为什么因为数据集作者给图做过缩放、剪切时如果只更新了 JPEG 没同步 XMLXML 里的宽高是最接近原始标注状态的反之亦然统一走一个源头才不会出现坐标和图片尺寸比例错位。max/min裁剪是为了避免极端情况下的框越界xmax xmin的丢弃条件是防守“退化框”。参数说明class_list传[defect]这种单类别列表即可输出 TXT 的每行格式是类别id 归一化中心x 归一化中心y 归一化宽 归一化高。六个小数的精度够用模型训练时不会因为精度不足产生漂移不要写%.8f导致文件体积翻倍也不要只写%.2f把小目标框精度损失掉。上面的脚本省略了目录遍历逻辑实际使用时在main里import glob对Annotations/*.xml逐个调用即可。转换完检查输出行数的总和wc -l labels/*.txt | tail -1如果总行数和 XML 里object总数相差很大参考 3.3 的边界场景排查。这一步的数字也能反过来校验原数据集标注质量如果单张图平均框数低于 0.5说明很多图是负样本训练时要考虑正负样本比例。3.3 四个边界坑坐标来源、空文件、类别名、尺寸不一致第一坑XML 里size的宽高和实际图片不一致。原因大多是数据处理阶段 resize 之后 XML 没重新写。解决转换前用脚本统一比对PIL.Image.open的size和 XML 的size不一致先修 XML 或先重出图。我一般会写一个循环把所有不一致的文件名打印出来先看一眼有多少少于 20 个就手动修多于 50 个就重新导出图片。第二坑YOLO TXT 空文件。VOC 里一张图如果没有目标转换脚本会写出空 TXT。有些用户把空 TXT 当异常清掉了导致负样本图失去“无目标”语义在验证时被误判为漏检。解决空 TXT 保留并单独统计数量。负样本图在缺陷检测里非常值钱它能教会模型“叶片干净时不要输出框”这比任何误报抑制策略都直接。第三坑类别大小写不一致。一个数据集里可能同时出现Defect和defect在class_list匹配时直接pass了。解决转换前把所有 XML 的类别名统一小写化或读取时split后统一strip()。这类问题在多人协作标注的数据集里极常见标注工具的默认类别名没对齐每个人按自己的习惯填。第四坑VOC→YOLO 和 YOLO→VOC 互转时坐标回推精度。把归一化坐标乘回img_w后要记得四舍五入不然回推的xmax可能差半个像素在评测 mAP 时出现 12 个框对不准。解决回推时用round()并做一次越界裁剪。另外注意 7z 包里的 VOC 标注和 YOLO 标注可能来自同一份标注的真值但坐标不完全一致互转后要抽几个文件人工比对别默认两者可以互相覆盖。注意这一类数据集常被拿去跑旋转框检测但标题写的是 VOCYOLO 水平矩形框转旋转框需要额外角度信息原包没有的话不必强行转换。4. 用 YOLOv8 在 3687 张图上训练损伤检测配置文件、超参与曲线判断4.1 数据集配置文件的写法假设你已经把 YOLO 格式的images/和labels/准备好了还差最后一份数据集 YAML。YOLOv8 训练自己的数据集第一步就是把这份 YAML 写对。注意这里的train和val可以写目录路径也可以写 TXT 索引文件路径两种风格ultralytics都能识别新手最容易在相对路径和绝对路径之间踩坑。# defect.yaml path: /data/wind_turbine_defect/yolo # 数据集根目录绝对路径最稳 train: images/train val: images/val nc: 1 names: 0: defect逻辑说明path的根目录下只要存在train和val子目录ultralytics会自动找对应的labels/train和labels/val也就是兄弟目录下的 TXT 文件。如果你的文件分布是train.txt、val.txt这种索引文件风格也可以写train: train.txt此时每行写图片绝对路径。参数说明nc必须和names的键数量一致0 开头的类别 id 决定 TXT 首列数值。把path写成相对路径容易出“找不到文件”的错尤其在不同容器间拷贝项目时我一般固定用绝对路径并在训练前cd到项目根目录确认一次。4.2 训练命令与关键超参yolo train datadefect.yaml modelyolov8m.pt epochs120 imgsz640 batch16 lr00.01 mosaic0.5 close_mosaic10 patience20逐项拆开讲。modelyolov8m.pt是选择预训练权重中等模型适合 3687 张这种规模v8s更快但特征表达弱v8l在小数据集上更容易过拟合。imgsz640是训练和推理的统一分辨率如果原图多在 2000 像素以上且缺陷很小可以试imgsz960代价是显存占用几乎翻倍。batch16在单张 V100 或 RTX 3090 上足够显存小于 24G 就降到 8batch 太小 BN 层统计量不稳这是训练后期 loss 震荡的常见来源。lr00.01是初始学习率单类缺陷任务不需要用更大的 0.05因为类别少、任务简单学习率过大容易在早期就把 loss 推到 nan。mosaic0.5表示只有一半 epoch 启用 mosaic 增强因为叶片缺陷目标小mosaic 拼图会把小目标进一步缩小close_mosaic10表示最后 10 个 epoch 关闭 mosaic让模型在正常的单图分布上微调这是防止小目标检测在最后阶段失稳的关键操作。patience20是早停验证集 mAP 连续 20 轮不涨就提前结束防止后段过拟合浪费时间。训练过程中注意看两类指标一是train/box_loss和train/cls_loss是否同步下降二是val/dfl_loss不能反弹太早。风电损伤检测里常见的 BN 崩溃现象表面是 loss 变成 nan实际原因是训练后期 BN 统计量在 mosaic 和正常图的分布切换下失稳。遇到这个情况先把batch调小到 8再关掉 mosaic 重新训练最后 20 轮。还要注意把cacheTrue加上数据量不大但图很大时缓存到内存能让每个 epoch 的时间缩短一半这是最容易忽略的提速参数。4.3 用混淆矩阵和损失函数判断 1 类别任务的真实水平训练结束后的runs/detect/trainX/confusion_matrix.png里 1 类别会显示成 2×2 加一个 background很多新手觉得混淆矩阵总和不是 1像个 bug其实这里每行是独立归一化的总和不唯一是正常的。你要盯的是 background 那列如果大量缺陷框被模型分到 background说明置信度阈值或者正负样本比有问题反过来如果背景被大量分到 defect说明模型过拟合了纹理噪声。针对 3687 张 1 类别的场景验证阶段建议直接把conf0.25压到0.05再看一遍检测结果。缺陷框小且边缘对比度低时默认阈值会把一堆“及格框”砍掉导致视觉效果很差但 mAP 并不低。用yolo predict modelbest.pt sourceval_images conf0.05输出可视化结果后再去决定后续报警阈值该定多少。损失函数曲线的判断同理box_loss 和 cls_loss 下降曲线应该是平滑递减如果出现周期性的锯齿多半是数据加载顺序里混入了噪声样本回去查标注。5. 风力机缺陷检测数据集的五个常见坑从 7z 解压报错到训练不收敛5.1 7z 解压时报“Cannot open encrypted archive”但密码明明正确现象解压命令输完报错提示无法打开加密压缩包密码复制粘贴检查过却依然失败。原因大多数情况是压缩包文件名或压缩内文件名带了非 UTF-8 编码7z 在读取时把文件名解码成了乱码你看到报错发生在读取文件列表阶段根本还没到校验密码那一步。另一种可能是压缩包在网盘传输中断文件尾部分块缺失7z 检查 CRC 失败后误报加密错误。这种情况和密码正确与否无关属于最典型的“7z 压缩文件密码是正确的但一直报错”。解决先用7z t 包名.7z跑一次性完整性测试确认包体没问题再用7z l 包名.7z查看内部文件列表如果出现乱码用7z x -mcp936或设置终端为 UTF-8 以正确解码。若传输损坏只能重新下载别在解压软件里反复试密码浪费时间。5.2 VOC 里一张图对应多张 XML 或漏 XML现象图片总数是 3687但 XML 有 3720 个多出来的几十个找不到对应图。原因数据集的标注阶段可能有重复标注文件被保留到打包目录或 XML 命名和图片名不完全一致比如图片叫img_001.jpg、XML 叫IMG_001.xml。差别只在大小写Windows 下发现不了Linux 下一秒变两个文件。还有一种可能是标注工具生成了.xml的临时备份文件文件名带~后缀。解决写脚本按统一规则重命名优先把图片名作为基准XML 文件名转成和图片一致后再比对。转换前先按 basename 取差集把多余文件移出目录避免训练时yolo因为找不到配对文件直接跳过图片。这里有一个实际经验不要直接删除多余 XML先移到quarantine/目录等确认训练正常后再清毕竟数据集的原始标注很珍贵。5.3 YOLO 训练时 image 和 label 数量对不上但没报错现象训练能启动但日志里每轮的图片数明显少于 3687跑到一半才发现 val 集数量不对。原因yolo train data...的验证集图片没有对应 TXTultralytics会把这部分图片静默过滤掉。这比 5.2 更隐蔽因为不是报错而是少数据。很多人在训练完看 mAP 时才发现验证集只有 300 张而自己明明划了 400 张这就是静默过滤的翻车现场。解决训练前用下面的脚本核对每一张图是否有同名 TXTfor img in $(cat val.txt); do lbl${img%.jpg}.txt [ -f $lbl ] || echo missing: $img done缺的按需补空 TXT 或移出验证集这一步做完再训练。我一般还会写一个 Python 脚本统计labels/val和images/val的文件数差值并打印具体缺失文件名双保险。5.4 缺陷目标太小默认输入尺寸导致大量漏检现象训练时用imgsz640验证 mAP 有 0.72但无人机实拍场景里叶片裂纹框不出来。原因风机叶片缺陷在整张画面中的像素占比常在 1% 以下imgsz640相当于把目标缩小到几个像素特征没了。模型学到的是“整片叶片”而非“裂纹”。这是小目标检测的血泪经验imgsz 设置不当mAP 再高也是假的。解决分两部分调。一是推理侧把imgsz提到 960 或 1280二是训练侧配合mosaic0和scale0.3这种更保守的增强参数让模型不要老看到被拉大缩小后的畸形目标。如果显存不够用Rect训练或切块推理把大图切成 1280 的 patch 再检测这是风电巡检里更常见的做法。切块时要注意 patch 之间留 10% 重叠防止缺陷正好被切在边缘。5.5 7z 重压缩后数据集给队友无法解压现象把 VOC 和 YOLO 目录整理好重新打 7z 包发出去队友在 Windows 上解压到一半报“头部错误”或者文件夹内路径变空。原因打包时用了7z a -mheon对文件头加密而队友的 7-Zip 版本太老不支持或者打包时写了绝对路径解压后生成一连串嵌套目录。还有一种可能是打包时把符号链接也打进去了Windows 解压时无法处理。解决打包时把工作目录切到数据集根目录的上一级用相对路径加包名cd /data 7z a -t7z wind_turbine_defect_3687.7z wind_turbine_defect/ -mx5-mx5是压缩等级默认级别并不比极限档差多少但极限档会让压缩和解压都慢一倍。要做好“发给别人能直接跑”的数据包打包前把解压后的相对路径测一遍别用绝对路径。我通常在打包前先解压到一个临时目录跑一遍校验确认没问题再发出去。6. 把 3687 张数据用到极致数据增强、badcase 回灌与置信度阈值校准数据增强对 1 类别小缺陷数据集比调网络结构更值得投资。YOLOv8 自带增强之外我建议做三类“物理层面”的增强随机亮度扰动模拟不同光照下的叶片表面随机高斯噪声模拟雨雾天气以及对叶片缺陷做局部裁剪放大后重新粘贴回原图背景。后者对本数据集尤其有效因为一张图里的缺陷往往只有一处直接用 Copy-Paste 可以把缺陷密度翻倍。实现时注意粘贴的缺陷框不要和原缺陷重叠PIL 合成后重新计算 YOLO 归一化坐标再写进 TXT跑一轮增强再跑一轮训练往往比单纯把 epochs 从 120 加到 300 更有效。badcase 回灌是另一个冷门但高收益的操作。把 val 集里模型预测错的图单独抽出来如果错误原因是目标过曝或模糊不要简单加进训练集而是对这些图做一次轻微的cv2.GaussianBlur和光照归一化作为“困难样本”放进 train 集。这样做的意义不是增加数量而是让模型在训练阶段就见过和它推理时最像的低质量输入而不是只在验证时才看到。最后是置信度阈值校准。别只盯着 mAP工业缺陷检测追求的是误报率可控。对 3687 张数据训练出的模型先在 50 张完全没有缺陷的负样本图上跑一遍统计误检框的置信度分布再在 100 张有缺陷图上统计召回框的置信度用这两条分布的交点去定最终报警阈值通常结果在 0.150.35 之间。把阈值写小会漏报写大全是误报这个交点方案比拍脑袋定conf0.25可靠得多。我的习惯是每次迭代后保留三件套训练曲线截图、验证集 badcase 汇总、阈值校准表这样任何一次改参数都有据可查。整个过程走一遍后你会发现3687 张 1 类别的数据集能支撑起一条足够可信的缺陷检测闭环剩下的就是你自己的数据收集节奏了希望帮到你。本文还有配套的精品资源点击获取