DSH HUB
HomePlugin StorePlugin PacksCommunityRankingsResourcesPublish Guide
Plugin source
Back to catalog

junchaomo /

junchaomo/dsh-traffic-counter

Topic repository only

DSH 插件 · 航拍道路断面与交叉口车流量统计(OpenVINO CPU + ByteTrack)

★ 0 Stars0 Forks0 IssuesN/A Community rating0 Confirmed installs
View on GitHub
READMESource: main@f78b6acb

交通流量分析工具(简易验证版)

DeepSeek Harness(DSH)插件 · 安装与配置

克隆本仓库后,在 DSH 的插件管理中使用 install_bundle,目标填本地克隆目录下 dsh-traffic-counter 子目录的绝对路径。侧栏面板提供统计和分析记录,视频上传、绘线和分析在 Python 工作台完成。

运行工作台需 Python 3.11。在仓库根目录执行 python -m pip install -r requirements.txt,将 YOLO26m 权重保存为 weights/yolo26m.pt,执行 python export_ov_fp32.py yolo26m 导出 OpenVINO CPU FP32 模型,再运行 python web_app.py。打开 http://127.0.0.1:5000。默认生成计数和 CSV,可在高级设置中开启标注视频。

通过航拍 / 路口监控视频自动分析车流量。基于 YOLO 检测 + ByteTrack 跟踪,采用「工作台 + 两个功能模块」的结构:

  1. 工作台(/):概览首页,提供累计/今日统计、最近分析记录、7 日趋势、服务与存储状态,以及两个模块的入口。
  2. 断面交通流量智能识别(/section):画 2 点计数线,统计穿过断面的分车型流量与 pcu。
  3. 交叉口转向交通流量智能识别(/turns):画进口道 / 出口道 ROI,统计分进口、分转向(左转 / 直行 / 右转 / 掉头)的分车型流量与时段统计。

网页版主流程:工作台选择模块 → 上传视频 → 首帧检测辅助定位 → 绘制 ROI / 计数线 → 后台实时进度分析 → 查看统计表 / 标注视频 / 事件 CSV;分析完成后工作台会自动记录本次分析。

环境

  • Python 3.11(本机 C:\Users\46198\AppData\Local\Programs\Python\Python311)
  • 依赖:pip install -r requirements.txt(ultralytics / opencv / numpy / flask / av / pillow / pandas)
  • 模型权重放在 weights/ 下:
    • 网页版默认 weights/yolo26m.pt(COCO 80 类),未下载时自动回退 yolo11n.pt / yolo11m.pt;
    • 命令行版 --model 默认 yolo11n.pt(首次运行会尝试自动下载,约 6MB)。
  • 权重下载被墙时:用国内镜像手动下载到 weights/,再用 --model 指定本地路径:
mkdir weights
curl -L -o weights/yolo11n.pt "https://ghfast.top/https://github.com/ultralytics/assets/releases/download/v8.4.0/yolo11n.pt"
python traffic_counter.py --source 视频.mp4 --model weights/yolo11n.pt

网页应用(推荐)

前后端分离:后端 web_app.py 只暴露 JSON API 与产物文件服务,前端是独立静态页面(工作台 static/workbench.html、模块一 static/index.html、模块二 static/turns.html,原生 JS,通过 fetch 调 API,结果由前端渲染)。

python web_app.py
# 工作台:          http://127.0.0.1:5000/
# 模块一(断面):  http://127.0.0.1:5000/section
# 模块二(转向):  http://127.0.0.1:5000/turns

工作台(概览首页)

  • 两个模块卡片:显示功能说明与特性标签,点击进入对应模块。
  • 概览统计:累计分析次数、今日分析、累计检测车辆、标准车当量 pcu、产物占用空间。
  • 最近分析记录(最多 12 条):时间 / 模块 / 源文件名 / 成功失败 / 总流量 / pcu,可直接打开视频、CSV、预览图。
  • 最近 7 天分析次数趋势、服务状态(模型 / 运行时长 / 监听地址)与数据目录位置。
  • 历史记录持久化在 data/history.json(本版本开始记录;旧分析不会补录),保留最近 500 条。

