From bd65394b530209e840855444767f2b76446d7fa3 Mon Sep 17 00:00:00 2001 From: xinyangtang91 <2809825433@qq.com> Date: Fri, 13 Nov 2026 19:55:41 +0800 Subject: [PATCH] =?UTF-8?q?feat(ground):=20=E6=96=B0=E5=A2=9E=E5=B7=AE?= =?UTF-8?q?=E9=80=9F=E5=B0=8F=E8=BD=A6=E6=B2=BF=E5=A2=99=E8=A1=8C=E9=A9=B6?= =?UTF-8?q?=E6=A8=A1=E5=9D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 地面载具里已有定点停车、避障和路径跟踪,但缺少一个只用一路激光 保持与墙距离的入门实验。沿墙行驶是理解激光分区、距离闭环和墙角 状态机的经典题目,也便于在没有 Gazebo 时用离线仿真复现。 - 新增 src/ground/diff_drive_wall_following:main.py 订阅 /scan、 发布 /cmd_vel;wall_follower.py 用右侧距离误差与车身夹角误差计算 角速度,正前方过近时进入原地左转状态;包含 launch、参数文件和 离线仿真脚本。 - 新增 docs/ground/diff_drive_wall_following.md:原理、状态图、参数、 ROS 与离线两种运行步骤、三张结果图和指标表。 - 首页与 mkdocs 导航加入口。 评审修复: - main.launch 移到 launch/ 目录,与 install(DIRECTORY launch ...) 一致; - package.xml 升级为 format="3"; - 本地测试从仓库根 tests/ 移到包内 test/ 目录; - 新增 .github/workflows/diff_drive_wall_following_tests.yml,push/PR 时自动运行模块测试、字节编译并构建文档。 验证:离线仿真在 Windows + Python 3.12 实际运行,绕行一圈 60.95 s、 路径 17.06 m、平均跟墙误差 0.031 m、最大 0.273 m;本地测试 28 项通过; mkdocs build 通过。ROS 端未在本机实机验证(没有 ROS 与 Gazebo), 需在 Noetic + TurtleBot3 上复验。 评审修复(第二轮): - docs job 改为安装仓库根的 requirements.txt(仓库没有 requirements-docs.txt),并显式安装 mkdocs 本体,避免只依赖插件的 传递依赖; - WallFollower.update 对 inf 测距做兜底:单路缺失时用 side 代替, 两路都缺失时跳过夹角项,避免 inf-inf=NaN 进入 cmd_vel; - main.py 发布前再次检查线速度/角速度有限性,异常时归零; - 新增 4 项测距缺失单元测试,本地测试 32 项通过。 --- .../diff_drive_wall_following_tests.yml | 61 +++++ docs/ground/diff_drive_wall_following.md | 188 ++++++++++++++ .../map_trajectory.png | Bin 0 -> 42143 bytes .../diff_drive_wall_following/velocity.png | Bin 0 -> 89995 bytes .../wall_distance.png | Bin 0 -> 76072 bytes docs/index.md | 1 + mkdocs.yml | 1 + .../diff_drive_wall_following/CMakeLists.txt | 23 ++ .../diff_drive_wall_following/README.md | 88 +++++++ .../config/params.yaml | 11 + .../launch/main.launch | 13 + src/ground/diff_drive_wall_following/main.py | 151 +++++++++++ .../diff_drive_wall_following/offline_sim.py | 238 ++++++++++++++++++ .../diff_drive_wall_following/package.xml | 19 ++ .../test_diff_drive_wall_following_local.py | 145 +++++++++++ .../wall_follower.py | 100 ++++++++ 16 files changed, 1039 insertions(+) create mode 100644 .github/workflows/diff_drive_wall_following_tests.yml create mode 100644 docs/ground/diff_drive_wall_following.md create mode 100644 docs/img/ground/diff_drive_wall_following/map_trajectory.png create mode 100644 docs/img/ground/diff_drive_wall_following/velocity.png create mode 100644 docs/img/ground/diff_drive_wall_following/wall_distance.png create mode 100644 src/ground/diff_drive_wall_following/CMakeLists.txt create mode 100644 src/ground/diff_drive_wall_following/README.md create mode 100644 src/ground/diff_drive_wall_following/config/params.yaml create mode 100644 src/ground/diff_drive_wall_following/launch/main.launch create mode 100644 src/ground/diff_drive_wall_following/main.py create mode 100644 src/ground/diff_drive_wall_following/offline_sim.py create mode 100644 src/ground/diff_drive_wall_following/package.xml create mode 100644 src/ground/diff_drive_wall_following/test/test_diff_drive_wall_following_local.py create mode 100644 src/ground/diff_drive_wall_following/wall_follower.py diff --git a/.github/workflows/diff_drive_wall_following_tests.yml b/.github/workflows/diff_drive_wall_following_tests.yml new file mode 100644 index 0000000000..4a47feb7d9 --- /dev/null +++ b/.github/workflows/diff_drive_wall_following_tests.yml @@ -0,0 +1,61 @@ +name: Diff drive wall following tests + +on: + push: + paths: + - 'src/ground/diff_drive_wall_following/**' + - 'docs/ground/diff_drive_wall_following.md' + - 'docs/img/ground/diff_drive_wall_following/**' + - '.github/workflows/diff_drive_wall_following_tests.yml' + pull_request: + paths: + - 'src/ground/diff_drive_wall_following/**' + - 'docs/ground/diff_drive_wall_following.md' + - 'docs/img/ground/diff_drive_wall_following/**' + - '.github/workflows/diff_drive_wall_following_tests.yml' + +jobs: + test: + name: Module tests (no ROS) + runs-on: ubuntu-22.04 + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Set up Python 3.8 + uses: actions/setup-python@v5 + with: + python-version: '3.8' + + - name: Install test dependencies + run: python3 -m pip install --upgrade pip numpy + + - name: Run local tests + run: python3 src/ground/diff_drive_wall_following/test/test_diff_drive_wall_following_local.py + + - name: Byte-compile module scripts + run: | + python3 -m py_compile \ + src/ground/diff_drive_wall_following/main.py \ + src/ground/diff_drive_wall_following/wall_follower.py \ + src/ground/diff_drive_wall_following/offline_sim.py + + docs: + name: Docs build + runs-on: ubuntu-22.04 + steps: + - name: Checkout + uses: actions/checkout@v4 + + - name: Set up Python 3.11 + uses: actions/setup-python@v5 + with: + python-version: '3.11' + + - name: Install docs dependencies + run: | + python3 -m pip install --upgrade pip + python3 -m pip install -r requirements.txt mkdocs + + - name: Build docs + run: python3 -m mkdocs build diff --git a/docs/ground/diff_drive_wall_following.md b/docs/ground/diff_drive_wall_following.md new file mode 100644 index 0000000000..935da185a5 --- /dev/null +++ b/docs/ground/diff_drive_wall_following.md @@ -0,0 +1,188 @@ +# 差速小车沿墙行驶实验 + +本实验让一台带 2D 激光雷达的差速小车沿着右侧墙壁行驶:正常段保持约 0.5 m 的墙距, +遇到墙角时原地左转,转过 90° 后继续跟随下一面墙,最终绕房间一圈回到起点。 + +## 一、实验目的与环境说明 + +### 1.1 实验目的 + +1. 掌握激光雷达数据的读取与分区:从 `LaserScan` 中提取正前、正右、右前、右后、正左五路距离; +2. 理解沿墙控制的两个误差来源:离墙距离误差、车身与墙的夹角误差; +3. 用有限状态机处理墙角:直行跟随与原地转向之间的切换; +4. 掌握差速小车 `/cmd_vel` 接口和 ROS 节点的超时保护; +5. 用离线仿真在没有机器人和 Gazebo 的情况下复现并量化控制效果。 + +### 1.2 实验环境 + +| 项目 | 配置 | +| ---- | ---- | +| 操作系统 | Ubuntu 20.04(ROS 端);Windows/Linux(离线仿真) | +| ROS 发行版 | ROS Noetic(Python 3) | +| 依赖 | rospy、geometry_msgs、sensor_msgs | +| 机器人 | 带 2D 激光雷达的差速底盘(如 TurtleBot3 burger) | +| 离线仿真依赖 | Python 3、numpy、matplotlib | + +功能包目录结构: + +```text +diff_drive_wall_following/ +├── main.py # ROS 节点入口:读 LaserScan、发 Twist +├── wall_follower.py # 纯 Python 沿墙控制器(可单独测试) +├── offline_sim.py # 矩形房间离线仿真与出图 +├── launch/main.launch # roslaunch 入口 +├── config/params.yaml # 默认参数 +├── test/test_diff_drive_wall_following_local.py # 本地测试 +├── package.xml +├── CMakeLists.txt +└── README.md +``` + +## 二、实验原理 + +### 2.1 五路测距 + +节点以机器人正前方为 0°,在五个方向各取 ±12° 范围内的最小有效距离: + +| 名称 | 角度 | 用途 | +| ---- | ---- | ---- | +| `front` | 0° | 判断是否到达墙角 | +| `side` | −90° | 右侧墙距离,沿墙的主反馈 | +| `front_right` | −45° | 与 `back_right` 一起估计车身夹角 | +| `back_right` | −135° | 与 `front_right` 一起估计车身夹角 | +| `left` | +90° | 预留,用于窄通道判断 | + +### 2.2 沿墙控制律 + +记右侧墙距离为 $d$、目标距离为 $d^*$,右前与右后距离分别为 $d_{fr}$、$d_{br}$,则 + +$$ +e_d = d - d^*, \qquad e_a = d_{fr} - d_{br} +$$ + +$$ +\omega = -\left(k_d e_d + k_a e_a\right), \qquad \omega \in [-\omega_{\max}, \omega_{\max}] +$$ + +$$ +v = v_0 \cdot \max\left(0.35,\ 1 - 0.8\frac{|\omega|}{\omega_{\max}}\right) +$$ + +- $e_d > 0$ 表示离墙太远,此时 $\omega < 0$(右转靠近墙); +- $e_a > 0$ 表示车头偏向外侧(右前比右后远),同样需要右转修正; +- 角速度越大线速度越低,转弯时不会因为速度过快而撞墙。 + +默认参数:$d^* = 0.5\ \mathrm{m}$、$k_d = 1.6$、$k_a = 1.2$、$\omega_{\max} = 0.9\ \mathrm{rad/s}$、 +$v_0 = 0.35\ \mathrm{m/s}$。 + +### 2.3 墙角状态机 + +```mermaid +stateDiagram-v2 + [*] --> FOLLOW + FOLLOW --> TURN: 前方 < 0.75 m + TURN --> TURN: 前方仍 < 1.1 m + TURN --> FOLLOW: 前方 > 1.1 m +``` + +正前方小于 `front_block_distance`(0.75 m)时认为到了墙角: +停车并原地以 0.8 rad/s 左转;等到前方重新大于 `front_clear_distance`(1.1 m), +说明已经转过墙角,回到沿墙状态。 + +### 2.4 安全策略 + +- **激光超时**:超过 `scan_timeout`(0.5 s)没有新数据时持续发布零速度; +- **速度随转角降低**:角速度接近上限时线速度降到 35%,留出修正时间; +- **退出停车**:`Ctrl+C` 或异常退出都会发布零速度。 + +## 三、运行步骤 + +### 3.1 ROS + Gazebo + +```bash +# 1. 编译 +mkdir -p ~/catkin_ws/src +cp -r <本仓库>/src/ground/diff_drive_wall_following ~/catkin_ws/src/ +chmod +x ~/catkin_ws/src/diff_drive_wall_following/main.py +cd ~/catkin_ws && catkin_make +source devel/setup.bash + +# 2. 启动仿真世界(TurtleBot3 示例) +export TURTLEBOT3_MODEL=burger +roslaunch turtlebot3_gazebo turtlebot3_world.launch + +# 3. 确认激光话题正常 +rostopic hz /scan + +# 4. 启动沿墙节点 +roslaunch diff_drive_wall_following main.launch +``` + +启动前让小车离右侧墙约 0.5 m、车头与墙平行,效果最好。 + +### 3.2 离线仿真 + +```bash +cd <本仓库> +python -m pip install numpy matplotlib +python src/ground/diff_drive_wall_following/offline_sim.py +``` + +离线仿真在 6 m × 5 m 的矩形房间内按 1° 分辨率做激光射线求交, +用差速小车运动学积分(含 0.15 s 执行器滞后)复现同样的控制器, +输出三张图和一组指标。 + +## 四、实验结果 + +离线仿真的任务参数:目标墙距 0.5 m、房间 6 m × 5 m、小车从南墙附近出发,沿右侧墙逆时针绕行一圈。 + +### 4.1 轨迹 + +![沿墙轨迹](../img/ground/diff_drive_wall_following/map_trajectory.png) + +蓝色为沿墙跟随段,红色为墙角转向段。小车依次经过南、东、北、西四面墙, +四个墙角都通过原地左转通过,最后回到起点附近。 + +### 4.2 右侧墙距离 + +![右侧墙距离](../img/ground/diff_drive_wall_following/wall_distance.png) + +直墙段距离稳定在 0.5 m 附近;经过墙角时右侧墙暂时“消失”,距离升到约 0.75 m, +转过墙角后重新收敛到 0.5 m。 + +### 4.3 速度指令 + +![速度曲线](../img/ground/diff_drive_wall_following/velocity.png) + +直墙段线速度约 0.35 m/s、角速度接近 0;墙角处线速度降到 0,角速度升到 0.8 rad/s; +转过墙角后出现一次反向修正,随后回到沿墙状态。 + +### 4.4 指标 + +| 指标 | 数值 | +| ---- | ---- | +| 绕行一圈时间 | 60.95 s | +| 路径长度 | 17.06 m | +| 平均跟墙误差 | 0.031 m | +| 最大跟墙误差 | 0.273 m(墙角段) | +| 最小前方净空 | 0.698 m | +| 终点位置 | (1.007, 0.518) m | + +平均误差约 3 cm,主要来自直墙段的控制噪声;最大误差出现在墙角, +这是“转角时右侧墙暂时丢失”的必然结果。最小前方净空 0.698 m 略小于 +0.75 m 的触发阈值,是执行器滞后造成的,实际机器人需要保留更多余量。 + +## 五、讨论与限制 + +1. 控制器只有比例项,没有积分项,直墙段会残留几厘米的稳态误差; +2. 算法假设右侧始终有一面连续的墙,遇到门洞、玻璃或动态障碍会失效, + 工程上通常再叠加前向避障或局部地图; +3. 转角依赖固定的 0.75 m / 1.1 m 阈值,房间尺寸或激光安装位置变化时需要重新调整; +4. 离线仿真是理想矩形房间 + 简化运动学,不含轮子打滑、激光噪声模型和真实动力学; +5. 本机为 Windows,没有 ROS 与 Gazebo,**ROS 端的实际运行未验证**, + 需要在 ROS Noetic + TurtleBot3 仿真或实车上按 3.1 节复验。 + +## 说明 + +本文档与配套代码在整理过程中使用了 AI 助手(DeepSeek)辅助,实验参数、运行结果 +和图表均由作者实际运行核对;作者对本文内容负全部责任。 diff --git a/docs/img/ground/diff_drive_wall_following/map_trajectory.png b/docs/img/ground/diff_drive_wall_following/map_trajectory.png new file mode 100644 index 0000000000000000000000000000000000000000..fca67608760f617669abc19b563f40a8d635be81 GIT binary patch literal 42143 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 literal 0 HcmV?d00001 diff --git a/docs/img/ground/diff_drive_wall_following/velocity.png b/docs/img/ground/diff_drive_wall_following/velocity.png new file mode 100644 index 0000000000000000000000000000000000000000..76fc247b158c842d1873eda74cc8a0b324308dff GIT binary patch literal 89995 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 WkldfUE=JfZ+S}|FFhr(+4n+tMaU1|>|?p> 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

2|xR{dojdp@-dH%sM3NwW6Rh7cfqw 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 literal 0 HcmV?d00001 diff --git a/docs/img/ground/diff_drive_wall_following/wall_distance.png b/docs/img/ground/diff_drive_wall_following/wall_distance.png new file mode 100644 index 0000000000000000000000000000000000000000..06075f6ffc56963e8fc96bd0b72f9558fa5d6d4c GIT binary patch literal 76072 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 z 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/src/ground/diff_drive_wall_following ~/catkin_ws/src/ +chmod +x ~/catkin_ws/src/diff_drive_wall_following/main.py +cd ~/catkin_ws && catkin_make +source devel/setup.bash + +# 2. 启动带激光雷达的仿真世界 +export TURTLEBOT3_MODEL=burger +roslaunch turtlebot3_gazebo turtlebot3_world.launch + +# 3. 确认激光话题有数据 +rostopic hz /scan + +# 4. 启动沿墙节点 +roslaunch diff_drive_wall_following main.launch +``` + +把小车放在离墙约 0.5 m、车头与墙平行的位置再启动,跟随效果最好。 + +### 方式二:离线仿真(不需要 ROS,用于快速验证控制逻辑) + +```bash +cd <本仓库> +python -m pip install numpy matplotlib +python src/ground/diff_drive_wall_following/offline_sim.py +``` + +脚本在 6 m × 5 m 的矩形房间里模拟 1° 分辨率激光和差速小车运动学, +让小车沿右侧墙逆时针绕行一圈,输出三张图和一组指标。 + +## 运行测试 + +```bash +cd <本仓库> +python3 src/ground/diff_drive_wall_following/test/test_diff_drive_wall_following_local.py +``` + +测试不需要 ROS / Gazebo,覆盖沿墙控制、墙角状态切换、速度限幅和工程文件; +GitHub Actions 会在 `src/ground/diff_drive_wall_following/**` 变更时自动运行该测试并构建文档。 + +## 参数 + +| 参数 | 默认值 | 说明 | +| ---- | ---- | ---- | +| `~target_distance` | 0.5 | 期望的右侧墙距离(m) | +| `~k_distance` | 1.6 | 距离误差到角速度的比例系数 | +| `~k_align` | 1.2 | 车身与墙夹角误差到角速度的比例系数 | +| `~max_angular` | 0.9 | 最大角速度(rad/s) | +| `~base_speed` | 0.35 | 沿墙时的基础线速度(m/s) | +| `~turn_speed` | 0.8 | 墙角原地转向角速度(rad/s) | +| `~front_block_distance` | 0.75 | 前方小于该距离判定为墙角(m) | +| `~front_clear_distance` | 1.1 | 前方大于该距离判定转角完成(m) | +| `~scan_timeout` | 0.5 | 激光超时(s),超时后停车 | + +## 话题接口 + +| 方向 | 话题 | 类型 | 说明 | +| ---- | ---- | ---- | ---- | +| 订阅 | `/scan` | `sensor_msgs/LaserScan` | 2D 激光雷达 | +| 发布 | `/cmd_vel` | `geometry_msgs/Twist` | `linear.x` 线速度、`angular.z` 角速度 | + +## 预期效果 + +小车保持右侧墙约 0.5 m 的间距前进,遇到墙角时原地左转,转过 90° 后继续跟随下一面墙, +最终绕房间一圈回到起点;离线仿真中平均跟墙误差约 3 cm(详细数据见文档)。 diff --git a/src/ground/diff_drive_wall_following/config/params.yaml b/src/ground/diff_drive_wall_following/config/params.yaml new file mode 100644 index 0000000000..e63d4c6db8 --- /dev/null +++ b/src/ground/diff_drive_wall_following/config/params.yaml @@ -0,0 +1,11 @@ +# 沿墙行驶参数(launch 中作为节点私有参数加载) +target_distance: 0.5 # 期望的右侧墙距离(m) +k_distance: 1.6 # 距离误差 -> 角速度的比例系数 +k_align: 1.2 # 车身与墙夹角误差 -> 角速度的比例系数 +max_angular: 0.9 # 最大角速度(rad/s) +base_speed: 0.35 # 沿墙时的基础线速度(m/s) +turn_speed: 0.8 # 墙角原地转向的角速度(rad/s) +front_block_distance: 0.75 # 前方小于该距离判定为墙角(m) +front_clear_distance: 1.1 # 前方大于该距离判定转角完成(m) +control_rate: 10.0 # 控制频率(Hz) +scan_timeout: 0.5 # 激光数据超时(s),超时后停车 diff --git a/src/ground/diff_drive_wall_following/launch/main.launch b/src/ground/diff_drive_wall_following/launch/main.launch new file mode 100644 index 0000000000..39ef8d3e84 --- /dev/null +++ b/src/ground/diff_drive_wall_following/launch/main.launch @@ -0,0 +1,13 @@ + + + + + + + + + + + + diff --git a/src/ground/diff_drive_wall_following/main.py b/src/ground/diff_drive_wall_following/main.py new file mode 100644 index 0000000000..4616b1cbe1 --- /dev/null +++ b/src/ground/diff_drive_wall_following/main.py @@ -0,0 +1,151 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +"""差速小车沿墙行驶 ROS 节点(模块入口 main.py)。 + +订阅 /scan(sensor_msgs/LaserScan),从激光数据中取正前、正右、右前、右后、 +正左五路距离,交给 wall_follower.py 的控制器,发布 /cmd_vel(Twist)。 + +运行: + rosrun diff_drive_wall_following main.py + roslaunch diff_drive_wall_following main.launch +""" +from __future__ import print_function + +import math + +import rospy +from geometry_msgs.msg import Twist +from sensor_msgs.msg import LaserScan + +from wall_follower import STATE_FOLLOW, STATE_NAMES, STATE_TURN, WallFollower + +# 五路测距对应的机器人坐标系角度(rad,0 为正前方,逆时针为正) +BEAM_ANGLES = { + 'front': 0.0, + 'side': -math.pi / 2, + 'front_right': -math.pi / 4, + 'back_right': -3 * math.pi / 4, + 'left': math.pi / 2, +} +WINDOW = math.radians(12) # 每路取 ±12° 内的最小距离,抗噪 + + +class WallFollowingNode(object): + + def __init__(self): + self.scan_topic = rospy.get_param('~scan_topic', '/scan') + self.cmd_topic = rospy.get_param('~cmd_topic', '/cmd_vel') + self.scan_timeout = rospy.get_param('~scan_timeout', 0.5) + + self.follower = WallFollower( + target_distance=rospy.get_param('~target_distance', 0.5), + k_distance=rospy.get_param('~k_distance', 1.6), + k_align=rospy.get_param('~k_align', 1.2), + max_angular=rospy.get_param('~max_angular', 0.9), + base_speed=rospy.get_param('~base_speed', 0.35), + turn_speed=rospy.get_param('~turn_speed', 0.8), + front_block_distance=rospy.get_param('~front_block_distance', 0.75), + front_clear_distance=rospy.get_param('~front_clear_distance', 1.1), + ) + + self.distances = None + self.last_scan_time = None + self.last_time = None + self.last_state = None + + self.pub = rospy.Publisher(self.cmd_topic, Twist, queue_size=10) + rospy.Subscriber(self.scan_topic, LaserScan, self.on_scan) + rospy.loginfo('沿墙行驶节点已启动:scan=%s -> cmd=%s', + self.scan_topic, self.cmd_topic) + + def _beam_distance(self, scan, angle): + """在 angle 附近 [-WINDOW, +WINDOW] 内取最小有效距离。""" + best = float('inf') + start = scan.angle_min + inc = scan.angle_increment + count = len(scan.ranges) + if count == 0 or inc == 0.0: + return best + + for i in range(count): + a = start + i * inc + # 把角度差归一化到 [-pi, pi] + diff = math.atan2(math.sin(a - angle), math.cos(a - angle)) + if abs(diff) > WINDOW: + continue + r = scan.ranges[i] + if r is None or r != r: # None / NaN + continue + if r < scan.range_min or r > scan.range_max: + continue + if r < best: + best = r + return best + + def on_scan(self, msg): + self.distances = dict((name, self._beam_distance(msg, angle)) + for name, angle in BEAM_ANGLES.items()) + self.last_scan_time = rospy.Time.now() + + def publish(self, v, w): + # 控制器已对缺失测距做兜底;这里再挡一层,保证 cmd_vel 不会出现 NaN/inf + if not math.isfinite(v): + v = 0.0 + if not math.isfinite(w): + w = 0.0 + msg = Twist() + msg.linear.x = v + msg.angular.z = w + self.pub.publish(msg) + + def run(self): + rate = rospy.Rate(rospy.get_param('~control_rate', 10.0)) + self.last_time = rospy.Time.now() + + while not rospy.is_shutdown(): + now = rospy.Time.now() + dt = (now - self.last_time).to_sec() + self.last_time = now + + if self.last_scan_time is None: + rate.sleep() + continue + + if (now - self.last_scan_time).to_sec() > self.scan_timeout: + self.publish(0.0, 0.0) + rospy.logwarn_throttle(2.0, '超过 %.1f 秒没有收到激光数据,已停车', + self.scan_timeout) + rate.sleep() + continue + + d = self.distances + v, w, state = self.follower.update( + d['front'], d['side'], d['front_right'], d['back_right'], + d['left'], dt) + self.publish(v, w) + + if state != self.last_state: + rospy.loginfo('状态切换:%s -> %s', + STATE_NAMES.get(self.last_state, '无'), + STATE_NAMES.get(state, state)) + self.last_state = state + + rate.sleep() + + self.publish(0.0, 0.0) + + +def main(): + rospy.init_node('diff_drive_wall_following') + node = WallFollowingNode() + try: + node.run() + except rospy.ROSInterruptException: + pass + finally: + node.publish(0.0, 0.0) + rospy.loginfo('节点退出,已发布零速度') + + +if __name__ == '__main__': + main() diff --git a/src/ground/diff_drive_wall_following/offline_sim.py b/src/ground/diff_drive_wall_following/offline_sim.py new file mode 100644 index 0000000000..0c45dbc1f9 --- /dev/null +++ b/src/ground/diff_drive_wall_following/offline_sim.py @@ -0,0 +1,238 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +"""差速小车沿墙行驶的离线仿真与出图(不需要 ROS / Gazebo)。 + +用法(在仓库根目录执行): + python src/ground/diff_drive_wall_following/offline_sim.py + +仿真内容: +- 一个 6 m x 5 m 的矩形房间,小车从南墙附近出发,沿右侧墙壁逆时针绕行一圈; +- 按真实激光雷达的角度分辨率(1°)做射线求交,取五路最小距离; +- 差速小车运动学积分 + 执行器一阶滞后,模拟速度指令到实际速度的延迟。 + +输出: + docs/img/ground/diff_drive_wall_following/map_trajectory.png + docs/img/ground/diff_drive_wall_following/wall_distance.png + docs/img/ground/diff_drive_wall_following/velocity.png +""" +from __future__ import print_function + +import json +import math +import os +import sys + +import numpy as np + +HERE = os.path.dirname(os.path.abspath(__file__)) +REPO_ROOT = os.path.abspath(os.path.join(HERE, '..', '..', '..')) +sys.path.insert(0, HERE) + +from wall_follower import STATE_FOLLOW, STATE_TURN, WallFollower # noqa: E402 + +OUTPUT_DIR = os.path.join(REPO_ROOT, 'docs', 'img', 'ground', 'diff_drive_wall_following') + +ROOM_WIDTH = 6.0 +ROOM_HEIGHT = 5.0 +START = (1.2, 0.5, 0.0) # x, y, heading +DT = 0.05 +TAU = 0.15 # 执行器时间常数 +MAX_TIME = 120.0 +BEAM_RESOLUTION = math.radians(1.0) +MAX_RANGE = 8.0 + +BEAM_CENTERS = { + 'front': 0.0, + 'side': -math.pi / 2, + 'front_right': -math.pi / 4, + 'back_right': -3 * math.pi / 4, + 'left': math.pi / 2, +} +WINDOW = math.radians(12) + + +def ray_distance(x, y, angle): + """从 (x, y) 沿 angle 发射射线,返回到矩形房间四壁的最近距离。""" + dx, dy = math.cos(angle), math.sin(angle) + best = MAX_RANGE + if dx > 1e-9: + best = min(best, (ROOM_WIDTH - x) / dx) + elif dx < -1e-9: + best = min(best, (0.0 - x) / dx) + if dy > 1e-9: + best = min(best, (ROOM_HEIGHT - y) / dy) + elif dy < -1e-9: + best = min(best, (0.0 - y) / dy) + return max(0.0, best) + + +def scan(x, y, heading, noise_std=0.0, rng=None): + """模拟一圈 1° 激光,返回五路最小距离。""" + ranges = {} + for name, center in BEAM_CENTERS.items(): + best = MAX_RANGE + n = int(round(WINDOW / BEAM_RESOLUTION)) + for k in range(-n, n + 1): + a = heading + center + k * BEAM_RESOLUTION + d = ray_distance(x, y, a) + if noise_std > 0 and rng is not None: + d += rng.normal(0.0, noise_std) + if d < best: + best = d + ranges[name] = best + return ranges + + +def simulate(noise_std=0.01, seed=7, follower_kwargs=None): + rng = np.random.RandomState(seed) + follower = WallFollower(**(follower_kwargs or {})) + + x, y, heading = START + v = 0.0 + w = 0.0 + + times = [0.0] + xs = [x] + ys = [y] + headings = [heading] + vs = [v] + ws = [w] + sides = [np.nan] + fronts = [np.nan] + states = [follower.state] + + t = 0.0 + lap_time = None + traveled = 0.0 + while t < MAX_TIME: + ranges = scan(x, y, heading, noise_std=noise_std, rng=rng) + cmd_v, cmd_w, state = follower.update( + ranges['front'], ranges['side'], ranges['front_right'], + ranges['back_right'], ranges['left'], DT) + + # 执行器一阶滞后 + alpha = min(DT / TAU, 1.0) + v += (cmd_v - v) * alpha + w += (cmd_w - w) * alpha + + x += v * math.cos(heading) * DT + y += v * math.sin(heading) * DT + heading += w * DT + + traveled += abs(v) * DT + t += DT + + times.append(t) + xs.append(x) + ys.append(y) + headings.append(heading) + vs.append(v) + ws.append(w) + sides.append(ranges['side']) + fronts.append(ranges['front']) + states.append(state) + + if lap_time is None and t > 10.0 and traveled > 14.0: + heading_error = abs(math.atan2(math.sin(heading - START[2]), + math.cos(heading - START[2]))) + if x > 1.0 and y < 1.2 and heading_error < 0.3: + lap_time = t + break + + return { + 't': np.array(times), 'x': np.array(xs), 'y': np.array(ys), + 'heading': np.array(headings), 'v': np.array(vs), 'w': np.array(ws), + 'side': np.array(sides), 'front': np.array(fronts), + 'state': np.array(states), 'lap_time': lap_time, 'traveled': traveled, + } + + +def metrics(data): + t = data['t'] + side = data['side'] + states = data['state'] + follow = states == STATE_FOLLOW + err = np.abs(side[follow] - 0.5) + err = err[~np.isnan(err)] + return { + 'lap_time_s': data['lap_time'], + 'path_length_m': float(data['traveled']), + 'mean_wall_error_m': float(err.mean()) if len(err) else float('nan'), + 'max_wall_error_m': float(err.max()) if len(err) else float('nan'), + 'min_front_clearance_m': float(np.nanmin(data['front'])), + 'final_position_m': [float(data['x'][-1]), float(data['y'][-1])], + } + + +def plot(data): + import matplotlib + matplotlib.use('Agg') + import matplotlib.pyplot as plt + from matplotlib.patches import Rectangle + + os.makedirs(OUTPUT_DIR, exist_ok=True) + + # 1) 地图与轨迹 + fig, ax = plt.subplots(figsize=(7, 5.5)) + ax.add_patch(Rectangle((0, 0), ROOM_WIDTH, ROOM_HEIGHT, fill=False, + edgecolor='black', linewidth=2)) + colors = {STATE_FOLLOW: ('FOLLOW', '#1f77b4'), + STATE_TURN: ('TURN', '#d62728')} + for state, (label, color) in colors.items(): + mask = data['state'] == state + if mask.any(): + ax.plot(data['x'][mask], data['y'][mask], color=color, linewidth=2, + label=label) + ax.plot(START[0], START[1], 'go', markersize=8, label='start') + ax.plot(data['x'][-1], data['y'][-1], 'rx', markersize=10, label='end') + ax.set_xlim(-0.4, ROOM_WIDTH + 0.4) + ax.set_ylim(-0.4, ROOM_HEIGHT + 0.4) + ax.set_aspect('equal') + ax.set_xlabel('x (m)') + ax.set_ylabel('y (m)') + ax.set_title('Wall-following trajectory (right-hand rule)') + ax.grid(True, alpha=0.3) + ax.legend(loc='upper right', fontsize=8) + fig.tight_layout() + fig.savefig(os.path.join(OUTPUT_DIR, 'map_trajectory.png'), dpi=150) + plt.close(fig) + + # 2) 右侧墙距离 + fig, ax = plt.subplots(figsize=(8, 4.2)) + ax.plot(data['t'], data['side'], color='#1f77b4', linewidth=1.5, label='right wall distance') + ax.axhline(0.5, color='gray', linestyle='--', linewidth=1, label='target 0.5 m') + ax.set_xlabel('time (s)') + ax.set_ylabel('distance (m)') + ax.set_title('Distance to the right wall') + ax.grid(True, alpha=0.3) + ax.legend(loc='upper right') + fig.tight_layout() + fig.savefig(os.path.join(OUTPUT_DIR, 'wall_distance.png'), dpi=150) + plt.close(fig) + + # 3) 速度 + fig, ax = plt.subplots(figsize=(8, 4.2)) + ax.plot(data['t'], data['v'], label='linear velocity v (m/s)') + ax.plot(data['t'], data['w'], label='angular velocity w (rad/s)') + ax.set_xlabel('time (s)') + ax.set_ylabel('command') + ax.set_title('Velocity commands while following the wall') + ax.grid(True, alpha=0.3) + ax.legend(loc='upper right') + fig.tight_layout() + fig.savefig(os.path.join(OUTPUT_DIR, 'velocity.png'), dpi=150) + plt.close(fig) + + +def main(): + data = simulate() + result = metrics(data) + plot(data) + print(json.dumps(result, ensure_ascii=False, indent=2)) + for name in ('map_trajectory.png', 'wall_distance.png', 'velocity.png'): + print('figure:', os.path.join(OUTPUT_DIR, name)) + return 0 + + +if __name__ == '__main__': + sys.exit(main()) diff --git a/src/ground/diff_drive_wall_following/package.xml b/src/ground/diff_drive_wall_following/package.xml new file mode 100644 index 0000000000..e113a702fd --- /dev/null +++ b/src/ground/diff_drive_wall_following/package.xml @@ -0,0 +1,19 @@ + + + diff_drive_wall_following + 0.1.0 + + 差速小车沿右侧墙壁行驶模块:订阅 /scan(LaserScan),取正前、正右、 + 右前、右后、正左五路距离,用距离误差与车身夹角误差计算 /cmd_vel + (Twist),实现沿墙跟随和墙角转向。配套文档见 + docs/ground/diff_drive_wall_following.md。 + + xinyangtang91 + MIT + + catkin + + rospy + geometry_msgs + sensor_msgs + diff --git a/src/ground/diff_drive_wall_following/test/test_diff_drive_wall_following_local.py b/src/ground/diff_drive_wall_following/test/test_diff_drive_wall_following_local.py new file mode 100644 index 0000000000..9839c460d0 --- /dev/null +++ b/src/ground/diff_drive_wall_following/test/test_diff_drive_wall_following_local.py @@ -0,0 +1,145 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""diff_drive_wall_following 本地测试(不需要 ROS / Gazebo / 激光雷达). + +A. 沿墙控制:距离保持、夹角修正、墙角转向状态切换 +B. 限幅与丢墙保护 +C. 工程文件:package.xml / CMakeLists.txt / main.launch / README / 文档 / 图片 + +用法: python3 src/ground/diff_drive_wall_following/test/test_diff_drive_wall_following_local.py +""" +from __future__ import annotations + +import math +import os +import sys +import xml.etree.ElementTree as ET + +PASS, FAIL = [], [] + + +def check(cond, label): + (PASS if cond else FAIL).append(label) + print(" [%s] %s" % ("PASS" if cond else "FAIL", label)) + + +HERE = os.path.dirname(os.path.abspath(__file__)) +PKG = os.path.abspath(os.path.join(HERE, "..")) +ROOT = os.path.abspath(os.path.join(PKG, "..", "..", "..")) +sys.path.insert(0, PKG) + +from wall_follower import ( # noqa: E402 + STATE_FOLLOW, STATE_TURN, WallFollower, +) + + +# ================================================================= A. 沿墙控制 +def test_follow(): + print("== A. 沿墙控制 ==") + follower = WallFollower() + + v, w, state = follower.update(2.0, 0.5, 0.5, 0.5, 2.0, 0.1) + check(state == STATE_FOLLOW, "正前方无遮挡时为 FOLLOW") + check(abs(w) < 1e-6, "距离和夹角都无误差时角速度约为 0") + check(0.0 < v <= 0.4, "正常跟随时有前进速度(%.2f m/s)" % v) + + follower = WallFollower() + _, w_far, _ = follower.update(2.0, 0.8, 0.8, 0.8, 2.0, 0.1) + check(w_far < 0.0, "离墙太远时向右转(w<0,%.2f)" % w_far) + + follower = WallFollower() + _, w_near, _ = follower.update(2.0, 0.3, 0.3, 0.3, 2.0, 0.1) + check(w_near > 0.0, "离墙太近时向左转(w>0,%.2f)" % w_near) + + follower = WallFollower() + _, w_angle, _ = follower.update(2.0, 0.5, 0.6, 0.4, 2.0, 0.1) + check(w_angle < 0.0, "车头偏向外侧时向右修正(w<0,%.2f)" % w_angle) + + +def test_corner_and_limits(): + print("== B. 墙角转向、限幅与丢墙 ==") + follower = WallFollower() + v, w, state = follower.update(0.5, 0.5, 0.5, 0.5, 0.5, 0.1) + check(state == STATE_TURN, "正前方小于阈值时进入 TURN") + check(v == 0.0 and w > 0.0, "转角时停车并原地左转") + + v, w, state = follower.update(0.9, 0.5, 0.5, 0.5, 2.0, 0.1) + check(state == STATE_TURN, "前方仍不够空时保持 TURN") + + v, w, state = follower.update(1.2, 0.5, 0.5, 0.5, 2.0, 0.1) + check(state == STATE_FOLLOW, "转过墙角后回到 FOLLOW") + + follower = WallFollower(max_angular=0.6) + _, w, _ = follower.update(2.0, 3.0, 3.0, 3.0, 2.0, 0.1) + check(abs(w) <= 0.6 + 1e-9, "角速度被限制在 max_angular 以内(%.2f)" % w) + + follower = WallFollower() + v, w, _ = follower.update(2.0, 5.0, 5.0, 5.0, 2.0, 0.1) + check(v > 0.0 and w < 0.0, "右侧丢墙时低速右转寻找墙壁") + + follower = WallFollower() + v, w, _ = follower.update(2.0, 0.5, float("inf"), float("inf"), 2.0, 0.1) + check(math.isfinite(v) and math.isfinite(w), + "前右/后右同时无回波时不输出 NaN(v=%s, w=%s)" % (v, w)) + check(abs(w) < 1e-6, "两路缺失时用 side 兜底,夹角误差为 0") + + follower = WallFollower() + _, w, _ = follower.update(2.0, 0.5, 0.8, float("inf"), 2.0, 0.1) + check(math.isfinite(w) and w < 0.0, + "单路缺失时用 side 兜底并保持有限输出(w=%.2f)" % w) + + follower = WallFollower() + v, w, _ = follower.update(2.0, float("inf"), float("inf"), float("inf"), 2.0, 0.1) + check(math.isfinite(v) and math.isfinite(w), + "右侧完全丢墙时输出仍有限(v=%.2f, w=%.2f)" % (v, w)) + + +# ================================================================= C. 工程文件 +def test_project_files(): + print("== C. 工程文件 ==") + pkg = ET.parse(os.path.join(PKG, "package.xml")).getroot() + check(pkg.findtext("name").strip() == "diff_drive_wall_following", "package.xml 包名正确") + deps = [d.text.strip() for d in pkg.findall("depend")] + for dep in ("rospy", "geometry_msgs", "sensor_msgs"): + check(dep in deps, "package.xml 声明依赖 %s" % dep) + + cmake = open(os.path.join(PKG, "CMakeLists.txt"), encoding="utf-8").read() + for name in ("main.py", "wall_follower.py", "offline_sim.py"): + check(name in cmake, "CMakeLists.txt 安装 %s" % name) + + launch = ET.parse(os.path.join(PKG, "launch", "main.launch")).getroot() + nodes = [n.get("type") for n in launch.findall("node")] + check("main.py" in nodes, "main.launch 启动 main.py") + args = [a.get("name") for a in launch.findall("arg")] + for name in ("scan_topic", "cmd_topic"): + check(name in args, "main.launch 暴露参数 %s" % name) + + check(os.path.exists(os.path.join(PKG, "README.md")), "README.md 存在") + check(os.path.exists(os.path.join( + ROOT, ".github", "workflows", "diff_drive_wall_following_tests.yml")), + "CI workflow 存在") + for rel in ( + "docs/ground/diff_drive_wall_following.md", + "docs/img/ground/diff_drive_wall_following/map_trajectory.png", + "docs/img/ground/diff_drive_wall_following/wall_distance.png", + "docs/img/ground/diff_drive_wall_following/velocity.png", + ): + check(os.path.exists(os.path.join(ROOT, rel)), "文件存在:%s" % rel) + + +def main(): + test_follow() + test_corner_and_limits() + test_project_files() + print("\n==================== 结果 ====================") + print("通过 %d 项,失败 %d 项" % (len(PASS), len(FAIL))) + if FAIL: + for f in FAIL: + print(" FAIL: %s" % f) + return 1 + print("全部通过") + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/src/ground/diff_drive_wall_following/wall_follower.py b/src/ground/diff_drive_wall_following/wall_follower.py new file mode 100644 index 0000000000..54353e8971 --- /dev/null +++ b/src/ground/diff_drive_wall_following/wall_follower.py @@ -0,0 +1,100 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +"""差速小车沿右侧墙壁行驶的控制器(纯 Python,不依赖 ROS)。 + +控制器只接收几路激光测距值,输出差速小车的线速度 v 和角速度 w: + + front 正前方最近距离 + side 正右方最近距离(跟随的目标墙) + front_right 右前方 45° 左右的距离 + back_right 右后方 45° 左右的距离 + left 正左方最近距离(预留,用于窄通道判断) + +沿墙策略: +1. 正常跟随时,用“右侧距离误差”把车拉回目标距离; +2. 用“右前 / 右后距离差”估计车身与墙的夹角,夹角偏了就转向修正; +3. 正前方太近说明到了墙角,原地左转,直到前方重新变空再继续跟随。 + +角速度约定:逆时针为正(左转为正)。 +""" +from __future__ import print_function + +import math + +STATE_FOLLOW = 'FOLLOW' +STATE_TURN = 'TURN' + +STATE_NAMES = { + STATE_FOLLOW: '沿墙', + STATE_TURN: '转角', +} + + +def _clamp(value, limit): + if value > limit: + return limit + if value < -limit: + return -limit + return value + + +class WallFollower(object): + """右侧沿墙控制器。""" + + def __init__(self, target_distance=0.5, k_distance=1.6, k_align=1.2, + max_angular=0.9, base_speed=0.35, turn_speed=0.8, + front_block_distance=0.75, front_clear_distance=1.1, + min_speed_factor=0.35, lost_range=3.0): + self.target_distance = float(target_distance) + self.k_distance = float(k_distance) + self.k_align = float(k_align) + self.max_angular = float(max_angular) + self.base_speed = float(base_speed) + self.turn_speed = float(turn_speed) + self.front_block_distance = float(front_block_distance) + self.front_clear_distance = float(front_clear_distance) + self.min_speed_factor = float(min_speed_factor) + self.lost_range = float(lost_range) + + self.state = STATE_FOLLOW + + def reset(self): + self.state = STATE_FOLLOW + + def update(self, front, side, front_right, back_right, left, dt): + """返回 (v, w, state)。dt 目前未参与计算,保留以保持接口一致。""" + if front < self.front_block_distance: + # 前方是墙:停车并原地左转 + self.state = STATE_TURN + return 0.0, self.turn_speed, self.state + + if self.state == STATE_TURN: + if front < self.front_clear_distance: + return 0.0, self.turn_speed, self.state + self.state = STATE_FOLLOW + + if not math.isfinite(side) or side >= self.lost_range: + # 右侧没有可跟随的墙,缓慢右转寻找 + return self.base_speed * self.min_speed_factor, -0.4, self.state + + distance_error = side - self.target_distance # 正:离墙太远 + + # 激光某一路没有有效回波时返回 inf;两路都缺失会得到 inf-inf=NaN。 + # 这里用侧向墙距兜底缺失的一路,仍无法兜底时跳过夹角修正。 + if not math.isfinite(front_right): + front_right = side + if not math.isfinite(back_right): + back_right = side + if math.isfinite(front_right) and math.isfinite(back_right): + align_error = front_right - back_right # 正:车头偏向外侧 + else: + align_error = 0.0 + + w = -(self.k_distance * distance_error + self.k_align * align_error) + w = _clamp(w, self.max_angular) + + speed_factor = 1.0 - 0.8 * abs(w) / self.max_angular + if speed_factor < self.min_speed_factor: + speed_factor = self.min_speed_factor + v = self.base_speed * speed_factor + return v, w, self.state