Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
31 commits
Select commit Hold shift + click to select a range
6bc5626
feat: 新增README文档和main.py主程序,完善项目结构
YDY027 Nov 23, 2025
6c586a1
实现主车辆沿道路行驶、生成NPC车辆互动及相机图像显示功能
YDY027 Dec 16, 2025
269b165
同步核心功能:1. 新增carla_tracking目录(含主车辆行驶+NPC互动+相机显示代码) 2. 旧carla tracking目…
YDY027 Dec 17, 2025
a856c14
修复:将carla_tracking从子模块转为普通目录,显示完整文件
YDY027 Dec 17, 2025
4a458bd
降低置信度阈值,保留低置信度的小目标检测结果
YDY027 Dec 17, 2025
8dd1f28
仅保留:补充carla_tracking文档和功能代码
YDY027 Dec 18, 2025
ab5ec55
刷新PR:清理button_control_vehicle和.gitignore的残留变更
YDY027 Dec 18, 2025
781feed
Merge branch 'OpenHUTB:main' into main
YDY027 Dec 18, 2025
cc379d6
Merge branch 'OpenHUTB:main' into main
YDY027 Dec 18, 2025
2b7050a
添加本地未追踪的车辆控制相关文件
YDY027 Dec 18, 2025
9cff10e
解决add/add冲突:保留远程版本的新增文件,合并远程main分支
YDY027 Dec 18, 2025
9bc6f93
恢复误修改的代码
YDY027 Dec 18, 2025
a859c8d
恢复被误删的gitignore
YDY027 Dec 18, 2025
665d5a2
解决.gitignore冲突
YDY027 Dec 18, 2025
3b67d5c
update
YDY027 Dec 18, 2025
7a27cb2
上传requirements文件
YDY027 Dec 19, 2025
49d21f3
update
YDY027 Dec 19, 2025
cdb3174
解决src/2d-carla-tracking目录冲突:同步远程版本,保留src/carla_tracking/main.py本地修改
YDY027 Dec 19, 2025
9c7ef83
解决src/2d-carla-tracking冲突,保留carla_tracking/main.py修改
YDY027 Dec 19, 2025
687e2a9
update
YDY027 Dec 19, 2025
7951f60
Merge branch 'OpenHUTB:main' into main
YDY027 Dec 19, 2025
8ea53d1
update
YDY027 Dec 19, 2025
83690ae
Update .gitignore
YDY027 Dec 19, 2025
9556632
Merge branch 'OpenHUTB:main' into main
YDY027 Dec 19, 2025
37dca6e
配置参数集中管理,修改语法错误问题
YDY027 Dec 19, 2025
fb9816c
Merge branch 'OpenHUTB:main' into main
YDY027 Dec 19, 2025
6603d65
新增了深度相机模块,并优化了跟踪器对距离信息的利用
YDY027 Dec 19, 2025
fd7093b
Merge branch 'OpenHUTB:main' into main
YDY027 Dec 19, 2025
61c6197
新增了深度相机模块,并优化了跟踪器对距离信息的利用
YDY027 Dec 19, 2025
f62cf14
Merge branch 'OpenHUTB:main' into main
YDY027 Dec 19, 2025
f0d312c
更新readme.md文件和requirements文件
YDY027 Dec 19, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 22 additions & 26 deletions src/carla_tracking/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,14 +4,14 @@
本项目实现了基于YOLOv5算法和CARLA仿真器的自动驾驶目标检测与跟踪功能。通过CARLA仿真环境生成动态交通场景,利用YOLOv5模型实时检测车辆、摩托车、公交车、卡车等交通参与者,结合内置优化版SORT跟踪算法实现目标的连续追踪,并通过OpenCV实时可视化检测与跟踪结果。

### 核心功能:
- 基于YOLOv5模型(支持yolov5s、yolov5m、yolov5x)进行实时目标检测,默认置信度阈值0.25
- 基于YOLOv5模型(支持yolov5s、yolov5m、yolov5x)进行实时目标检测,默认置信度阈值0.2
- 集成优化版SORT跟踪算法(内置实现,无需额外依赖),通过卡尔曼滤波和历史位置平滑处理,实现对检测目标的稳定跟踪,支持多目标ID持续标注
- 与CARLA仿真器深度集成,自动生成主车辆和NPC交通流,挂载RGB相机采集实时图像(分辨率640×480)
- 与CARLA仿真器深度集成,自动生成主车辆和NPC交通流,挂载RGB相机和深度相机采集实时图像(RGB相机分辨率800×600)
- 支持同步模式运行,保证检测帧率与仿真环境一致(默认0.05s/帧,20FPS)
- 实时可视化检测/跟踪结果,显示目标类别、置信度及跟踪ID,不同类别目标使用差异化颜色标注
- 实时可视化检测/跟踪结果,显示目标类别、置信度、跟踪ID、距离及速度信息,不同类别目标使用差异化颜色标注
- 引入深度信息优化:基于目标距离动态调整跟踪参数,提升不同距离目标的跟踪稳定性

## 安装步骤

### 前置条件:
- Python 3.7+(推荐3.7,与CARLA兼容性更佳)
- CARLA仿真器(支持0.9.x系列版本,版本需与Python API匹配)
Expand Down Expand Up @@ -71,11 +71,11 @@ CarlaUE4.exe

2. 运行主程序:
```bash
# 基础运行(默认yolov5m模型+SORT跟踪器)
# 基础运行(默认yolov5m模型+SORT跟踪器,启用深度增强)
python main.py

# 可选参数配置
python main.py --model yolov5x --tracker sort --host localhost --port 2000 --conf-thres 0.25 --iou-thres 0.45
python main.py --model yolov5x --tracker sort --host localhost --port 2000 --conf-thres 0.25 --iou-thres 0.45 --npc-count 20
```