模块界面操作

  • 首页:上传视频(mp4/avi/mov/mkv/webm),高级设置里可调置信度 / 推理分辨率 / 隔帧数。
  • 固定查看窗口:预览区宽度 100%、高 70vh、浅灰背景;视频按自身长宽比 contain 居中,任何比例都不会撑乱布局;滚轮以鼠标为中心缩放(可滚动)、按住拖动平移;右上角按钮为漫游 / 放大 / 缩小 / 适应。
  • 首帧检测辅助:选视频后对首帧跑一次 YOLO,用浅蓝色框叠加车辆位置,方便对准车道;浏览器无法预览的格式(AVI / 多数 MKV)会明确提示改用 mp4。
  • 绘制计数线(自动编号):在车道上点击 2 个点画出橙色虚线计数线(任意角度),画完自动完成一个断面,可连续画多条并自动编号。
  • 操作模式:绘制计数线(默认)/ 删除计数线(点线删除,自动重排序号)/ 漫游(抓手平移)。
  • 命令:撤销 / 完成 / 清空;画布留白区域点击不会生成端点;两点距离过近(<5px)会提示并忽略第二个点。
  • 分析进度:分析接口以 NDJSON 流式返回(loading → 多条 progress → done/error,长时间无进度会发 keepalive),前端实时显示进度条、已扫描帧数、已用时间;分析期间锁定绘制 / 删除 / 换视频,可点「取消分析」中断,完成后自动清理上传文件。
  • 分析完成后自动删除上传的原始视频;标注视频、事件 CSV、计数线预览图保留在 outputs/(网页上传的文件名带随机前缀,不会互相覆盖)。

断面计数判定

每个断面 = 一条 2 点计数线。车辆 bbox 底边中心(接地点) 从计数线一侧翻到另一侧,且在新一侧连续稳定 2 帧才确认计数;穿越后须离开计数线约 4% 画面高度 才允许再次计数,抑制线附近抖动造成的重复/双向误判。

  • 每条计数线统计穿过的总流量(单一方向断面,不区分方向);同一 track_id 在一个断面只计 1 次。
  • 类别按同一车辆历史帧做 面积加权投票,避免远近距离导致的类别跳变(如远处误判 truck)。
  • COCO 的 truck 类别统一按 大货车 统计(模型只输出 truck 一个类别,不按检测框面积细分小 / 中 / 大),套用大货车 pcu 系数 4.0。
  • 结果页诊断:若检测到车辆但计数为 0,会提示检查计数线是否横穿道路、与车流垂直。

模块二:交叉口转向流量(/turns)

  • ROI 绘制:分别绘制「进口道 ROI」(多边形,系统自动取离交叉口中心最近的边作为该进口的 gate 虚线)、「出口道 ROI」(多边形),可选绘制「交叉口中心区域」;进口 / 出口各最多 8 个,按方位自动命名(北/东北/… 进口 / 出口)。
  • 判定流程:车辆接地点穿过进口 gate 且朝向交叉口 → 进入交叉口 → 连续 2 帧进入某个出口 ROI 确认出口 → 用“进口 gate 中点→中心”与“中心→出口质心”的夹角判定 左转 / 直行 / 右转 / 掉头。同一 track_id 只计 1 次;进口后 20 秒仍未出场则丢弃。
  • 统计结果:总流量 / pcu、左转/直行/右转/掉头、分进口道分车型 + 分转向表、时段统计(bucket_min 默认 5 分钟,可设 5/15/60)、ROI 预览图、标注视频、事件 CSV(frame,time_s,track_id,class,entry,exit,turn,pcu)。
  • 对视频的要求:进口 / 出口 ROI 要覆盖完整车道、避免相互大面积重叠;车辆需能被稳定跟踪(夜间、遮挡、过密会下降)。

API

