目录
- 车牌检测 YOLOv5n(keremberke) 完全指南:原理、TigerPro 接入、代码实战与落地案例(`keremberke-yolov5n-license-plate`)
- 1. 开篇:这个模型解决什么问题
- 0.1 阅读路线(3 分钟 / 30 分钟)
- 1.1 目标检测在业务里真正交付什么
- 1.2 输出如何被下游消费
- 1.3 复杂度与评测口径(加分项)
- 1.4 适合用 / 不适合用
- 2. 模型名片与能力边界
- 2.1 规格速查表
- 2.2 输入输出约定(实施视角)
- 2.3 资源与性能预期(经验区间,需本机实测)
- 3. 在 TigerPro 架构中的位置
- 3.1 与同分类模型的关系
- 3.2 和平台其它模块怎么接线
- 4. 使用教程:从零跑通到可验收
- 4.1 准备权重(最容易翻车的一步)
- 4.2 业务页操作清单
- 4.3 列出并校验模型(必跑)
- 4.4 业务调用示例
- 4.5 命令行与前端选型
- 4.6 推荐调参表
- 5. 落地案例(可照着做)
- 5.1 主案例:轻量车牌检测
- 5.2 对照案例:同场景换模型会怎样
- 5.3 验收表(复制到飞书/表格)
- 5.4 小故事:一次真实风格的排障路径(围绕 `keremberke-yolov5n-license-plate`)
- 6. 优缺点、风险与替代
- 7. 避坑清单(排障优先级)
- 8. 工程化建议与监控
- 8.1 部署检查清单
- 8.2 日常观察
- 8.3 安全与合规
- 9. 常见问题 FAQ
- 10. 文末互动
- 11. 下篇预告
- 12. 参考资料
- 13. 原理深化与可视化(技术深度)
- 13.1 为什么「能出结果」不等于「可上线」
- 13.2 建议的对照实验设计(可直接抄)
- 14. 数据配方与样本工程
- 14.1 最小可行样本集(MVP)
- 14.2 标注与真值
- 14.3 域偏移应对
- 15. 性能压测与容量规划
- 15.1 压什么
- 15.2 简易压测脚本思路
- 15.3 容量经验法则
- 16. 生产发布 SOP(可打印)
- 16.1 发布前(针对 `keremberke-yolov5n-license-plate`)
- 16.2 发布中
- 16.3 发布后
- 17. 与 TigerPro 模块联调要点
- 18. 进阶 FAQ 与决策树
- 18.1 选型决策树(文字版)
- 19. 本篇速查卡(可裁剪转发)
- 附录补强 1:落地时的沟通话术、分工与复盘
车牌检测 YOLOv5n(keremberke) 完全指南:原理、TigerPro 接入、代码实战与落地案例(keremberke-yolov5n-license-plate)
系列:TigerPro AI 模型手册(5/110)· 分类:交通车辆
你能带走什么:原理边界、规格表、完整接入步骤、可运行代码、双案例、调参表、避坑与验收清单。
适用读者:CV_PyhonVue_Tigerpro 研发 / 实施 / 算法联调同学。
github地址:Tiger AI Plateform项目采用Apache License 2.0开源协议发布;请合法合规使用;github地址:https://github.com/5758703
1. 开篇:这个模型解决什么问题
YOLOv5n 车牌定位(keremberke)。车辆追踪兼容项,经专用加载器推理。
一句话记忆:车牌检测 YOLOv5n(keremberke)的modelKey是keremberke-yolov5n-license-plate,任务是目标检测(object-detection),前端主要在车辆追踪(/ai/vehicle),典型场景是「轻量车牌检测」。如果你只想最快跑通:先保证权重目录非空,再在对应业务页下拉选中本模型,用 5~10 条真实样本冒烟。
0.1 阅读路线(3 分钟 / 30 分钟)
| 你的目标 | 建议阅读 |
|---|---|
| 今天就要跑通 | 第 2 章规格表 + 第 4 章步骤与代码 |
| 本周要上线 | 再加第 5~8 章案例、避坑、监控 |
| 要写技术方案/发博文 | 全文,尤其第 13~19 章深度与 SOP |
本篇是 TigerPro 模型手册第5/110篇,聚焦单一 modelKey,避免把 110 个模型揉进一篇「大而空」的清单文。
1.1 目标检测在业务里真正交付什么
车牌检测 YOLOv5n(keremberke)(keremberke-yolov5n-license-plate)属于目标检测:对每一帧输入输出一组框( x 1 , y 1 , x 2 , y 2 ) (x_1,y_1,x_2,y_2)(x1,y1,x2,y2)、类别 id/名称与置信度s ∈ [ 0 , 1 ] s\in[0,1]s∈[0,1]。检测不是「看图说话」,而是把非结构化像素变成可检索、可告警、可追踪的结构化事件。在园区安防里,检测结果会进入告警规则引擎;在交通卡口里,检测框会裁剪给 OCR;在跨镜 MTMC 里,检测框是局部追踪与 ReID 提特征的唯一入口。
工程上要同时盯三件事:召回(漏检)、精度(误报)、延迟(能否跟得上抽帧)。三者互相拉扯——把 conf 提到0.6 0.60.6误报下降但漏检上升;把分辨率提到 1080p 精度更好但 CPU 吃紧。TigerPro 建议先用默认参数跑通链路,再用验收表做网格搜索,而不是一上来「玄学调参」。
1.2 输出如何被下游消费
常见下游有四类:① 可视化叠加(监控墙 MJPEG);② 事件入库(检测记录/告警);③ 二次模型(车牌 OCR、姿态、分割);④ 追踪关联(ByteTrack/IoU + 全局 ReID)。因此选检测模型时,不要只看 COCO mAP,还要看「小目标」「遮挡」「夜间」是否覆盖你的摄像头视角。
1.3 复杂度与评测口径(加分项)
单帧推理可粗写为T f r a m e ≈ T p r e + T n e t + T n m s T_{\mathrm{frame}} \approx T_{\mathrm{pre}} + T_{\mathrm{net}} + T_{\mathrm{nms}}Tframe≈Tpre+Tnet+Tnms。其中 NMS 在候选框数为n nn时近似O ( n log n ) O(n\log n)O(nlogn)到O ( n 2 ) O(n^2)O(n2)量级,密集人群会放大后处理占比。业务验收请同时报:mAP@0.5、漏检率、P95 延迟、每小时误报条数——四者缺一,线上扯皮成本极高。
1.4 适合用 / 不适合用
| 更适合 | 不太适合 |
|---|---|
| 业务明确需要 目标检测,且已有或可采集对应样本 | 期望「一个模型包打天下」跨任务硬套 |
| 能接受本地权重部署与 TigerPro 页面选型 | 权重无法落地、只能纯云端且无替代接口 |
| 需要与告警/追踪/MTMC/OCR 等模块组合 | 只要一次性演示、不愿做验收与监控 |
| 愿意维护金标集与版本回滚 | 拒绝记录指标、只凭主观「看起来行」 |
选型时把keremberke-yolov5n-license-plate放进「候选短名单」,用同一批样本对比同分类相邻模型的延迟与误差,再锁生产版本。短名单建议不超过 3 个 modelKey,否则对照实验会拖成月度项目。
2. 模型名片与能力边界
2.1 规格速查表
| 项 | 内容 |
|---|---|
| 显示名称 | 车牌检测 YOLOv5n(keremberke) |
| modelKey | keremberke-yolov5n-license-plate |
| 业务分类 | 交通车辆 |
| 任务类型 | object-detection(目标检测) |
| 推理框架/库 | ultralytics |
| 版本标签 | v5 |
| 登记来源 | seed:_ensure_ai_model |
| 权重相对路径 | uploads/models/keremberke-yolov5n-license-plate |
| 前端入口 | 车辆追踪 →/ai/vehicle |
| 典型场景 | 轻量车牌检测 |
| 上游地址 | https://huggingface.co/keremberke/yolov5n-license-plate |
2.2 输入输出约定(实施视角)
| 维度 | 说明 |
|---|---|
| 输入 | 按任务可能是图片/视频帧/音频/文本;页面/ai/vehicle决定表单字段 |
| 输出 | 框/掩码/关键点/向量/文本/音频等;最终以后端 JSON 或文件流为准 |
| 状态 | AiModel.status 启用 + file_path 非空才可稳定推理 |
| 失败表现 | 400/空列表/回退模型/日志 traceback,优先查权重与 task |
2.3 资源与性能预期(经验区间,需本机实测)
| 环境 | 预期 | 建议 |
|---|---|---|
| 笔记本 CPU | 可冒烟,延迟可能数百毫秒到数秒 | 降分辨率/降 FPS/用 nano 或量化 |
| 服务器多核 CPU | 可小并发 | 限流 + 队列 |
| GPU | 视频与大批量更舒服 | 注意显存与多模型争用 |
3. 在 TigerPro 架构中的位置
TigerPro 的模型不是散落脚本,而是「登记 → 绑定权重 → 业务页选择 → services 推理 → 展示/告警/入库」。本模型keremberke-yolov5n-license-plate同样走这条链路。理解位置,才能在监控墙、MTMC、告警之间排障。