简介依托YOLOv8构建的交通锥桶合规摆放检测系统是一套面向计算机视觉、人工智能方向的毕业设计与课程设计完整项目包适合计科、自动化、电子信息等相关专业学生以及需要快速做目标检测落地验证的开发者参考。压缩包共8个文件包括3个Python脚本分别完成模型训练、可视化界面交互、视频检测、3个PyTorch权重文件含预训练权重与训练结果权重以及2个TXT说明文档部署说明与使用指南整体大小15.91MB解压后即可按说明运行。目前已有34人学习下载代码经测试稳定可输出核心指标曲线、混淆矩阵、F1分数曲线、精确率-召回率曲线、验证集预测结果及标签分布图适合直接支撑毕设答辩展示。项目同时打包完整数据集与可视化页面二次修改门槛低也可作为课程设计、大作业的起步模板节省从数据准备到模型落地的重复工作。1. 交通锥桶合规摆放检测真正难的不是识别而是判定道路施工现场的锥桶摆放监管要回答的是“锥桶有没有按规范摆”而不是“画面里有没有锥桶”。单纯用目标检测模型输出“检测到几个锥桶”只完成了上半场相邻间距是否超标、数量是否足够、摆放线是否平直这些都需要在检测框基础上重新用规则判断。基于YOLOv8的交通锥桶合规摆放检测系统做的就是“检测 规则判定 可视化”这一整条链路用YOLOv8定位锥桶把坐标换算成距离再按施工作业要求给出合规结论最后由带界面的程序呈现结果。这套逻辑常见于道路施工安全监测和智慧工地场景也天然适合作为毕业设计或课程设计——数据集、模型训练、界面、部署教程正好覆盖一个从数据到交付的完整闭环。2. 把YOLOv8的检测框变成“合规结论”任务分解与规则判定2.1 YOLOv8的检测边界模型输出什么、不输出什么YOLOv8推理后的结果是一个(N,6)的数组N是保留的检测框数量6列分别是x1, y1, x2, y2, conf, cls。检测框坐标对应输入图像的像素位置置信度表示“这里有一个锥桶”的概率。它的任务边界非常明确负责告诉你锥桶在哪但不负责告诉你“这个锥桶和下一个锥桶之间的距离是否超标”。这是很多第一次做合规检测的人踩坑的地方——试图把“合规”当成一个类别直接训进网络。合规与否取决于物体间的相对位置模型在推理时看到的是整张图片的特征理论上能学但需要大量正负样本才能稳定区分“间距略大”和“间距超标”数据成本极高且换了场地规则就要重新训练。相比之下更可靠的工程做法是YOLOv8负责检测规则引擎负责判定两层通过坐标对接。这也是我拆解这类系统时默认采纳的分层方案。2.1.1 C2f结构与DFL对锥桶检测的实际影响YOLOv8的主干网络里用C2f模块替代了早期版本的C3。C2f会把输入分成两支一支直接卷积另一支经过多个Bottleneck后做拼接梯度传播路径比C3更丰富。对锥桶这种外观结构简单、但经常密集出现的目标C2f的收敛速度比前代更快不必在结构层面额外做复杂的特征融合设计。如果数据集里大量存在远景小锥桶优先通过提高输入分辨率和增加小目标增强来解决成本比改动C2f低得多。检测头方面YOLOv8使用了解耦头和DFL损失。DFL让网络学习物体四条边的位置分布而不仅是回归一个距离值对锥桶这种尺寸跨度大的目标预测框稳定性更好。需要记住的是这个系统最终效果不取决于模型的峰值精度而取决于检测框落得准不准——后续间距计算完全依赖框的底部中心点框偏了后处理规则再严谨也算不出正确结果。2.2 把“合规摆放”翻译成可计算的坐标规则施工作业对锥桶摆放的核心要求通常落在三件事数量是否足够、相邻锥桶间距是否在允许范围、摆放线是否平直。数量从检测结果直接统计即可间距和直线度需要把像素坐标换算成物理距离。常见的换算是用固定相机的俯视画面在地面放置已知尺寸的标定物计算像素与实际距离的比例更精确一点的做法是用单应矩阵做逆透视变换消除画面中近大远小的影响。如果只是课程设计或演示版本直接用“像素距离 × scale 常数”近似也能跑通代价是画面不同位置的误差不同判定阈值要适当放宽。我一般会在配置里保留scale参数切换摄像头或视频时不用改判定逻辑。2.2.1 取锥桶底部中心作为计算锚点锥桶顶部是尖的顶部中心受遮挡和目标形态影响大底部相对稳定。因此先写一个从检测框到落地点坐标的转换函数。import numpy as np def boxes_to_points(boxes, confs, conf_threshold0.45): 从YOLOv8检测结果提取锥桶底部中心点。 boxes: (N,4)格式为 [x1, y1, x2, y2] confs: (N,)置信度数组 points [] for box, conf in zip(boxes, confs): if conf conf_threshold: continue x1, y1, x2, y2 box cx (x1 x2) / 2.0 bottom_y max(y1, y2) # 图像坐标系y轴向下取较大值 points.append((cx, bottom_y, conf)) return points代码逻辑说明max(y1, y2)取检测框下边缘作为锥桶接触地面的位置因为YOLOv8输出的(x1,y1)是左上角、(x2,y2)是右下角。统一用底部中心计算间距可以避免锥桶顶部倾斜或轻微裁切带来的坐标抖动。取点后按x坐标排序依次计算相邻点的欧氏距离。2.2.2 间距、数量与直线度的判定实现def judge_cones(points, scale1.0, expected_count10, min_spacing3.0, max_spacing8.0, max_lateral_offset0.12): 对锥桶摆放做规则判定。 points: [(cx, bottom_y, conf), ...] scale: 像素到实际距离的换算系数米/像素 expected_count: 画面内预期锥桶数量 min_spacing / max_spacing: 相邻间距上下限单位米 max_lateral_offset: 摆放线横向偏差占比上限 if len(points) expected_count: return { ok: False, reason: f数量不足, 检测到{len(points)}个, 预期{expected_count}个 } pts sorted(points, keylambda p: p[0]) distances [] for i in range(len(pts) - 1): dx (pts[i1][0] - pts[i][0]) / scale dy (pts[i1][1] - pts[i][1]) / scale distances.append(np.hypot(dx, dy)) for i, d in enumerate(distances): if not (min_spacing d max_spacing): return { ok: False, reason: f间距异常, 第{i}段与第{i1}段距离{d:.2f}米, distances: distances } # 用y坐标标准差近似衡量摆放平直度 lateral_std np.std([p[1] for p in pts]) / scale line_length (pts[-1][0] - pts[0][0]) / scale offset_ratio lateral_std / max(1.0, line_length) if offset_ratio max_lateral_offset: return { ok: False, reason: f摆放不平直, 横向偏差比例{offset_ratio:.3f}, distances: distances } return {ok: True, reason: 合规, distances: distances}这里有几个参数会直接影响判定结果。expected_count需要根据相机覆盖的实际路段长度预设而不是整个施工区域的锥桶总量min_spacing和max_spacing来自施工作业规范3米到8米只是示例值用于验证跑道时一定要先确认现场要求max_lateral_offset用横向偏差占整段摆放长度的比例来过滤“歪歪扭扭”的摆放0.12意味着允许约12%的横向偏移。直线度用y坐标标准差是简化方案前提是画面中锥桶大致从左到右排列相机斜向俯视时需先做透视变换。2.3 漏检与误检会怎么传导到合规结论判定逻辑严格依赖检测框的稳定程度。一个锥桶漏检会让相邻间距显示为真实值的两倍甚至更大系统会误报“间距超标”连续几个漏检则会让数量判断直接失败。这类系统的训练数据必须把遮挡、重叠、夜间场景单列出来不能只堆“干净”的白天照片。我的建议是训练时优先保证召回率把阈值放宽宁可多检出几个疑似目标再用后处理中的conf_threshold过滤误检框在数量判断时会产生“数量过多”的提示容易被人工发现而漏检带来的间距误报排查起来更麻烦。3. 数据集与训练用YOLOv8训出能用的锥桶检测器3.1 数据集目录结构与样本组织拿到任何数据集第一步都是把它整理成ultralytics的标准目录规范否则后续训练和验证都会出问题。推荐结构如下datasets/ cones/ images/ train/ val/ labels/ train/ val/图片统一用JPEG标注文件为同名txt一行一个目标格式是class x_center y_center width height坐标值是相对图片宽高的比例范围0到1。锥桶作为单类别目标类别编号固定为0。这里容易踩的坑是只建train目录、忘记建val目录ultralytics在检测不到val时会自动从train里抽出部分样本看似能跑但验证结果不稳定无法横向对比不同训练配置。样本组织上我习惯把图片分成三类正常摆放、异常摆放间距过大、数量不足、干扰场景雨雾、夜间、逆光、锥桶被车辆遮挡。占比大约7:2:1。正常场景保证模型召回率异常和干扰场景决定合规判定在真实环境里的稳定性。单类别检测800到1500张图足够起步。数据清洗时直接把标注错误的图片从目录移走不要依赖工具去批量“修正”后者容易引入坐标格式错误。# 统计训练集图片和标注数量 find datasets/cones/images/train -type f | wc -l find datasets/cones/labels/train -type f | wc -l如果两个数字不一致说明有图片缺少标注文件或标注文件没有对应图片需要先补齐再训练。3.2 编写train.yaml并启动训练训练配置用一个yaml文件描述数据集信息# datasets/cones.yaml path: datasets/cones train: images/train val: images/val nc: 1 names: 0: cone启动命令使用ultralytics命令行即可yolo detect train datacones.yaml modelyolov8n.pt \ imgsz640 epochs150 batch16 device0 projectruns模型权重yolov8n.pt会在首次运行时自动下载。如果是GTX 1660 Ti这类显存只有6GB的显卡batch从16降到8或者继续用nano规模模型而不换yolov8s。训练完成后runs/detect/train/weights/best.pt是部署时用的权重last.pt是中断恢复用的中间产物不要直接拿去部署。训练参数按下面这组先用再根据曲线微调参数建议值说明imgsz640训练与推理保持一致改1280对小锥桶有利但显存占用增加明显epochs150单类别100到150轮足够更多轮次容易过拟合batch8-166GB显存用8训练速度不够就调小imgszpatience50验证集指标连续50轮不提升就提前停止optimizerauto让框架自动选择SGD或AdamW少调一个参数数据增强使用默认配置即可mosaic、翻转、仿射变换在这类单类别检测任务上表现稳定。如果夜间照片偏少可以在训练前用亮度抖动脚本批量增强不要在推理端做复杂预处理。3.3 用results.csv画损失函数曲线训练过程会在runs/detect/train/下生成results.csv包含train和val两侧的box_loss、cls_loss、dfl_loss以及mAP指标。需要可视化时直接用pandas读取import pandas as pd import matplotlib.pyplot as plt df pd.read_csv(runs/detect/train/results.csv) plt.plot(df[train/box_loss], labeltrain box loss) plt.plot(df[val/box_loss], labelval box loss) plt.xlabel(epoch) plt.ylabel(loss) plt.legend() plt.savefig(loss_curve.png, dpi150)判断模型是否收敛重点看val/box_loss在训练末尾是否还有大幅波动。如果val曲线持续反弹而train仍在下降说明过拟合可以提前停止。单类别锥桶检测不必过度追求mAP50-95mAP50达到0.85以上配合后处理阈值已经足够支撑合规判定逻辑。训练结束后把best.pt单独复制出来同时用pip show ultralytics记录当前框架版本换机器部署时能少走弯路。4. 可视化界面与实时推理PyQt5里的检测线程与状态面板4.1 界面要完成的三件事可视化界面的核心作用是把模型输出的坐标变成值班人员看得懂的结论。一个最低可用的版本包含三个区域左侧是视频画面右侧是检测结果表锥桶数量、当前状态、触发原因顶部是开始和停止按钮。业务逻辑只有一条每帧先做目标检测再执行合规判定最后把两个结果同时刷新到界面。界面框架建议直接用PyQt5。虽然OpenCV自带的cv2.imshow也能显示视频但它和推理循环在同一线程里界面事件处理会阻塞视频读取典型表现是拖拽窗口时画面卡顿。PyQt5的QThread和信号槽机制天然适合把推理放到工作线程再把结果发回主线程刷新。4.2 用QThread承载推理信号回传检测结果import cv2 import numpy as np from PyQt5.QtCore import QThread, pyqtSignal from PyQt5.QtGui import QImage from ultralytics import YOLO class InferenceThread(QThread): # 回传画面给主线程显示 frame_updated pyqtSignal(QImage) # 回传合规判定结果 result_updated pyqtSignal(dict) def __init__(self, model_path, video_source0, parentNone): super().__init__(parent) self.model YOLO(model_path) self.video_source video_source self.running True def run(self): cap cv2.VideoCapture(self.video_source) if not cap.isOpened(): self.result_updated.emit({ok: False, reason: 摄像头打开失败}) return while self.running and cap.isOpened(): ret, frame cap.read() if not ret: break results self.model(frame, verboseFalse)[0] boxes results.boxes.xyxy.cpu().numpy() confs results.boxes.conf.cpu().numpy() points boxes_to_points(boxes, confs) info judge_cones(points) info[count] len(points) frame self.draw_status(frame, info) self.frame_updated.emit(self.to_qimage(frame)) self.result_updated.emit(info) cap.release() def stop(self): self.running False self.wait() staticmethod def to_qimage(cv_frame): rgb cv2.cvtColor(cv_frame, cv2.COLOR_BGR2RGB) h, w, ch rgb.shape return QImage(rgb.data, w, h, ch * w, QImage.Format_RGB888).copy() staticmethod def draw_status(frame, info): status OK if info[ok] else NOT OK color (0, 200, 0) if info[ok] else (0, 0, 255) cv2.putText(frame, status, (30, 50), cv2.FONT_HERSHEY_SIMPLEX, 1.2, color, 2) return frame代码里有三个关键点。第一boxes.xyxy.cpu().numpy()把GPU上的张量搬到CPU避免在遍历坐标时反复触发CUDA同步拖慢推理速度。第二to_qimage里的.copy()不能省QImage本身不持有底层数据不加copy的话信号传递完成后OpenCV缓冲区一释放界面画面就会花屏。第三视频源是真实摄像头时cap.open()失败要立刻发错误信号否则窗口会一直黑屏用户会误以为程序卡死。4.3 状态面板的刷新方式主窗口槽函数只负责刷新控件不要在槽里再做模型推理。示例连接方式如下self.thread.result_updated.connect(self.update_status) def update_status(self, info): if info[ok]: self.label_status.setText(合规) self.label_status.setStyleSheet(color: green;) else: self.label_status.setText(不合规: info[reason]) self.label_status.setStyleSheet(color: red;) self.label_count.setText(f检测到锥桶: {info.get(count, 0)} 个)result_updated每帧都会触发一次信号如果信号频率过高导致界面控件刷新频繁可以在judge_cones后加一个简单的节流逻辑例如只在状态发生变化时emit一次result_updated。这个细节在长时间连续运行场景下能明显降低界面线程的CPU占用。5. 部署验证与改进环境固化、损失曲线与边界场景5.1 先钉死环境再交付部署环节最常见的问题不是模型效果差而是torch和CUDA版本不匹配换一台机器就报import torch失败。推荐用conda创建独立环境conda create -n cones python3.10 -y conda activate cones pip install ultralytics8.2.0 opencv-python4.9.0.80 pyqt55.15.10没有NVIDIA显卡的机器安装CPU版torch即可单帧推理延迟在300到600毫秒之间作为毕设或课程设计演示可以接受。有GTX 1060或1660 Ti这类显卡时把推理切成半精度能白拿30%到50%的性能提升model YOLO(best.pt) results model(frame, halfTrue, device0)注意halfTrue只在CUDA设备上生效CPU设备会报错或忽略该参数。5.2 用一条命令验证部署成功部署完成后先跑一个不带界面的推理命令排除界面代码干扰yolo predict modelbest.pt sourcetest.mp4 saveTrue conf0.4能正常生成runs/detect/predict下的结果图说明模型加载、视频解码、后处理链路都正常。之后再把视频接入界面程序手动打印info字典检查合规判定结果。验收时我会关注三个指标首帧加载时间、平均单帧延迟、进程内存变化。内存持续增长到1GB以上时优先怀疑UI中积压了未释放的QImage而不是模型内存泄漏。5.3 对合规判定做离线回归测试合规判定逻辑不需要每次都跑视频。从测试图片目录批量跑一遍能快速验证阈值调整是否生效from pathlib import Path from ultralytics import YOLO model YOLO(best.pt) for img_path in Path(test_images).glob(*.jpg): results model(img_path, verboseFalse)[0] boxes results.boxes.xyxy.cpu().numpy() confs results.boxes.conf.cpu().numpy() info judge_cones(boxes_to_points(boxes, confs)) print(f{img_path.name}: {info[reason]})调整间距阈值或数量阈值后离线回归能立刻看出哪些历史样本的结论变了。阈值参数建议放到独立config文件中离线脚本和界面程序共同引用改动时只动一处。实际交付时我会再把上面几项检查拼成一个deploy_check.sh脚本每台新机器部署后运行一次输出PASS/FAIL这比任何口头说明都直接。本文还有配套的精品资源点击获取