接口 说明
GET /api/workbench 工作台概览:模块元数据、累计/今日统计、最近 12 条分析记录、7 日趋势、服务与存储信息
POST /api/preview_detect multipart:video、conf、imgsz;返回首帧车辆框归一化坐标,供前端叠加
POST /api/analyze multipart:video + sections(JSON [{"id":1,"line":[[x1,y1],[x2,y2]]}],坐标 0~1) + conf/imgsz/skip;返回 NDJSON 实时进度流
POST /api/analyze_turns 模块二:multipart video + entries/exits(JSON ROI 数组,坐标 0~1)+ center(可选 polygon)+ conf/imgsz/skip/bucket_min;返回同协议 NDJSON
GET /、/section、/turns 工作台、模块一、模块二页面
GET /files/<name> 访问 outputs/ 下已生成的产物

后端会校验参数范围(conf 0.011、imgsz 324096、skip 0100、断面 132 条、ROI 1~8 个),非法参数返回 400 JSON;服务只监听 127.0.0.1 并校验 Host/Origin,降低本机跨站请求风险。每次分析结束(成功/失败)都会写入 data/history.json,工作台据此展示概览与最近记录。

命令行版

# 路口平视视频:在画面高度 60% 处画横向计数线
python traffic_counter.py --source videos/你的视频.mp4 --mode line --line-y 0.6

# 航拍俯视视频:统计画面中央区域内进出车辆
python traffic_counter.py --source videos/你的视频.mp4 --mode zone

# 实时预览窗口(按 q 退出)
python traffic_counter.py --source videos/你的视频.mp4 --mode line --show

本机 Python 用 3.11:C:\Users\46198\AppData\Local\Programs\Python\Python311\python.exe,也可以先把它加进 PATH 后用 python 直接调用。

命令行参数

参数 默认 说明
--source 必填 视频文件路径,或摄像头索引(如 0)
--model yolo11n.pt YOLO 权重路径或模型名
--mode line line=虚拟线(路口平视);zone=区域(航拍俯视)
--line-y 0.6 计数线在画面高度中的比例位置(0~1)
--conf 0.35 检测置信度阈值,漏检调低、误检调高
--imgsz 1280 推理分辨率
--classes 1 2 3 5 7 参与计数的类别(bicycle/car/motorcycle/bus/truck)
--skip 0 隔 N 帧处理一次(0=逐帧),用于长视频加速
--show 关 弹窗实时预览
--output outputs 输出目录

命令行输出:outputs/*_annotated.mp4、*_events.csv、*_zones.png(区域模式)。网页断面模式的产物名为 *_sections.mp4 / *_sections_events.csv / *_sections.png。

服务管理(自启 / 启停)

项目目录下有 4 个双击即可用的脚本:

脚本 作用
启动服务.bat 启动服务并显示状态(等待端口就绪,最多 30s)
安装开机自启.bat 写入登录自启 VBS 并确保服务运行
停止服务.bat 停止 Web 服务
卸载自启.bat 停止服务并移除登录自启

说明:

  • 自启采用当前用户启动文件夹方案(无需管理员权限),登录后无窗口后台运行;VBS 已通过 cscript 语法验证。
  • 脚本按自身位置推导项目目录($PSScriptRoot),整体移动/复制项目后无需改脚本;Python 路径可用环境变量 TRAFFIC_COUNTER_PYTHON 指定。
  • server.ps1 手工启动时会把 stdout/stderr 重定向到 logs\web_app.out.log / web_app.err.log(每次启动覆盖,无自动轮转)。
  • 未注册 Windows 计划任务,暂不支持“进程崩溃自动重启”,异常停止后双击「启动服务.bat」即可恢复。
  • 自启效果需注销/重启或重新登录后验证;server.ps1 -Action status 可查看端口、进程、自启状态。

输出文件

文件 说明
*_sections.mp4 断面模式标注视频(检测框、计数线、实时计数)
*_sections_events.csv 断面模式事件明细(帧号 / 时间 / track_id / 车型 / 断面序号)
*_sections.png 计数线预览图(首帧 + 计数线 + 序号)
*_turns.mp4 模块二标注视频(进口/出口 ROI、gate、轨迹、转向结果)
*_turns_events.csv 模块二事件明细(帧号 / 时间 / track_id / 车型 / 进口 / 出口 / 转向 / pcu)
*_turns.png 交叉口 ROI 预览图(首帧 + 进口/出口/中心区域 + 名称)
*_annotated.mp4 / *_events.csv / *_zones.png 命令行 line / zone 模式的产物
data/history.json 工作台的历史记录(每次分析的成功/失败条目,最多 500 条;可删除重置概览)

运行结束终端会打印汇总:总通过车辆、分方向数量、小时流量(veh/h)与标准车当量(pcu/pcu/h)。

标注视频 / 预览图中的中文断面序号使用系统中文字体(Pillow)绘制,不会出现 ?????? 乱码;系统没有可用中文字体时会回退成 S1 / Zone1 等 ASCII 标签。

自检工具

工具 用途
test_counter.py 模块一计数逻辑单元测试:line/zone 判定、断面穿越/抖动/斜线、pcu 折算,无需视频
test_turns.py 模块二转向算法单元测试:合成轨迹的左/直/右/掉头判定、去重、时间桶、pcu,无需视频
test_turns_pipeline.py 模块二集成冒烟:假 YOLO + 合成视频跑通 analyze_turns 的 CSV/进度/产物/取消
test_web.py 后端接口测试:两个模块的参数校验、上传清理、NDJSON 流式协议、路径与 Host 防护,无需模型
gen_test_video.py 生成一段合成“车辆”视频,用于端到端跑通验证
detect_check.py 用现有权重对 videos/synth_traffic.mp4 首帧做车辆检测自检
python test_counter.py
python test_turns.py
python test_turns_pipeline.py
python test_web.py
python detect_check.py --video videos/synth_traffic.mp4

合成视频里的简易车形 YOLO 不一定全部识别,gen_test_video.py 主要用于验证管线能跑通;真实计数精度请用实际视频验证。

车型换算(标准车当量 pcu)

按《城市道路交通规划设计规范》表 9.2.4 的车型换算系数折算:

COCO 检测类别 对应车型 换算系数
car 小客车 / 出租车 1.0
bus 公交车 2.0(单机车基准)
truck 大货车(COCO 的 truck 统一按大货车统计) 4.0(大货车 / 集装箱)
motorcycle 摩托车 0.4
bicycle 自行车(非机动车) 0.2

模型只输出 truck 一个类别,无法可靠区分小 / 中 / 大货车,因此统一按“大货车 / 集装箱”系数 4.0 折算;公交车仅能识别为一个类别,取单机车 2.0 基准;电动自行车 / 三轮车等当前模型无法细分,不纳入统计。系数定义在 VEHICLE_PCE,可直接调整。

已知限制

  • 车速测算未实现(需相机标定)。
  • 网页版提供断面(模块一)与交叉口转向(模块二)两个功能;命令行 zone 模式与 ROI 高分辨率重检(roi_recheck)暂未在网页暴露。
  • 交叉口转向需要人工绘制进口 / 出口 ROI,且视频中的车辆轨迹需可连续跟踪;RTSP 实时流暂未接入(当前为上传视频文件)。
  • 夜间 / 强逆光 / 密集遮挡下准确率下降,属检测模型固有局限。
  • 浏览器不能解码 AVI / 部分 MKV,网页预览会提示改用 mp4;命令行后端可处理这些格式。
  • 暂不支持触摸手势;高 DPI 屏幕上画布为 CSS 像素渲染(不影响坐标精度)。
  • outputs/ 不会自动清理,长期使用请按需删除旧产物;uploads/ 会在启动时清理超过 24h 的残留上传。
  • 工作台历史从引入该功能后开始记录,之前的旧分析不会补录;删除 data/history.json 可重置概览统计。
  • 不可用于商业或盈利项目。
—/ 5

No ratings yet

Manifest verification required

Commit f78b6acbf831

Community comments

No comments yet. Be the first to write one.

DSH HUB

A community index for DSH plugins. Not an official GitHub or DeepSeek AI product.

CommunityResourcesAPIAbout