3. 操作指令:
Expand All @@ -88,38 +88,39 @@ python main.py --model yolov5x --tracker sort --host localhost --port 2000 --con
- 支持检测类别:汽车(car)、摩托车(motorcycle)、公交车(bus)、卡车(truck)(对应COCO数据集ID:2、3、5、7)
- 模型选择:yolov5s(轻量快速)、yolov5m(平衡精度与速度)、yolov5x(高精度,适合对精度要求高的场景)
- 检测优化:
- 采用多帧投票机制(保留至少1帧出现的目标),提高小目标检测稳定性
- 过滤过小检测框(宽度和高度均大于8像素),减少误检
- 采用多帧投票机制(保留至少2帧出现的目标),提高小目标检测稳定性
- 过滤过小检测框(基于距离动态调整阈值,远距离目标允许更小检测框),减少误检
- 支持置信度阈值(--conf-thres)和NMS IOU阈值(--iou-thres)配置

2. 目标跟踪:
- 采用优化版SORT跟踪算法,核心改进包括:
- 卡尔曼滤波器参数优化,适配车辆运动特性
- 引入历史位置平滑处理,减少跟踪抖动
- 提高IOU匹配阈值,增强跟踪稳定性
- 过滤过小检测框,减少误跟踪
- 跟踪核心参数:max_age(最大消失帧数,默认5)、min_hits(最小命中数,默认3)、iou_threshold(IOU匹配阈值,默认0.4)
- 跟踪结果包含持续的目标ID,支持目标短暂消失后重新出现的ID匹配
- 卡尔曼滤波器参数优化,基于目标距离动态调整过程噪声,适配车辆运动特性
- 引入历史位置平滑处理,远距离目标采用更高平滑权重,减少跟踪抖动
- 基于目标距离动态调整IOU匹配阈值,增强不同距离目标的跟踪稳定性
- 基于距离的尺寸过滤策略,适应透视变换影响
- 对远距离目标延长保留时间,减少频繁消失与重现
- 跟踪核心参数:max_age(最大消失帧数,默认8)、min_hits(最小命中数,默认2)、iou_threshold(基础IOU匹配阈值,默认0.4)
- 跟踪结果包含持续的目标ID、距离信息和速度估计,支持目标短暂消失后重新出现的ID匹配

3. CARLA交互:
- 自动清理仿真环境中的残留车辆和静态车辆,保证场景纯净
- 主车辆开启自动驾驶模式,相机优化挂载于主车辆前方(x=2.0m,z=1.5m),更适合前方车辆检测
- 自动生成NPC车辆并开启自动驾驶,构建动态交通场景(默认生成10辆)
- spectator视角自动跟随主车辆(后上方5m,俯角30°),方便观察全局场景
- 主车辆开启自动驾驶模式,相机优化挂载于主车辆前方(x=1.8m,z=1.6m,俯角-5°),更适合前方车辆检测
- 自动生成NPC车辆并开启自动驾驶,构建动态交通场景(数量可通过--npc-count配置,默认15辆)
- spectator视角自动跟随主车辆(后上方8m,z=10m,俯角-35°),方便观察全局场景
- 同步模式运行,固定帧率0.05s/帧(20FPS),保证检测稳定性
- 深度相机与RGB相机精确同步,提供目标距离信息用于优化跟踪

## 项目结构
- main.py:主程序脚本,包含以下核心组件:
- KalmanFilter:卡尔曼滤波器实现,用于目标运动状态预测与更新
- Track:跟踪目标实体类,维护单目标的边界框、ID、生命周期及历史位置等信息
- Sort:SORT跟踪器核心实现,处理多目标匹配与跟踪状态管理
- KalmanFilter:卡尔曼滤波器实现,用于目标运动状态预测与更新,支持基于距离的参数动态调整
- Track:跟踪目标实体类,维护单目标的边界框、ID、生命周期、历史位置、距离及速度等信息
- Sort:SORT跟踪器核心实现,处理多目标匹配与跟踪状态管理,集成深度信息优化
- 工具函数:包含边界框绘制(支持类别差异化颜色)、相机投影矩阵构建、CARLA环境清理等功能
- CARLA交互模块:负责服务器连接、车辆生成、相机配置及同步控制
- 检测与跟踪主逻辑:集成YOLOv5检测与SORT跟踪,实现端到端流程
- YOLOv5预训练模型(yolov5s.pt/yolov5m.pt/yolov5x.pt):需放置在指定路径

## 常见问题

### CARLA连接失败:
- 确保CARLA仿真器已启动,且端口与脚本参数一致(默认2000)
- 检查CARLA版本与Python API版本是否匹配
Expand All @@ -130,11 +131,6 @@ python main.py --model yolov5x --tracker sort --host localhost --port 2000 --con
- 检查模型文件名与代码中`model_paths`字典配置一致
- 网络问题导致模型自动下载失败时,可手动下载并放置到指定路径

### 性能问题:
- 检测速度慢:可切换为yolov5s模型,或降低相机分辨率(修改`camera_bp`的`image_size_x`和`image_size_y`参数)
- 仿真卡顿:减少NPC车辆数量(修改`spawn_npcs`函数的`count`参数)
- 内存占用高:关闭不必要的后台程序,或降低模型复杂度

### 可视化窗口无响应:
- 确保OpenCV版本兼容(推荐4.5.x系列)
- 检查是否存在未处理的异常导致主循环中断
Expand Down
2 changes: 1 addition & 1 deletion src/carla_tracking/requirements.txt
Original file line number Diff line number Diff line change
@@ -1,4 +1,4 @@
python >= 3.7
python>=3.7
numpy
opencv-python
torch
Expand Down
Loading