Skip to content

提交期末文档#7302

Open
Liuxuanyu0331 wants to merge 40 commits into
OpenHUTB:mainfrom
Liuxuanyu0331:main
Open

提交期末文档#7302
Liuxuanyu0331 wants to merge 40 commits into
OpenHUTB:mainfrom
Liuxuanyu0331:main

Conversation

@Liuxuanyu0331

@Liuxuanyu0331 Liuxuanyu0331 commented Jun 12, 2026

Copy link
Copy Markdown
Contributor

修改概述

本次 PR 为 DriveSim-Enhanced 自动驾驶仿真平台提供了完整的技术文档与部署方案,完成了项目从代码实现到可交付文档的基础设施建设。


修改的详细描述

  1. 产品定位与特性梳理:明确了 DriveSim-Enhanced 作为自动驾驶算法验证平台的核心价值,总结了深度学习感知、交通信号识别、路径规划、实时遥测、多视角交互等 6 大核心特性。

  2. 双仿真平台支持方案:系统梳理了 GTAV + OpenPilot 联合仿真与 CARLA 专业仿真器两种技术路线的适用场景、优劣势对比及系统要求,满足不同研发维度的需求。

  3. 环境部署自动化:提供了 CARLA 环境的手动部署步骤与一键启动脚本 start_carla.bat 的自动化编排逻辑,大幅降低用户的部署门槛。

  4. 模块架构文档化:整理了项目核心代码结构(main.pyautomatic_control.pydrive.pyrl_agent.pymap_swithcer.py),明确了各模块的功能边界与职责划分。

  5. FAQ 与演进路线:补充了常见问题的排查指南(版本不匹配、编码乱码、性能卡顿等),并规划了下一阶段的强化学习跟车模型、自定义场景生成、数据采集等演进方向。


经过了什么样的测试?

  1. 操作系统:Windows 11 (22H2) + Windows 10 (21H2)

  2. Python 版本

    • Python 3.8.10(CARLA 0.9.15 推荐版本)
    • Python 3.9.13(兼容性验证)
  3. 基础校验

    • ✅ CARLA 仿真器与 Python API 连接测试通过(carla.__version__ == 0.9.15
    • start_carla.bat 脚本在 UTF-8 with BOM 编码下正常运行
    • ✅ 依赖列表 requirements.txt 完整性校验(pip install -r requirements.txt 无报错)
    • ✅ Markdown 文档在所有主流阅读器(GitHub、Typora、VS Code)中渲染正常
    • ✅ 所有超链接与锚点跳转有效
微信图片_20260613231702_7_2 微信图片_20260613231634_4_2

Liuxuanyu0331 and others added 30 commits April 14, 2026 11:16
这段代码定义了一个名为 `ResearchConfiguration` 的配置管理类,用于加载和管理研究模型的各种内部参数。该类通过读取 YAML 格式的配置文件来初始化内部属性字典 `_props`,并同时支持字典式访问(使用方括号)和属性式访问(使用点号)两种方式来读取和修改配置项。代码实现了 `__getitem__`、`__setitem__`、`__getattr__` 和 `__setattr__` 等特殊方法,使得用户可以灵活地通过 `config['key']` 或 `config.key` 的形式获取或设置配置值。此外,类中还添加了文件存在性检查、编码指定、删除操作支持、长度获取、迭代遍历、安全获取方法 `get()`、批量更新 `update()`、导出字典 `to_dict()`、保存到文件 `save()` 以及从字典创建的类方法 `from_dict()` 等实用功能,整体上提供了一个健壮且易用的配置管理工具。
选题并命名文件夹carla-jaywalker-experiments
完成选题并创建主函数代码
实现自动驾驶的核心控制逻辑,包括:
- 路径跟踪与轨迹跟随
- 速度调节与自适应巡航控制
- 车道保持辅助
- 碰撞避免逻辑

该模块增强了驾驶模拟器的自动化驾驶能力,同时保持安全约束。
- 补充 CARLA 模拟器安装与使用说明
- 新增功能特性介绍(交通信号灯检测、车道保持等)
- 添加常见问题解答(Q&A)
- 统一文档格式,提升可读性
- 动态检测距离:根据车速自动调整(30~50米),高速下更早介入
- 侧向空间感知:基于车道 waypoint 判断左右车道是否可通行,避免撞墙或逆行
- 状态机控制:检测→避障→回正,实现完整的绕行动作,不依赖随机方向
- 平滑控制:接管时渐进式转向与动态刹车,驾驶体验更自然
- 紧急模式:10米内触发全制动并同时转向规避

- 实时检测前方红绿灯状态(通过交通信号灯 actor 识别)
- 红灯/黄灯时自动减速停车,绿灯时恢复行驶
- 支持停止线距离判断,避免闯红灯
- 可与其他辅助功能协同工作,互不冲突

- 快捷键 R:全局开关辅助驾驶
- 快捷键 T:单独开关自动避障
- 快捷键 F:切换自动驾驶/手动模式

- 修复 `ActorList` 类型无法相加导致的运行时崩溃
- 优化障碍物检测性能,单次遍历过滤所有相关 actor
- 提升 HUD 信息显示,实时展示障碍物距离与系统状态
- 修复侧向安全检查失败时的默认策略,避免系统卡死

- 兼容 CARLA 0.9.15
- 支持 Windows
- 依赖:Pygame, NumPy, CARLA Python API

- `automatic_control.py`
- 在 automatic_control.py 中添加 --rl-mode 和 --rl-train 命令行参数
- 支持连续动作空间(PPO)和离散动作空间(DQN)两种训练模式
- 实现基于速度、前进距离、目标接近、碰撞惩罚的奖励函数
- 训练过程中自动保存检查点模型到 ./rl_checkpoints/
- 支持推理模式,加载预训练模型进行自主驾驶
- 训练模式下自动禁用辅助驾驶,避免干扰学习
- 添加车辆卡死检测与 episode 重置优化,确保训练连续性
Liuxuanyu0331 and others added 10 commits April 17, 2026 18:44
实现地图源切换功能,提升驾驶模拟器地图展示的灵活性。

主要功能:
- 支持多种地图源(街道图、卫星图、地形图)动态切换
- 切换时保持当前视角位置和缩放级别
- 提供统一的地图切换 API

影响范围:
- 仅新增独立模块,不影响现有功能
- 新增 start_carla.bat 启动器
- 支持自动启动 CarlaUE4 引擎
- 自动检测 Python 脚本路径并运行
- 兼容 Windows 11 系统"
@Liuxuanyu0331 Liuxuanyu0331 changed the title 完成最终的中文说明文档 提交期末文档 Jun 13, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant