From f4716c62edbb79fa350bf028e838c49765a911f1 Mon Sep 17 00:00:00 2001 From: xinyangtang91 <2809825433@qq.com> Date: Fri, 13 Nov 2026 19:50:10 +0800 Subject: [PATCH] =?UTF-8?q?feat(water):=20=E6=96=B0=E5=A2=9E=20ROV=20?= =?UTF-8?q?=E5=85=AD=E6=8E=A8=E8=BF=9B=E5=99=A8=E6=8E=A8=E5=8A=9B=E5=88=86?= =?UTF-8?q?=E9=85=8D=EF=BC=88ROS=201/catkin=EF=BC=89=E6=A8=A1=E5=9D=97?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 水域载具现有实验多从键盘控制、轨迹跟踪和感知出发,缺少把上层 力/力矩指令落到推进器上的分配环节;推进器饱和与单推进器故障时 会发生什么,也没有可复现的对比实验。 - 新增 src/water/rov_thruster_allocation_ros1:allocation.py 用推进器 布置矩阵的伪逆做最小二乘分配,支持 clamp/scale 两种饱和策略和单 推进器故障重构;main.py 订阅 /rov/wrench,发布 /rov/thruster_cmd 与 /rov/wrench_achieved;包含 launch、参数文件和离线验证脚本。 - 新增 docs/water/rov_thruster_allocation_ros1.md:布局与分配矩阵推导、 饱和/故障策略、话题接口、ROS 与离线运行、三张结果图和指标表。 - 首页与 mkdocs 导航加入口。 评审修复: - main.launch 移到 launch/main.launch,与 CMakeLists.txt 的 install(DIRECTORY launch config ...) 匹配; - package.xml 升级为 format="3",补充 python3-numpy; - 本地测试移到包内 test/ 目录; - master 已合入同名的 ROS 2 包 rov_thruster_allocation,为避免覆盖, ROS 1/catkin 实现更名为 rov_thruster_allocation_ros1; - 分支重建到最新 master,解决 docs/index.md 等文件冲突。 验证:离线验证在 Windows + Python 3.12 实际运行,正常任务分配残差约 1e-13%、最大推力 29.5 N;过载时 clamp 残差 82.56%、scale 残差 55.92%; T2 故障残差 15.15%。本地测试 42 项通过;mkdocs build 通过。ROS 端 未在本机实机验证(没有 ROS 与 ROV 仿真器),需在 Noetic + 仿真器上复验。 --- .../achieved_vs_desired.png | Bin 0 -> 71992 bytes .../saturation_fault.png | Bin 0 -> 38912 bytes .../thruster_cmds.png | Bin 0 -> 66195 bytes docs/index.md | 1 + docs/water/rov_thruster_allocation_ros1.md | 187 ++++++++++++++++ mkdocs.yml | 1 + .../CMakeLists.txt | 23 ++ .../rov_thruster_allocation_ros1/README.md | 87 ++++++++ .../allocation.py | 111 ++++++++++ .../config/params.yaml | 6 + .../launch/main.launch | 17 ++ .../rov_thruster_allocation_ros1/main.py | 127 +++++++++++ .../offline_sim.py | 200 ++++++++++++++++++ .../rov_thruster_allocation_ros1/package.xml | 20 ++ ...test_rov_thruster_allocation_ros1_local.py | 145 +++++++++++++ 15 files changed, 925 insertions(+) create mode 100644 docs/img/water/rov_thruster_allocation_ros1/achieved_vs_desired.png create mode 100644 docs/img/water/rov_thruster_allocation_ros1/saturation_fault.png create mode 100644 docs/img/water/rov_thruster_allocation_ros1/thruster_cmds.png create mode 100644 docs/water/rov_thruster_allocation_ros1.md create mode 100644 src/water/rov_thruster_allocation_ros1/CMakeLists.txt create mode 100644 src/water/rov_thruster_allocation_ros1/README.md create mode 100644 src/water/rov_thruster_allocation_ros1/allocation.py create mode 100644 src/water/rov_thruster_allocation_ros1/config/params.yaml create mode 100644 src/water/rov_thruster_allocation_ros1/launch/main.launch create mode 100644 src/water/rov_thruster_allocation_ros1/main.py create mode 100644 src/water/rov_thruster_allocation_ros1/offline_sim.py create mode 100644 src/water/rov_thruster_allocation_ros1/package.xml create mode 100644 src/water/rov_thruster_allocation_ros1/test/test_rov_thruster_allocation_ros1_local.py diff --git a/docs/img/water/rov_thruster_allocation_ros1/achieved_vs_desired.png b/docs/img/water/rov_thruster_allocation_ros1/achieved_vs_desired.png new file mode 100644 index 0000000000000000000000000000000000000000..c602ec0dae82df38ca3fa19bc52cf78a59a5c95d GIT binary patch literal 71992 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 W;o9?jWZnq*jbPyZL3Eat-i literal 0 HcmV?d00001 diff --git a/docs/img/water/rov_thruster_allocation_ros1/saturation_fault.png b/docs/img/water/rov_thruster_allocation_ros1/saturation_fault.png new file mode 100644 index 0000000000000000000000000000000000000000..25af2c7dcd8732429d004130da268f2de6488ab0 GIT binary patch literal 38912 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 literal 0 HcmV?d00001 diff --git a/docs/img/water/rov_thruster_allocation_ros1/thruster_cmds.png b/docs/img/water/rov_thruster_allocation_ros1/thruster_cmds.png new file mode 100644 index 0000000000000000000000000000000000000000..372e9c5f9519facb241d8a2a38185b0f244aedf1 GIT binary patch literal 66195 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/rov/wrench| A["推力分配节点"] + A -->|/rov/thruster_cmd| T["推进器驱动"] + A -->|/rov/wrench_achieved| M["监控与评估"] +``` + +| 方向 | 话题 | 类型 | 说明 | +| ---- | ---- | ---- | ---- | +| 订阅 | `/rov/wrench` | `geometry_msgs/Wrench` | 期望力/力矩(机体坐标系) | +| 发布 | `/rov/thruster_cmd` | `std_msgs/Float64MultiArray` | 6 个推进器推力(N) | +| 发布 | `/rov/wrench_achieved` | `geometry_msgs/Wrench` | 限幅后实际可达的 wrench | + +安全处理:超过 `wrench_timeout`(0.5 s)没有收到新的期望 wrench 时,推进器指令归零; +节点退出时同样归零。 + +## 四、运行步骤 + +### 4.1 ROS 节点 + +```bash +mkdir -p ~/catkin_ws/src +cp -r <本仓库>/src/water/rov_thruster_allocation_ros1 ~/catkin_ws/src/ +chmod +x ~/catkin_ws/src/rov_thruster_allocation_ros1/main.py +cd ~/catkin_ws && catkin_make +source devel/setup.bash + +roslaunch rov_thruster_allocation_ros1 main.launch + +# 另开终端发送期望 wrench +rostopic pub -1 /rov/wrench geometry_msgs/Wrench \ + "{force: {x: 30.0, y: 0.0, z: 0.0}, torque: {x: 0.0, y: 0.0, z: 0.0}}" +rostopic echo /rov/thruster_cmd +``` + +故障重构示例:`roslaunch rov_thruster_allocation_ros1 main.launch failed_thruster:=1`。 + +### 4.2 离线验证 + +```bash +cd <本仓库> +python -m pip install numpy matplotlib +python src/water/rov_thruster_allocation_ros1/offline_sim.py +``` + +脚本发送一段 12 s 的预设任务(前进 → 转向 → 下潜抬头 → 组合运动), +再单独测试饱和和故障场景,输出三张图与指标。 + +## 五、实验结果 + +### 5.1 正常任务下的推进器指令 + +![推进器指令](../img/water/rov_thruster_allocation_ros1/thruster_cmds.png) + +- 0~3 s 前进:四个水平推进器成对出力(T1/T2 为正、T3/T4 为负),合力沿 +x; +- 3~6 s 转向:对角推进器反向出力,产生 +Mz 力矩; +- 6~9 s 下潜抬头:T6 明显大于 T5,既提供垂向力又产生抬头力矩; +- 9~12 s 组合运动:水平与垂直推进器同时工作。 + +### 5.2 期望与可达 wrench + +![期望与实际 wrench](../img/water/rov_thruster_allocation_ros1/achieved_vs_desired.png) + +正常工况下(最大推力 40 N),实际可达 wrench 与期望值完全重合, +任务段最大分配残差约 $10^{-13}\%$(数值精度),说明伪逆分配是精确的。 + +### 5.3 饱和与故障对比 + +![饱和与故障残差](../img/water/rov_thruster_allocation_ros1/saturation_fault.png) + +| 场景 | 相对残差 | 说明 | +| ---- | ---- | ---- | +| 正常 | ≈ 0% | 指令在推进器能力范围内 | +| 饱和 + clamp | 82.56% | 各推进器被独立裁剪,水平力方向偏差 13.57° | +| 饱和 + scale | 55.92% | 等比缩小 0.441 倍,方向不变,幅度不足 | +| T2 故障 | 15.15% | 剩余推进器重新分配,前进力降到约 25.5 N,转向力矩部分损失 | + +结论:饱和时 `clamp` 的残差反而比 `scale` 更大,因为独立限幅破坏了推进器之间的比例关系; +`scale` 虽然也达不到期望,但至少保持了合力方向,更适合作为默认策略。 + +## 六、讨论与限制 + +1. 伪逆分配只考虑几何关系,没有考虑推进器推力与电压/转速的非线性、死区和效率差异; +2. 本布置横滚不可控,若需要横滚自由度需要增加推进器或改变布置; +3. 故障重构假设已通过检测知道哪个推进器失效,故障诊断本身不在本实验范围内; +4. 离线验证只检查分配矩阵与限幅逻辑,不包含 ROV 动力学响应; +5. 本机为 Windows,没有 ROS 与 ROV 仿真环境,**ROS 端实际运行未验证**, + 需要在 ROS Noetic 与 ROV 仿真器/实机上按 4.1 节复验。 + +## 说明 + +本文档与配套代码在整理过程中使用了 AI 助手(DeepSeek)辅助,实验参数、运行结果 +和图表均由作者实际运行核对;作者对本文内容负全部责任。 diff --git a/mkdocs.yml b/mkdocs.yml index b0722465d0..d7dbc60e0a 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -569,6 +569,7 @@ nav: - ROV 浮力-压载配平与初稳性核算: './water/rov_ballast_trim.md' - ROV 深度保持 PID 控制与扰动恢复仿真: './water/rov_depth_hold.md' - ROV 推进器配置矩阵与饱和感知推力分配: './water/rov_thruster_allocation.md' + - ROV 六推进器推力分配(ROS 1/catkin): './water/rov_thruster_allocation_ros1.md' - 水下多传感器感知与 3D 轨迹跟踪控制: './water/rov_trajectory_tracking.md' - 水下声呐 SLAM 占据栅格建图与自主避障导航: './water/rov_sonar_slam_navigation.md' - MuJoCo 水下 ROV 串级定深控制: './water/mujoco_rov_depth_control.md' diff --git a/src/water/rov_thruster_allocation_ros1/CMakeLists.txt b/src/water/rov_thruster_allocation_ros1/CMakeLists.txt new file mode 100644 index 0000000000..0cd3890a27 --- /dev/null +++ b/src/water/rov_thruster_allocation_ros1/CMakeLists.txt @@ -0,0 +1,23 @@ +cmake_minimum_required(VERSION 3.0.2) +project(rov_thruster_allocation_ros1) + +# 分配算法使用 numpy,ROS Noetic 的 python3-numpy 由系统提供 +find_package(catkin REQUIRED COMPONENTS + rospy + geometry_msgs + std_msgs +) + +catkin_package() + +catkin_install_python(PROGRAMS + main.py + allocation.py + offline_sim.py + DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION} +) + +install(DIRECTORY launch config + DESTINATION ${CATKIN_PACKAGE_SHARE_DESTINATION} + USE_SOURCE_PERMISSIONS +) diff --git a/src/water/rov_thruster_allocation_ros1/README.md b/src/water/rov_thruster_allocation_ros1/README.md new file mode 100644 index 0000000000..7e4d6c217b --- /dev/null +++ b/src/water/rov_thruster_allocation_ros1/README.md @@ -0,0 +1,87 @@ +# rov_thruster_allocation_ros1 — ROV 六推进器推力分配 + +把上层控制器给出的期望力/力矩 `/rov/wrench`(`geometry_msgs/Wrench`,机体坐标系)分配到 +4 个 45° 布置的水平推进器和 2 个垂直推进器,发布 `/rov/thruster_cmd` +(`std_msgs/Float64MultiArray`,单位 N),同时发布实际可达的 `/rov/wrench_achieved` +(`Wrench`)。支持推进器饱和处理和单推进器故障重构。配套教程见 +[docs/water/rov_thruster_allocation_ros1.md](../../docs/water/rov_thruster_allocation_ros1.md)。 + +## 运行环境 + +| 项目 | 配置 | +| ---- | ---- | +| 操作系统 | Ubuntu 20.04(ROS 节点) | +| ROS | ROS Noetic(Python 3) | +| 依赖 | rospy、geometry_msgs、std_msgs、numpy | +| 离线验证 | Windows / Linux,Python 3 + numpy + matplotlib(不需要 ROS) | + +## 运行步骤 + +### 方式一:ROS 节点 + +```bash +# 1. 拷贝到工作空间并编译 +mkdir -p ~/catkin_ws/src +cp -r <本仓库>/src/water/rov_thruster_allocation_ros1 ~/catkin_ws/src/ +chmod +x ~/catkin_ws/src/rov_thruster_allocation_ros1/main.py +cd ~/catkin_ws && catkin_make +source devel/setup.bash + +# 2. 启动分配节点 +roslaunch rov_thruster_allocation_ros1 main.launch + +# 3. 另开终端手动发一个期望 wrench(向前的 20 N 推力) +rostopic pub -1 /rov/wrench geometry_msgs/Wrench \ + "{force: {x: 20.0, y: 0.0, z: 0.0}, torque: {x: 0.0, y: 0.0, z: 0.0}}" + +# 4. 查看分配结果 +rostopic echo /rov/thruster_cmd +rostopic echo /rov/wrench_achieved +``` + +### 方式二:离线仿真(不需要 ROS) + +```bash +cd <本仓库> +python -m pip install numpy matplotlib +python src/water/rov_thruster_allocation_ros1/offline_sim.py +``` + +脚本按一段预设任务发送多组 wrench,输出推进器指令、可达 wrench 和饱和/故障对比图。 + +## 参数 + +| 参数 | 默认值 | 说明 | +| ---- | ---- | ---- | +| `~max_thrust` | 40.0 | 单个推进器最大推力(N) | +| `~saturation_mode` | `scale` | 饱和策略:`scale` 按比例缩小,`clamp` 直接限幅 | +| `~failed_thruster` | -1 | 故障推进器下标(0~5),-1 表示正常 | +| `~control_rate` | 20.0 | 分配频率(Hz) | +| `~wrench_timeout` | 0.5 | 期望 wrench 超时(s),超时后推进器归零 | + +## 话题接口 + +| 方向 | 话题 | 类型 | 说明 | +| ---- | ---- | ---- | ---- | +| 订阅 | `/rov/wrench` | `geometry_msgs/Wrench` | 期望力/力矩(机体坐标系,Z 向上) | +| 发布 | `/rov/thruster_cmd` | `std_msgs/Float64MultiArray` | 6 个推进器推力(N) | +| 发布 | `/rov/wrench_achieved` | `geometry_msgs/Wrench` | 限幅后实际可达的 wrench | + +## 推进器布置 + +| 编号 | 名称 | 位置 (x, y) m | 推力方向 | +| ---- | ---- | ---- | ---- | +| T1 | 前左水平 | (0.22, 0.16) | 45° | +| T2 | 前右水平 | (0.22, -0.16) | −45° | +| T3 | 后左水平 | (−0.22, 0.16) | 135° | +| T4 | 后右水平 | (−0.22, −0.16) | −135° | +| T5 | 前垂直 | (0.18, 0.0) | +Z | +| T6 | 后垂直 | (−0.18, 0.0) | +Z | + +该布置无法产生横滚力矩(Mx),横滚是不可控自由度,分配矩阵秩为 5。 + +## 预期效果 + +正常工况下,分配后的实际 wrench 与期望值误差在数值精度范围内(< 0.01%); +期望推力超过推进器能力时,`scale` 模式按比例缩小并保持方向,`clamp` 模式会改变合力方向; +某个推进器故障后,其余推进器重新分配,仍能保持大部分自由度的控制能力。 diff --git a/src/water/rov_thruster_allocation_ros1/allocation.py b/src/water/rov_thruster_allocation_ros1/allocation.py new file mode 100644 index 0000000000..a1dc6a6e27 --- /dev/null +++ b/src/water/rov_thruster_allocation_ros1/allocation.py @@ -0,0 +1,111 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +"""ROV 六推进器推力分配(纯 Python + numpy,不依赖 ROS)。 + +给定期望的六维力/力矩(机体坐标系,单位 N 与 N·m): + + wrench = [Fx, Fy, Fz, Mx, My, Mz] + +按照推进器布置矩阵 B(6 x N),用最小二乘伪逆求每个推进器的推力: + + T = B^+ * wrench + +并处理两类工程问题: + +1. **饱和**:任一推进器超过最大推力时, + - `clamp` 模式直接限幅(会改变合力的方向); + - `scale` 模式把整个期望力/力矩按比例缩小(方向不变,但幅度变小); +2. **推进器故障**:把故障推进器对应的列从 B 中移除,用剩余推进器重新分配, + 故障推进器输出固定为 0。 + +推进器布置参考 BlueROV2 一类的六推进器 ROV: +4 个 45° 布置的水平推进器 + 2 个垂直推进器。该布置无法产生横滚力矩(Mx), +因此 B 的秩为 5,横滚是不可控自由度。 +""" +from __future__ import print_function + +import numpy as np + +# 推进器布置:名称、安装位置 (x, y) m、推力方向(单位向量,机体坐标系) +THRUSTERS = [ + {'name': 'T1_front_left', 'pos': (0.22, 0.16), 'dir': (0.7071, 0.7071, 0.0)}, + {'name': 'T2_front_right', 'pos': (0.22, -0.16), 'dir': (0.7071, -0.7071, 0.0)}, + {'name': 'T3_rear_left', 'pos': (-0.22, 0.16), 'dir': (-0.7071, 0.7071, 0.0)}, + {'name': 'T4_rear_right', 'pos': (-0.22, -0.16), 'dir': (-0.7071, -0.7071, 0.0)}, + {'name': 'T5_vertical_front', 'pos': (0.18, 0.0), 'dir': (0.0, 0.0, 1.0)}, + {'name': 'T6_vertical_rear', 'pos': (-0.18, 0.0), 'dir': (0.0, 0.0, 1.0)}, +] + +WRENCH_NAMES = ('Fx', 'Fy', 'Fz', 'Mx', 'My', 'Mz') + + +def build_allocation_matrix(thrusters=None): + """由推进器布置构造 6 x N 的分配矩阵 B:wrench = B * T。""" + if thrusters is None: + thrusters = THRUSTERS + B = np.zeros((6, len(thrusters))) + for i, thruster in enumerate(thrusters): + x, y = thruster['pos'] + dx, dy, dz = thruster['dir'] + force = np.array([dx, dy, dz], dtype=float) + moment = np.cross(np.array([x, y, 0.0]), force) + B[:, i] = np.concatenate([force, moment]) + return B + + +def allocate(wrench, max_thrust=20.0, failed=None, mode='scale', thrusters=None): + """把期望 wrench 分配到各推进器。 + + 参数 + ---- + wrench : 长度 6 的序列 [Fx, Fy, Fz, Mx, My, Mz] + max_thrust : 单个推进器最大推力(N) + failed : 故障推进器下标(从 0 开始),None 表示全部正常 + mode : 'scale'(按比例缩小,保方向)或 'clamp'(直接限幅) + thrusters : 可选的自定义推进器布置 + + 返回字典:commands、achieved、residual、saturated、scale、active + """ + if thrusters is None: + thrusters = THRUSTERS + B = build_allocation_matrix(thrusters) + wrench = np.asarray(wrench, dtype=float) + n = B.shape[1] + + active = [i for i in range(n) if i != failed] + B_active = B[:, active] + raw = np.linalg.pinv(B_active).dot(wrench) + + scale = 1.0 + saturated = False + if len(raw) and np.max(np.abs(raw)) > max_thrust: + saturated = True + if mode == 'clamp': + raw = np.clip(raw, -max_thrust, max_thrust) + else: + scale = max_thrust / np.max(np.abs(raw)) + raw = raw * scale + + commands = np.zeros(n) + for k, index in enumerate(active): + commands[index] = raw[k] + + achieved = B.dot(commands) + residual = wrench - achieved + return { + 'commands': commands, + 'achieved': achieved, + 'residual': residual, + 'saturated': saturated, + 'scale': scale, + 'active': active, + } + + +def residual_ratio(result, wrench): + """残差相对期望 wrench 的比例(%),用于横向对比不同分配策略。""" + wrench = np.asarray(wrench, dtype=float) + norm = np.linalg.norm(wrench) + if norm < 1e-12: + return 0.0 + return float(np.linalg.norm(result['residual']) / norm * 100.0) diff --git a/src/water/rov_thruster_allocation_ros1/config/params.yaml b/src/water/rov_thruster_allocation_ros1/config/params.yaml new file mode 100644 index 0000000000..29039416b9 --- /dev/null +++ b/src/water/rov_thruster_allocation_ros1/config/params.yaml @@ -0,0 +1,6 @@ +# 推力分配参数(launch 中作为节点私有参数加载) +max_thrust: 40.0 # 单个推进器最大推力(N) +saturation_mode: scale # 饱和策略:scale 按比例缩小 / clamp 直接限幅 +failed_thruster: -1 # 故障推进器下标(0~5),-1 表示全部正常 +control_rate: 20.0 # 分配频率(Hz) +wrench_timeout: 0.5 # 期望 wrench 超时(s),超时后推进器归零 diff --git a/src/water/rov_thruster_allocation_ros1/launch/main.launch b/src/water/rov_thruster_allocation_ros1/launch/main.launch new file mode 100644 index 0000000000..951e57fabd --- /dev/null +++ b/src/water/rov_thruster_allocation_ros1/launch/main.launch @@ -0,0 +1,17 @@ + + + + + + + + + + + + + + + + diff --git a/src/water/rov_thruster_allocation_ros1/main.py b/src/water/rov_thruster_allocation_ros1/main.py new file mode 100644 index 0000000000..ab0233d50f --- /dev/null +++ b/src/water/rov_thruster_allocation_ros1/main.py @@ -0,0 +1,127 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +"""ROV 推力分配 ROS 节点(模块入口 main.py)。 + +订阅期望力/力矩 `/rov/wrench`(geometry_msgs/Wrench,机体坐标系), +用 allocation.py 的伪逆分配算法把六维 wrench 分配到各推进器, +发布: + + /rov/thruster_cmd std_msgs/Float64MultiArray 各推进器推力(N) + /rov/wrench_achieved geometry_msgs/Wrench 实际可达的 wrench + +支持推进器故障(参数 ~failed_thruster)和两种饱和策略(~saturation_mode): +`scale` 按比例缩小、保持合力方向;`clamp` 直接限幅。 + +运行: + rosrun rov_thruster_allocation_ros1 main.py + roslaunch rov_thruster_allocation_ros1 main.launch +""" +from __future__ import print_function + +import rospy +from geometry_msgs.msg import Wrench +from std_msgs.msg import Float64MultiArray + +from allocation import THRUSTERS, allocate + + +class ThrusterAllocationNode(object): + + def __init__(self): + self.wrench_topic = rospy.get_param('~wrench_topic', '/rov/wrench') + self.cmd_topic = rospy.get_param('~cmd_topic', '/rov/thruster_cmd') + self.achieved_topic = rospy.get_param('~achieved_topic', '/rov/wrench_achieved') + self.max_thrust = rospy.get_param('~max_thrust', 40.0) + self.saturation_mode = rospy.get_param('~saturation_mode', 'scale') + failed = int(rospy.get_param('~failed_thruster', -1)) + self.failed = None if failed < 0 else failed + self.wrench_timeout = rospy.get_param('~wrench_timeout', 0.5) + + if self.failed is not None and not (0 <= self.failed < len(THRUSTERS)): + rospy.logwarn('failed_thruster=%d 超出范围,按无故障处理', self.failed) + self.failed = None + + self.wrench = None + self.last_wrench_time = None + self.was_saturated = False + + self.pub_cmd = rospy.Publisher(self.cmd_topic, Float64MultiArray, queue_size=10) + self.pub_achieved = rospy.Publisher(self.achieved_topic, Wrench, queue_size=10) + rospy.Subscriber(self.wrench_topic, Wrench, self.on_wrench) + + rospy.loginfo('推力分配节点已启动:wrench=%s -> cmd=%s,max_thrust=%.1f N,模式=%s', + self.wrench_topic, self.cmd_topic, self.max_thrust, + self.saturation_mode) + if self.failed is not None: + rospy.logwarn('推进器 %s 已标记为故障,其余推进器重新分配', + THRUSTERS[self.failed]['name']) + + def on_wrench(self, msg): + self.wrench = [msg.force.x, msg.force.y, msg.force.z, + msg.torque.x, msg.torque.y, msg.torque.z] + self.last_wrench_time = rospy.Time.now() + + def publish_cmd(self, commands): + msg = Float64MultiArray() + msg.data = [float(v) for v in commands] + self.pub_cmd.publish(msg) + + def publish_achieved(self, achieved): + msg = Wrench() + msg.force.x, msg.force.y, msg.force.z = achieved[0], achieved[1], achieved[2] + msg.torque.x, msg.torque.y, msg.torque.z = achieved[3], achieved[4], achieved[5] + self.pub_achieved.publish(msg) + + def publish_idle(self): + self.publish_cmd([0.0] * len(THRUSTERS)) + self.publish_achieved([0.0] * 6) + + def run(self): + rate = rospy.Rate(rospy.get_param('~control_rate', 20.0)) + while not rospy.is_shutdown(): + now = rospy.Time.now() + if self.wrench is None or self.last_wrench_time is None: + self.publish_idle() + rate.sleep() + continue + + if (now - self.last_wrench_time).to_sec() > self.wrench_timeout: + self.publish_idle() + rospy.logwarn_throttle(2.0, '超过 %.1f 秒没有收到期望 wrench,推进器已归零', + self.wrench_timeout) + rate.sleep() + continue + + result = allocate(self.wrench, max_thrust=self.max_thrust, + failed=self.failed, mode=self.saturation_mode) + self.publish_cmd(result['commands']) + self.publish_achieved(result['achieved']) + + if result['saturated'] != self.was_saturated: + if result['saturated']: + if self.saturation_mode == 'scale': + rospy.logwarn('推进器饱和,期望 wrench 按 %.2f 比例缩小', + result['scale']) + else: + rospy.logwarn('推进器饱和,已按最大推力限幅') + self.was_saturated = result['saturated'] + + rate.sleep() + + self.publish_idle() + + +def main(): + rospy.init_node('rov_thruster_allocation_ros1') + node = ThrusterAllocationNode() + try: + node.run() + except rospy.ROSInterruptException: + pass + finally: + node.publish_idle() + rospy.loginfo('节点退出,推进器指令已归零') + + +if __name__ == '__main__': + main() diff --git a/src/water/rov_thruster_allocation_ros1/offline_sim.py b/src/water/rov_thruster_allocation_ros1/offline_sim.py new file mode 100644 index 0000000000..e63e425a7e --- /dev/null +++ b/src/water/rov_thruster_allocation_ros1/offline_sim.py @@ -0,0 +1,200 @@ +#!/usr/bin/env python +# -*- coding: utf-8 -*- +"""ROV 推力分配的离线验证与出图(不需要 ROS / 仿真器)。 + +用法(在仓库根目录执行): + python src/water/rov_thruster_allocation_ros1/offline_sim.py + +内容: +1. 一段 12 s 的预设任务(前进、转向、下潜、组合运动),验证正常分配精度; +2. 饱和对比:期望推力超过单推进器上限时,clamp 与 scale 两种策略的差异; +3. 故障对比:T2 推进器失效后,用剩余推进器重新分配的效果。 + +输出: + docs/img/water/rov_thruster_allocation_ros1/thruster_cmds.png + docs/img/water/rov_thruster_allocation_ros1/achieved_vs_desired.png + docs/img/water/rov_thruster_allocation_ros1/saturation_fault.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 allocation import ( # noqa: E402 + THRUSTERS, WRENCH_NAMES, allocate, build_allocation_matrix, residual_ratio, +) + +OUTPUT_DIR = os.path.join(REPO_ROOT, 'docs', 'img', 'water', 'rov_thruster_allocation_ros1') + +RATE = 20.0 +MAX_THRUST = 40.0 +DURATION = 12.0 + + +def mission_wrench(t): + """12 s 预设任务:前进 -> 转向 -> 下潜抬头 -> 组合运动。""" + if t < 3.0: + return [30.0, 0.0, 0.0, 0.0, 0.0, 0.0] + if t < 6.0: + return [0.0, 0.0, 0.0, 0.0, 0.0, 5.0] + if t < 9.0: + return [0.0, 0.0, 20.0, 0.0, 3.0, 0.0] + return [20.0, 10.0, 12.0, 0.0, 0.0, 3.0] + + +def run_mission(): + steps = int(DURATION * RATE) + times = np.arange(steps) / RATE + commands = np.zeros((steps, len(THRUSTERS))) + achieved = np.zeros((steps, 6)) + desired = np.zeros((steps, 6)) + ratios = np.zeros(steps) + + for k, t in enumerate(times): + wrench = mission_wrench(t) + result = allocate(wrench, max_thrust=MAX_THRUST, mode='scale') + commands[k] = result['commands'] + achieved[k] = result['achieved'] + desired[k] = wrench + ratios[k] = residual_ratio(result, wrench) + + return times, desired, achieved, commands, ratios + + +def wrench_angle_error_deg(wrench, result): + """水平推力方向误差(度),用 Fx/Fy 两个分量计算。""" + w = np.asarray(wrench[:2], dtype=float) + a = np.asarray(result['achieved'][:2], dtype=float) + nw, na = np.linalg.norm(w), np.linalg.norm(a) + if nw < 1e-9 or na < 1e-9: + return float('nan') + cos_value = float(np.dot(w, a) / (nw * na)) + cos_value = max(-1.0, min(1.0, cos_value)) + return math.degrees(math.acos(cos_value)) + + +def scenarios(): + """返回各场景的指标,用于柱状图。""" + normal = allocate([20.0, 0.0, 0.0, 0.0, 0.0, 0.0], max_thrust=MAX_THRUST) + over = [80.0, 10.0, 0.0, 0.0, 0.0, 10.0] # 超过推进器能力 + clamp = allocate(over, max_thrust=MAX_THRUST, mode='clamp') + scale = allocate(over, max_thrust=MAX_THRUST, mode='scale') + fault_wrench = [30.0, 0.0, 0.0, 0.0, 0.0, 4.0] + fault = allocate(fault_wrench, max_thrust=MAX_THRUST, failed=1) + + data = { + 'normal': residual_ratio(normal, [20.0, 0.0, 0.0, 0.0, 0.0, 0.0]), + 'clamp': residual_ratio(clamp, over), + 'scale': residual_ratio(scale, over), + 'fault': residual_ratio(fault, fault_wrench), + } + extra = { + 'normal_max_residual_pct': data['normal'], + 'saturation_clamp_residual_pct': data['clamp'], + 'saturation_scale_residual_pct': data['scale'], + 'saturation_scale_factor': scale['scale'], + 'saturation_clamp_angle_error_deg': wrench_angle_error_deg(over, clamp), + 'saturation_scale_angle_error_deg': wrench_angle_error_deg(over, scale), + 'fault_residual_pct': data['fault'], + 'fault_achieved': fault['achieved'].tolist(), + 'fault_commands': fault['commands'].tolist(), + 'matrix_rank': int(np.linalg.matrix_rank(build_allocation_matrix())), + } + return data, extra + + +def plot(times, desired, achieved, commands, ratios, bar_data): + import matplotlib + matplotlib.use('Agg') + import matplotlib.pyplot as plt + + os.makedirs(OUTPUT_DIR, exist_ok=True) + + # 1) 推进器指令 + styles = ['-', '--', '-.', ':'] + fig, axes = plt.subplots(2, 1, figsize=(9, 6), sharex=True) + for i in range(4): + axes[0].plot(times, commands[:, i], label=THRUSTERS[i]['name'], + linewidth=1.6, linestyle=styles[i]) + axes[0].set_ylabel('thrust (N)') + axes[0].set_title('Horizontal thruster commands during the mission') + axes[0].grid(True, alpha=0.3) + axes[0].legend(loc='upper right', fontsize=7, ncol=2) + + for i in (4, 5): + axes[1].plot(times, commands[:, i], label=THRUSTERS[i]['name'], + linewidth=1.6, linestyle=styles[i - 4]) + axes[1].set_xlabel('time (s)') + axes[1].set_ylabel('thrust (N)') + axes[1].set_title('Vertical thruster commands') + axes[1].grid(True, alpha=0.3) + axes[1].legend(loc='upper right', fontsize=8) + fig.tight_layout() + fig.savefig(os.path.join(OUTPUT_DIR, 'thruster_cmds.png'), dpi=150) + plt.close(fig) + + # 2) 期望 vs 实际 wrench(四个可控分量) + components = [0, 1, 2, 5] # Fx, Fy, Fz, Mz + fig, axes = plt.subplots(2, 2, figsize=(9, 6), sharex=True) + for ax, index in zip(axes.flat, components): + ax.plot(times, desired[:, index], 'k--', linewidth=1.5, label='desired') + ax.plot(times, achieved[:, index], color='#1f77b4', linewidth=1.5, label='achieved') + ax.set_title(WRENCH_NAMES[index]) + ax.grid(True, alpha=0.3) + ax.legend(loc='upper right', fontsize=8) + for ax in axes[1]: + ax.set_xlabel('time (s)') + fig.suptitle('Desired vs achieved wrench (normal operation)') + fig.tight_layout() + fig.savefig(os.path.join(OUTPUT_DIR, 'achieved_vs_desired.png'), dpi=150) + plt.close(fig) + + # 3) 饱和与故障残差对比 + labels = ['normal', 'clamp\n(saturated)', 'scale\n(saturated)', 'fault T2'] + values = [bar_data['normal'], bar_data['clamp'], bar_data['scale'], bar_data['fault']] + colors = ['#2ca02c', '#ff7f0e', '#1f77b4', '#d62728'] + fig, ax = plt.subplots(figsize=(7, 4.2)) + bars = ax.bar(labels, values, color=colors) + for bar, value in zip(bars, values): + ax.text(bar.get_x() + bar.get_width() / 2.0, value + 0.3, + '%.2f%%' % value, ha='center', va='bottom', fontsize=9) + ax.set_ylabel('relative wrench residual (%)') + ax.set_title('Allocation residual: normal, saturation and fault') + ax.grid(True, axis='y', alpha=0.3) + fig.tight_layout() + fig.savefig(os.path.join(OUTPUT_DIR, 'saturation_fault.png'), dpi=150) + plt.close(fig) + + +def main(): + times, desired, achieved, commands, ratios = run_mission() + bar_data, extra = scenarios() + plot(times, desired, achieved, commands, ratios, bar_data) + + result = { + 'mission_max_residual_pct': float(ratios.max()), + 'mission_mean_residual_pct': float(ratios.mean()), + 'max_thruster_command_N': float(np.abs(commands).max()), + 'saturation_scale_factor': extra['saturation_scale_factor'], + 'saturation_clamp_residual_pct': extra['saturation_clamp_residual_pct'], + 'saturation_scale_residual_pct': extra['saturation_scale_residual_pct'], + 'saturation_clamp_angle_error_deg': extra['saturation_clamp_angle_error_deg'], + 'fault_T2_residual_pct': extra['fault_residual_pct'], + 'matrix_rank': extra['matrix_rank'], + } + print(json.dumps(result, ensure_ascii=False, indent=2)) + for name in ('thruster_cmds.png', 'achieved_vs_desired.png', 'saturation_fault.png'): + print('figure:', os.path.join(OUTPUT_DIR, name)) + return 0 + + +if __name__ == '__main__': + sys.exit(main()) diff --git a/src/water/rov_thruster_allocation_ros1/package.xml b/src/water/rov_thruster_allocation_ros1/package.xml new file mode 100644 index 0000000000..4bf7760f7d --- /dev/null +++ b/src/water/rov_thruster_allocation_ros1/package.xml @@ -0,0 +1,20 @@ + + + rov_thruster_allocation_ros1 + 0.1.0 + + ROV 六推进器推力分配模块:订阅期望力/力矩 /rov/wrench,用分配矩阵 + 的伪逆把六维 wrench 分配到 4 个水平推进器和 2 个垂直推进器, + 发布 /rov/thruster_cmd 与 /rov/wrench_achieved;支持饱和处理和 + 单推进器故障重构。配套文档见 docs/water/rov_thruster_allocation_ros1.md。 + + xinyangtang91 + MIT + + catkin + + rospy + geometry_msgs + std_msgs + python3-numpy + diff --git a/src/water/rov_thruster_allocation_ros1/test/test_rov_thruster_allocation_ros1_local.py b/src/water/rov_thruster_allocation_ros1/test/test_rov_thruster_allocation_ros1_local.py new file mode 100644 index 0000000000..66b6a2d7fa --- /dev/null +++ b/src/water/rov_thruster_allocation_ros1/test/test_rov_thruster_allocation_ros1_local.py @@ -0,0 +1,145 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""rov_thruster_allocation_ros1 本地测试(不需要 ROS / 仿真器). + +A. 分配矩阵:形状、秩、横滚不可控 +B. 正常分配:合力与期望一致 +C. 饱和:clamp / scale 两种策略与限幅 +D. 故障重构:故障推进器输出为 0,其余推进器重新分配 +E. 工程文件 + +用法: python3 tests/test_rov_thruster_allocation_ros1_local.py +""" +from __future__ import annotations + +import os +import sys +import xml.etree.ElementTree as ET + +import numpy as np + +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 allocation import ( # noqa: E402 + THRUSTERS, allocate, build_allocation_matrix, residual_ratio, +) + + +# ================================================================= A. 分配矩阵 +def test_matrix(): + print("== A. 分配矩阵 ==") + B = build_allocation_matrix() + check(B.shape == (6, len(THRUSTERS)), "B 形状为 6 x %d" % len(THRUSTERS)) + check(np.linalg.matrix_rank(B) == 5, "B 的秩为 5(横滚不可控)") + check(np.allclose(B[3, :], 0.0), "横滚行全为 0") + check(np.allclose(B[2, 4:], [1.0, 1.0]), "两个垂直推进器提供垂向推力") + + +# ================================================================= B. 正常分配 +def test_normal_allocation(): + print("== B. 正常分配 ==") + for wrench in ([30.0, 0.0, 0.0, 0.0, 0.0, 0.0], + [0.0, 0.0, 20.0, 0.0, 3.0, 0.0], + [0.0, 0.0, 0.0, 0.0, 0.0, 5.0]): + result = allocate(wrench, max_thrust=40.0) + check(not result["saturated"], "wrench=%s 未饱和" % wrench[:2]) + check(np.linalg.norm(result["residual"]) < 1e-9, + "wrench=%s 分配残差接近 0" % wrench[:2]) + check(np.all(np.abs(result["commands"]) <= 40.0 + 1e-9), + "各推进器推力不超过 40 N") + + result = allocate([0.0, 0.0, 0.0, 2.0, 0.0, 0.0], max_thrust=40.0) + check(abs(result["achieved"][3]) < 1e-9, "横滚指令无法执行,Mx 实际为 0") + + +# ================================================================= C. 饱和 +def test_saturation(): + print("== C. 饱和处理 ==") + wrench = [80.0, 10.0, 0.0, 0.0, 0.0, 10.0] + clamp = allocate(wrench, max_thrust=40.0, mode="clamp") + scale = allocate(wrench, max_thrust=40.0, mode="scale") + + check(clamp["saturated"] and scale["saturated"], "两种模式都检测到饱和") + check(np.all(np.abs(clamp["commands"]) <= 40.0 + 1e-9), "clamp 后推力不超过上限") + check(np.all(np.abs(scale["commands"]) <= 40.0 + 1e-9), "scale 后推力不超过上限") + check(scale["scale"] < 1.0, "scale 比例小于 1(%.2f)" % scale["scale"]) + + check(residual_ratio(clamp, wrench) > residual_ratio(scale, wrench), + "clamp 残差大于 scale(方向被破坏)") + check(np.allclose(scale["achieved"], np.array(wrench) * scale["scale"], atol=1e-9), + "scale 模式下实际 wrench 与期望成正比(保持方向)") + + +# ================================================================= D. 故障重构 +def test_fault(): + print("== D. 故障重构 ==") + result = allocate([30.0, 0.0, 0.0, 0.0, 0.0, 4.0], max_thrust=40.0, failed=1) + check(result["commands"][1] == 0.0, "故障推进器 T2 指令为 0") + check(1 not in result["active"] and len(result["active"]) == len(THRUSTERS) - 1, + "活动推进器数量少 1") + check(abs(result["achieved"][0]) > 20.0, "剩余推进器仍能提供主要前进推力") + check(result["residual"][0] != 0.0, "故障后存在不可完全补偿的残差") + + +# ================================================================= E. 工程文件 +def test_project_files(): + print("== E. 工程文件 ==") + pkg = ET.parse(os.path.join(PKG, "package.xml")).getroot() + check(pkg.findtext("name").strip() == "rov_thruster_allocation_ros1", "package.xml 包名正确") + check(pkg.get("format") == "3", "package.xml 使用 format=\"3\"") + deps = [d.text.strip() for d in pkg.findall("depend")] + for dep in ("rospy", "geometry_msgs", "std_msgs"): + check(dep in deps, "package.xml 声明依赖 %s" % dep) + exec_deps = [d.text.strip() for d in pkg.findall("exec_depend")] + check("python3-numpy" in exec_deps, "package.xml 声明 python3-numpy 运行依赖") + + cmake = open(os.path.join(PKG, "CMakeLists.txt"), encoding="utf-8").read() + for name in ("main.py", "allocation.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 ("wrench_topic", "cmd_topic", "failed_thruster"): + check(name in args, "main.launch 暴露参数 %s" % name) + + check(os.path.exists(os.path.join(PKG, "README.md")), "README.md 存在") + for rel in ( + "docs/water/rov_thruster_allocation_ros1.md", + "docs/img/water/rov_thruster_allocation_ros1/thruster_cmds.png", + "docs/img/water/rov_thruster_allocation_ros1/achieved_vs_desired.png", + "docs/img/water/rov_thruster_allocation_ros1/saturation_fault.png", + ): + check(os.path.exists(os.path.join(ROOT, rel)), "文件存在:%s" % rel) + + +def main(): + test_matrix() + test_normal_allocation() + test_saturation() + test_fault() + 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())