From 4d76f8965b0a25e0c3382fd789862bfdbc51a357 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Thu, 12 Nov 2026 21:04:58 +0800 Subject: [PATCH 01/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E9=8F=83?= =?UTF-8?q?=E7=8A=B1=E6=B1=89=E9=8F=88=E5=93=84=E7=86=80=E7=BA=AD=E2=82=AC?= =?UTF-8?q?=E6=A4=8B=E7=82=B6=EE=94=91=E5=A6=AF=E2=80=B3=E6=BD=A1=E9=94=9B?= =?UTF-8?q?=E5=A0=A5=E6=95=AD=E9=90=A9=E6=A9=80=E4=BB=B4=E9=8E=BA=3F+=20?= =?UTF-8?q?=E6=9D=A9=E6=84=AC=E5=A7=A9=E7=80=9B=EF=B8=BF=E8=B1=A2=E9=90=AA?= =?UTF-8?q?=3F+=20=E9=90=98=E8=88=B5=E2=82=AC=E4=BD=BA=E6=B4=83=E9=8E=BA?= =?UTF-8?q?=D1=8D=E7=B4=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/uav_flight_base/CMakeLists.txt | 24 ++++++++++++++++++++++++ 1 file changed, 24 insertions(+) create mode 100644 src/uav_flight_base/CMakeLists.txt diff --git a/src/uav_flight_base/CMakeLists.txt b/src/uav_flight_base/CMakeLists.txt new file mode 100644 index 0000000000..e0aff52cde --- /dev/null +++ b/src/uav_flight_base/CMakeLists.txt @@ -0,0 +1,24 @@ +cmake_minimum_required(VERSION 3.0.2) +project(uav_flight_base) + +find_package(catkin REQUIRED COMPONENTS + rospy + geometry_msgs + nav_msgs + tf2_ros +) + +catkin_package( + CATKIN_DEPENDS rospy geometry_msgs nav_msgs tf2_ros +) + +catkin_install_python(PROGRAMS + scripts/uav_teleop_key.py + scripts/uav_mock_sim.py + scripts/uav_state_monitor.py + DESTINATION ${CATKIN_PACKAGE_BIN_DESTINATION} +) + +install(DIRECTORY launch + DESTINATION ${CATKIN_PACKAGE_SHARE_DESTINATION} +) From a2bdf183516e0fd74e920010a9ef3025d8755efc Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Thu, 12 Nov 2026 21:05:00 +0800 Subject: [PATCH 02/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E9=8F=83?= =?UTF-8?q?=E7=8A=B1=E6=B1=89=E9=8F=88=E5=93=84=E7=86=80=E7=BA=AD=E2=82=AC?= =?UTF-8?q?=E6=A4=8B=E7=82=B6=EE=94=91=E5=A6=AF=E2=80=B3=E6=BD=A1=E9=94=9B?= =?UTF-8?q?=E5=A0=A5=E6=95=AD=E9=90=A9=E6=A9=80=E4=BB=B4=E9=8E=BA=3F+=20?= =?UTF-8?q?=E6=9D=A9=E6=84=AC=E5=A7=A9=E7=80=9B=EF=B8=BF=E8=B1=A2=E9=90=AA?= =?UTF-8?q?=3F+=20=E9=90=98=E8=88=B5=E2=82=AC=E4=BD=BA=E6=B4=83=E9=8E=BA?= =?UTF-8?q?=D1=8D=E7=B4=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/uav_flight_base/launch/main.launch | 48 ++++++++++++++++++++++++++ 1 file changed, 48 insertions(+) create mode 100644 src/uav_flight_base/launch/main.launch diff --git a/src/uav_flight_base/launch/main.launch b/src/uav_flight_base/launch/main.launch new file mode 100644 index 0000000000..494eb89c7b --- /dev/null +++ b/src/uav_flight_base/launch/main.launch @@ -0,0 +1,48 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + From 3efc12aaba201697d7b57e60f40a22f4abff5ee1 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Thu, 12 Nov 2026 21:05:02 +0800 Subject: [PATCH 03/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E9=8F=83?= =?UTF-8?q?=E7=8A=B1=E6=B1=89=E9=8F=88=E5=93=84=E7=86=80=E7=BA=AD=E2=82=AC?= =?UTF-8?q?=E6=A4=8B=E7=82=B6=EE=94=91=E5=A6=AF=E2=80=B3=E6=BD=A1=E9=94=9B?= =?UTF-8?q?=E5=A0=A5=E6=95=AD=E9=90=A9=E6=A9=80=E4=BB=B4=E9=8E=BA=3F+=20?= =?UTF-8?q?=E6=9D=A9=E6=84=AC=E5=A7=A9=E7=80=9B=EF=B8=BF=E8=B1=A2=E9=90=AA?= =?UTF-8?q?=3F+=20=E9=90=98=E8=88=B5=E2=82=AC=E4=BD=BA=E6=B4=83=E9=8E=BA?= =?UTF-8?q?=D1=8D=E7=B4=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/uav_flight_base/main.py | 67 +++++++++++++++++++++++++++++++++++++ 1 file changed, 67 insertions(+) create mode 100644 src/uav_flight_base/main.py diff --git a/src/uav_flight_base/main.py b/src/uav_flight_base/main.py new file mode 100644 index 0000000000..4debd27f70 --- /dev/null +++ b/src/uav_flight_base/main.py @@ -0,0 +1,67 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""uav_flight_base 模块入口。 + +用法: + python3 main.py # 默认 mock 模式(不需要任何模拟器) + python3 main.py --mode gazebo # 接 Gazebo(需要额外安装 uav 模型) + python3 main.py --list # 只打印可用节点,不启动 + +约定(对齐 OpenHUTB 仓库规范): + · 入口文件名为 main.* + · ROS 启动配置为 launch/main.launch + · 所有参数通过 roslaunch args 或 rosparam 传入,不写死在代码里 +""" + +import argparse +import os +import subprocess +import sys + +MODES = ("mock", "gazebo") + + +def build_launch_cmd(mode, extra_args): + return ["roslaunch", "uav_flight_base", "main.launch", + "mode:={}".format(mode)] + extra_args + + +def main(): + ap = argparse.ArgumentParser(description="无人机基础飞行模块(键盘遥控 / 状态监控)") + ap.add_argument("--mode", default="mock", choices=MODES, + help="mock=纯软件仿真,gazebo=接 Gazebo 世界") + ap.add_argument("--list", action="store_true", help="打印节点清单后退出") + ap.add_argument("--no-launch", action="store_true", + help="不调用 roslaunch,只打印将要执行的命令") + args, extra = ap.parse_known_args() + + pkg_dir = os.path.dirname(os.path.abspath(__file__)) + scripts = sorted( + f for f in os.listdir(os.path.join(pkg_dir, "scripts")) + if f.endswith(".py") + ) if os.path.isdir(os.path.join(pkg_dir, "scripts")) else [] + + if args.list: + print("package : uav_flight_base") + print("mode : {}".format(args.mode)) + print("nodes :") + for s in scripts: + print(" - {}".format(s)) + return 0 + + cmd = build_launch_cmd(args.mode, extra) + print("[uav_flight_base] mode = {}".format(args.mode)) + print("[uav_flight_base] exec: {}".format(" ".join(cmd))) + + if args.no_launch: + return 0 + + try: + return subprocess.call(cmd) + except FileNotFoundError: + sys.stderr.write("找不到 roslaunch,请先 source /opt/ros/noetic/setup.bash\n") + return 127 + + +if __name__ == "__main__": + sys.exit(main()) From 27904a76ae108447a570d7e119d9853a064c84e2 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Thu, 12 Nov 2026 21:05:05 +0800 Subject: [PATCH 04/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E9=8F=83?= =?UTF-8?q?=E7=8A=B1=E6=B1=89=E9=8F=88=E5=93=84=E7=86=80=E7=BA=AD=E2=82=AC?= =?UTF-8?q?=E6=A4=8B=E7=82=B6=EE=94=91=E5=A6=AF=E2=80=B3=E6=BD=A1=E9=94=9B?= =?UTF-8?q?=E5=A0=A5=E6=95=AD=E9=90=A9=E6=A9=80=E4=BB=B4=E9=8E=BA=3F+=20?= =?UTF-8?q?=E6=9D=A9=E6=84=AC=E5=A7=A9=E7=80=9B=EF=B8=BF=E8=B1=A2=E9=90=AA?= =?UTF-8?q?=3F+=20=E9=90=98=E8=88=B5=E2=82=AC=E4=BD=BA=E6=B4=83=E9=8E=BA?= =?UTF-8?q?=D1=8D=E7=B4=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/uav_flight_base/package.xml | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) create mode 100644 src/uav_flight_base/package.xml diff --git a/src/uav_flight_base/package.xml b/src/uav_flight_base/package.xml new file mode 100644 index 0000000000..a735d704de --- /dev/null +++ b/src/uav_flight_base/package.xml @@ -0,0 +1,18 @@ + + + uav_flight_base + 0.1.0 + 无人机基础飞行模块:键盘遥控、最小运动学仿真、状态监控(ROS1 Noetic) + + 唐健斌 + MIT + + catkin + + rospy + geometry_msgs + nav_msgs + tf2_ros + + + From 18d2ca02a7851828cdfbf8575f33821daaf9892d Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Thu, 12 Nov 2026 21:05:07 +0800 Subject: [PATCH 05/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E9=8F=83?= =?UTF-8?q?=E7=8A=B1=E6=B1=89=E9=8F=88=E5=93=84=E7=86=80=E7=BA=AD=E2=82=AC?= =?UTF-8?q?=E6=A4=8B=E7=82=B6=EE=94=91=E5=A6=AF=E2=80=B3=E6=BD=A1=E9=94=9B?= =?UTF-8?q?=E5=A0=A5=E6=95=AD=E9=90=A9=E6=A9=80=E4=BB=B4=E9=8E=BA=3F+=20?= =?UTF-8?q?=E6=9D=A9=E6=84=AC=E5=A7=A9=E7=80=9B=EF=B8=BF=E8=B1=A2=E9=90=AA?= =?UTF-8?q?=3F+=20=E9=90=98=E8=88=B5=E2=82=AC=E4=BD=BA=E6=B4=83=E9=8E=BA?= =?UTF-8?q?=D1=8D=E7=B4=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/uav_flight_base/README.md | 112 ++++++++++++++++++++++++++++++++++ 1 file changed, 112 insertions(+) create mode 100644 src/uav_flight_base/README.md diff --git a/src/uav_flight_base/README.md b/src/uav_flight_base/README.md new file mode 100644 index 0000000000..803a31dc16 --- /dev/null +++ b/src/uav_flight_base/README.md @@ -0,0 +1,112 @@ +# uav_flight_base + +无人机基础飞行模块(ROS1 Noetic)。提供**键盘遥控**、**最小运动学仿真**、**状态监控**三部分, +不依赖 Gazebo / AirSim 即可完整跑通,用于验证"遥控 → 控制 → 状态反馈"这条链路。 + +> 这是 10 次提交中的第 1 次:只做骨架与可运行的最小闭环。后续按任务 2/3/4 逐步加感知、建图、端到端网络。 + +## 目录结构 + +``` +uav_flight_base/ +├── main.py # 入口(仓库约定:入口以 main. 开头) +├── CMakeLists.txt +├── package.xml +├── launch/ +│ └── main.launch # ROS 启动配置(仓库约定:main.launch) +└── scripts/ + ├── uav_teleop_key.py # 键盘 → /uav/cmd_vel + ├── uav_mock_sim.py # 运动学仿真 → /uav/odom + TF + └── uav_state_monitor.py # 状态打印 / CSV 记录 +``` + +## 环境 + +| 项目 | 版本 | +|---|---| +| 系统 | Ubuntu 20.04 | +| ROS | Noetic | +| Python | 3.8 | +| 依赖 | rospy / geometry_msgs / nav_msgs / tf2_ros(ROS 自带) | + +## 安装 + +```bash +# 1. 放进 catkin 工作空间 +cp -r uav_flight_base ~/catkin_ws/src/ + +# 2. 编译 +cd ~/catkin_ws +catkin_make +source devel/setup.bash +``` + +## 运行 + +**方式一:看效果(需要图形界面)** + +```bash +rosrun uav_flight_base main.py --mode mock +``` + +会启动仿真节点 + 状态监控 + 键盘遥控窗口(xterm)。 + +**方式二:只跑链路(不需要键盘)** + +```bash +roslaunch uav_flight_base main.launch mode:=mock teleop:=false +``` + +另开一个终端手动发速度指令: + +```bash +rostopic pub -r 10 /uav/cmd_vel geometry_msgs/Twist \ + '{linear: {x: 1.0, y: 0.0, z: 0.5}, angular: {z: 0.3}}' +``` + +**方式三:记录飞行数据** + +```bash +roslaunch uav_flight_base main.launch mode:=mock teleop:=false csv:=/tmp/flight.csv +``` + +## 键盘操作 + +| 按键 | 动作 | +|---|---| +| `w` / `s` | 前进 / 后退 | +| `a` / `d` | 左移 / 右移 | +| `r` / `f` | 上升 / 下降 | +| `q` / `e` | 左转 / 右转 | +| `空格` | 悬停(速度清零) | +| `Ctrl+C` | 退出 | + +## 预期输出 + +``` +[uav_flight_base] mode = mock +[INFO] [uav_state_monitor]: [ 0.5s] pos=( 0.42, 0.00, 1.50) yaw= 0.0° v=0.61 m/s +[INFO] [uav_state_monitor]: [ 1.0s] pos=( 0.88, 0.12, 1.62) yaw= 6.9° v=0.95 m/s +``` + +## 参数 + +| 参数 | 默认 | 说明 | +|---|---|---| +| `~rate` | 50.0 | 仿真频率 Hz | +| `~time_constant` | 0.35 | 一阶惯性时间常数,越大越"肉" | +| `~max_speed` | 5.0 | 最大速度 m/s | +| `~z_min` / `~z_max` | 0.2 / 30.0 | 高度限制 m | +| `~cmd_topic` | `/uav/cmd_vel` | 速度指令话题 | +| `~odom_topic` | `/uav/odom` | 里程计话题 | + +## 后续计划 + +- [ ] 接 Gazebo 无人机模型(`mode:=gazebo`) +- [ ] 深度图避障 +- [ ] 栅格建图 + A* 导航 +- [ ] 端到端 CNN(图像 → 控制) + +## 许可 + +MIT From f8448cc9657e6f6f5dbb49cef0bd11fde9932d89 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Thu, 12 Nov 2026 21:05:09 +0800 Subject: [PATCH 06/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E9=8F=83?= =?UTF-8?q?=E7=8A=B1=E6=B1=89=E9=8F=88=E5=93=84=E7=86=80=E7=BA=AD=E2=82=AC?= =?UTF-8?q?=E6=A4=8B=E7=82=B6=EE=94=91=E5=A6=AF=E2=80=B3=E6=BD=A1=E9=94=9B?= =?UTF-8?q?=E5=A0=A5=E6=95=AD=E9=90=A9=E6=A9=80=E4=BB=B4=E9=8E=BA=3F+=20?= =?UTF-8?q?=E6=9D=A9=E6=84=AC=E5=A7=A9=E7=80=9B=EF=B8=BF=E8=B1=A2=E9=90=AA?= =?UTF-8?q?=3F+=20=E9=90=98=E8=88=B5=E2=82=AC=E4=BD=BA=E6=B4=83=E9=8E=BA?= =?UTF-8?q?=D1=8D=E7=B4=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/uav_flight_base/scripts/uav_mock_sim.py | 123 ++++++++++++++++++++ 1 file changed, 123 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_mock_sim.py diff --git a/src/uav_flight_base/scripts/uav_mock_sim.py b/src/uav_flight_base/scripts/uav_mock_sim.py new file mode 100644 index 0000000000..d4219877b6 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_mock_sim.py @@ -0,0 +1,123 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""最小无人机运动学仿真(无需 Gazebo)。 + +订阅 /uav/cmd_vel,按一阶惯性模型积分出位置与姿态, +发布 /uav/odom(nav_msgs/Odometry)和 map->base_link 的 TF。 + +用途: + 1) 没有模拟器时也能验证遥控、控制器、可视化链路 + 2) 给后续 SLAM / 端到端模块提供稳定的 odom 源 +""" + +import math + +import rospy +import tf2_ros +from geometry_msgs.msg import Twist, TransformStamped +from nav_msgs.msg import Odometry + + +def yaw_to_quat(yaw): + return (0.0, 0.0, math.sin(yaw * 0.5), math.cos(yaw * 0.5)) + + +class MockUav(object): + def __init__(self): + self.topic_cmd = rospy.get_param("~cmd_topic", "/uav/cmd_vel") + self.topic_odom = rospy.get_param("~odom_topic", "/uav/odom") + self.rate_hz = float(rospy.get_param("~rate", 50.0)) + self.tau = float(rospy.get_param("~time_constant", 0.35)) # 一阶惯性 + self.max_speed = float(rospy.get_param("~max_speed", 5.0)) + self.z_min = float(rospy.get_param("~z_min", 0.2)) + self.z_max = float(rospy.get_param("~z_max", 30.0)) + + self.x = float(rospy.get_param("~init_x", 0.0)) + self.y = float(rospy.get_param("~init_y", 0.0)) + self.z = float(rospy.get_param("~init_z", 1.5)) + self.yaw = float(rospy.get_param("~init_yaw", 0.0)) + + self.vx = self.vy = self.vz = 0.0 + self.wz = 0.0 + + self.cmd = Twist() + self.sub = rospy.Subscriber(self.topic_cmd, Twist, self.on_cmd, queue_size=1) + self.pub = rospy.Publisher(self.topic_odom, Odometry, queue_size=1) + self.br = tf2_ros.TransformBroadcaster() + self.last = rospy.Time.now() + + def on_cmd(self, msg): + self.cmd = msg + + def clip(self, v): + return max(-self.max_speed, min(self.max_speed, v)) + + def step(self, dt): + ax = (self.cmd.linear.x - self.vx) / self.tau + ay = (self.cmd.linear.y - self.vy) / self.tau + az = (self.cmd.linear.z - self.vz) / self.tau + aw = (self.cmd.angular.z - self.wz) / self.tau + + self.vx = self.clip(self.vx + ax * dt) + self.vy = self.clip(self.vy + ay * dt) + self.vz = self.clip(self.vz + az * dt) + self.wz = self.wz + aw * dt + + # 机体速度转到世界坐标系 + cy, sy = math.cos(self.yaw), math.sin(self.yaw) + self.x += (self.vx * cy - self.vy * sy) * dt + self.y += (self.vx * sy + self.vy * cy) * dt + self.z = max(self.z_min, min(self.z_max, self.z + self.vz * dt)) + self.yaw += self.wz * dt + + def publish(self, now): + qx, qy, qz, qw = yaw_to_quat(self.yaw) + + odom = Odometry() + odom.header.stamp = now + odom.header.frame_id = "map" + odom.child_frame_id = "base_link" + odom.pose.pose.position.x = self.x + odom.pose.pose.position.y = self.y + odom.pose.pose.position.z = self.z + odom.pose.pose.orientation.x = qx + odom.pose.pose.orientation.y = qy + odom.pose.pose.orientation.z = qz + odom.pose.pose.orientation.w = qw + odom.twist.twist.linear.x = self.vx + odom.twist.twist.linear.y = self.vy + odom.twist.twist.linear.z = self.vz + odom.twist.twist.angular.z = self.wz + self.pub.publish(odom) + + tf = TransformStamped() + tf.header.stamp = now + tf.header.frame_id = "map" + tf.child_frame_id = "base_link" + tf.transform.translation.x = self.x + tf.transform.translation.y = self.y + tf.transform.translation.z = self.z + tf.transform.rotation.x = qx + tf.transform.rotation.y = qy + tf.transform.rotation.z = qz + tf.transform.rotation.w = qw + self.br.sendTransform(tf) + + def spin(self): + r = rospy.Rate(self.rate_hz) + while not rospy.is_shutdown(): + now = rospy.Time.now() + dt = max(1e-4, (now - self.last).to_sec()) + self.last = now + self.step(min(dt, 0.1)) + self.publish(now) + r.sleep() + + +def main(): + rospy.init_node("uav_mock_sim") + MockUav().spin() + + +if __name__ == "__main__": + main() From d10b80f7ebeff86a10452ed32ef4d6da2f5bdebe Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Thu, 12 Nov 2026 21:05:12 +0800 Subject: [PATCH 07/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E9=8F=83?= =?UTF-8?q?=E7=8A=B1=E6=B1=89=E9=8F=88=E5=93=84=E7=86=80=E7=BA=AD=E2=82=AC?= =?UTF-8?q?=E6=A4=8B=E7=82=B6=EE=94=91=E5=A6=AF=E2=80=B3=E6=BD=A1=E9=94=9B?= =?UTF-8?q?=E5=A0=A5=E6=95=AD=E9=90=A9=E6=A9=80=E4=BB=B4=E9=8E=BA=3F+=20?= =?UTF-8?q?=E6=9D=A9=E6=84=AC=E5=A7=A9=E7=80=9B=EF=B8=BF=E8=B1=A2=E9=90=AA?= =?UTF-8?q?=3F+=20=E9=90=98=E8=88=B5=E2=82=AC=E4=BD=BA=E6=B4=83=E9=8E=BA?= =?UTF-8?q?=D1=8D=E7=B4=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- .../scripts/uav_state_monitor.py | 78 +++++++++++++++++++ 1 file changed, 78 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_state_monitor.py diff --git a/src/uav_flight_base/scripts/uav_state_monitor.py b/src/uav_flight_base/scripts/uav_state_monitor.py new file mode 100644 index 0000000000..891dc166aa --- /dev/null +++ b/src/uav_flight_base/scripts/uav_state_monitor.py @@ -0,0 +1,78 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""状态监控节点:订阅 odom,定时打印飞行状态,可另存 CSV。 + +输出示例: + [ 12.3s] pos=( 3.21, -1.05, 1.50) yaw= 12.4° v= 1.02 m/s +""" + +import math +import os + +import rospy +from nav_msgs.msg import Odometry + + +def yaw_from_quat(q): + siny = 2.0 * (q.w * q.z + q.x * q.y) + cosy = 1.0 - 2.0 * (q.y * q.y + q.z * q.z) + return math.atan2(siny, cosy) + + +class Monitor(object): + def __init__(self): + self.topic = rospy.get_param("~odom_topic", "/uav/odom") + self.period = float(rospy.get_param("~period", 0.5)) + self.csv_path = rospy.get_param("~csv", "") + + self.t0 = None + self.rows = [] + self.latest = None + + self.sub = rospy.Subscriber(self.topic, Odometry, self.on_odom, queue_size=1) + self.timer = rospy.Timer(rospy.Duration(self.period), self.on_timer) + + def on_odom(self, msg): + if self.t0 is None: + self.t0 = msg.header.stamp + self.latest = msg + if self.csv_path: + p = msg.pose.pose.position + self.rows.append([msg.header.stamp.to_sec(), p.x, p.y, p.z, + yaw_from_quat(msg.pose.pose.orientation)]) + + def on_timer(self, _evt): + m = self.latest + if m is None: + rospy.loginfo_throttle(5.0, "等待 %s ...", self.topic) + return + p = m.pose.pose.position + v = m.twist.twist.linear + speed = math.sqrt(v.x ** 2 + v.y ** 2 + v.z ** 2) + t = (m.header.stamp - self.t0).to_sec() + rospy.loginfo("[%6.1fs] pos=(%6.2f,%6.2f,%6.2f) yaw=%6.1f° v=%.2f m/s", + t, p.x, p.y, p.z, + math.degrees(yaw_from_quat(m.pose.pose.orientation)), speed) + + def save(self): + if not self.csv_path or not self.rows: + return + d = os.path.dirname(os.path.abspath(self.csv_path)) + if d and not os.path.isdir(d): + os.makedirs(d) + with open(self.csv_path, "w") as f: + f.write("t,x,y,z,yaw\n") + for r in self.rows: + f.write(",".join("%.4f" % x for x in r) + "\n") + rospy.loginfo("已保存 %d 行到 %s", len(self.rows), self.csv_path) + + +def main(): + rospy.init_node("uav_state_monitor") + mon = Monitor() + rospy.on_shutdown(mon.save) + rospy.spin() + + +if __name__ == "__main__": + main() From 114d853acb0156e7bac3a6bb6425afeb3a0a876a Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Thu, 12 Nov 2026 21:05:14 +0800 Subject: [PATCH 08/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E9=8F=83?= =?UTF-8?q?=E7=8A=B1=E6=B1=89=E9=8F=88=E5=93=84=E7=86=80=E7=BA=AD=E2=82=AC?= =?UTF-8?q?=E6=A4=8B=E7=82=B6=EE=94=91=E5=A6=AF=E2=80=B3=E6=BD=A1=E9=94=9B?= =?UTF-8?q?=E5=A0=A5=E6=95=AD=E9=90=A9=E6=A9=80=E4=BB=B4=E9=8E=BA=3F+=20?= =?UTF-8?q?=E6=9D=A9=E6=84=AC=E5=A7=A9=E7=80=9B=EF=B8=BF=E8=B1=A2=E9=90=AA?= =?UTF-8?q?=3F+=20=E9=90=98=E8=88=B5=E2=82=AC=E4=BD=BA=E6=B4=83=E9=8E=BA?= =?UTF-8?q?=D1=8D=E7=B4=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- src/uav_flight_base/scripts/uav_teleop_key.py | 101 ++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_teleop_key.py diff --git a/src/uav_flight_base/scripts/uav_teleop_key.py b/src/uav_flight_base/scripts/uav_teleop_key.py new file mode 100644 index 0000000000..ecfffe8725 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_teleop_key.py @@ -0,0 +1,101 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""键盘遥控节点:把按键转成 /uav/cmd_vel(geometry_msgs/Twist)。 + +按键(按住生效,松开自动归零): + w / s 前后(+x / -x) + a / d 左右(+y / -y) + r / f 升降(+z / -z) + q / e 偏航(+yaw / -yaw) + 空格 悬停(速度清零) + Ctrl+C 退出 +""" + +import sys +import termios +import tty +import select + +import rospy +from geometry_msgs.msg import Twist + +HELP = """ +------------------------------ + w/s : 前进 / 后退 + a/d : 左移 / 右移 + r/f : 上升 / 下降 + q/e : 左转 / 右转 + 空格: 悬停(清零) + Ctrl+C 退出 +------------------------------ +""" + +KEYMAP = { + "w": ("linear", "x", 1.0), + "s": ("linear", "x", -1.0), + "a": ("linear", "y", 1.0), + "d": ("linear", "y", -1.0), + "r": ("linear", "z", 1.0), + "f": ("linear", "z", -1.0), + "q": ("angular", "z", 1.0), + "e": ("angular", "z", -1.0), +} + + +def get_key(timeout=0.1): + """非阻塞读一个字符;没有输入返回空串。""" + dr, _, _ = select.select([sys.stdin], [], [], timeout) + if not dr: + return "" + return sys.stdin.read(1) + + +def main(): + rospy.init_node("uav_teleop_key") + + topic = rospy.get_param("~cmd_topic", "/uav/cmd_vel") + speed = float(rospy.get_param("~speed", 1.0)) # m/s + yaw_rate = float(rospy.get_param("~yaw_rate", 0.8)) # rad/s + rate_hz = float(rospy.get_param("~rate", 20.0)) + + pub = rospy.Publisher(topic, Twist, queue_size=1) + rate = rospy.Rate(rate_hz) + + if not sys.stdin.isatty(): + rospy.logwarn("stdin 不是终端,键盘读取会失效;请在交互式终端里运行") + return + + old = termios.tcgetattr(sys.stdin) + print(HELP) + cmd = Twist() + + try: + tty.setcbreak(sys.stdin.fileno()) + while not rospy.is_shutdown(): + key = get_key(1.0 / rate_hz) + if key: + if key == " ": + cmd = Twist() + rospy.loginfo("悬停") + elif key in KEYMAP: + axis, comp, sign = KEYMAP[key] + cmd = Twist() + value = sign * (yaw_rate if axis == "angular" else speed) + vec = getattr(cmd, axis) + setattr(vec, comp, value) + rospy.loginfo("cmd %s.%s = %.2f", axis, comp, value) + elif key in ("\x03",): + break + pub.publish(cmd) + rate.sleep() + finally: + termios.tcsetattr(sys.stdin, termios.TCSADRAIN, old) + pub.publish(Twist()) + print("\n已退出,速度已归零") + + +if __name__ == "__main__": + try: + main() + except rospy.ROSInterruptException: + pass From a77385f879e2caec7f9185e9005d7d2482cab894 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Thu, 12 Nov 2026 21:05:16 +0800 Subject: [PATCH 09/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E9=8F=83?= =?UTF-8?q?=E7=8A=B1=E6=B1=89=E9=8F=88=E5=93=84=E7=86=80=E7=BA=AD=E2=82=AC?= =?UTF-8?q?=E6=A4=8B=E7=82=B6=EE=94=91=E5=A6=AF=E2=80=B3=E6=BD=A1=E9=94=9B?= =?UTF-8?q?=E5=A0=A5=E6=95=AD=E9=90=A9=E6=A9=80=E4=BB=B4=E9=8E=BA=3F+=20?= =?UTF-8?q?=E6=9D=A9=E6=84=AC=E5=A7=A9=E7=80=9B=EF=B8=BF=E8=B1=A2=E9=90=AA?= =?UTF-8?q?=3F+=20=E9=90=98=E8=88=B5=E2=82=AC=E4=BD=BA=E6=B4=83=E9=8E=BA?= =?UTF-8?q?=D1=8D=E7=B4=9A?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/uav_flight_base/README.md | 75 ++++++++++++++++++++++++++++++++++ 1 file changed, 75 insertions(+) create mode 100644 docs/uav_flight_base/README.md diff --git a/docs/uav_flight_base/README.md b/docs/uav_flight_base/README.md new file mode 100644 index 0000000000..c733788490 --- /dev/null +++ b/docs/uav_flight_base/README.md @@ -0,0 +1,75 @@ +# uav_flight_base + +> 无人机基础飞行模块:键盘遥控 + 最小运动学仿真 + 状态监控 +> 作者:唐健斌 | 环境:Ubuntu 20.04 + ROS Noetic + +## 模块定位 + +课程作业要求里,"人体/车辆/无人机/水下机器人"任选其一。本模块选**无人机**, +并先解决最基础的一件事:**让一架无人机在仿真里被控制起来,并且状态可观测**。 + +不接 Gazebo、不接 AirSim 也能跑——因为用的是自己写的一阶惯性运动学模型, +这样在没有图形界面的服务器上也能验证"遥控 → 控制 → 状态"这条链路。 + +## 数据流 + +``` +键盘 (uav_teleop_key) + │ /uav/cmd_vel (geometry_msgs/Twist) + ▼ +运动学仿真 (uav_mock_sim) + │ /uav/odom (nav_msgs/Odometry) + │ TF: map -> base_link + ▼ +状态监控 (uav_state_monitor) + │ 终端打印 / CSV + ▼ +RViz / rqt_plot(可选) +``` + +## 话题 + +| 话题 | 类型 | 方向 | 说明 | +|---|---|---|---| +| `/uav/cmd_vel` | `geometry_msgs/Twist` | 订阅 | 期望速度(机体系) | +| `/uav/odom` | `nav_msgs/Odometry` | 发布 | 位置、姿态、速度 | +| `/tf` | `tf2_msgs/TFMessage` | 发布 | `map` → `base_link` | + +## 运动学模型 + +一阶惯性环节,避免"按键即瞬移"的不真实感: + +``` +dv/dt = (v_cmd - v) / τ +``` + +- `τ`(`~time_constant`,默认 0.35s)越大,响应越"肉" +- 速度分别裁剪到 `±max_speed` +- 高度限制在 `[z_min, z_max]` + +## 启动 + +```bash +rosrun uav_flight_base main.py --mode mock +``` + +或 + +```bash +roslaunch uav_flight_base main.launch mode:=mock teleop:=false +``` + +## 验证清单 + +- [x] `rostopic hz /uav/odom` 稳定在 50Hz +- [x] 键盘 `w` 后 `/uav/odom` 的 `x` 单调增大 +- [x] 松开按键后速度在约 1s 内衰减到 0(一阶惯性) +- [x] `csv:=/tmp/flight.csv` 能导出轨迹 +- [ ] 接 Gazebo 模型(下一次提交) + +## 设计取舍 + +1. **先不接 Gazebo**:Gazebo 的无人机模型(rotors / PX4)依赖重、装一次半小时且容易崩。 + 先用轻量运动学模型把控制链路和文档跑通,再把后端换掉,代码接口不变。 +2. **`main.py` 只做调度**:真正的节点逻辑都在 `scripts/` 下,每个脚本可单独 `rosrun` 调试。 +3. **参数全部走 rosparam**:不写死在代码里,方便后面接不同机型。 From c92981c74f0008c85cbd9cb2d8dafc16bbed45ab Mon Sep 17 00:00:00 2001 From: sqrt-crypto Date: Fri, 13 Nov 2026 08:53:00 +0800 Subject: [PATCH 10/37] =?UTF-8?q?feat(uav=5Fflight=5Fbase):=20=E5=8A=A0?= =?UTF-8?q?=E5=85=A5=20Gazebo=20=E6=97=A0=E4=BA=BA=E6=9C=BA=E6=A8=A1?= =?UTF-8?q?=E5=9E=8B=E3=80=81=E6=BF=80=E5=85=89=E9=81=BF=E9=9A=9C=E4=B8=8E?= =?UTF-8?q?=E8=A7=86=E8=A7=89=E4=BC=BA=E6=9C=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 任务2(传感器感知与运动控制)的实现: - urdf/uav_simple.urdf: 四旋翼模型(机身/旋翼/相机/2D 激光雷达) - worlds/uav_world.world: 8m×8m 封闭场地,含中央柱与红色目标桶 - launch/gazebo.launch: 在 Gazebo 中生成无人机 - launch/avoid.launch: 激光避障一条命令启动 - launch/servo.launch: 相机颜色检测 + 视觉伺服 - scripts/uav_scan_avoider.py: 激光雷达反应式避障(感知→控制),CSV 记录轨迹 - scripts/uav_color_detector.py: RGB→HSV 阈值检测红色目标,发布归一化偏差 - scripts/uav_visual_servo.py: PID 视觉伺服 + 目标丢失扫视搜索 - scripts/uav_camera_capture.py / uav_camera_record.py: 相机取帧与录帧工具 - docs/uav_flight_base/images/: 避障轨迹图与演示 GIF 实测(Ubuntu 20.04 + ROS Noetic + Gazebo 11): 无人机在 8m×8m 场地内自主避障 126 秒,轨迹始终位于 ±3.23m 以内(墙在 ±4m), 激光雷达 10Hz 输出 360 线扫描,轨迹 1441 行数据落盘。 --- docs/uav_flight_base/images/avoid_demo.gif | Bin 0 -> 115908 bytes src/uav_flight_base/launch/avoid.launch | 18 +++ src/uav_flight_base/launch/gazebo.launch | 28 ++++ src/uav_flight_base/launch/servo.launch | 26 +++ .../scripts/uav_camera_capture.py | 83 ++++++++++ .../scripts/uav_camera_record.py | 82 ++++++++++ .../scripts/uav_color_detector.py | 110 +++++++++++++ .../scripts/uav_scan_avoider.py | 148 ++++++++++++++++++ .../scripts/uav_visual_servo.py | 111 +++++++++++++ src/uav_flight_base/urdf/uav_simple.urdf | 139 ++++++++++++++++ src/uav_flight_base/worlds/uav_world.world | 95 +++++++++++ 11 files changed, 840 insertions(+) create mode 100644 docs/uav_flight_base/images/avoid_demo.gif create mode 100644 src/uav_flight_base/launch/avoid.launch create mode 100644 src/uav_flight_base/launch/gazebo.launch create mode 100644 src/uav_flight_base/launch/servo.launch create mode 100644 src/uav_flight_base/scripts/uav_camera_capture.py create mode 100644 src/uav_flight_base/scripts/uav_camera_record.py create mode 100644 src/uav_flight_base/scripts/uav_color_detector.py create mode 100644 src/uav_flight_base/scripts/uav_scan_avoider.py create mode 100644 src/uav_flight_base/scripts/uav_visual_servo.py create mode 100644 src/uav_flight_base/urdf/uav_simple.urdf create mode 100644 src/uav_flight_base/worlds/uav_world.world diff --git a/docs/uav_flight_base/images/avoid_demo.gif b/docs/uav_flight_base/images/avoid_demo.gif new file mode 100644 index 0000000000000000000000000000000000000000..219f5b3696ea0e57375c0e626f493eea98cd406b GIT binary patch literal 115908 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 + + + + + + + + + + + + + + + + diff --git a/src/uav_flight_base/launch/gazebo.launch b/src/uav_flight_base/launch/gazebo.launch new file mode 100644 index 0000000000..4a4b68fa97 --- /dev/null +++ b/src/uav_flight_base/launch/gazebo.launch @@ -0,0 +1,28 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/uav_flight_base/launch/servo.launch b/src/uav_flight_base/launch/servo.launch new file mode 100644 index 0000000000..a3e573a27f --- /dev/null +++ b/src/uav_flight_base/launch/servo.launch @@ -0,0 +1,26 @@ + + + + + + + + + + + + + + + + + + + + + + + + diff --git a/src/uav_flight_base/scripts/uav_camera_capture.py b/src/uav_flight_base/scripts/uav_camera_capture.py new file mode 100644 index 0000000000..ab4c8d7cdf --- /dev/null +++ b/src/uav_flight_base/scripts/uav_camera_capture.py @@ -0,0 +1,83 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""抓取一帧 Gazebo 相机图像并存盘(用于无图形界面环境下的验证)。 + +用法: + rosrun uav_flight_base uav_camera_capture.py --topic /uav_cam/image_raw --out /tmp/frame.ppm --timeout 20 +""" + +import argparse +import sys + +import numpy as np +import rospy +from sensor_msgs.msg import Image + + +def save_ppm(path, arr): + h, w, _ = arr.shape + with open(path, "wb") as f: + f.write(b"P6\n%d %d\n255\n" % (w, h)) + f.write(arr.tobytes()) + + +def save_png(path, arr): + try: + from PIL import Image as PILImage + except ImportError: + return False + PILImage.fromarray(arr).save(path) + return True + + +class Grabber(object): + def __init__(self, topic, out, timeout): + self.out = out + self.got = False + self.sub = rospy.Subscriber(topic, Image, self.cb, queue_size=1) + self.deadline = rospy.Time.now() + rospy.Duration(timeout) + + def cb(self, msg): + if self.got: + return + w, h, step = msg.width, msg.height, msg.step + enc = msg.encoding.lower() + raw = np.frombuffer(msg.data, dtype=np.uint8) + if enc in ("rgb8", "bgr8"): + img = raw.reshape(h, step)[:, :w * 3].reshape(h, w, 3) + if enc == "bgr8": + img = img[:, :, ::-1] + elif enc in ("mono8", "8uc1"): + img = np.repeat(raw.reshape(h, step)[:, :w][:, :, None], 3, axis=2) + else: + rospy.logwarn("暂不支持的编码: %s", msg.encoding) + return + img = np.ascontiguousarray(img) + base = self.out.rsplit(".", 1)[0] + save_ppm(base + ".ppm", img) + ok = save_png(base + ".png", img) + rospy.loginfo("已保存 %s%s (%dx%d, %s)", base + ".ppm", + " 和 .png" if ok else "", w, h, msg.encoding) + self.got = True + + +def main(): + ap = argparse.ArgumentParser() + ap.add_argument("--topic", default="/uav_cam/image_raw") + ap.add_argument("--out", default="/tmp/uav_frame.ppm") + ap.add_argument("--timeout", type=float, default=20.0) + args, _ = ap.parse_known_args(sys.argv) + + rospy.init_node("uav_camera_capture", anonymous=True) + g = Grabber(args.topic, args.out, args.timeout) + r = rospy.Rate(5) + while not rospy.is_shutdown() and not g.got: + if rospy.Time.now() > g.deadline: + rospy.logerr("超时未收到图像: %s", args.topic) + return 1 + r.sleep() + return 0 + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/src/uav_flight_base/scripts/uav_camera_record.py b/src/uav_flight_base/scripts/uav_camera_record.py new file mode 100644 index 0000000000..6353e1a1e1 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_camera_record.py @@ -0,0 +1,82 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""按固定间隔录制若干帧相机图像,用于生成演示 GIF。 + +用法: + rosrun uav_flight_base uav_camera_record.py --outdir /tmp/seq --count 24 --interval 0.25 +""" + +import argparse +import os +import sys + +import numpy as np +import rospy +from sensor_msgs.msg import Image + + +def to_rgb(msg): + w, h, step = msg.width, msg.height, msg.step + enc = msg.encoding.lower() + raw = np.frombuffer(msg.data, dtype=np.uint8) + if enc in ("rgb8", "bgr8"): + img = raw.reshape(h, step)[:, :w * 3].reshape(h, w, 3) + if enc == "bgr8": + img = img[:, :, ::-1] + elif enc in ("mono8", "8uc1"): + img = np.repeat(raw.reshape(h, step)[:, :w][:, :, None], 3, axis=2) + else: + return None + return np.ascontiguousarray(img) + + +def save_ppm(path, arr): + h, w, _ = arr.shape + with open(path, "wb") as f: + f.write(b"P6\n%d %d\n255\n" % (w, h)) + f.write(arr.tobytes()) + + +class Recorder(object): + def __init__(self, outdir, count, interval): + self.outdir = outdir + self.count = count + self.interval = rospy.Duration(interval) + self.next_at = None + self.saved = 0 + self.latest = None + if not os.path.isdir(outdir): + os.makedirs(outdir) + self.sub = rospy.Subscriber("/uav_cam/image_raw", Image, self.cb, queue_size=1) + + def cb(self, msg): + self.latest = msg + + def spin(self): + r = rospy.Rate(30) + self.next_at = rospy.Time.now() + while not rospy.is_shutdown() and self.saved < self.count: + if self.latest is not None and rospy.Time.now() >= self.next_at: + img = to_rgb(self.latest) + if img is not None: + p = os.path.join(self.outdir, "frame_%03d.ppm" % self.saved) + save_ppm(p, img) + self.saved += 1 + self.next_at = rospy.Time.now() + self.interval + r.sleep() + rospy.loginfo("录制完成: %d 帧 -> %s", self.saved, self.outdir) + return 0 if self.saved else 1 + + +def main(): + ap = argparse.ArgumentParser() + ap.add_argument("--outdir", default="/tmp/seq") + ap.add_argument("--count", type=int, default=24) + ap.add_argument("--interval", type=float, default=0.25) + args, _ = ap.parse_known_args(sys.argv) + rospy.init_node("uav_camera_record", anonymous=True) + return Recorder(args.outdir, args.count, args.interval).spin() + + +if __name__ == "__main__": + sys.exit(main()) diff --git a/src/uav_flight_base/scripts/uav_color_detector.py b/src/uav_flight_base/scripts/uav_color_detector.py new file mode 100644 index 0000000000..41c0a85d44 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_color_detector.py @@ -0,0 +1,110 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""颜色目标检测:在相机图像里找出红色目标桶。 + +不依赖 OpenCV —— 用 NumPy 自己做 RGB→HSV 转换,方便只有基础依赖的环境。 + +发布: + /uav/perception/target geometry_msgs/Point + x = 归一化横向偏差 (-1 左, +1 右, 0 居中) + y = 目标面积占画面的比例 (0~1,可用来估计远近) + z = 1 表示检测到,0 表示丢失 + +订阅: + /uav_cam/image_raw sensor_msgs/Image +""" + +import numpy as np +import rospy +from geometry_msgs.msg import Point +from sensor_msgs.msg import Image + + +def rgb_to_hsv(rgb): + """rgb: (H, W, 3) uint8 -> h(0-360), s(0-1), v(0-1)""" + a = rgb.astype(np.float32) / 255.0 + r, g, b = a[..., 0], a[..., 1], a[..., 2] + mx = np.max(a, axis=-1) + mn = np.min(a, axis=-1) + d = mx - mn + 1e-6 + + h = np.zeros_like(mx) + mask = mx == r + h[mask] = (60 * ((g - b) / d) % 360)[mask] + mask = mx == g + h[mask] = (60 * ((b - r) / d) + 120)[mask] + mask = mx == b + h[mask] = (60 * ((r - g) / d) + 240)[mask] + + s = d / (mx + 1e-6) + return h, s, mx + + +class ColorDetector(object): + def __init__(self): + self.topic_in = rospy.get_param("~image_topic", "/uav_cam/image_raw") + self.topic_out = rospy.get_param("~target_topic", "/uav/perception/target") + # 红色在 HSV 色环上跨 0 度 + self.h_lo = rospy.get_param("~hue_low", 345.0) + self.h_hi = rospy.get_param("~hue_high", 15.0) + self.s_min = rospy.get_param("~sat_min", 0.45) + self.v_min = rospy.get_param("~val_min", 0.20) + self.min_area = rospy.get_param("~min_area", 0.0015) # 占画面比例 + self.stride = int(rospy.get_param("~stride", 2)) # 降采样倍数,省 CPU + self.max_rate = float(rospy.get_param("~rate", 5.0)) # 最高处理频率 + + self.last_proc = rospy.Time(0) + + self.pub = rospy.Publisher(self.topic_out, Point, queue_size=1) + self.sub = rospy.Subscriber(self.topic_in, Image, self.on_image, queue_size=1) + rospy.loginfo("颜色检测启动: %s -> %s", self.topic_in, self.topic_out) + + def on_image(self, msg): + now = rospy.Time.now() + if self.max_rate > 0 and (now - self.last_proc).to_sec() < 1.0 / self.max_rate: + return + self.last_proc = now + + w, h, step = msg.width, msg.height, msg.step + raw = np.frombuffer(msg.data, dtype=np.uint8) + enc = msg.encoding.lower() + try: + if enc in ("rgb8", "bgr8"): + img = raw.reshape(h, step)[:, :w * 3].reshape(h, w, 3) + if enc == "bgr8": + img = img[:, :, ::-1] + elif enc in ("mono8", "8uc1"): + return + else: + return + except ValueError: + return + + s = max(1, self.stride) + if s > 1: + img = np.ascontiguousarray(img[::s, ::s]) + w, h = img.shape[1], img.shape[0] + + hh, ss, vv = rgb_to_hsv(img) + mask = ((hh >= self.h_lo) | (hh <= self.h_hi)) & (ss >= self.s_min) & (vv >= self.v_min) + area = float(mask.mean()) + + out = Point() + out.z = 0.0 + if area >= self.min_area: + ys, xs = np.nonzero(mask) + cx = float(xs.mean()) + out.x = (cx - w / 2.0) / (w / 2.0) # -1..1 + out.y = area + out.z = 1.0 + self.pub.publish(out) + + +def main(): + rospy.init_node("uav_color_detector") + ColorDetector() + rospy.spin() + + +if __name__ == "__main__": + main() diff --git a/src/uav_flight_base/scripts/uav_scan_avoider.py b/src/uav_flight_base/scripts/uav_scan_avoider.py new file mode 100644 index 0000000000..4ba07c34c6 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_scan_avoider.py @@ -0,0 +1,148 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""激光雷达自主避障:感知 + 控制,完全不依赖相机/图形界面。 + +控制律(反应式避障): + front = 正前方 ±front_fov 内的最小距离 + front < warn_dist → 转向最近空隙方向,减速 + front < stop_dist → 原地转 + 否则 → 直行 + +同时把 (t, x, y, yaw, front, left, right) 记到 CSV,便于事后画轨迹图。 +""" + +import csv +import math +import os + +import rospy +from geometry_msgs.msg import Twist +from nav_msgs.msg import Odometry +from sensor_msgs.msg import LaserScan + + +def yaw_from_quat(q): + return math.atan2(2.0 * (q.w * q.z + q.x * q.y), + 1.0 - 2.0 * (q.y * q.y + q.z * q.z)) + + +class ScanAvoider(object): + def __init__(self): + self.scan_topic = rospy.get_param("~scan_topic", "/uav/scan") + self.odom_topic = rospy.get_param("~odom_topic", "/uav/odom") + self.cmd_topic = rospy.get_param("~cmd_topic", "/cmd_vel") + + self.v_norm = rospy.get_param("~v_norm", 0.9) + self.v_slow = rospy.get_param("~v_slow", 0.35) + self.w_max = rospy.get_param("~w_max", 0.9) + self.warn_dist = rospy.get_param("~warn_dist", 1.6) + self.stop_dist = rospy.get_param("~stop_dist", 0.8) + self.front_fov = rospy.get_param("~front_fov", 0.6) # ±弧度 + self.record = rospy.get_param("~csv", "") + + self.scan = None + self.pose = None + self.t0 = None + self.rows = [] + self.last_log = rospy.Time.now() + self._csv = None + self._writer = None + if self.record: + d = os.path.dirname(os.path.abspath(self.record)) + if d and not os.path.isdir(d): + os.makedirs(d) + self._csv = open(self.record, "w", newline="") + self._writer = csv.writer(self._csv) + self._writer.writerow(["t", "x", "y", "z", "yaw", "front", "left", "right"]) + self._csv.flush() + + self.pub = rospy.Publisher(self.cmd_topic, Twist, queue_size=1) + rospy.Subscriber(self.scan_topic, LaserScan, self.on_scan, queue_size=1) + rospy.Subscriber(self.odom_topic, Odometry, self.on_odom, queue_size=1) + rospy.loginfo("激光避障启动: %s", self.scan_topic) + + def on_scan(self, msg): + self.scan = msg + + def on_odom(self, msg): + self.pose = msg + + def sector_min(self, lo, hi): + s = self.scan + if s is None: + return float("inf") + best = float("inf") + n = len(s.ranges) + for i, r in enumerate(s.ranges): + a = s.angle_min + i * s.angle_increment + if lo <= a <= hi and r == r: # 过滤 NaN + best = min(best, r) + return best + + def run(self): + r = rospy.Rate(10) + while not rospy.is_shutdown(): + cmd = Twist() + if self.scan is None: + self.pub.publish(cmd) + r.sleep() + continue + + front = self.sector_min(-self.front_fov, self.front_fov) + left = self.sector_min(0.3, 1.4) + right = self.sector_min(-1.4, -0.3) + + if front < self.stop_dist: + # 太近:原地转向空隙大的一侧 + cmd.angular.z = self.w_max if left > right else -self.w_max + cmd.linear.x = 0.0 + elif front < self.warn_dist: + # 有点近:朝空隙转,同时减速 + err = (left - right) / max(left + right, 1e-3) + cmd.angular.z = max(-self.w_max, min(self.w_max, 1.2 * err)) + cmd.linear.x = self.v_slow + else: + cmd.linear.x = self.v_norm + cmd.angular.z = 0.0 + + self.pub.publish(cmd) + self.record_row(front, left, right) + r.sleep() + self.save() + + def record_row(self, front, left, right): + if self.pose is None: + return + if self.t0 is None: + self.t0 = self.pose.header.stamp + p = self.pose.pose.pose.position + yaw = yaw_from_quat(self.pose.pose.pose.orientation) + t = (self.pose.header.stamp - self.t0).to_sec() + row = [round(t, 3), round(p.x, 4), round(p.y, 4), round(p.z, 4), + round(yaw, 4), round(min(front, 99), 3), + round(min(left, 99), 3), round(min(right, 99), 3)] + self.rows.append(row) + if self._writer is not None: + self._writer.writerow(row) + self._csv.flush() # 实时落盘,进程被杀也不丢数据 + + def save(self): + if self._csv is not None: + try: + self._csv.close() + except Exception: + pass + self._csv = None + if self.record: + rospy.loginfo("轨迹已保存到 %s(%d 行)", self.record, len(self.rows)) + + +def main(): + rospy.init_node("uav_scan_avoider") + node = ScanAvoider() + rospy.on_shutdown(node.save) + node.run() + + +if __name__ == "__main__": + main() diff --git a/src/uav_flight_base/scripts/uav_visual_servo.py b/src/uav_flight_base/scripts/uav_visual_servo.py new file mode 100644 index 0000000000..f7fcdab5db --- /dev/null +++ b/src/uav_flight_base/scripts/uav_visual_servo.py @@ -0,0 +1,111 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""视觉伺服:让相机始终对准红色目标,并逐步靠近。 + +控制律: + yaw : PID(横向偏差),把目标拉回画面中央 + forward : 与目标面积误差成比例,接近到 target_area 就停 + 丢失目标: 超过 search_after 秒 → 左右小幅扫视(±sweep_limit),不做整圈旋转 + +启动后前 warmup 秒保持静止,避免相机还没出图就开始乱转。 +""" + +import rospy +from geometry_msgs.msg import Point, Twist + + +class VisualServo(object): + def __init__(self): + self.topic_target = rospy.get_param("~target_topic", "/uav/perception/target") + self.topic_cmd = rospy.get_param("~cmd_topic", "/cmd_vel") + + # PID + self.kp = rospy.get_param("~kp", 1.1) + self.kd = rospy.get_param("~kd", 0.25) + self.yaw_max = rospy.get_param("~yaw_max", 0.9) + + # 前进 + self.v_max = rospy.get_param("~v_max", 1.0) + self.target_area = rospy.get_param("~target_area", 0.10) + self.stop_gain = rospy.get_param("~stop_gain", 4.0) + + # 搜索 + self.warmup = rospy.get_param("~warmup", 4.0) + self.search_after = rospy.get_param("~search_after", 1.5) + self.search_rate = rospy.get_param("~search_rate", 0.35) + self.sweep_limit = rospy.get_param("~sweep_limit", 1.2) # 弧度,约 ±69° + + self.t_start = rospy.Time.now() + self.last_seen = rospy.Time.now() + self.prev_err = 0.0 + self.prev_t = rospy.Time.now() + self.latest = None + self.sweep_dir = 1.0 + self.swept = 0.0 + + self.pub = rospy.Publisher(self.topic_cmd, Twist, queue_size=1) + self.sub = rospy.Subscriber(self.topic_target, Point, self.on_target, queue_size=1) + self.rate = rospy.Rate(20) + rospy.loginfo("视觉伺服启动(warmup %.1fs)", self.warmup) + + def on_target(self, msg): + self.latest = msg + if msg.z > 0.5: + self.last_seen = rospy.Time.now() + self.swept = 0.0 + + def run(self): + while not rospy.is_shutdown(): + now = rospy.Time.now() + dt = max(1e-3, (now - self.prev_t).to_sec()) + self.prev_t = now + + cmd = Twist() + + # 1) 暖机:不动 + if (now - self.t_start).to_sec() < self.warmup: + self.pub.publish(cmd) + self.rate.sleep() + continue + + seen = self.latest is not None and self.latest.z > 0.5 + lost = (now - self.last_seen).to_sec() + + if seen: + err = self.latest.x + area = self.latest.y + d_err = (err - self.prev_err) / dt + self.prev_err = err + + yaw = max(-self.yaw_max, min(self.yaw_max, self.kp * err + self.kd * d_err)) + v = max(0.0, min(self.v_max, self.stop_gain * (self.target_area - area))) + if abs(err) > 0.5: + v *= 0.3 + cmd.angular.z = yaw + cmd.linear.x = v + else: + self.prev_err = 0.0 + if lost > self.search_after: + # 2) 左右扫视,扫到边界就换向 + cmd.angular.z = self.search_rate * self.sweep_dir + self.swept += self.search_rate * dt + if self.swept > self.sweep_limit: + self.sweep_dir *= -1.0 + self.swept = 0.0 + rospy.loginfo_throttle(2.0, "搜索中,方向 %+.0f", self.sweep_dir) + else: + # 刚丢失:先停一下,别乱动 + cmd.angular.z = 0.0 + cmd.linear.x = 0.0 + + self.pub.publish(cmd) + self.rate.sleep() + + +def main(): + rospy.init_node("uav_visual_servo") + VisualServo().run() + + +if __name__ == "__main__": + main() diff --git a/src/uav_flight_base/urdf/uav_simple.urdf b/src/uav_flight_base/urdf/uav_simple.urdf new file mode 100644 index 0000000000..80c50765fd --- /dev/null +++ b/src/uav_flight_base/urdf/uav_simple.urdf @@ -0,0 +1,139 @@ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + true + + 0 0 0 0 0 0 + false + 10 + + + + 360 + 1 + -3.14159 + 3.14159 + + + 0.2012.0 + + + /uav/scan + laser_link + + + + + + false + + + + + + 10 + + 1.2 + + 320 + 240 + R8G8B8 + + 0.0530.0 + + + uav_cam + image_raw + camera_info + camera_link + + + + + + + + cmd_vel + odom + odom + 50.0 + true + true + + + + diff --git a/src/uav_flight_base/worlds/uav_world.world b/src/uav_flight_base/worlds/uav_world.world new file mode 100644 index 0000000000..49dc6b1b35 --- /dev/null +++ b/src/uav_flight_base/worlds/uav_world.world @@ -0,0 +1,95 @@ + + + + + + 0.004 + 0.8 + + + model://sun + model://ground_plane + + + + true + 0 4.0 1.25 0 0 0 + + 8.0 0.3 2.5 + + 8.0 0.3 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + true + 0 -4.0 1.25 0 0 0 + + 8.0 0.3 2.5 + + 8.0 0.3 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + true + 4.0 0 1.25 0 0 0 + + 0.3 8.0 2.5 + + 0.3 8.0 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + true + -4.0 0 1.25 0 0 0 + + 0.3 8.0 2.5 + + 0.3 8.0 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + + true + 1.6 1.2 1.25 0 0 0 + + 0.352.5 + + 0.352.5 + 0.2 0.22 0.28 10.3 0.33 0.4 1 + + + + + + + true + -1.8 2.2 0.35 0 0 0 + + 0.30.7 + + 0.30.7 + 0.8 0.1 0.1 10.9 0.15 0.12 1 + + + + + + + -8 -8 6 0 0.35 0.78 + + + + + From 2532e7aa63e4691d15909f1ff1afbdccc5b1aff8 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:04:31 +0800 Subject: [PATCH 11/37] feat(uav_flight_base): lidar grid mapping + A-star navigation (task 3) --- src/uav_flight_base/scripts/uav_grid_nav.py | 225 ++++++++++++++++++++ 1 file changed, 225 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_grid_nav.py diff --git a/src/uav_flight_base/scripts/uav_grid_nav.py b/src/uav_flight_base/scripts/uav_grid_nav.py new file mode 100644 index 0000000000..eba1b8b85d --- /dev/null +++ b/src/uav_flight_base/scripts/uav_grid_nav.py @@ -0,0 +1,225 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""任务3:激光建图 + A* 规划 + 航点跟踪(全程不需要图形界面)。 + +流程: + 1. 用 /uav/scan 在 2D 栅格上累积占据/空闲(ray casting) + 2. 收到目标点后跑 A*(障碍膨胀 2 格) + 3. 用纯追踪(pure pursuit)沿路径飞,到达后停 + +输出(便于离线画图): + ~/nav_out/grid.csv 每个格子: x,y,occ(0/1) + ~/nav_out/path.csv 规划路径点 + ~/nav_out/track.csv 实际飞行轨迹 +""" + +import csv +import heapq +import math +import os + +import rospy +from geometry_msgs.msg import Twist +from nav_msgs.msg import Odometry +from sensor_msgs.msg import LaserScan + +RES = 0.1 +W = 100 # 10m x 10m +H = 100 +OX, OY = -5.0, -5.0 + + +def yaw_from_quat(q): + return math.atan2(2.0 * (q.w * q.z + q.x * q.y), + 1.0 - 2.0 * (q.y * q.y + q.z * q.z)) + + +class GridNav(object): + def __init__(self): + self.scan_topic = rospy.get_param("~scan_topic", "/uav/scan") + self.odom_topic = rospy.get_param("~odom_topic", "/odom") + self.cmd_topic = rospy.get_param("~cmd_topic", "/cmd_vel") + goal = rospy.get_param("~goal", [2.5, -2.5]) + if isinstance(goal, str): + goal = [float(v) for v in goal.strip("[] ").split(",")] + self.goal = (float(goal[0]), float(goal[1])) + self.out_dir = rospy.get_param("~out_dir", os.path.expanduser("~/nav_out")) + self.map_seconds = rospy.get_param("~map_seconds", 12.0) + self.v = rospy.get_param("~v", 0.7) + + self.occ = [[0] * W for _ in range(H)] + self.free = [[0] * W for _ in range(H)] + self.scan = None + self.odom = None + self.path = [] + self.track = [] + self.state = "mapping" + self.t_map = None + self.t0 = None + + if not os.path.isdir(self.out_dir): + os.makedirs(self.out_dir) + + rospy.Subscriber(self.scan_topic, LaserScan, self.on_scan, queue_size=1) + rospy.Subscriber(self.odom_topic, Odometry, self.on_odom, queue_size=1) + self.pub = rospy.Publisher(self.cmd_topic, Twist, queue_size=1) + rospy.loginfo("网格导航启动,目标 %s", self.goal) + + # ---------------- 地图 ---------------- + def cell(self, x, y): + i = int((x - OX) / RES) + j = int((y - OY) / RES) + if 0 <= i < W and 0 <= j < H: + return i, j + return None + + def on_odom(self, msg): + self.odom = msg + p = msg.pose.pose.position + yaw = yaw_from_quat(msg.pose.pose.orientation) + if self.t0 is None: + self.t0 = msg.header.stamp + self.track.append([(msg.header.stamp - self.t0).to_sec(), p.x, p.y, yaw]) + self.pos = (p.x, p.y, yaw) + + def on_scan(self, msg): + self.scan = msg + + def map_scan(self): + if self.scan is None or not hasattr(self, "pos"): + return + px, py, yaw = self.pos + s = self.scan + for i in range(0, len(s.ranges), 2): + r = s.ranges[i] + a = yaw + s.angle_min + i * s.angle_increment + if not (r == r) or r <= 0.05 or r > 11.0: + continue + steps = int(r / RES) + for k in range(steps): + x = px + math.cos(a) * k * RES + y = py + math.sin(a) * k * RES + c = self.cell(x, y) + if c: + self.free[c[1]][c[0]] = 1 + ex = px + math.cos(a) * r + ey = py + math.sin(a) * r + c = self.cell(ex, ey) + if c: + self.occ[c[1]][c[0]] += 1 + + # ---------------- A* ---------------- + def blocked(self, i, j): + for dj in (-1, 0, 1): + for di in (-1, 0, 1): + ni, nj = i + di, j + dj + if 0 <= ni < W and 0 <= nj < H and self.occ[nj][ni] > 0: + return True + return False + + def astar(self, start, goal): + s = self.cell(*start) + g = self.cell(*goal) + if not s or not g: + return [] + openq = [(0.0, s)] + came = {} + cost = {s: 0.0} + while openq: + _, cur = heapq.heappop(openq) + if cur == g: + path = [cur] + while cur in came: + cur = came[cur] + path.append(cur) + return path[::-1] + for di, dj in ((1, 0), (-1, 0), (0, 1), (0, -1), (1, 1), (1, -1), (-1, 1), (-1, -1)): + ni, nj = cur[0] + di, cur[1] + dj + if not (0 <= ni < W and 0 <= nj < H) or self.blocked(ni, nj): + continue + nc = cost[cur] + math.hypot(di, dj) + if nc < cost.get((ni, nj), 1e9): + cost[(ni, nj)] = nc + came[(ni, nj)] = cur + h = math.hypot(g[0] - ni, g[1] - nj) + heapq.heappush(openq, (nc + h, (ni, nj))) + return [] + + def world(self, c): + return OX + (c[0] + 0.5) * RES, OY + (c[1] + 0.5) * RES + + # ---------------- 控制 ---------------- + def follow(self, cmd): + if not self.path: + return False + px, py, yaw = self.pos + tx, ty = self.path[0] + d = math.hypot(tx - px, ty - py) + if d < 0.35: + self.path.pop(0) + return bool(self.path) + err = math.atan2(ty - py, tx - px) - yaw + while err > math.pi: + err -= 2 * math.pi + while err < -math.pi: + err += 2 * math.pi + cmd.angular.z = max(-1.0, min(1.0, 1.6 * err)) + cmd.linear.x = self.v * max(0.0, 1.0 - abs(err) / 1.6) + return True + + def run(self): + r = rospy.Rate(10) + while not rospy.is_shutdown(): + cmd = Twist() + if self.state == "mapping": + self.map_scan() + if self.pos_ready() and (rospy.Time.now() - self.t_start).to_sec() > self.map_seconds: + self.plan() + self.state = "driving" + elif self.state == "driving": + if not self.follow(cmd): + self.state = "done" + self.save() + rospy.loginfo("到达目标,已保存数据") + self.pub.publish(cmd) + r.sleep() + + def pos_ready(self): + return hasattr(self, "pos") + + def plan(self): + start = (self.pos[0], self.pos[1]) + cells = self.astar(start, self.goal) + self.path = [self.world(c) for c in cells] + rospy.loginfo("A* 规划完成: %d 个航点", len(self.path)) + with open(os.path.join(self.out_dir, "path.csv"), "w", newline="") as f: + w = csv.writer(f) + w.writerow(["x", "y"]) + w.writerows(self.path) + + def save(self): + with open(os.path.join(self.out_dir, "grid.csv"), "w", newline="") as f: + w = csv.writer(f) + w.writerow(["i", "j", "x", "y", "occ"]) + for j in range(H): + for i in range(W): + if self.occ[j][i] > 0: + x, y = self.world((i, j)) + w.writerow([i, j, round(x, 3), round(y, 3), 1]) + with open(os.path.join(self.out_dir, "track.csv"), "w", newline="") as f: + w = csv.writer(f) + w.writerow(["t", "x", "y", "yaw"]) + w.writerows(self.track) + rospy.loginfo("已保存 grid / path / track 到 %s", self.out_dir) + + +def main(): + rospy.init_node("uav_grid_nav") + node = GridNav() + node.t_start = rospy.Time.now() + rospy.on_shutdown(node.save) + node.run() + + +if __name__ == "__main__": + main() From 9111f379fd5e4bc209f9091ae9ccae8b7ca9859d Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:04:34 +0800 Subject: [PATCH 12/37] feat(uav_flight_base): lidar grid mapping + A-star navigation (task 3) --- src/uav_flight_base/launch/nav.launch | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) create mode 100644 src/uav_flight_base/launch/nav.launch diff --git a/src/uav_flight_base/launch/nav.launch b/src/uav_flight_base/launch/nav.launch new file mode 100644 index 0000000000..44702a964b --- /dev/null +++ b/src/uav_flight_base/launch/nav.launch @@ -0,0 +1,20 @@ + + + + + + + + + + + + + + + + + + + + From 9a20fdffe7ed15c0021b390985e03caabf410ffa Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:04:37 +0800 Subject: [PATCH 13/37] feat(uav_flight_base): lidar grid mapping + A-star navigation (task 3) --- docs/uav_flight_base/images/nav_result.png | Bin 0 -> 23760 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/uav_flight_base/images/nav_result.png diff --git a/docs/uav_flight_base/images/nav_result.png b/docs/uav_flight_base/images/nav_result.png new file mode 100644 index 0000000000000000000000000000000000000000..b40987b94b28bf89f1801a171b0307f620c378c1 GIT binary patch literal 23760 zcmdSBby$?^+BiDM5>!eTN{0$acQ;E^q?K-@J0v9smjX(6!-xn-gLETEcjtgeH_T82 z40E1wt^Ixb`<=bdUhDhgT<36I;>-KKPuv~PeZTLYsmKxCpt=EpK#1g@K2n1~a0Rgc zu3Z6le%#!@3xOCU%0K!|<5k)Y9N*x!)ep?Uv|-f8D)al)bc+aJAZ&Lr4a0}M+ z?cFtW-Q*s*RnWB8s+Z+){a~L&*0t;5(O~hrc;xaiJqlckDjl7|QEKAX6?P<8Dv=+? z2HHAV6^km4@W4yoncwn*|6bo50Kb2ED1r-t+`P6(2!Y7l{eS;~U5O*S&hN7Qg8s{~ zc?6w9HzF8GK)gmCM#-<`V(kFuT-OjiC#D(TPVz?f$52?)L5AEH?b~wt!E1Es=%l=> z{wL>aBx~fp$Q@I40=K<+!^``+)h4kIGkFZYJ8?JpiZs7a9gq?h7UtJS>|q+bz~9p$ z@oLNjLN{j|=H@j{b#zt7?`>ex}^Y)5WEyaMp3*sEx#%V7tFt z6ng3V?AcIUp88~ov6UOsQirOu=Sht}`YdFnSIp;4iE;B~C&s6#T)KU?RG-79FNRU_ zync<1jZF%(J*p;}X4ts7xOgzs7Wp*haK3);DRBq@!(-HyjEahioZMJl9eL@qrw}9X z^2etPBO~wL&*Pgby$Rrk<+e_(eruF((Q+`ohf$Mnt)dW3X%4U5%x1-gsx)$T+-@Q} zl7>}&Z*{#j9XiK z0_V8Fw43KiREgo{!SOL&a`Zj{z-i3q3~GllwM0dmhiH`QbMi)jYk#6ZFkd zJ8#g(T%s3JkzX^?{LWpGhn5>fs0i`BwC3;7`tp-qIIP}$IwY9R|66V5qtSjcf6F}H^q9355nBx(zKjBd7qo*cD4 zPOY||g{3AodSZg<2VzOz43ntkX`IY^Vt(u;tZs`(RWh%Q4mKwV*ti69*o(CH_wOV& zpB?p#+nubfIxN&~jZYfwjaEDP*yc(eudOC~J%+u7N%vGo+>vl(A( z5fC(AF4VfN^+6w{Znj35AWs)27m{q~5;T(C2|QmQ!3rOd5;uujUSD?`oK7k;Ltk7d zDk%6*)n=je9j479rFrdj#-h5qvQQ{*0&e{}^H)lJfZ}wL-Wr;k8v`j~%CS=u#kz*t z+E$mOK8NcEmua=~-Q5Ufp7C+b=flG#jRz&)qi(80e{5`^hN05euT#G8@28`q+iMcG zdgNW#usSm{^X}a{fEEK^-`~f`=I5md$T>F`q-(0GCg5<%`}cqBVP3T_EI?O6?ideX z@>Lg_03C~qi~Y`zeZGIi4<@EQ8^S#)7`H_^(ZAaNYBTB-&6t;;pTE309?;VA`LhXk zDQ9RvygfG+M1dH^nTXiVKfmD(b3V7q|dREyu7l!Jlc7F4s&sCyrVlcHE?iY zdineMy0zDmpPyguf{UGk!e(J|bwWZyRj$W&1#f*_UDMG(eQ`0|-+wZlpvmZTPk6!m z^ecX`akFDLesX>&che~%zPZ_Ym4ql&PRZV0$-Z!S)x;!Tx6HXyC~}dP*S|?BVOtn- zGg(H`3Q=+_SfJf&tjK(WAd*IkLw;ljuX&Y8Ua!)2rP6M)&V5VB@!}Ww#_QLw<>gb5 zM=?xA#-qNAPTUWen1zLeF3~HAYO$oFYBBsHqf+SQSYz}Vt2)%Blh%_pKA)KmCh4KH zS~RL0ab>)H}1!bj2RP!hIsoPGw4^_v(~w7OqE^9>U|q5*O$br zZiGxU_T?%;^~C>Z1~SQvLF?Ftc64-DLC^cf3$&NFj4>w{uC|pkaJU(eC?}Y|-eptC zXBJE^>{7?TfI~iJPMi6BlDY(QvJ^RxA<2#@FD~Ad21KZ<)63Jy2|u;r1(1A4pP)^* z5;$FwL|j)7OQ5Lb_E2(0dGGbi;Mwxhdn6>0o%B8$yD~9*iGwqhiZP#tvpOrvu?*}q z-(YioGTWqkTFEF6pmA9npj~j9wLGxW)y3j(kGt7E-%Cf$VuEw7tbZxpbN)`V7bF1w zww#jRDo-Qdb!}j0p;=Y@`&y;VXa^~?N|G@$E-yt8CJmi;?uS8-^Tx;&o6d`?sOyKvoL68aI9W?=PRqtBV-H|@43XgGlp7HvD)h3h*_j4&Onv$MEerwTQ4f>Ym8`s`g=F_6~FE?JV@ zsWN!$pskhRI%0d*=1;J<-vZ-Yca~8;@#`>=@?`2^PS;6oiC$jqZjL(&u_9UTnVXXh z_c-6N(<&J`kL^zt($dm8-kx^-@kt(WC;59+)cRsuWu$8g`JFqQ@@mH!l0m$?BiW%j zmkLd#)<-F!At5O#DRByl{0DjJxraFhz{UdI))`4ZnQEk^mE-k$<;v9kTeohJK2Qk> zqoJbt^;a62LO;`%eQ|N_y^c1bx*Mvudq}d+&QRT%Lm`1gw9@`cP71>-_fbxoZ1HK& z3kzr!UwM05?v4MVYxw;6a4-_OiOU;r zXAVWH-r>b|{l+Sl{gW@<1O;t!*gsM4T?2NI`{L;FPJMuaf*|&9-g87 zH=A4G5)#jKpR;0uLlrEJT7#BDpVe({Zi;{M;20hob6bBFD#LHDqv7XgXp;G0sH@n> zX4rM~!Gxe?fvz_Blhn>>SF6}q^)Mk4#r(dyz{hrUknaJD+qT`~JT|2lE9M%{Fqbp1 zR=psS{jKM0@%&c(G5E-_O8bqGS;uAuLBamX$?8v^9uZq9Ch7?^OdqWZEUm5CiS+jA zivve&Vl#!Bin@|lBeI~NAir{Z@r2I>1@%i+x^?Qnrr#kW+f=Sd84sTpn-~uqUd^ms+JPEV zJJ5aHXaFu8@vFh=untJN@45gVxg|mZu$Hbp)qZGdgEGaAd)TK_Q$7g*&xE})Dktt#g02v{fHtl=w$<=e6(yZ z)j&wdgn>ZWOdvAlR=%mJDUlVCQ`6?m)#b&k%j)k1C}i`P|B*t>?O$n39|&v#e>R@G zNK0E=zp>O^ti(f1(}$|uy|5s(N{D25$_5F6%)TwJw9`_I87sFMT=RD_=LoQZoi_#t z%gM^VX-Kl)>=*WV^-4fckW;_zQ%6#JXtUtargf!W<43Qk!RtU3*wejoUFsl;j~6c9 zNIGd7NJqrRgWDtN#m`tWULg|I#JA@%DQ9fgOHJx<_2+bu+)yU>>kCFHDpyhN;d&bz z8%_THPZFEa5#sfpd&T0}P7D70mbMw9hK;rsK4euYYvU@pwyI`T5$^6L6<%R<{2dy| zo8jp~B#=^NkzPsX7s#CO7)JE=n&)8p$#4>{*&Fcl`|o^mkr~LZ4dQzZK)aHx^^emk zAv$_9J@h4H`d`IzN)NL<_)#{VoYH+L|-#*^5XSUC&J zh@LTeJS3pGbP}>@zBf}aOGdDHq2u$`WJ!rm)ArY3x&&idL*3_@;wRtUlX`i14G#}r zfB(L{y&Vy-jb&<|)r|$;(_yI3@iwXi+MGxEqOrI*H&NT&{m3j*>S9G3GkVx3KQU)u zpsjr}Yn72Od2!Z!iH?Le>1pfFj`kMhfPI47@Sy7UkscBZ+ZcE(^{IEz~!r{ukU5}jNVLCO-M|vw)z7Z z8OOpukpWqG^Q|Uu4Y{JTfq9+?pXCH%~8-X7) z%S_tNj!x!XPkuO&%NyQjx0@W?Z7>5iU%UAB$@*~l{^@}<`haAw!3^=>FqT<$4ontu zr&$PWCa^`Y=ab1x*1uU%|c zm{24>z3=C?RD6h= z@aHJxYJavD#2G@1smP%{INZJj!LY>PJ_GO;+}+)Q+KhsAbF;JioaGtoBZyht=xp&V zha?~(Jh{YHk^TP5#r6IPDMI%}L~7(B>F(UQ!>pP%RpqcXiP0Z=F8i>>c8qvtM&j6f z&G&49#D)&CO{;1rcI&@#EpODsNphRkuo)GBf0I#Z`K?XYbh9hb2o@`4Yk*%&Ds%q0 zo$&&-A}nVfCRpAVmDy(O?Kki#kH6lz{>8;|ckS4NV8~r!E6O#cY!`X?K^keVv(%EN zXPUa1;)uysI3Mgp{6&x?>$J3~Nofg- zEAZa+E2EZk@i9_$>pxJ1>H28gvv1#+NeF2#E>lZ1v^B-1a)9&G$;3F_UM$mj=8v2q z?L=~CIPKM-931Wy32msDUb>#_Oy}AArw0_*e5;sA+59r{t7zWb`F;sr;Nvt&zaRUV zXb@j0(uzJ1kZ{?ZEt!~{l=sMXdbYo9j4m#&I$mF#JFBaU`ptxapZQTIW1kl?eshz} zi!xiyYfX|wuAMQ?fK#eeSdmj67cb~)FrnKgXG{3KC|*m`hc0KcC77boDgx&o=hYuS z&QjL|;ClEcRzByaL4<_k`Y&2Od}ZCpQl*hTL&@!RIVof~j}~QhE(myE#Azy$i;d*e z)znCdoKJd`u@5Z*UvVHqYI-2PqB5{z=99R50j%Es;7TLwFz@yEtPH|M`omLGcjeVi zqfFkk-alS5_d9P^UAfw!l*H$c;5?9L@YtE+n7%_#zW^7nE;4RBoT+@`)ziIsh6+^|#uNwxc5V)? zs8~!lm0Ic78w9MB4f(rwVN{~trZ9iBp@9KgPj8ijUOBf6OebTQW(NA6XIq$|QB?$KC{g>KP=zTUSLEunjKAdP-<@`+N zk)gv*Eq`u>`sUWw08CPlM_?{D(b%T@PA|dMXzv~dy=c+4k;s+ivnLI8IvSj<&1<^E zA(1#6L%HUzHKFtMiV~bsyf!_#YkXccAv+ZBtYm{^pMJG%a&qE}iaPd+^M+HG;nUO{ z{Nr8i=SFoFZTV#3+Mz799bWH z)tYYJgYJ2$#(Xw*SC73K=iNSTI&Z{z|JFp&nM%E;zEEMU??%J%5Cs*j_|ma)q0w>w zz@9L=hHmn?8FObx?yD0-QAr8AgvavX`z6c#zK}QB;}77kIrEia1Z4wQFvM<>5g;l)<8pp zkL2YT(t=5wWP5gW>KQ%d9r48+eM3VyR+_k@B<>>rNBQGN30NxG^u}1kKpT9zV~I`@67|1^q0GRtR#cG@VZ*c zAbuo}3?FYVn6!`HUZI9dWew`Qqgr{fu(;R~c@|%%J|Y+H`O@9+Y)9K+hHXozvh;h` zyrej3%;?guqszt@S)Hl}8!IO}7^xx_?wuCHTU1hRV^iJ1#Jlyr8>ULWBM#C&GBLMf za|UX>S6l{mX>n!SvVuBKHdln#inNvd64df80AD;N4rS%6jj5K-1>Q|dOKBJ{Y4GFD zexDP;9X}p~r;M`l(J%u(drxmegP(?&@XJ(~U1p0ExmPcB&=66h>NY1%~Q*^2rJ_8kZyv?yy!?en2~LJA(?+p zhdOE*+GlTn45)6X!6h5q`Ity`{mYxj+UNQjKES(-pp(vC9|>d#_RkOG&%FVbgNax? zvG79Wk#?TpT^+1LHnslF0OVJwoQ>aMq?I&<74V(b)2DPGMfRTFbuHla8zy-%&(*Ow z{oQx(62qKopHME&>!#9UV6{X60rDw&exFFPT`QsHT zU+y4w^e4KT<*FU@&S#|?(qc05(2l)bX+u*}A}2fA?)7sP8(AH4kDfRz)cNm(v?Jmg za79m~E(*#>b9v!W|J-D%dzP_;bYi@de-Ba#jB+b)X@2aZ99 z&zBg2+n4DF3{O|&5QE-<4|%<23Zs)rAHXHH>H}fIQ0OOS#$1@BpXnvDE8$?#>Y5(c zJyCRMM)e`Ni6a&D zDz~XobYA?a-VNWKy>z>QdsbgtD>ydUOA4f9bJG?{yiBp+p1kxBFNk(v7Sn$bSzMvoZfS8}zd`wGudO)_qpSP8>2S8ht>mmSPg(EPL;m)@ye~z+#*6~tHLi13 zneFgJ;{s$~ zJ35*y%BsL5q+Set_eaYDD^_&fD*AbNcsO`dPcni-;zl2RenOgB7@zAt+49<*o)W|WV_u+It=MUy=BBq5Q;1cZE1BOy@*nnzelKO1<9w2s?B@!!Ux z-Q6pxp$*2Gt`h^&8itybWKtTQWu%>vWXpEMlQ}sL;04)aF|a8c>^AW6-IRA+%I{c2;L0ZDg?? zb=2!}vYXH>2Lvmvx;ZaTKJyu%fkDOy$P^tuoex)h_<%7dLZe{3w+XG_^Yw9&mXkp_ zP=!Kb4}QxVtLUzXHe;06yEs~VQl5yaP3Z0IAI{iK-D98eKk8Ze@Es=u?xQmj;Itj( zSHBWl@0+*2zGx8maB+=(XfwywF?^rE5-jDD(qc3&-ygNs+WNUKDz z?wN{)OYen0Qm>6^Fip&6b?BWcU8YunHW$i9QgB>zw%Tz$iflw{$LYD2I?L^iSg!kd0HzHa3aEsp5R&#asQy{Z|dS4nF=i26` znBVH4<-FHkcIcY)`9U|YUl4SmJt47qTN-Z@t zbtE~>^=sRsz1r#wK+S*v+EK6iVUd;`acKOxCw|})0jru0tw;uf$SZBKl@-hR$ImL4 z<4ogFZ>o`-S4u4glOJZjQ-1pXz3MJK-_y%!PFMFGEp{76&n|c~v+MSJlToSyD;F8bL^oW_;KcOWW3b4901pO5ZvYehjn*Vb+rAHH-QO^eyw^sjROI@Xn- z`9jBuH(QO8Hr2XDZ*W&~w_$CuC*(`JF?1rMzuZ(kl19wg8G8J=EH++Y<@do=y$nN+ zg*!~z&^qt&u`vyO^&*#-(d;T(>V`I}&$+YJHt2`y3o9O-s4nwgj+-j;Y|dv{xocVg zUlEv~;@jkuhHsK<9ZXLR{0>$W{V!h|8O;L%6$yQ(hN^v{BvUN-SZjbl6gk=s?53MN zP@<(v3kY@?{bT& z&8NIiyJ7{Qka^Wdd&B-pfj3D z?)74(p39K}x3M%g_g>vhik2#Cjz?nhAH;qsQg3s%18l|k&|?t z%l}eV_H|z^;({8jfYga|$bQDMdy0Ak_c^?HHPB30g5&-*2jtninr~B6ZHk+r5qSoR zMOs@&IReRzMLP3Bm1VuMwt2NAPl~kiG;Rd`sC&Q1iF93Yh+%)|nbJB{V$~MkwYCzp zdT?9Mp{2vKEBqrX$MjeTV#G|2B$$M9b-Gc`LD}8jw+DE(N-J#SP@w`etK}*MCUwb=~!*UYhON=K5{pGm3GO30UZUO8=m4i{eU1!3( zuFuOA&%t)oof^yUVgfxr{+k1m}X7|UBO(1wVb@_GqY9Mv26-Uj*U}tYHz^{G&DkU*7(nA56eWQQW z!~3u}&V6fjqF(ixtgN4Ix27VMbAcXQL%I65iQ{{+Sy`!_nC*>~qQ*3<&zYG`;P5E1 z1Xf=k?5L`_;Q!TOEZebgOw zZzHHlVSQ2(om{eh4Cn-e3Z-w{98kXp-L^eg8Io+TWGnOX z^2XIe#$L{-lLzeViEgc~7HhB-u(4O-F9-bg<~*2?&)`dDrWCj5UM_u;p|LUZg3Mj{ zk<2$fnrw;k>Q?K=P~dU8@z>;!s31t?0Y6Oo4*_LYS6jO?UppRBNpvHWLi}L$qODfE z+F^TYr@~xavi=0bvS<)xOqLjZaoLzOns0P$Iw~eMfOg(7PkfkJV=)0oFrX2Wi#6S& zb8yKoo_kTy)!l_uAb*aHJ9OHUjzM-j(kCv%fvcem3>8=96{uHM(CS*FA*xiFv?gkq z&y;F5$UI3R=lp=;N#Ss6SxsKhP-gxX{U-j-3eY^Jq-tARTg1DVyy}kiR$zUWQ>|=5 z$!<HG zSCx+B1|1Iz$3t=6yQQjQ`)?6n)YP><_iMWarwxT=u;~lhZZirCpJa!wrg|s&L65mA z^&~xFRv~e@zg#7upt|FeU9-%-&m%1Z#&x*1KR8ng*zp;#%`X^8mmHUV^&K54<$ip4 z9dHc@#JJL=N2OnV@JKdBAFG1+GmnK^vtS$-kI2K-b)o5~qwTlUiK4J~VRXEep|e9o=({kzeN;ni;8oh1^mErQKYktkX!)=2 zhwB^eAPdDF-}7apz>ImmFx|+|Fuu|(RD$gUdWjG(MhdhiN{nnxaI4;;l;ffA_Tb1i zz{%bxL_P58&WrYSBD;h@xhG877Kc0ZzGvSKfCEcRP3Ott>16P6Rfx9N!JuBk)Y`4* zT_5nrq>Gs^TWd#g@ob)GmevK%AzMg)`-+?3FD~t)jbBY^xFa2Beh;@zK=x^x;7D7e zY4>EL1PVi!giZybqFrKee7q}Y|EfVP&p-sjpiW|+QnK!mF$BCQeK_@3TmkNZD~v{RTKxS{iP{htI*Y%t*mG;4!?FyYE{Hz;dip2GE?Q#>XUx zlyTdmvaH}Au>wnO)(j>8U@Sc&Ew(=x%k}uM8|Mw)0=i`hxOF8(c{5*3DwFFV+e;bc zS7H5)HZu-DOW(tl9Zci6FyBoD`LiKIEb}V)#we_)>Fc|$xD5X&ksggWf2OZ4d6GT} zQh#CsY(fspQym>a`8^@B_$QSZI%i4S%ClZfleEW=evo`&;P2Fqi+3<;Ry((Uo~o4Q zVi%cV)IaDDKA!HMUBd#5K-6m!;IKFiPQFJeD^o^OQr>ZWvA4U_A6e3C%#*n&>sX7< z7|p%GxiPiZVrViC1QgciXZP(hC^2DuDW7LsX-QsWSauq`lUiBLC@e4rl~|KzkW+p4 zUNu5_XpTZd-7uThqUQpeW>sBn5?x6U2Z7V^E~(q)Tyo^<#nyzbC$*#eZWCNka6Ea* z5pjepDbAk(Zm+UkqMbMeFyje4&3Rwa;NpCp%E$Zr_JX5v@kZ(A0|l`;eb)%+six|U zhadO5vH@cXobSC|N~D5fai7mx<$HBUB3hbh;5xClCu(!*>lo>IFEBLQsuGAocPoI= zo>!irEk*~&aJ&l0!91Zm`%QJY9l3`-U*RRqA&#IBGPibfQ0|YGJqJN_f!~*sqC4;b z(v)O%i>?+P)Dtds=+^MX-N3ZuL;KkVttL9S1kG+dh$?jw2bSODp>5$f!TGDXg7S=kd2B*nD6 z3qf;pb5KlcL3<*1zt?EWORd-uKA_+;#(T*(jFddb>V%*yqPBVcd*O!SRmDb@Cr-_R z?zfY~G}4QTE#hXpL{94kuMSI_gQ!2wDfQ~%H>PZ$oM+8Ue<3oQ(YJMbO!!_%Y$8DR z$1}b;>X`u-X3-lED;bfk8z4O%Z@?+Ue|S4B$`@LeTJO`b{vMcy^K$)W5k7P4LvX&K znGf520^$ZrDq4M)N*({m@U|uFJnf0%rcvT+`$0dg!IQL3<)WLkf$7o_;^Fn>-69yg^B!XRKXq{WX`?-|j<_NF3ow zP-IE8i7Cw~3nUF^k+3xUV<hw(~XQ$mD`K7MOrukTR zI)lE-ui4!%Z{Y5EfEoSO0RHc*{*$+v;u{+SMH_ZKp@xNI)f71 zyEj`YA&>x>YuE?B6J?uBwk_*eb@b_0&Hn;{4An6$a3-Yjq=_!d=0hMYTydht3X5MJ zU`M2(iEv>47q6EE(p*`j|La8Q`|Du(#I!sAcA+%%YlviECqlU&)RJwF9aS8uirK2y zuV#twGt8U~i|WqW9}Ux1vawIZCZ({>JPK5X*!rM+rWSo^a^d0e;Nr{sEC&YhBLR0QL|}VTX{;xyQ+t@-I#Nt$l*}ZbGXW zD#tP~P|jng3Lwww(cph$@?UM>U+fGo)8TcrB@QIOVc7NmB*tHy;-AR(??=2WJHmUH zy|2@hr)#npZCK9}=0Ff8KmdW*hyEoX|E$|zN~?VKieq7nBS;1;Y#8u&#{N_UqjG8pM$sFt>EMt;ebF&IsXQpN?#86`r3&K7P@Lj+F z*-u6+CHbpz3g$Qbhp1+TI!{~)2Q-=@`)m9!Yg5s36CkOj3ajHjun+Z{+~cwXbov)I z=KoX>*o9wzeZ=`l#O`$m5H|bJ-V|`}f4=r_m0X9Y-Rpw`0Px>Zpe6uE&iBJsuf2=J z+Q7Oi(h!bse+kDxUa6(X0%!TYWoy^|PH1IAZD_ z;|RuFI=G6kv)6KnvgfkZ1GT6gul)q;MeLdi&CQNgF7c{Y@O5%lvKmYP7vVqksGFKEz`Cc^)ij=*#6?9rFK6)BLFtc?KvUEsR02SL^8hjxFiH zYDUA?CPqg|<0#EO$gitcafj=!b*|G5>aX384? z8K8cRAhP1q(^s-KU`+8Jdilxp(Br=;g_#0+FRqdO-y8xU{G~ps376_8u)Py+ zqnJ-N(}TrNz1uvfuR^qd?hcS;;`i#Q*tS~nwaf~?0@=DX01?sPiw%5>>c#vfh5N!2 zC=!}`$&CwJsFK!8PUE4t=t0O7E6@XSPc5HdQho7S=niBckaLfvV~kgzn0l*{;qEVx z^J`Wh#E2>X(y$#-mPnIz+u?CudeNu;-*!@|F;nN?B1vIWmlxN%Z;7fJZhag(W&v^$ z@)0%Vl~+V)Wxx3`2R{7iTuR0PwW|tE%V=W4;qJVJ7ir{{~i`w38T}bhMTi#x9C50hnH(vQZ6(kcd z(iAWJ7fb)T`GPb7ZqF22ON!yAHW2#=XS|js%2giq_x(JuZsF_=NqQN8HvKSHyq4W= z&}U^et;N`wDSo%;cx8RY_W^Uc4e|!<#(NdWaUd94o77|Fy&U)C5w6&?pT0nAD?`19 z{@V_q1XViMkNT<0!{F~GD)sSOrm>`9;79dYKiX%V$|SKdHE+ySf>z<8zmrJ1t)A6iuXYs%-E80$&a86 zPywz%K-CIA-Qq7pd0_0&>Y8x36-0~#Ft*-Z7)~iCc9`7-_T7lbp#6`b216K71klnV zQtWi4^g4L#rXz(LaLkZ~6Cm0EC6ys(NUOXFjNc}-YF+^1fxHYTp5cN-ya$TDXbG+I zbH@;l*7IQ;HzF`vCuA!XIHq8|nE+qB59MHQ9~=N+Vt25&!p;XFZghz%2Gz7|5(!SW zWLY+lq00LkL~x}Cm}(>IdR{xDd%qC{tbo10U=j`4cq{<-tupmU^3{#?#RFzg6i9*$ zv(b;`Rep#A03hJ_J`87F2DljOb-rLnfG=bwC0pg!Cs5S6;Z zFE$9F0P_cM;!88YaE1VzL1vfvGv~?O4iI!;$JEQ+OTX;o=v|j0;(l0l@h9G?NO$aEQYJ299F~DH6z>uK;*TNtXFr z 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 literal 0 HcmV?d00001 From 854303699a96d3f8fb626c7d04bd5b533765edb2 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:13:24 +0800 Subject: [PATCH 14/37] feat(uav_flight_base): tune visual servo, move target in front, add camera demo --- src/uav_flight_base/worlds/uav_world.world | 191 +++++++++++---------- 1 file changed, 96 insertions(+), 95 deletions(-) diff --git a/src/uav_flight_base/worlds/uav_world.world b/src/uav_flight_base/worlds/uav_world.world index 49dc6b1b35..f256890e4f 100644 --- a/src/uav_flight_base/worlds/uav_world.world +++ b/src/uav_flight_base/worlds/uav_world.world @@ -1,95 +1,96 @@ - - - - - - 0.004 - 0.8 - - - model://sun - model://ground_plane - - - - true - 0 4.0 1.25 0 0 0 - - 8.0 0.3 2.5 - - 8.0 0.3 2.5 - 0.55 0.56 0.6 10.72 0.73 0.76 1 - - - - - - true - 0 -4.0 1.25 0 0 0 - - 8.0 0.3 2.5 - - 8.0 0.3 2.5 - 0.55 0.56 0.6 10.72 0.73 0.76 1 - - - - - - true - 4.0 0 1.25 0 0 0 - - 0.3 8.0 2.5 - - 0.3 8.0 2.5 - 0.55 0.56 0.6 10.72 0.73 0.76 1 - - - - - - true - -4.0 0 1.25 0 0 0 - - 0.3 8.0 2.5 - - 0.3 8.0 2.5 - 0.55 0.56 0.6 10.72 0.73 0.76 1 - - - - - - - true - 1.6 1.2 1.25 0 0 0 - - 0.352.5 - - 0.352.5 - 0.2 0.22 0.28 10.3 0.33 0.4 1 - - - - - - - true - -1.8 2.2 0.35 0 0 0 - - 0.30.7 - - 0.30.7 - 0.8 0.1 0.1 10.9 0.15 0.12 1 - - - - - - - -8 -8 6 0 0.35 0.78 - - - - - + + + + + + 0.004 + 0.8 + + + model://sun + model://ground_plane + + + + true + 0 4.0 1.25 0 0 0 + + 8.0 0.3 2.5 + + 8.0 0.3 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + true + 0 -4.0 1.25 0 0 0 + + 8.0 0.3 2.5 + + 8.0 0.3 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + true + 4.0 0 1.25 0 0 0 + + 0.3 8.0 2.5 + + 0.3 8.0 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + true + -4.0 0 1.25 0 0 0 + + 0.3 8.0 2.5 + + 0.3 8.0 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + + true + 0.8 -1.9 1.25 0 0 0 + + 0.352.5 + + 0.352.5 + 0.2 0.22 0.28 10.3 0.33 0.4 1 + + + + + + + true + 2.6 0.3 0.35 0 0 0 + + 0.30.7 + + 0.30.7 + 0.8 0.1 0.1 10.9 0.15 0.12 1 + + + + + + + -8 -8 6 0 0.35 0.78 + + + + + + From bd7215a11e167f1980e25b2a91c457a0be2e0358 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:13:27 +0800 Subject: [PATCH 15/37] feat(uav_flight_base): tune visual servo, move target in front, add camera demo --- src/uav_flight_base/launch/servo.launch | 9 ++++++--- 1 file changed, 6 insertions(+), 3 deletions(-) diff --git a/src/uav_flight_base/launch/servo.launch b/src/uav_flight_base/launch/servo.launch index a3e573a27f..d2bf13e22f 100644 --- a/src/uav_flight_base/launch/servo.launch +++ b/src/uav_flight_base/launch/servo.launch @@ -18,9 +18,12 @@ output="screen"> - - - + + + + + + From 5d4865a6737e897644a20e8e6951f16085449d6d Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:13:29 +0800 Subject: [PATCH 16/37] feat(uav_flight_base): tune visual servo, move target in front, add camera demo --- docs/uav_flight_base/images/servo_demo.gif | Bin 0 -> 10597 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/uav_flight_base/images/servo_demo.gif diff --git a/docs/uav_flight_base/images/servo_demo.gif b/docs/uav_flight_base/images/servo_demo.gif new file mode 100644 index 0000000000000000000000000000000000000000..47f4c8f9229dce4fc89d0c3acdde7d233c948bce GIT binary patch literal 10597 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 ID++q_Usa=5LI3~& literal 0 HcmV?d00001 From 8d10f7930ae52952066a13ca440e0c19137dc035 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:13:32 +0800 Subject: [PATCH 17/37] feat(uav_flight_base): tune visual servo, move target in front, add camera demo --- docs/uav_flight_base/images/camera_frame.png | Bin 0 -> 3237 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/uav_flight_base/images/camera_frame.png diff --git a/docs/uav_flight_base/images/camera_frame.png b/docs/uav_flight_base/images/camera_frame.png new file mode 100644 index 0000000000000000000000000000000000000000..27f8f5795828622a95dc35b88da5e61d11c2d82b GIT binary patch literal 3237 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 Date: Fri, 13 Nov 2026 09:18:20 +0800 Subject: [PATCH 18/37] feat(uav_flight_base): end-to-end behavior cloning (image to cmd_vel), task 4 --- .../scripts/uav_expert_collect.py | 129 ++++++++++++++++++ 1 file changed, 129 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_expert_collect.py diff --git a/src/uav_flight_base/scripts/uav_expert_collect.py b/src/uav_flight_base/scripts/uav_expert_collect.py new file mode 100644 index 0000000000..8722d7d755 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_expert_collect.py @@ -0,0 +1,129 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""任务4 第一步:采集"专家"数据(行为克隆)。 + +专家策略不看图像,用 Gazebo 真值位姿算朝向目标的偏航误差,输出 +(v, w) 控制量;同时把相机图像存盘。训练时只用图像 → 控制量, +推理时也不需要真值,实现真正的"端到端"。 + +产物: + ~/bc_data/images/000000.png ... 64x48 灰度图 + ~/bc_data/labels.csv frame,v,w +""" + +import math +import os + +import rospy +import cv2 +import numpy as np +from gazebo_msgs.msg import ModelStates +from geometry_msgs.msg import Twist +from sensor_msgs.msg import Image + +W, H = 64, 48 +GOAL = (2.6, 0.3) + + +def yaw_from_quat(q): + return math.atan2(2.0 * (q.w * q.z + q.x * q.y), + 1.0 - 2.0 * (q.y * q.y + q.z * q.z)) + + +class Collector(object): + def __init__(self): + self.out = rospy.get_param("~out_dir", os.path.expanduser("~/bc_data")) + self.every = int(rospy.get_param("~every", 3)) # 每 3 帧存一张 + self.v_max = rospy.get_param("~v_max", 0.7) + self.model_name = rospy.get_param("~model_name", "uav") + + self.img_dir = os.path.join(self.out, "images") + if not os.path.isdir(self.img_dir): + os.makedirs(self.img_dir) + + self.labels = open(os.path.join(self.out, "labels.csv"), "w") + self.labels.write("frame,v,w\n") + + self.count = 0 + self.seen = 0 + self.pose = None + self.img = None + self.latest = None + + rospy.Subscriber("/uav_cam/image_raw", Image, self.on_img, queue_size=1) + rospy.Subscriber("/gazebo/model_states", ModelStates, self.on_states, queue_size=1) + self.pub = rospy.Publisher("/cmd_vel", Twist, queue_size=1) + rospy.loginfo("采集开始 -> %s", self.out) + + def on_img(self, msg): + self.img = msg + + def on_states(self, msg): + try: + i = msg.name.index(self.model_name) + except ValueError: + return + p = msg.pose[i] + self.pose = (p.position.x, p.position.y, yaw_from_quat(p.orientation)) + + def control(self, x, y, yaw): + dx, dy = GOAL[0] - x, GOAL[1] - y + dist = math.hypot(dx, dy) + err = math.atan2(dy, dx) - yaw + while err > math.pi: + err -= 2 * math.pi + while err < -math.pi: + err += 2 * math.pi + w = max(-0.8, min(0.8, 1.3 * err)) + v = self.v_max * max(0.0, 1.0 - abs(err) / 1.4) + if dist < 0.5: + v, w = 0.0, 0.0 + return v, w + + def run(self): + r = rospy.Rate(15) + while not rospy.is_shutdown(): + if self.img is None or self.pose is None: + r.sleep() + continue + + m = self.img + buf = np.frombuffer(m.data, dtype=np.uint8) + small = None + try: + if m.encoding.lower() in ("rgb8", "bgr8"): + a = buf.reshape(m.height, m.step)[:, :m.width * 3] + a = a.reshape(m.height, m.width, 3) + gray = cv2.cvtColor(a, cv2.COLOR_RGB2GRAY) + small = cv2.resize(gray, (W, H)) + except Exception: + small = None + + v, w = self.control(*self.pose) + cmd = Twist() + cmd.linear.x = v + cmd.angular.z = w + self.pub.publish(cmd) + + self.seen += 1 + if small is not None and self.seen % self.every == 0: + name = "%06d.png" % self.count + cv2.imwrite(os.path.join(self.img_dir, name), small) + self.labels.write("%s,%.3f,%.3f\n" % (name, v, w)) + self.labels.flush() + self.count += 1 + if self.count % 50 == 0: + rospy.loginfo("已采集 %d 帧", self.count) + r.sleep() + + self.labels.close() + rospy.loginfo("采集结束,共 %d 帧", self.count) + + +def main(): + rospy.init_node("uav_expert_collect") + Collector().run() + + +if __name__ == "__main__": + main() From fab8931cede945fc9e897596d5bce1f996808827 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:18:23 +0800 Subject: [PATCH 19/37] feat(uav_flight_base): end-to-end behavior cloning (image to cmd_vel), task 4 --- src/uav_flight_base/scripts/uav_train_np.py | 106 ++++++++++++++++++++ 1 file changed, 106 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_train_np.py diff --git a/src/uav_flight_base/scripts/uav_train_np.py b/src/uav_flight_base/scripts/uav_train_np.py new file mode 100644 index 0000000000..ce70f2d151 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_train_np.py @@ -0,0 +1,106 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""任务4:端到端神经网络(图像 -> 控制量),纯 NumPy 实现,无需 torch。 + +网络结构: + 输入 32x24 灰度 (768) -> 隐层 64 (ReLU) -> 输出 2 (v, w) + 损失 MSE + L2 正则,SGD + 动量 + +用法: + python3 uav_train_np.py ~/bc_data 300 +产物: + ~/bc_data/weights.npz +""" + +import csv +import os +import sys + +import numpy as np + + +def load(root, w=32, h=24): + import cv2 + rows = list(csv.DictReader(open(os.path.join(root, "labels.csv")))) + xs, ys = [], [] + for r in rows: + img = cv2.imread(os.path.join(root, "images", r["frame"]), cv2.IMREAD_GRAYSCALE) + if img is None: + continue + xs.append(cv2.resize(img, (w, h)).astype(np.float32).ravel() / 255.0) + ys.append([float(r["v"]), float(r["w"])]) + return np.array(xs), np.array(ys, dtype=np.float32) + + +def main(): + root = os.path.expanduser(sys.argv[1] if len(sys.argv) > 1 else "~/bc_data") + epochs = int(sys.argv[2]) if len(sys.argv) > 2 else 300 + + x, y = load(root) + print("samples:", x.shape, y.shape) + if len(x) < 20: + print("样本太少,先采集数据") + return 1 + + n, d = x.shape + idx = np.random.permutation(n) + split = int(n * 0.85) + tr, va = idx[:split], idx[split:] + + # 归一化目标 + y_mean = y[tr].mean(axis=0) + y_std = y[tr].std(axis=0) + 1e-6 + yn = (y - y_mean) / y_std + + rng = np.random.RandomState(0) + W1 = rng.randn(d, 64).astype(np.float32) * np.sqrt(2.0 / d) + b1 = np.zeros(64, dtype=np.float32) + W2 = rng.randn(64, 2).astype(np.float32) * np.sqrt(2.0 / 64) + b2 = np.zeros(2, dtype=np.float32) + + mW1 = np.zeros_like(W1); mb1 = np.zeros_like(b1) + mW2 = np.zeros_like(W2); mb2 = np.zeros_like(b2) + + lr = 3e-3 + mom = 0.9 + l2 = 1e-4 + best = 1e9 + best_pack = None + + for ep in range(epochs): + perm = np.random.permutation(len(tr)) + for i in range(0, len(perm), 64): + b = tr[perm[i:i + 64]] + xb, yb = x[b], yn[b] + h = xb @ W1 + b1 + h = np.maximum(h, 0.0) + o = h @ W2 + b2 + e = o - yb + go = e * (2.0 / len(b)) + gW2 = h.T @ go + l2 * W2 + gb2 = go.sum(axis=0) + gh = (go @ W2.T) * (h > 0) + gW1 = xb.T @ gh + l2 * W1 + gb1 = gh.sum(axis=0) + mW1 = mom * mW1 - lr * gW1; W1 += mW1 + mb1 = mom * mb1 - lr * gb1; b1 += mb1 + mW2 = mom * mW2 - lr * gW2; W2 += mW2 + mb2 = mom * mb2 - lr * gb2; b2 += mb2 + + hv = np.maximum(x[va] @ W1 + b1, 0.0) + vloss = float(np.mean((hv @ W2 + b2 - yn[va]) ** 2)) + if vloss < best: + best = vloss + best_pack = (W1.copy(), b1.copy(), W2.copy(), b2.copy()) + if ep % 50 == 0 or ep == epochs - 1: + print("epoch %3d val %.5f" % (ep, vloss)) + + W1, b1, W2, b2 = best_pack + np.savez(os.path.join(root, "weights.npz"), W1=W1, b1=b1, W2=W2, b2=b2, + y_mean=y_mean, y_std=y_std) + print("best val loss %.5f -> %s" % (best, os.path.join(root, "weights.npz"))) + return 0 + + +if __name__ == "__main__": + sys.exit(main()) From f403bf066564229095532d6d598b0d30989f4c01 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:18:25 +0800 Subject: [PATCH 20/37] feat(uav_flight_base): end-to-end behavior cloning (image to cmd_vel), task 4 --- src/uav_flight_base/scripts/uav_np_driver.py | 62 ++++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_np_driver.py diff --git a/src/uav_flight_base/scripts/uav_np_driver.py b/src/uav_flight_base/scripts/uav_np_driver.py new file mode 100644 index 0000000000..9b831c5f8f --- /dev/null +++ b/src/uav_flight_base/scripts/uav_np_driver.py @@ -0,0 +1,62 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""任务4:用 NumPy 网络实时飞行(纯图像输入,不使用任何真值)。""" + +import os +import sys + +import cv2 +import numpy as np +import rospy +from geometry_msgs.msg import Twist +from sensor_msgs.msg import Image + +W, H = 32, 24 + + +class NpDriver(object): + def __init__(self, weights): + z = np.load(weights) + self.W1, self.b1 = z["W1"], z["b1"] + self.W2, self.b2 = z["W2"], z["b2"] + self.ym, self.ys = z["y_mean"], z["y_std"] + self.pub = rospy.Publisher("/cmd_vel", Twist, queue_size=1) + rospy.Subscriber("/uav_cam/image_raw", Image, self.on_img, queue_size=1) + self.count = 0 + self.busy = False + rospy.loginfo("NumPy 策略已加载: %s", weights) + + def on_img(self, msg): + if self.busy: + return + self.busy = True + try: + buf = np.frombuffer(msg.data, dtype=np.uint8) + a = buf.reshape(msg.height, msg.step)[:, :msg.width * 3].reshape(msg.height, msg.width, 3) + gray = cv2.cvtColor(a, cv2.COLOR_RGB2GRAY) + small = cv2.resize(gray, (W, H)).astype(np.float32).ravel() / 255.0 + h = np.maximum(small @ self.W1 + self.b1, 0.0) + o = h @ self.W2 + self.b2 + out = o * self.ys + self.ym + cmd = Twist() + cmd.linear.x = float(np.clip(out[0], 0.0, 0.8)) + cmd.angular.z = float(np.clip(out[1], -0.9, 0.9)) + self.pub.publish(cmd) + self.count += 1 + if self.count % 100 == 0: + rospy.loginfo("推理 %d 帧 v=%.2f w=%.2f", self.count, cmd.linear.x, cmd.angular.z) + except Exception as e: + rospy.logwarn_throttle(5.0, "推理失败: %s", e) + finally: + self.busy = False + + +def main(): + path = os.path.expanduser(sys.argv[1] if len(sys.argv) > 1 else "~/bc_data/weights.npz") + rospy.init_node("uav_np_driver") + NpDriver(path) + rospy.spin() + + +if __name__ == "__main__": + main() From d8c7f8c31f34ce12e9d76ee85cbdf98a544ed422 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:18:28 +0800 Subject: [PATCH 21/37] feat(uav_flight_base): end-to-end behavior cloning (image to cmd_vel), task 4 --- src/uav_flight_base/scripts/uav_train_cnn.py | 101 +++++++++++++++++++ 1 file changed, 101 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_train_cnn.py diff --git a/src/uav_flight_base/scripts/uav_train_cnn.py b/src/uav_flight_base/scripts/uav_train_cnn.py new file mode 100644 index 0000000000..99161f3695 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_train_cnn.py @@ -0,0 +1,101 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""任务4 第二步:训练 CNN(图像 -> 控制量),行为克隆。 + +输入: ~/bc_data/images/*.png (64x48 灰度) + labels.csv +输出: ~/bc_data/model.pt + +网络: Conv(1->8,3x3) - ReLU - MaxPool2 - Conv(8->16,3x3) - ReLU - MaxPool2 + - FC(16*12*16 -> 64) - ReLU - FC(64 -> 2) +""" + +import csv +import os +import sys + +import numpy as np +import torch +import torch.nn as nn + + +class SmallCNN(nn.Module): + def __init__(self): + super(SmallCNN, self).__init__() + self.features = nn.Sequential( + nn.Conv2d(1, 8, 3, padding=1), nn.ReLU(), nn.MaxPool2d(2), + nn.Conv2d(8, 16, 3, padding=1), nn.ReLU(), nn.MaxPool2d(2), + ) + self.head = nn.Sequential( + nn.Linear(16 * 12 * 16, 64), nn.ReLU(), + nn.Linear(64, 2), + ) + + def forward(self, x): + x = self.features(x) + x = x.view(x.size(0), -1) + return self.head(x) + + +def load_data(root): + import cv2 + labels = list(csv.DictReader(open(os.path.join(root, "labels.csv")))) + xs, ys = [], [] + for r in labels: + p = os.path.join(root, "images", r["frame"]) + img = cv2.imread(p, cv2.IMREAD_GRAYSCALE) + if img is None: + continue + xs.append(img.astype(np.float32) / 255.0) + ys.append([float(r["v"]), float(r["w"])]) + x = torch.from_numpy(np.array(xs)[:, None, :, :]) + y = torch.from_numpy(np.array(ys, dtype=np.float32)) + return x, y + + +def main(): + root = os.path.expanduser(sys.argv[1] if len(sys.argv) > 1 else "~/bc_data") + epochs = int(sys.argv[2]) if len(sys.argv) > 2 else 30 + x, y = load_data(root) + print("samples:", x.shape, y.shape) + if len(x) < 20: + print("样本太少") + return 1 + + n = len(x) + idx = torch.randperm(n) + split = int(n * 0.85) + tr, va = idx[:split], idx[split:] + + net = SmallCNN() + opt = torch.optim.Adam(net.parameters(), lr=1e-3) + lossf = nn.MSELoss() + + best = 1e9 + for ep in range(epochs): + net.train() + perm = tr[torch.randperm(len(tr))] + tot = 0.0 + for i in range(0, len(perm), 32): + b = perm[i:i + 32] + opt.zero_grad() + out = net(x[b]) + loss = lossf(out, y[b]) + loss.backward() + opt.step() + tot += loss.item() * len(b) + net.eval() + with torch.no_grad(): + vloss = lossf(net(x[va]), y[va]).item() + if ep % 5 == 0 or ep == epochs - 1: + print("epoch %3d train %.5f val %.5f" % (ep, tot / len(tr), vloss)) + if vloss < best: + best = vloss + torch.save(net.state_dict(), os.path.join(root, "model.pt")) + + print("best val loss: %.5f" % best) + print("saved:", os.path.join(root, "model.pt")) + return 0 + + +if __name__ == "__main__": + sys.exit(main()) From c88661400df6f7f3a672d1cd8d23197c5f42cb06 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:18:30 +0800 Subject: [PATCH 22/37] feat(uav_flight_base): end-to-end behavior cloning (image to cmd_vel), task 4 --- src/uav_flight_base/scripts/uav_cnn_driver.py | 62 +++++++++++++++++++ 1 file changed, 62 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_cnn_driver.py diff --git a/src/uav_flight_base/scripts/uav_cnn_driver.py b/src/uav_flight_base/scripts/uav_cnn_driver.py new file mode 100644 index 0000000000..003b7e93fe --- /dev/null +++ b/src/uav_flight_base/scripts/uav_cnn_driver.py @@ -0,0 +1,62 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""任务4 第三步:用训练好的 CNN 实时飞行(只吃图像,不用任何真值)。""" + +import os +import sys + +import cv2 +import numpy as np +import rospy +import torch +from geometry_msgs.msg import Twist +from sensor_msgs.msg import Image + +from uav_train_cnn import SmallCNN + +W, H = 64, 48 + + +class CnnDriver(object): + def __init__(self, model_path): + self.net = SmallCNN() + self.net.load_state_dict(torch.load(model_path, map_location="cpu")) + self.net.eval() + self.pub = rospy.Publisher("/cmd_vel", Twist, queue_size=1) + rospy.Subscriber("/uav_cam/image_raw", Image, self.on_img, queue_size=1) + self.busy = False + self.count = 0 + rospy.loginfo("CNN 推理已加载: %s", model_path) + + def on_img(self, msg): + if self.busy: + return + try: + buf = np.frombuffer(msg.data, dtype=np.uint8) + a = buf.reshape(msg.height, msg.step)[:, :msg.width * 3] + a = a.reshape(msg.height, msg.width, 3) + gray = cv2.cvtColor(a, cv2.COLOR_RGB2GRAY) + small = cv2.resize(gray, (W, H)).astype(np.float32) / 255.0 + t = torch.from_numpy(small)[None, None, :, :] + with torch.no_grad(): + out = self.net(t)[0].numpy() + cmd = Twist() + cmd.linear.x = float(max(0.0, min(0.8, out[0]))) + cmd.angular.z = float(max(-0.9, min(0.9, out[1]))) + self.pub.publish(cmd) + self.count += 1 + if self.count % 100 == 0: + rospy.loginfo("推理 %d 帧 v=%.2f w=%.2f", self.count, cmd.linear.x, cmd.angular.z) + except Exception as e: + rospy.logwarn_throttle(5.0, "推理失败: %s", e) + + +def main(): + path = os.path.expanduser(sys.argv[1] if len(sys.argv) > 1 else "~/bc_data/model.pt") + rospy.init_node("uav_cnn_driver") + CnnDriver(path) + rospy.spin() + + +if __name__ == "__main__": + main() From 0b52526ca33d765315f1053858c44c9362391d37 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:21:50 +0800 Subject: [PATCH 23/37] feat(uav_flight_base): unified main.py entry for tasks 1-4, update README --- src/uav_flight_base/main.py | 159 ++++++++++++++++++++++++++---------- 1 file changed, 118 insertions(+), 41 deletions(-) diff --git a/src/uav_flight_base/main.py b/src/uav_flight_base/main.py index 4debd27f70..92f591c869 100644 --- a/src/uav_flight_base/main.py +++ b/src/uav_flight_base/main.py @@ -1,16 +1,18 @@ #!/usr/bin/env python3 # -*- coding: utf-8 -*- -"""uav_flight_base 模块入口。 +"""uav_flight_base 模块统一入口。 -用法: - python3 main.py # 默认 mock 模式(不需要任何模拟器) - python3 main.py --mode gazebo # 接 Gazebo(需要额外安装 uav 模型) - python3 main.py --list # 只打印可用节点,不启动 +课程要求:入口文件名为 main.*,所有功能支持 launch 启动。 +本文件把 4 个任务收敛到一个命令: -约定(对齐 OpenHUTB 仓库规范): - · 入口文件名为 main.* - · ROS 启动配置为 launch/main.launch - · 所有参数通过 roslaunch args 或 rosparam 传入,不写死在代码里 + python3 main.py --list 查看全部任务 + python3 main.py --task 1 键盘遥控(运动学仿真) + python3 main.py --task 2 --mode lidar 激光雷达感知 + 反应式避障 + python3 main.py --task 2 --mode vision 相机颜色检测 + 视觉伺服 + python3 main.py --task 3 栅格建图 + A* 导航 + python3 main.py --task 4 --stage collect|train|drive 端到端网络 + +所有任务都在 Ubuntu 20.04 + ROS Noetic + Gazebo 11 上验证通过。 """ import argparse @@ -18,50 +20,125 @@ import subprocess import sys -MODES = ("mock", "gazebo") - +PKG = "uav_flight_base" -def build_launch_cmd(mode, extra_args): - return ["roslaunch", "uav_flight_base", "main.launch", - "mode:={}".format(mode)] + extra_args +TASKS = { + 1: { + "name": "键盘遥控 + 运动学仿真", + "desc": "键盘输入 → /uav/cmd_vel → 运动学模型 → /uav/odom + TF", + "launch": "main.launch", + "args": {"mode": "mock"}, + }, + 2: { + "name": "传感器感知 + 运动控制", + "desc": "lidar: 360 线激光 → 扇区最近距离 → 反应式避障;" + "vision: HSV 颜色检测 → PID 视觉伺服", + "launch": None, # 按 mode 选择 + "args": {}, + }, + 3: { + "name": "建图 + 导航", + "desc": "激光 ray casting 占据栅格 → 8 邻域 A* → 纯追踪飞行", + "launch": "nav.launch", + "args": {}, + }, + 4: { + "name": "端到端模型(图像 → 控制)", + "desc": "专家采数据 → 训练网络 → 网络实时飞行", + "launch": None, + "args": {}, + }, +} +LAUNCH_2 = {"lidar": "avoid.launch", "vision": "servo.launch"} -def main(): - ap = argparse.ArgumentParser(description="无人机基础飞行模块(键盘遥控 / 状态监控)") - ap.add_argument("--mode", default="mock", choices=MODES, - help="mock=纯软件仿真,gazebo=接 Gazebo 世界") - ap.add_argument("--list", action="store_true", help="打印节点清单后退出") - ap.add_argument("--no-launch", action="store_true", - help="不调用 roslaunch,只打印将要执行的命令") - args, extra = ap.parse_known_args() - pkg_dir = os.path.dirname(os.path.abspath(__file__)) - scripts = sorted( - f for f in os.listdir(os.path.join(pkg_dir, "scripts")) - if f.endswith(".py") - ) if os.path.isdir(os.path.join(pkg_dir, "scripts")) else [] - - if args.list: - print("package : uav_flight_base") - print("mode : {}".format(args.mode)) - print("nodes :") - for s in scripts: - print(" - {}".format(s)) - return 0 +def show_list(): + print("=" * 66) + print(" uav_flight_base —— 无人机仿真模块(任务 1~4)") + print("=" * 66) + for k in sorted(TASKS): + t = TASKS[k] + print(" [任务 %d] %s" % (k, t["name"])) + print(" %s" % t["desc"]) + if t["launch"]: + print(" 启动: roslaunch %s %s" % (PKG, t["launch"])) + elif k == 2: + print(" 启动: roslaunch %s avoid.launch | servo.launch" % PKG) + else: + print(" 启动: stage=collect / train / drive(见 README)") + print("") + print(" 用法示例: python3 main.py --task 3") + print("=" * 66) - cmd = build_launch_cmd(args.mode, extra) - print("[uav_flight_base] mode = {}".format(args.mode)) - print("[uav_flight_base] exec: {}".format(" ".join(cmd))) - if args.no_launch: +def run_launch(launch, extra, dry): + cmd = ["roslaunch", PKG, launch] + extra + print("[main] 执行: " + " ".join(cmd)) + if dry: + print("[main] --dry-run:只打印命令,不启动") return 0 - try: return subprocess.call(cmd) except FileNotFoundError: - sys.stderr.write("找不到 roslaunch,请先 source /opt/ros/noetic/setup.bash\n") + sys.stderr.write("[main] 找不到 roslaunch,请先 source /opt/ros/noetic/setup.bash\n") return 127 +def run_task4(stage, dry): + home = os.path.expanduser("~") + data = os.path.join(home, "bc_data") + scripts = os.path.join(home, "catkin_ws/src", PKG, "scripts") + + if stage == "collect": + cmd = ["rosrun", PKG, "uav_expert_collect.py"] + elif stage == "train": + cmd = [sys.executable, os.path.join(scripts, "uav_train_np.py"), data, "300"] + elif stage == "drive": + cmd = ["rosrun", PKG, "uav_np_driver.py", os.path.join(data, "weights.npz")] + else: + sys.stderr.write("[main] --stage 只能是 collect / train / drive\n") + return 2 + + print("[main] 执行: " + " ".join(cmd)) + if dry: + print("[main] --dry-run:只打印命令,不启动") + return 0 + return subprocess.call(cmd) + + +def main(): + ap = argparse.ArgumentParser(description="无人机仿真模块统一入口") + ap.add_argument("--task", type=int, choices=[1, 2, 3, 4], help="要运行的任务编号") + ap.add_argument("--mode", default="lidar", choices=["lidar", "vision"], + help="任务2 的感知方式") + ap.add_argument("--stage", default="collect", choices=["collect", "train", "drive"], + help="任务4 的阶段") + ap.add_argument("--gui", action="store_true", help="显示 Gazebo 界面") + ap.add_argument("--dry-run", action="store_true", help="只打印命令不执行") + ap.add_argument("--list", action="store_true", help="列出全部任务") + args, extra = ap.parse_known_args() + + if args.list or args.task is None: + show_list() + return 0 + + gui = "true" if args.gui else "false" + + if args.task == 1: + # main.launch 没有 gui 参数,只有 teleop / csv + return run_launch(TASKS[1]["launch"], + ["mode:=mock"] + extra, args.dry_run) + + if args.task == 2: + launch = LAUNCH_2[args.mode] + return run_launch(launch, ["gui:=%s" % gui] + extra, args.dry_run) + + if args.task == 3: + return run_launch(TASKS[3]["launch"], ["gui:=%s" % gui] + extra, args.dry_run) + + return run_task4(args.stage, args.dry_run) + + if __name__ == "__main__": sys.exit(main()) From 34ade7b574332f4097b7b5d958b2b696265ea9d6 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:21:52 +0800 Subject: [PATCH 24/37] feat(uav_flight_base): unified main.py entry for tasks 1-4, update README --- src/uav_flight_base/README.md | 33 ++++++++++++++++++++++++++++++++- 1 file changed, 32 insertions(+), 1 deletion(-) diff --git a/src/uav_flight_base/README.md b/src/uav_flight_base/README.md index 803a31dc16..f2c23eaf8f 100644 --- a/src/uav_flight_base/README.md +++ b/src/uav_flight_base/README.md @@ -1,6 +1,37 @@ # uav_flight_base -无人机基础飞行模块(ROS1 Noetic)。提供**键盘遥控**、**最小运动学仿真**、**状态监控**三部分, +无人机仿真模块(ROS1 Noetic + Gazebo 11),对应课程要求的四个任务。 + +## 统一入口 + +所有任务都由 `main.py` 分发,一条命令即可运行: + +```bash +python3 main.py --list # 查看全部任务 +python3 main.py --task 1 # 键盘遥控 + 运动学仿真 +python3 main.py --task 2 --mode lidar # 激光雷达感知 + 反应式避障 +python3 main.py --task 2 --mode vision # 相机颜色检测 + 视觉伺服 +python3 main.py --task 3 # 栅格建图 + A* 导航 +python3 main.py --task 4 --stage collect # 端到端网络:采集 +python3 main.py --task 4 --stage train # 端到端网络:训练 +python3 main.py --task 4 --stage drive # 端到端网络:飞行 +``` + +| 任务 | 感知 | 控制 | 对应 launch | +|---|---|---|---| +| 1 键盘遥控 | — | 键盘 → Twist | `main.launch` | +| 2 传感器感知 | 360 线激光 | 反应式避障 | `avoid.launch` | +| 2 传感器感知 | 相机(HSV) | PID 视觉伺服 | `servo.launch` | +| 3 建图导航 | 激光 → 占据栅格 | A* + 纯追踪 | `nav.launch` | +| 4 端到端 | 相机图像 | 神经网络 | `main.py --task 4` | + +> 无图形环境(纯 SSH)时,用 +> `xvfb-run -a -s "-screen 0 1024x768x24" python3 main.py --task 2 --mode vision` +> 给 Gazebo 相机提供虚拟显示器。 + +## 模块说明(第一部分:基础链路) + +提供**键盘遥控**、**最小运动学仿真**、**状态监控**三部分, 不依赖 Gazebo / AirSim 即可完整跑通,用于验证"遥控 → 控制 → 状态反馈"这条链路。 > 这是 10 次提交中的第 1 次:只做骨架与可运行的最小闭环。后续按任务 2/3/4 逐步加感知、建图、端到端网络。 From 2f6384ac554fc14a570992dbdcf21301e2a27b7e Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:35:24 +0800 Subject: [PATCH 25/37] feat(uav_flight_base): neural scan-to-cmd policy + multi-scene evaluation (task 2) --- .../scripts/uav_scan_dataset.py | 71 +++++++++++++++++++ 1 file changed, 71 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_scan_dataset.py diff --git a/src/uav_flight_base/scripts/uav_scan_dataset.py b/src/uav_flight_base/scripts/uav_scan_dataset.py new file mode 100644 index 0000000000..ba72747e3d --- /dev/null +++ b/src/uav_flight_base/scripts/uav_scan_dataset.py @@ -0,0 +1,71 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""任务2(神经网络版)第一步:采集 (激光扫描, 速度指令) 数据。 + +一边运行专家避障策略(uav_scan_avoider),一边记录它发出的 cmd_vel 与 +当时的 360 线激光扫描,得到行为克隆数据集。 + +产物: ~/policy_data/scan_dataset.csv +""" + +import csv +import os + +import numpy as np +import rospy +from geometry_msgs.msg import Twist +from sensor_msgs.msg import LaserScan + +N = 90 # 采样维度(360 线降采样到 90) +RMAX = 3.5 # 距离截断 + + +class Recorder(object): + def __init__(self): + out = rospy.get_param("~out_dir", os.path.expanduser("~/policy_data")) + if not os.path.isdir(out): + os.makedirs(out) + self.path = os.path.join(out, "scan_dataset.csv") + self.f = open(self.path, "w", newline="") + self.w = csv.writer(self.f) + self.w.writerow(["r%d" % i for i in range(N)] + ["v", "w"]) + + self.scan = None + self.cmd = None + self.count = 0 + + rospy.Subscriber("/uav/scan", LaserScan, self.on_scan, queue_size=1) + rospy.Subscriber("/cmd_vel", Twist, self.on_cmd, queue_size=1) + rospy.Timer(rospy.Duration(0.1), self.tick) + rospy.loginfo("采集到 %s", self.path) + + def on_scan(self, msg): + self.scan = msg + + def on_cmd(self, msg): + self.cmd = msg + + def tick(self, _evt): + if self.scan is None or self.cmd is None: + return + r = np.array(self.scan.ranges, dtype=np.float32) + r[~np.isfinite(r)] = RMAX + r = np.clip(r, 0.0, RMAX) + idx = np.linspace(0, len(r) - 1, N).astype(int) + feat = r[idx] + self.w.writerow(list(np.round(feat, 3)) + + [round(self.cmd.linear.x, 3), round(self.cmd.angular.z, 3)]) + self.f.flush() + self.count += 1 + if self.count % 100 == 0: + rospy.loginfo("已记录 %d 条", self.count) + + +def main(): + rospy.init_node("uav_scan_dataset") + Recorder() + rospy.spin() + + +if __name__ == "__main__": + main() From 8996718a145ac01d2b9858ff229091b31ed8d051 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:35:27 +0800 Subject: [PATCH 26/37] feat(uav_flight_base): neural scan-to-cmd policy + multi-scene evaluation (task 2) --- .../scripts/uav_train_scan_policy.py | 90 +++++++++++++++++++ 1 file changed, 90 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_train_scan_policy.py diff --git a/src/uav_flight_base/scripts/uav_train_scan_policy.py b/src/uav_flight_base/scripts/uav_train_scan_policy.py new file mode 100644 index 0000000000..283df6e1bb --- /dev/null +++ b/src/uav_flight_base/scripts/uav_train_scan_policy.py @@ -0,0 +1,90 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""任务2(神经网络版)第二步:训练"扫描 -> 速度"网络。 + +结构: 90 -> 96 (ReLU) -> 2 纯 NumPy,SGD + 动量 +输入: ~/policy_data/scan_dataset.csv +输出: ~/policy_data/scan_policy.npz +""" + +import csv +import os +import sys + +import numpy as np + + +def load(path): + rows = list(csv.reader(open(path))) + head = rows[0] + data = np.array([[float(v) for v in r] for r in rows[1:]], dtype=np.float32) + n_in = len(head) - 2 + return data[:, :n_in], data[:, -2:] + + +def main(): + root = os.path.expanduser(sys.argv[1] if len(sys.argv) > 1 else "~/policy_data") + epochs = int(sys.argv[2]) if len(sys.argv) > 2 else 400 + x, y = load(os.path.join(root, "scan_dataset.csv")) + print("samples:", x.shape) + + # 输入归一化 + 目标归一化 + xm, xs = x.mean(0), x.std(0) + 1e-6 + ym, ys = y.mean(0), y.std(0) + 1e-6 + xn = (x - xm) / xs + yn = (y - ym) / ys + + # 按时间顺序切分(避免相邻帧泄漏) + n = len(xn) + cut = int(n * 0.85) + xtr, ytr = xn[:cut], yn[:cut] + xva, yva = xn[cut:], yn[cut:] + + d = x.shape[1] + h = 96 + rng = np.random.RandomState(0) + W1 = rng.randn(d, h).astype(np.float32) * np.sqrt(2.0 / d) + b1 = np.zeros(h, dtype=np.float32) + W2 = rng.randn(h, 2).astype(np.float32) * np.sqrt(2.0 / h) + b2 = np.zeros(2, dtype=np.float32) + mW1 = np.zeros_like(W1); mb1 = np.zeros_like(b1) + mW2 = np.zeros_like(W2); mb2 = np.zeros_like(b2) + + lr, mom, l2 = 2e-3, 0.9, 1e-5 + best, best_pack = 1e9, None + + for ep in range(epochs): + perm = np.random.permutation(len(xtr)) + for i in range(0, len(perm), 64): + b = perm[i:i + 64] + xb, yb = xtr[b], ytr[b] + hh = np.maximum(xb @ W1 + b1, 0.0) + o = hh @ W2 + b2 + e = o - yb + go = e * (2.0 / len(b)) + gW2 = hh.T @ go + l2 * W2 + gb2 = go.sum(0) + gh = (go @ W2.T) * (hh > 0) + gW1 = xb.T @ gh + l2 * W1 + gb1 = gh.sum(0) + mW1 = mom * mW1 - lr * gW1; W1 += mW1 + mb1 = mom * mb1 - lr * gb1; b1 += mb1 + mW2 = mom * mW2 - lr * gW2; W2 += mW2 + mb2 = mom * mb2 - lr * gb2; b2 += mb2 + + hv = np.maximum(xva @ W1 + b1, 0.0) + vl = float(np.mean((hv @ W2 + b2 - yva) ** 2)) + if vl < best: + best, best_pack = vl, (W1.copy(), b1.copy(), W2.copy(), b2.copy()) + if ep % 50 == 0 or ep == epochs - 1: + print("epoch %3d val %.5f" % (ep, vl)) + + W1, b1, W2, b2 = best_pack + np.savez(os.path.join(root, "scan_policy.npz"), + W1=W1, b1=b1, W2=W2, b2=b2, xm=xm, xs=xs, ym=ym, ys=ys) + print("best val %.5f -> scan_policy.npz" % best) + return 0 + + +if __name__ == "__main__": + sys.exit(main()) From 782106046dcc0e32f717e760c3f710b9c7c9b261 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:35:29 +0800 Subject: [PATCH 27/37] feat(uav_flight_base): neural scan-to-cmd policy + multi-scene evaluation (task 2) --- .../scripts/uav_scan_policy.py | 79 +++++++++++++++++++ 1 file changed, 79 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_scan_policy.py diff --git a/src/uav_flight_base/scripts/uav_scan_policy.py b/src/uav_flight_base/scripts/uav_scan_policy.py new file mode 100644 index 0000000000..817f900ee8 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_scan_policy.py @@ -0,0 +1,79 @@ +#!/usr/bin/env python3 +# -*- coding: utf-8 -*- +"""任务2(神经网络版)第三步:用训练好的网络接管飞行,并记录评估指标。 + +订阅 /uav/scan -> 网络 -> /cmd_vel +同时把 (t, v, w, min_range) 写到 ~/policy_data/eval_.csv +""" + +import csv +import os +import sys + +import numpy as np +import rospy +from geometry_msgs.msg import Twist +from sensor_msgs.msg import LaserScan + +N = 90 +RMAX = 3.5 + + +class ScanPolicy(object): + def __init__(self, weights, tag): + z = np.load(weights) + self.W1, self.b1 = z["W1"], z["b1"] + self.W2, self.b2 = z["W2"], z["b2"] + self.xm, self.xs = z["xm"], z["xs"] + self.ym, self.ys = z["ym"], z["ys"] + + out = os.path.dirname(weights) or os.path.expanduser("~/policy_data") + self.log = open(os.path.join(out, "eval_%s.csv" % tag), "w", newline="") + self.w = csv.writer(self.log) + self.w.writerow(["t", "v", "w", "min_range"]) + self.t0 = rospy.Time.now() + self.count = 0 + self.min_all = 9.9 + + self.pub = rospy.Publisher("/cmd_vel", Twist, queue_size=1) + rospy.Subscriber("/uav/scan", LaserScan, self.on_scan, queue_size=1) + rospy.loginfo("扫描策略已加载: %s tag=%s", weights, tag) + + def on_scan(self, msg): + r = np.array(msg.ranges, dtype=np.float32) + r[~np.isfinite(r)] = RMAX + r = np.clip(r, 0.0, RMAX) + mr = float(r.min()) + self.min_all = min(self.min_all, mr) + + idx = np.linspace(0, len(r) - 1, N).astype(int) + feat = (r[idx] - self.xm) / self.xs + hh = np.maximum(feat @ self.W1 + self.b1, 0.0) + o = hh @ self.W2 + self.b2 + out = o * self.ys + self.ym + + cmd = Twist() + cmd.linear.x = float(np.clip(out[0], 0.0, 0.9)) + cmd.angular.z = float(np.clip(out[1], -1.0, 1.0)) + self.pub.publish(cmd) + + self.count += 1 + if self.count % 5 == 0: + self.w.writerow([round((rospy.Time.now() - self.t0).to_sec(), 2), + round(cmd.linear.x, 3), round(cmd.angular.z, 3), round(mr, 3)]) + self.log.flush() + if self.count % 100 == 0: + rospy.loginfo("推理 %d 帧 v=%.2f w=%.2f min_range=%.2f", + self.count, cmd.linear.x, cmd.angular.z, mr) + + +def main(): + path = os.path.expanduser(sys.argv[1] if len(sys.argv) > 1 else "~/policy_data/scan_policy.npz") + tag = sys.argv[2] if len(sys.argv) > 2 else "run" + rospy.init_node("uav_scan_policy") + ScanPolicy(path, tag) + rospy.spin() + + +if __name__ == "__main__": + main() From 607be25922ffec880dd7d1e47f64252a5401481b Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:35:31 +0800 Subject: [PATCH 28/37] feat(uav_flight_base): neural scan-to-cmd policy + multi-scene evaluation (task 2) --- src/uav_flight_base/launch/gazebo.launch | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/src/uav_flight_base/launch/gazebo.launch b/src/uav_flight_base/launch/gazebo.launch index 4a4b68fa97..4128e29fcb 100644 --- a/src/uav_flight_base/launch/gazebo.launch +++ b/src/uav_flight_base/launch/gazebo.launch @@ -1,13 +1,14 @@ - + + - + @@ -22,7 +23,7 @@ - + From a85e31d37ad9d196c7e2ea0a5c8f2aaf66b2e61e Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:35:33 +0800 Subject: [PATCH 29/37] feat(uav_flight_base): neural scan-to-cmd policy + multi-scene evaluation (task 2) --- .../worlds/uav_world_dense.world | 130 ++++++++++++++++++ 1 file changed, 130 insertions(+) create mode 100644 src/uav_flight_base/worlds/uav_world_dense.world diff --git a/src/uav_flight_base/worlds/uav_world_dense.world b/src/uav_flight_base/worlds/uav_world_dense.world new file mode 100644 index 0000000000..66625218aa --- /dev/null +++ b/src/uav_flight_base/worlds/uav_world_dense.world @@ -0,0 +1,130 @@ + + + + + + 0.004 + 0.8 + + + model://sun + model://ground_plane + + + + true + 0 4.0 1.25 0 0 0 + + 8.0 0.3 2.5 + + 8.0 0.3 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + true + 0 -4.0 1.25 0 0 0 + + 8.0 0.3 2.5 + + 8.0 0.3 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + true + 4.0 0 1.25 0 0 0 + + 0.3 8.0 2.5 + + 0.3 8.0 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + true + -4.0 0 1.25 0 0 0 + + 0.3 8.0 2.5 + + 0.3 8.0 2.5 + 0.55 0.56 0.6 10.72 0.73 0.76 1 + + + + + + + true + 1.2 1.2 1.25 0 0 0 + + 0.7 0.7 2.5 + 0.7 0.7 2.5 + 0.3 0.32 0.38 10.42 0.45 0.52 1 + + + + + true + -1.4 -1.2 1.25 0 0 0 + + 0.7 0.7 2.5 + 0.7 0.7 2.5 + 0.3 0.32 0.38 10.42 0.45 0.52 1 + + + + + true + 2.0 -2.0 1.25 0 0 0 + + 0.7 0.7 2.5 + 0.7 0.7 2.5 + 0.3 0.32 0.38 10.42 0.45 0.52 1 + + + + + true + -2.2 2.0 1.25 0 0 0 + + 0.7 0.7 2.5 + 0.7 0.7 2.5 + 0.3 0.32 0.38 10.42 0.45 0.52 1 + + + + + true + 0.0 1.8 1.25 0 0 0 + + 0.32.5 + 0.32.5 + 0.25 0.27 0.33 10.36 0.38 0.45 1 + + + + + true + 0.0 -1.9 1.25 0 0 0 + + 0.32.5 + 0.32.5 + 0.25 0.27 0.33 10.36 0.38 0.45 1 + + + + + + -8 -8 6 0 0.35 0.78 + + + + + From 7481789c76696adcbb8d974beb3ae5b6945939e8 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:35:36 +0800 Subject: [PATCH 30/37] feat(uav_flight_base): neural scan-to-cmd policy + multi-scene evaluation (task 2) --- docs/uav_flight_base/README.md | 49 ++++++++++++++++++++++++++++++++++ 1 file changed, 49 insertions(+) diff --git a/docs/uav_flight_base/README.md b/docs/uav_flight_base/README.md index c733788490..0688acf789 100644 --- a/docs/uav_flight_base/README.md +++ b/docs/uav_flight_base/README.md @@ -73,3 +73,52 @@ roslaunch uav_flight_base main.launch mode:=mock teleop:=false 先用轻量运动学模型把控制链路和文档跑通,再把后端换掉,代码接口不变。 2. **`main.py` 只做调度**:真正的节点逻辑都在 `scripts/` 下,每个脚本可单独 `rosrun` 调试。 3. **参数全部走 rosparam**:不写死在代码里,方便后面接不同机型。 + +--- + +## 任务 2(神经网络版):扫描 → 速度的端到端策略 + +### 数据流 + +``` +专家策略 uav_scan_avoider ──/cmd_vel──┐ + ├─→ uav_scan_dataset.py ─→ scan_dataset.csv +激光雷达 /uav/scan ───────────────────┘ (90 维扫描 + 动作标签) + │ + ▼ + uav_train_scan_policy.py ─→ scan_policy.npz + │ + ▼ + /uav/scan ─→ uav_scan_policy.py ─→ /cmd_vel +``` + +### 网络结构 + +``` +输入 90 维激光扫描(-π..π 降采样,距离截断 3.5m,标准化) +隐层 96 单元 ReLU +输出 2 维(linear.x, angular.z),标准化后反变换 +损失 MSE + L2(1e-5),SGD + 动量 0.9,lr=2e-3,400 epoch +``` + +样本 **1757** 条,按时间顺序切分(前 85% 训练、后 15% 验证,避免相邻帧泄漏), +最佳验证损失 **0.0728**。 + +### 多场景评估结果 + +| 指标 | 场景A 开阔场地 | 场景B 密集障碍 | +|---|---|---| +| 运行时长 | 116 s | 137 s | +| 平均速度 | 0.61 m/s | **0.03 m/s** | +| 平均角速度 | 0.21 rad/s | 0.12 rad/s | +| 最近障碍距离 | 0.66 m | 0.59 m | +| 贴障时间占比 (<0.6m) | 0.0 % | **90.5 %** | + +**结论**:训练数据只来自开阔场地,策略在**同类场景表现良好**(全程未贴近障碍), +但在**未见过的密集场景中趋于保守停滞**(平均速度 0.03 m/s)——典型的行为克隆分布漂移。 +后续可通过在密集场景补采数据、或加入 DAgger 式在线纠正来改善。 + +![场景A](images/policy_sceneA.png) + +![场景B](images/policy_sceneB.png) + From 4e262abcf4e9148e0628e1117c22333e0d5c1f82 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:36:01 +0800 Subject: [PATCH 31/37] docs(uav_flight_base): multi-scene evaluation figures --- docs/uav_flight_base/images/policy_sceneA.png | Bin 0 -> 34988 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/uav_flight_base/images/policy_sceneA.png diff --git a/docs/uav_flight_base/images/policy_sceneA.png b/docs/uav_flight_base/images/policy_sceneA.png new file mode 100644 index 0000000000000000000000000000000000000000..a85257850c22e2aad6c29f3dfa95b17959185ef2 GIT binary patch literal 34988 zcmcGVWkAz!-0p2fNz>c*Y6~)PyTy-cgy_2f3HtI@&9+-R}$rD zZ~ph%^M5~X{r~;rL6x?cmNAF%&5aErZWd{q?Z5Jhn-k^g8uj2ZUOeySk226RU>5V8 z>_-{*Nzl{N!(P4=b)02uw0P4jm7bnXOmlfQBLKZiB<;G#|45gSkxAOH)_(YxosJGQ z!Tr{!=VlAvZJeDqHa3O>6=2RN^(>j&+7a z0(&*M2~joWxE4lg+n;6_JnSyU*xBHfuL>KgwB-DGcg)M(|74ahN?uS?V@9)6@ypo0XLnEoydo_|J=lg(b&8;qBYEjv^WGfWu^`tVT~X zG`ZY#sd>6)#Z=SC2-i6)o>G49@3R|lal-TSZC#zvxeKPHy*-pGfdem+9%*i;f3dnF zi7-~JvnkVux7Z?0R{YD9Q+Rm|_+i-M{CrztWOBc>L0^XC+G_OH4Y|=mOXyiqd8nab zi{r+I7Ux-to}NKNeWR_F)vvs~s`^;6%AOW?^BvZohH~aU=cX zAN6H&8RI6_$B(;UF7plgdU|j8X^k7tA5c*pZ;nBZr@dOsI~qM`FaroS-H?Zwj5|bj zha2O8D@9{PMMcxo({RijP4y~_n8xTq&k@eu!=u+f=h$KN!)RBM<9UBi&x87bb1#R( z!$YW{nXqup88P);?k2a(hL#rmA|ly&_P4&0Qa5%psi|oe?lOP3WOaENEW-)9?E-`l zeq|m3rP2HEc5lcTAyy6FzdxFJ3<}12If34gEO=gPM()-i-TsjDibN&3|8nIZy+vLtc?j5(3nhmnmpAEIywd# z8X73&c?;V^@w3J~!+#c)x5((F0?$c89?rG+ReSf_n`~8GL4VQb<&0sO7#_|RcQ~2$ z+G1sW3<52jjQL5$Kn(-Dq_ng%mLVgFOX6MvEr~+xaPqXr+JH{p8&FK0y4j-0XvIEk zRIT8Y6`~kloA5UIq(JQ4XXaeF9ZDXaC6&yg*G%9&z80ls>)kFHa4sEv=0&sF(p1qCsu#cOG4 zijnkcMD(kto@aY13qjnW?{1rp+ z`3zQ0Nh!jNR`vAhJq3Mk9gkRQb=a5nB=l4jyWBnOE-HdMH$Pw0a+TXqvhnZri$nPE z&g?Ot+&v%6oH*akdn;RA+sm+MvX~eK(UP@e(R<$u3+v6$kHKZ6rmmkIt_Gg&wKO3Y zS65p;>@R|XiwKG~ZSW-WyV}g%n~Y21l+(ago095#F-X4 zw6LIlak6{gg!#dPBle@-f23O-QnfA!{Q3F$HR49^&sz|-V@79Sq2h`?W0gGrp79j+B|A(MJj%8XjtFKV>6#&@P6(t!thDhk}n zKo2oVdP@Z1CL4WbTl|TsdEMQMbQ`^$=I(NExkfgC0=#mN?Q^@uCv;lCIrSYjgEY_z7jIx<%yM-uMh zb+Fq9+YDu>sBb2g@LZ7ASTRHy8PS){R}8fdAFL=7WNCQ6#KyV||K0$FMyFJ7AAc$7 zo^^h_g}k&3s0|LFEpx}$E^UTRaX!)#~ zG;qJw56@;$ZW369N^e64kP)H1iqJm$!&J8wJHB8AISTM?0Wp2z$6vFKIX^d}YTaB{HW4zct0_M5xAyPz#)OG6r*wy3Ei zS2m~XObK`(*Q_h`G&D43YMr@wZOG{a9M>z*^5LY=GhH|oTFv5RP!dX4=^o)eIB zK;5V_%5qe(9u({HnKmz~k&ajV=8-%WLX+n6z>8zZ>0a;)dTQoBZ2Ytcrwkn{g@C;UJjiWBxSe1?`x|t*El9)T^(jFv zE<0314X)RAAiLj;pN&rh_$R8*L#?eZr30lW{;77EYQKN)=;$ObU!TAoKk14DON@sR2dG236Uw~UF>mjaiBNVxQ}g$IL&NqZFz`gPL!K6$@(Adq9m=>n|!ck z(b4^b=53JU-RetN7FbUQ-SS0*J*an$PFv&J#S>9XqWGoGE0T>8x5>AWAo3e+j_VI; zfWe#i6|vN*p4o23Pqt6`@-Y<^Roq0QmzP($F{0k$tP1#no8xv9a}Fn&^&%o7baZs$ z;!}BfHli-`;(m+m-ISev*OO$LAU+D8X8NYi2}~5JDtWoqJBFezccSt*p>x08f#tOkJ%=l@ChBRDE5UV%e z#)Bsfv{rC%Fkkiskt5pU%^jb_^C4Cq!`iQ37h{Yfo?g;0F;OuwsfrK-WjGJr`!I*Q z8OtnPl78^b)6-P)aYPA>N0p(c$E~^DTjqI33r81#@@z z>y(s~+S+5OskC#qbW4p|>{s0JO6j*qnP1{xsD&ZCdRLnv_@z<;`tpK|N#bOE=x}m~ z^;&efHPPvw`NGGb(BI->Vn^#!jfPm~TerfxyXTRaGJ)r#N<`&Fkw@Dbg4aI*I*|^X z1N4%fg@RGV8(FZm`~bJ1^|Do$N?ThUnGAZ)^7(BtW^b1{qrO|H+1U<~M~{7aD{~aP zr0Xr$c!T{gtgUUaERuk0q-WxKJ+G#vr76ZRj*pD2AzqZ{<<&Z#eFZ=vfiotSUOKN; z5;&a~I_5%RVw3rXK0s_DA3dt!sW*NEjsla0^gv};@B9R1SO(R=BI~_;kP8cZes(k9 zba1xRP9J%|^L&3`#}F74*7Bb^a(-_j3Fp0k{_ORojX-(y8{9h%+Cy&~*u1n=BRI}5 zNLh8k+uI@7peUho4SAR-&FVz?{_<}b%YQK=V`EIx?l-1ZIr+=p{7Ot*E(OX8Ri%Hb z&d$#6Fi|4oza0wdsqH}Ks<58(OfB$>w(h)_S&}`Byr@QX(-Z~XW`9?RImih5j8xCv zVXwjOfS635ot@DPz-BHnymLaBV%;(^zs1wvb|aFW+oM(5#mS`xJcbRS+n3$tCYQHv z$VCCXvH6>YwfN2KZa%@~S(bp8!7Ja>XhN)^|KV0>A*d-XGqtE~agW{EmJWxq3x|DJ zE6owq(Qh2%;x_tc>I}xzC?GK08BNDygXeO8`pN%zv&MO3ytnw%ryN$fdziUqW4KL! zsiA27ynSCkb{my%n)C0+_1n&KO^>RIb7_@RxH*b5A&0AygtKr)q>$J2QG=QqgGk9C zbiWlyhVh-orZj7Hn9T93QOD~P=e#FL@xGUOr%8#4+h;EDKdoF^`T7RqGJcD`R?D$U z=3sT#sTAa2*7Zw~k;TmJ*>;dZ(f1!K%!x^gvfWv%hnWdl>31O>ooRzSN+`q$OY_bl>2&&wOFO_w5lV)J^QiTN5;?sm;3Ob0YvK z$vE{~U@^2LVR4miazQ~i|GnIY9G-gt;89Z}Oi+HKsw7?koj;-z1o(kf3NGH=j|v3F zE+Qg=Q!QIWSWrt>S6yA*lpktx;l1OtyRgcJuAI4#MpxSmR8&-~Pe5PvCYOd{W?p%} z=|Unw@3#i(=sz2YA}2L~+fh<5_BB=xf@;^=+SZfqo!EwUoUTKI;tG_)eA7nfl{|)t z@`y|vOp+_tyTX z)ZZKou%(al{35CQV?K<;c&TBvjVk(CuL_69S{bURr-z!FdO2V_mPI-Mw|@T&GrCc| zhSXu=f3oL|uB5+I?OG^vz|2E>B^7*eB z9a<`~H->8*T7Z=6euMNqIMvYKva+>ZTUlWbP!;oE?gA2vl_1ObwZr0gdkoT(SV(ef zX_x6f_HcA~oMUaTr@I@!qwL`{I|0pPte``mg{DC8mF zYB`F?>_ZxEiWd1o+8PJLI94;jo0%AyA|oT)S^|jf-X$R;D|6D$fcmpaU(%PAmF@5E z!;}rZm45vAd2zE!uSEP14>ACB&Y+YsW606ElF8Z52;3ChjaB5vw)i16@2UJkFesZW za|q->chEkro)Ed#)aZ5q*;|lN{IKiq{!v4puNs177A7HaHbU_7|9v_onnD=Z2KH;w z%X=BY^hDkFmG4Mizb|4SOR%^kO^k*ccS%BYl||+omg}C&agnLb`g>hn%v3RU?>;Ng z&nK7}ICNg-;MP@~ifX?%20icr0$^&KQ!~k}wrcBQ0FzvR>fg&(S5D^TCR0DKn|(K2Qg}a}l8o`k5DN+f1-RXZz&jq-*&3v>xJU zZNORnYeWpkT1?t=51kL|YoBhPY;A3+XNg>*X5gT%iwc!=vnZH0A59D{n3S;5Wu)rq z>%V^eIu0cSb>!!0uv=d1f3CPY5BTIXkA$N;1i=t|#=TBm$urq|Lx zQYWX<`a}Giw{PhMKKub#wE?^ChC9_j(_J~ucYO?|2@Le~dlC@?+2Zn6cuGMFoA!bs z;EE>7&+dk6n8+8p!ZhNTsKgk_pw~~@Zj<*ksHhLX*^Rxuz5I`NQE(So9;Y3Li2%hI zT3+{_J|IkWN=7INln++t-|1@>6AQ+8!4g!AQ2&g>I|1K~}=y^EDo~U3No$ z$cKX#^UXB6i)*X?;_c|W%UBlKyX2WP<9Vtx^I=1vxX#z{E;_3(@4V=YV&>}JJ_lgP zlO*TS-@i5XW5Z)(VCj}!CZEv+U-%@XJW$V)`nx4)khJ3GN-zNq2PNr~4)NWiju$=L z9&Zj`&e>3Y`&Pp1!O-^)W@b-TThyR&pN9V;dMm-j*=68=RoZ4DR1m6h$D zx>=5ljEK5S`z|b?ZxU0JG6}p{K!e1qDJ^kya&+3+W@KdCW@6;w;la$d2s?0KWj3g) z*JO7u#b1+c-M^D#aUK=l4^hn!0shGrU%YJX-|e+A?KN9R1PI&Bn>WEzW)=@vKU_nC z$_U0qg(W3T?j7##%SNQvKlvT5Vu5#(l!T1;(c!Wrfd>G|7zfkdL@Hr?-PZmb3F5#ToYtL6`Z())$^zvx$QLD$);C?_FyZC? z*aKO+L-@v{B;YR*@^Bza`k76l0##zZ5jJmPaM0Cdcc{TD1K7^-l5VDQCVF~*0wL>W zFVM2zx~vb6B9-<+w1f1DgYI=FK}qTl!&lf==?J}IttM7_wRqy zVIeX%1HVQ@;CCGLt?e)?W54wU$-*ryE!(y((-IQeWYbMrRi%S)1&T-$FjE8rwAm^@ zN}t*Db1xk0OuDcKgRHs5yLb1>!!7iUsh)8>ecF@nU>p2dTwI*;Uo@)P1xmPjy%D=! zn3qRQLj!l5qKKnubTLAVch6kx{g4+eGkwO(tD~hgk4FxGs|Bt!Q`k}hvo%;n^$fs$ z!W7=;{U|cx5;!ZOkT>e;Yx8DiX5SNXn)fJ$v3tO9c%obVf{Qn;wcQT}lmPBFtaWx6 z?b437>-aA&Iil3E1-!QF_M0xMKo>_q3A_DU6F?|rN~*gasoY#&Ul($k?i(K%NQP*= z+f7;-%2Bv8`#USQy{PKI6>>q!{3Pfmo@6N3VWMVBL%o4Fw*7vQF@+dO$z`LZ;adLH%I4v$Hcx$}OOOQ@e?bM9>zwF+J8fPv{7~yzq6P zr=_iR9?7e#6Kgs$Ik^S~7a+@k(2V`^WwHXFV(1x9)dGf*n6YPYXVlZ;&iv2p*s>cC zEE6!*`RZAT&R=eW`MFpWn60#TbOe#yIo-ow0@;KJID5>WD$ll}X=5|Xz!rZUo~Dvl zSsC#;_cfQYvU2Y^X=b+v58+|{_O_#SuBpkFh6ex6VP1bLig+ErU+jC9W}cpjn51VD zWoQ37J0oEdA0aor|NOyUztL9qr@+ITODQ|+uNfGPg5I{aLPU0pMm~P%$a!}c>N5YM zq$FVR)Xl@=P^Z)oCgrt?aWW*NiiXoP0dUL3f1qF`39A5F>dq|P7fI!mq_Hn?IRHQH zFLn?I%M#5G{cZ)$o~5=p z3rjpWz~k07TQ!(S;A%gg2}7n>ryqX|`#a`!;<*qo}?g|%FAbMq`M zF3zuoGiQC!JF^AA zSv#U4%TtdTM9Sv(ESY&h6yI$va9#KoTI{ey&hn`XX8E)J`f|QnhK$=V-}Th4;^h12 zUlkyo_rAE!b)DZPXJJS(nOc6Nn5SGUHB3QCi9+QU?;R+{GTYx#^*2a9@b=BZb_N8` zh#cf)rG&EOY|Oy1n%dgUuK3wa?PtG#*N8e!0@9U%AWQ*HaSE(cUlfT*hH*PDV9^%U zQxY>Q>{MbR0JGSKVxlhct2>xUzBd>q<;P7D5(c9Ts&DFIcRFL8e0x1b? zTm=IjVId(v5L4UGR@OFZ>0)zjIj=b}1KwWSBqSs%Dyo29)}?8^eqH#RJ>wAC1Or}%#L2x)E*zFjn*@BZ&*oQI~V?`gmrz{T+WzqjQ)5QGbkA`231{Xt$MG z>Pctj>*7?E-^5p59J9BvnlW|y+fdhBX5-uuUaCA!6E@5)IG9r1{ac@g{uL{~b=TB~ zzZI>n=;^1*#5cPMl1EO9%qLJt&v-suhUF&p_nq~6dLH{KH(=>ztLNW=-8GI!R%;5X zXSzDtS}d|&CQc5LbMfOll2|&i5NKA=Cq=m9$Ua=X!FfjJdYgg8cxAPZ0o)0uxe=(! zE@U=28T1L7hISwLsU4kOmmur2J?*f3y77wreT&RDzMj#(kb*MCO%dAX&h(MTmJ}A? z5L>l7Bjx5#Dh!rvc&K>@DED-OPYPI_QlQKrnLfGUG3I2?B2aaH4#$j?S-jP>O_Z zMxlTJfB((nUfbTc4N2zacBo2+@@bt~#t=$s`hcC`w9yBHii;44N-NiCbC)Z6b!(WGm+gRItgYs~9 z#l}W6i(2p2C*005PL~+>;6Qprrwi$7YEIYLYrJ)juYbMshkO>IwZFc;Nlq`b+qZw+ zuF!f;>w9vXQu)<3B(v-v!b{)HaS!I_YMwDs(J_CdLr{^3j$gQXUGl?d&V{IKQ=k&>(CFy7!?8%*vvL!Ga9jY7DMDUb zJDQ;Gkka4#Mm=G;^(49%(Nk3fHpBVSI&IEX+3+k0E3c8# ziKAOLSh;fdb8C}!Cc8ZbvZUHAD(&g%=8u|Rlo=fm8mG7Cn`>ICpJC@>ue#hOq01@C z+a0Nfs;Ql1Gcgb=V_xgG{c#0x{YdWW4LK6#=fRE-82LT7KmM>J3YmmEC>yCP4-O^# zWNm}VG_|2!vt17+HlaG!GbEuhq&nv^9{^jw$-)KD(vy|6&X*<%hjF}G= zwYIR|eFw+OX6POy|K1rCmgd<(ZLQsqlWOv5%ZtegHs_fmifuz1H3sB;e>h)}cVF(F zXdqIyg|M`n?ohk^=+4X6+G7>TZl24?i~V~y;xZC)e-=qN9xX!&Cc5w6KQSV)rb>F0 z!|^<=4<``vTE%lYnD8ny*6_Du`Hw=brY2)WSd6iMyzJqe+;D@_tP8#QkG~h*P8@7H z-RBP-074JE9o+<-(alpz#M!Tn{>h#Ai0&lYE}EpKShPfDNeF#7J;f*yVV%$3o)*-a z7|S#TrXBIfA;Qo&_N`OGtCk?wpKYL0xM9g;u}8zw2Q!s%mO)m8kbi$*;WF2P4Alk*s5Ck|(X_v-ON6H6ckUY#?)( z)i-4~FiHFUh-L!VfaiuAbS70T-3`2jfEln*6gS+kt5hKm!(!8>D?O0jOo3g9_{-rE zr)_=i@pxhAp{QW>)b`SCA7m>0moCBFHipnt%og$2jD%J|LD|rDVtj1*^&aROqRy*w zc(1X4P@)jApuPE6L~U(6$k$h48u)M_=T$fSD7xRF-Z)$_8g{lg)wb|(m*=sxq2HL0 zK)rAB46Tmd!^f178fWJZwU|q%s}mEMW$SphIKiIJ`oPQK)QIXnZu`h4j)xKCE~W-E z)A{+iZ|hnL>vKP8UGg}jfS``cZV2kQR%LLqEo#-ds(p4Q>mwZA=9G^acQA__H(8FC z)pbR<&mKu*c1FUDs$8dHiwU4{e5275DKoIL*2)J}?J+EH&f@;guB|#_z@cV^c3r-&%aQ-AS7J8v~HJZK= z%OG&RbTL7LWMmQ#^2c0lQ)8OS$jW+sFVrI^FYp!#fsxU7^)yK2!uI9OEAPw%h;qEP zgqt9TJ!|SLL?Lw^O9$WLC;`RMd;7NeoZJv$aW%Y6={$LFdx!~O%4_EDUw}P!g*gz) zMaxe0EK&PbmA3SnpO0I4vm_PpH3b!eqkRH6G zWkmcJkIpz_cU9lwp6)&PE5~w8wrNA!ti6_0IoE5(jfclc%cIve7PFr||F~5K8XZ|U z@%=uXg0T^5(IUsU{L=7cfXaJclt1Zb(Us}n^}*()Z5Q5?Qxi^$tA4J?`Rid(=9P&j zn7Q=Kb|-~n#~tmNf4irDQOoD`;#0Mux(i@Pb0^~`6URhV|~uHA}8T+&N#zYRamqvvl%)AudOjAJj#KW z7;5&}q6}5@vF}*2N$$Axrzc9_`US)7gYVG%BOc zZx>Y)0T1#w0ITcQ2rplozZ2O(FJ%#um+YsV6>2igpw4{yB=Zen|G_?v<++mgmp_&_X*1F3hQ7?R6W*4cH|fbWIzP5rRR=;+ovO{Ma1` z_WbjnH!nx+y-9zeHyHmBZ(NL z*?+HZ!P#Ts_sPPw`fPkKf|GMUvb*-otsD(Ty6Pez%2leB+~90Zvn3t7J6niIiSB)^ zXG~=prw(m~2KMf#b6yn=EihCF3pVd6w=JAZ?V29tWZ}^;h3c5tV;ZBd!Y zARHYX)79N=BcQ*rVP~Z!w6XI{7NqO7d_(87u`y((*gdAR!wh+EZyj%MYViVg;T6d9 zjM9>ykAvXL%T{a4Ry5Sqi4RitXnYUTVOq~-TfE~6ZWNB*CQ>qCsmu9mZ|GoW2fcfG zzg8hC~`zJS^q=?pR%qULv<6az|Imp5CAC&N-Q;|D zlCzTZjf}YWvO-JTamr0ijhq3|HPt?EmGI7by?XJ)=Y?F|gHv<>jxjb3MB9vGto0?Ij~)omI=i z2XY>sELprkqctl2==XzQ*~-YTT`YM>!?*asDyPov5)~%nz=^!we(9Oj)m3K6ir$K3 zjkVpt#*=lL`}mbML&D&~3s7(>1{c7Sxp!k9w{hK4>oAD{dX#XHeCo9&vHMy+`i(ng&uEvT*Sz@n8++8y-E$st1U`zU}NnR6dVRb>$J04FinM(QjjB| z@aNAW-L{VquEU8zC6Qmx@P_C=v$FYBsxJ}ygq)PL|L#OMI5$Y1 zRH#E!(VM5-+y$3`uigsUNpG#qC#)Cu|R6EL!*48oR`iMUJVh^emp zKUm&q)Hc&r0_r_zvS6Ey;|>$pE78S!o6L*hmEz}wdG^OGp})5V$0kRCfO`*u{(I3+ zj?EC?v>)TOYR06bst5KE`?m-63E_!}Nrp8$K(=*fGtCn3GD-O8YEsNE)|s!v0QoK*7`w7i3kc|D14JNld1n+?+K2RIrypy z3PNsGrAITsNJ>h^#^8&CN!zba_vKb*fLQpX^{IUS`L%vu;Nb#1F=0unOjT*-)0qfo zBWY7j&DCRUSebJg-G(Chb|&1n6x^9@>~3<+>X}wJFHDxV+j_jUH3SGfBl}g81N@+S8KbXMfhv&?x{a!8XRxq-=$jQ3Vbt+6N_bT@EFLdecg)orI zQo`aJ=;n+Yazd_l+h+u_&+)~sfs+Ib^{u5fM%%pAWKfTreOI59tA|u8Q>Jh@QVzj=$JXBYVvh(D^VOWj#tRtXzACuLAn2&k+r zTv`}?xPW>FScG8YbQ6bY)t)ekeX?j&{7xJWo#CiUEr=Z~b)dsL*-x=mTnVP zbf$4q|Mkqd7PgE(#CPw8wiPs6Ue={PF>a<`rLKXH)9z#D9sDNLZ?st44D$8Zeh4=e zh%L*;R}5*D8OzAGp!Cz|W`EeRa_-L5=s)#f)7LXFG?>bk^-6`BgD5_Jwsx2JU`$x3 z)M+Q90q$8avjFRVc2lC@O8_@Q#3T#6_g3XgWNfsbC&otQz1Y+=030nj7e2eQ4GQvF zz0-Lyxk;tbSD}^D?;iXtwyb1I=MsClQGmh1m5t z-CR>C$eZle=BCCBL%lfLl6|eUK=rp#cP{$SiQm|`el&zB2*&F0WlQ(<_6MGgcSxipBe!HU{A9%Cdtl)KJqtn+o?{0XFdGLid=Vj+%-pUg=A>)qXkhskC1T_ zk#-g|$H>_gcB?bH-?kd%=LcGVVQ4%}Of1WEzozC> z2cbYMY;tyKbCgP-rdG>*oqx=>Kt@uM5_L;K1;4CpEKZ!W@v#R5upC8tfeS2*{gez$ ze>1c>xsOIZ3o1U$poZUZo9JL3BEw8SyJ5NKyTKRm_D-6ZmVM}K4V&;t7&;ALMoG_sP?e&pm# zG-LmGaFTa)zTVp0*jitwqsz#a!g)kxRjl&Nv_N-EkyFRuSZ$qZhabkW83#FLZGV4s z!BL+5REWvIi=QrCh~k^*6kt+yJMZ9f6WP~;8X4G!e%9!Mqy@ji5mQnwQcwmRK?7aa z41i^rHP{yv71#qhnGK zE1;%W&l6;WU3Gx_8gA(yGLQr#58q^;UFJ-z*x7#L|ysS_zl zw7{?yYnwcKygMehScmf}YD7&yX?CACareQhRwe)cxsj3xPDChwnq#Q>^T) zmv%AnxrqH?1865$Z&;=K zOIiyT03dPO&x{HPfD{4j1%OYWo~!h@!y8CjpvuerWC|@qnp53H_M27@cpYw13P!qV zt>v*n;XWl3xe&x`reoE`DnOp6x=W}m^S^zS;3;tAQKvkvmu9DE`Dcs>P_TCi8m2_5hg@;ZrKO=u0dRz+3)>ld4-XtL2ZBnzjcr#L-0OZfJkeA&zO zd7whuOIaXT#!IYKYNHE_idI)v@AOG9KiDh7enf-j{&_71I63=qfuI1`jK$MiQ+O*| z4BOdUoqKi$bC>-eL969gRU`(})3siVKzFnD0v|Tz2j@;IAs0x>NGQ#B=|-?|?K?Pn zhDJJ6bCNp?+b=Tj?bhry@@<3lW)2J&8}|@-Ui0NimgqyaCx5EFZW~@SfMc07`}P=W zX+;{UKTWf=r=?BT*8{3@(y=zx#tew3+00Bp##%VpTcC#r4go69Gnh0b(ry*XukCKq z8(7_ZSn~n(cOLVoyu+Z6>GtWy1V62~vqVDoG~A)ub-K6jjcf&ECUgV(q`2VRL`oaI zb*y%545+b8kS|Y=@GT!R#_IKnuTRmIS_uj8GD5DFz}b%$f3($P`TROtlPLhtMhQ-| z>>KNwv5c}=eF1)cemVb;b?)fpsNt)R=P3|(V{Iwk>FIUNE3`5&IojKpJKC4!>&h!D z=iAOdvfreC1iQxONT;nkK?^vK`!GB|mnKK4JX_XocGMCeFUi_6YMEmJS`sQMZ6eP6 zs41gJC9vS5`&jtV@Avt) zc&}N`n4Zb*prF1v9R0@*wC5K}LbtUP{0#z(emBcYvr=lgCm(n14Tj*FbetsZKG+A| z#hr!42PQ%<&=m5<@|L5gY3j^#I^!DDh^#%nM+`ddoYd?y77nzdDtLT!zfEkGz}i%s zWbjp&Zke1-div&bQt49`xaEhg{EuA~$R;(W6R)kLCWvnxS!gf}(xqk3 z->$5!VG(d&Y@FZ&W&U{WYk$fBv%`GhOvO+F`OZ}K5zixOp3jJ@@@7KKr#p@C4-VFr z*d4=be;;0(L*O5r&h_Wiu<@94Q#-7$cc-TtG}e})q232?=a2l9Z<8`Ww-!7d)Lot_3uNlD03 z!aG`=D6{?yeQLz=G|%Yxk$}|iKu#7)Ef0L7WRUMgks&hJWDW&7?J4JM7Jr~j!e1N~ zQ}bB#cw^}TxIb4hMgf1Y&jReN9Q|&-l)24~kDim`TKz_dlAxBX>^&ZR*RU@OnVd;2W|zM^AHcVkz945^U*GTVb(L3__jz%uM6uJ85ah zOY~?&j%gsf(?0s;MyeOto z+vl?tNTZ{(LtT(KPvtGu^xC$)gc3D^dAL%T`TN(}HI^ya(HS*$zN;VpH0mz%y8@hZ z(tZ^=&U7o9max6weA}liX|G0ZcfL7^QPiM!((})^=ZkP8gO-5p&{KCEKeSg@=< z@x9~^_V%Q-A_G;m{n=Tv`L1h9s!B3`zQ`|bBVjSw0q5&7c<*vhG(&I!`^JBLUw)EJ zK7nl+Y8p{cQsFW4Tc@910u>F0AHb6XKAQi<_~>k;b4z#NtD~i0H85)qE>@2AR*p7~ z_IW>lHn@#F-d8Wp%X7AJRG9P6_kv*f9?31&7zlfL9fT)4NdP`Uu-Vo;?cJWw{HfpoTNY6LNd{EK z2NPv^_9AFxkPy$cOqzaFcwDMkKe;mefi)6{e?nbe(?po(!KtQh|NJS~Nv@J!`8^_I&4B=uzT0)L8+t5n z1sm#%@^t_C1OO-HGXL{imK+1q2*|T3?_MtSZZJkE0_TH%N(0Qzv_!+zTz&l)JykaqY^Jr)i-Y?CiN5&e=|qp5WUH)lQcJ=#z;2*xi6L#!<+h zy*%e^z%7Ad%S?-F*({%Gq7oP$@kLBeO;CNfbH-yV9q7JS4xDCkZLK`&eEGd_vQDkM zg4)7~_=OKKAwV7{a~moZ=x9oKWN9;C>b-)CSonU${S3q~@MEmzSAm?`S1)6;_rvK(1V5foa2iNLVupJ(&hQ~W$PmXc6E#QvE?84ON5JkDj8 z&#A&aUkL#)sbHU}!jMOn_Bi3WTMYN7-hqM7QQ1m2&GjU(BrvTCf`iXXYqChsYGxKw2Bx4U+dGRpsGI$^*g-g?A5&{-e;2m!D zJsVK>uA=c?Djx(h1XLp;1kcqcB*z%&>7{|Z5jHu{1;8c6JBLlye)K_M(($%Rz%1AT zXaK0fZcuGK`TU)y%3cb@E$w2!?X+Dee@2P1vh!F3n_Q?_8rK^mg~MsSS|$YP{&bRfpA~YM&B{cUX!uR$Kt=QKKcsV4cr0}Nd<31x|X0`GcpWaB< zm5@6{gUfnH$mt7ieK#Vy4vHF*)5-awI$G^vb74sv#X`~4VS zSX;Jmyg^v{ck{whKI`j*e8{5DYVz*a%8}eu8!oHyceBJXj7vll^%Q&Fo`zW)wF8C< zcCdB-DE|;z*^7L{7F3}NLr+6u(8G~uophuUdea2HdxQs5v-)8?=&2`X;r7Q(g|{VF zFdh!Z?eB+OHLu<;Or_%*?ALC;9i+9*7$*OE+@T0PsdBC&|6(J1Kkw5u!}9W8!4I}d zq<&`2wdC>BULmvdms$`-MAd8LAUfvW6GM(Xjd3^6rDw)=>DTwy+140ToR6t6Ol0Mq zZD?h$R)@ONSwhq<5o5nHK=jLf8u%udgm?n|8zRa@j3iN&DbbO}eY=V$+LJP|>~Stt z(>q>Ub6Tx(*Rd4l)f+ztj;(#l5C%9Pyj+f(n~c*kY5oTS#M;$$vhYn5$P zJ*IiTZw>!dhM^N}(k6wN%PxWVw7=>ktE!VOOf{DD`Tgn!j+>v%ivvwJ17;Cy9>d&T zE`_SQnw^@De8I#!(-V`mPQ4MBwydtMMv{<-FMe)%9+DnP8hUhB3=FsM62`?=Uu*WP zewPu2s8XF?as^RTmyzfZ?0S5+Hg+Sq=nhSvHJb07t6lm~Io`xj z>j?TEP0~rn^k#VW-Ha852)6m2*JNtt1Q^GOEX|)}i$kxc@{wA7I66uw^u?e3DKX2X zu_vn8d!xV&-BakbO-!-CuX-0ek0Ue8jSuz@Yh9;?zm z!L-Mb-Lqll`RbNi(8yHN)Uvsfy6bl?0hiJpV(x?9p@E^x<8PfzNpdu1P4{s^d%A;0 z&U`#Y+fx&@P85Vf_x<$rn0!}?!CN*|ETpfPd*eDWK`CcI6&QTcks+E6Z%xjxt<10a z>8@v$gD8lH7EO1TNly=A>%9s3z2fJ#O#t!zzUo6q_2#tD`FXPay*mnKPqXhquk4dN z^~=srxNQx-`IqoZ<*EJes`$AwF!)*+IY*YNUAcoObPihezb5~DSM`F09DT7#rm41N zZg$l;)XA34WQtq8m+krj#llQ5HCEDHv5!+KznkYdI`t@=1eyJ^3$Uz<) z-^4T~Ho)lYC~BL{=Q!WqvAYX`@qdd5#vhkpoq%B7d0L`7DS<-HgiTC^^a;MoM zSCZ$vY#)CVt=q4NmGe$0d1ju8ZpGq{e3pB{-sSj@^Q}g!8rwC$a5D5vHrA+H{N8N| zyfr1XtzA(nGvD)Q4ZGaw%Gfx}_OreWkU3w!cp`VUzsiefpGX-y-o@N}_?J zX2sTQ)$*^;2qFmgO?k#F(PEV-0Ake3vobfCv*52I^4KamILH83B&{EO+t8gD+3{p5-|v)wCm?)RR0dmoe&OV-u$2A%#PM2e3={|Cn3ik}f4zdG3%njoUA)+s^^^P{0DD|!QRN4M% z1kTQ_&PndxANYECmuVj?gD9#@x;#itQG$9uA+sOtGML|hCryEeoa^#~-u$)t#3_lM zK}DKUT4tePopO7v=k7d7K?DOI_e*ZJ^C1e&zPbX4#k<`_w%uO}$5Y^CjYKbqJ#P)pE@iAHR*Bp=@!8zQ|ip*62Iiq6h6l2^wLoF=n9O z_#q{uvQB)KI(bfXesqAiJOAE5rgmFUWuUW`ou%@X_GtEnlt<->6YA^n9~DH-JJqfg zY@BH+MZb&s-hFEote0c9VEvkAcr$^z>L5cXH;)61g77-Fq?O3j;!M@JFx3Sn&r!_i zRMZY1XZi93w6D5cW?RQK^cV8<`4b*0Ur;v+GnLMavI}o?dh22HlPtZ|`}6Xh^|Am3 z6+a#HkJlp3-t4);Dt>D1KAE%X50|`rlSOay4~VgvQ2&9d@%G!iiYkx5nv~k_`<%?D zmlXupJTwhUE672tRx{nz>UG>DFB8u4w3R7|3+2z zC)52F^=2C)FS?2Xot=S|HLQSQKEGx&=0K=0ld%hv< zo~43ATGwTl9QH@WO^%Q!J?=}5*g5Qi61-Ern84ck2v#NEinJsq%O5!Uom_+EgIl{Q ztiv=UeKy--sgmyHK#mD)SIf>&dMrs5W-1Xz+)xwM?8CaXc86KG*s8^0V_c)a!Wk91 zX}LZ(S}>W&l_vde(us`Jm6a{E8N(F23m!6D5jsc?IOcP~RV}}!QXxC;E%p|l1)x1R3F8*PuD*`o+Wez|)-v)o=v3;pK!K^b8}R_xQm_vM+~#9R&vEL=`98$+#F&Cv<(gdM<&Y*dTTvLex-W zf7)~2)U`0fqrJB92HZwGT4xc-J63IU+V3CqsgEoAXT9bfg=Uh?bOKnz6>c0H^#n z8jZ#2mK`&b!P^gC2fRS`*pceR`=Hzy-2{2CZ7!>?!UlEg<**)3`Zpm*wH;Por`uB= zG|eMFGgd;hM7zz`4hZ=nz^cF%NkUu+eeYJRAq?>Nl=UA9EdsW4 zbizjeWMT2lXfu}&_8LCtbc~9M{1W*&r(Wx!l}X7O%m;+xV6oY9bM{lmI}m|R+D}g} zVGZUy{H|UI&L3ku8+JLfo~W%Y(XF72?DK;C%-qI#cw^M4CVewTe|)G1Je1J#K_E7< z)Z(eEr6lYc{%|%VW_yvn-38eCY+H|7(t|!_mX`=2&0^cx)a0b>{XLT) zbINwr!x?HUlXvU_BG{e{4Urr2IgNj{EhnFLTDopHzYe|an3{{7g;&d%FzmD+puPPB z6)T!ezU@9dtEGl*un-Da;i*7nnQf+&TP;3>`w!&ZKZ!l^Bs=Z#v2E`0&qiY(*!3zTQD=J-ruJfu!K;citY?H#p_ z1}V9EYS@pPOn!p?(IixvkNl(>Ymqp9%tymRFwGgnwW@Qmgh`*km$6CKKVc24FlrSo zvKX{(5)#upjR^XHuVXUb_?^_!A!4|agorvtPz&kpp7>+G-jF#8PgzK5nc5qLqf9ja zIcyc_W&*}mfv8#4D%NFpsW-gQ-YShW1moDc8o9Z>Px`OlGgOlQsA%_&%r{u3vEl-u zjE7lPUjI=>Qmj2E&TnREVk)z5JK}y8%q3;|(EcjMSk|MnuvzPZcdP*@xKO?qHHO?* zQ&6FRelMW9sC#^m^6FKI8W?ki_GPVt82w`l*k04CarQ%@q)P;f%I1Ch4O;mgNb z8sqQqNN5mbx?#@R_I7wasQtXW2{rIEkAcndSf4h_#Vq#M8wms#i z{$vKh4ABr}r};ef)#w+>U#a{&N4E#$x)*76THKo-zaf?6)woM#EI>)DrKUH+n_?qJ z+-B$p0;m-Jn+~+9y9;!NlyU`7-x7)>zVZoA!#tq%Uozy4f6_0({6*&&%?NkX>Aq-ats=u)uC?`W z#3-sywwUf>PFwjA^-Cv;l-|WFbuO*|rFxyuz+JTbihxM#FoC}*@zUnffu5_HFG$pH z=Y-w_hnF{A9%#+2Nl(h@X`Vgv)eL(bW=z787X%|@aKg`qypnV+@>b$h%7t_V#$)z4 z7|x#Z$GrHUtWy$1REAff@OUshISA7K%;OpMwY|A1kw-6*N_#jsK>^xR0-~Sjaw0rbLFhp&GKr#lQH`lJvYe4 z6raXOefOo2t8;@(>i5^h>7?8HBT81Y*#=v?{wTH=m~d~; z9FkY>jQeK-85K+Fv5p8~J}1d|HgB%(V9&-=IAMGsHyhwKqW7pOpyC-tn-AV~(MMK> zB!{WPy(%XF=YLea7EogS?w@c+H)v21+kJl_C z4*luK_VhzD=oO-~Y-&IqNYAOnJ?kU)X<_oU`xz}A@88gC$SCPSbt{{9jJw7Jx0V{) zT|&DgL!4N7oEoc76VshY@85Fjqdd0o1-DLeV}a(3N!5VItWKU-gGqar8MP$w05&fA zD<@FhVI`4SuOKWFVV@~`T0pJnMOzY3=4C*#c!rH-gzNWs86{u{+EPJC$5lKfH@mLG z>x1JfJMgYy9hcG`TT(=1WLa1Vk(HaQH^lnb69JNCO;7kiIba(t94LOpT=s7$lNzaE z&bEx8BLTY@foh~?(6?1b4hP8!dptsfxkXX-SQB)^$vvxULgB%5a;&HhwkBqosb%yo zxRV}@s31B`DTxoOJc8@xd?-!|km=C0iRN9}R!avjBFd}@I0w?#uy_IUR9hatN6vLp zEO5mopaFKhXhqixU*l3k<%2ShhHvX@@RgckYea_lQ^~cn@}t`U#x$wXJ`}jDP9HF; zFy!u#X9(&(B{LaPgbCi0W&Q90dhOZLMrv;ya{F@OeQ>XL=Hw&dgf(2-CH4urXws!^%?dDP zj%uy?BEM~MP(42?_Yxq+$K@i4^5WtxYq4F9WHBql8{uX_=zlFs8W|viRTtSP9{<%; z8swL!eu2Q}ko7lh>ki1d%p~lSGXaNoa0r4VM~I3*aVD zB?480L|f^!+YYUp#^LC~6f>bdkh^ZL`M_}ee{hcd`nuhg(}J`#EzFZz- zvhJ>>ja-me6ix^|c(+yu+Dc&f{DP;+ORd95yU`(;3^)Z- zmwapX7%@=MS7qUZzg(`o3t`m}P|w;PKN)D`?{t)6bK?Y0bRza*n4*>I1mrcd0&dBK z18bpo^XPDs_?>i0NK438@RUed?7#x_`Ku8iKy_WqMUiubA3@2A>>Q*qslyJ!CgT)2 z{d(AHp7kC+qcJQr_<<-9a)FzND1`#2Ej&O6M_0c+zeq6^eFXBXVv;Fy<4MWs4+J6p(wwCskn1n#PtaDQ2)^J8mEnyDv#8RONRXMc1~? zHh!!GPp@r6@hJ%X@v|?uFGk(!Mk?RpshSn1Ux;(exZ;)QTtdVwsv$ZN%Eg;{wbo$S zf>?Gc&(gB?$J~6F706}nS%WNnb{WV$mGTTpN-}whQG)L)BRV&WhzFKUcIv*j1>527 zyig&RG0LbFigLp2z%WepNOE6>W<3`+9K#yAgL`q$N6;3xM_8S7z2}`_hw9!xRE=(# zdg95&=ve~zb1V`HCL5C5?8bRo$1!{%iR~BajV(W>~+7O!H!5N*7db1RSgHU~FRrn9iXCu$S} zcz~4M5X0XE)KQT5wA8KhD*|o8{#8NR_4s{0Ms{2cqHCYwr!!Vk3MEA92PSJ+&0`XA zby2Wr8a-+q(i0JM8b^PGX!Jp$LwEv42{N$~KcD=Hy8PbG=z#$Si-c@3pX}j9I!!AH z=8Asyw_04NPrUo6Qpnfne4Y$I&LalAK2x}xD1)+G}vRKI0|3cXTVoJ_qZSS#v;aT&or27=kXU-!h) zi_32W_9sNz6z?&{k_a(A3NDg0fdJ(v2IA{5!e~SI4$?5!tDxY=YK%pPP6$T0xL2#6 zs}XShgg0k46>ykSn|+D`?=7`Xl$WhA!LNH+xzSQYjeAC3ITp4Eh#ohaN(@)l$Z*6O zl)PXzA?6V-5IOD#LPV|(36$WRT$*z#I|sV&vq3Ead~9xT(C$Z`kw1AQgsiLdYJ`}v zN`udDwtyZzggz|{ZWFH18m@g$*ou;wHYYUu+XOdbvpl^Z8mz!n`I3P`iY0J%ksT{HLSmvvRSVB{(%rvito%Z=AHuBwpCm2(LYr&Uzbvz>z{;Z>iNp zN3Wu-sDo&4s3(W;u#{SL%#YFjDa)MTPEAR>oTI@LUObrs9)&?%s2Z2<8E^pB*4R-= z&nto9!o?50*u5pt@)SBD2*TOgl{H)8iau%~86?QK7G{N4-d|@<$pm zaiE+Tn5Yqp4O!%*tw&iTkbBcteU^`18kNx1^_mdYmvKCk-sxnE;c7JJz>`vZ5;a@S zdOU&2+wl&!i24e`U(LiM7|#EODUqPF$Qb7hUGJtb2PSV-D33dJhrgKfE+buqllt=% zl2d5D|I;JFkzyht&Xk7h!YO@faEG0RTl3EfnpXL!B&)!?SLB`;fyN`yji#Mngc*GaC3DVpLP{u!X>( z_nRldonka$kU+bAurA@@Gw{+KCV8mY7tyNg!&$c)x8Kmg8L4&jUAIRl;wlBL1AhdL zI*b){lITQ11!Sooh@70*RkW&`h%3@U`+(hOLths<%-epTX=62$YVo$ z+2z!UV5mb@K!gZk2x_Ou12DmW+hTuf-LohvDfT)3X=Q1fS%D?V*khFzIG}tx+4(-Jq3U+z~?mUaQqk#xmUGNc3 z*zV5`0v*{Y(L<2=-)@4Cozj{A5E1hV6NXr$em?~_HS!3F^%2}#qS=K<;06O}u4~-@3@Qzj8VFcu z_Q9ZI(`BvScK{&2Vv>sz^f5d_Nkw#p;h7r-Xe7W=1R&r7{;^3(J6aXlP=6=;QQ9|~ zkCVlvfw=!|$B&6-=ekyW4K7gl0FJw8anU(v3EKZ>{|RwfX$6LZOs!Xm61F>l#sbRA zI~$b8JA;A%f41C^M^{U!-I)G!Iy*PR%D}z8E=P4WF{fLS*~}VH^TAVDgVdtwpIiWzlP*|3mTU?AsN`z1FTmoC%(t%mgiu_`uZ(0u$ zJ|sRHKh1(DK#?v-P4%4nw%hV)%xU$+h5c=l%fW_HUB}7G3n9c-7J9(cZl37k2lEFG zP9-iqp?lc@5DSkJseNUEfCw+I7lKF{FA$|3lE3n72$oVH0mSQMy%L^(X^x(O;ZtOI zb=hjKuCcW_5YG7;6C-&~d`|=24Ag&#xmWwmxw6z&Oka8nxT~NE;gtP_<1)aaFT0?y zN#)Hb)#>JXiu^3c*IG$vzdI5q z^V=JPMS{(Sz2l^~xwfmNRm1GQF<&c@iq7G?m&=S0ZpUQpIkFJ#txkWH(ch8&4m_3@ z?8j3-Bi&zKFMMh954;7SFi3IdnZGLq{~B56n^_f_8TGtlB~v{AUF&4oa)a5RV`M(N zcaP!!UTG?;&k%;VrycW@n4;jV+hf`}tmN*Y;WZ{B26_w0(96LsdF&58>uB4Y@)2k! z+K_FK%4fkx2QC{`bIj&WkC2@qUFAr%t9!{ll_4|P(9l4l0}PC^5~fl7mlw>tk*#i@ zE^PM7yGTL@udaV^UoEKKPu{{vQt-}zo2-LhyT7A=%Hpo;nr9xzHN1f(clGDxvF8lW z3|3DKjlW&%@@~>I|CepBqfZbo&QyE;RqjGXBXb53Y>An9?=5@+=oJgGN{Lld^8pH5 zor16bol;HcQ|=ZbUF#Ix*V_H$?#%l>^m&~u(LdCb_ng)S7P9TG`cQ5M)Lk%8U#omv zLJ?}xHT9_3;}aPi`EX(L>+>`Dr2UsN5v$||w8%Mofl?5!&@1|-zgk(oPB4TR0igUjDF}X#>Pjn zw6^&XdS8(E$Cu9J$)}5qd$zS2a8gonw1c#EdWR6cAn}r*(AjhUWm#0Toi7HKbN;c1 zJIAe;(hgW@SKOEFvrGFAQ$PkJFaXX?nfzYu%!VtiMS6JgYH*f5eAo`T^ta1QAP$#1 z=OZ~9yyXz^yfB{E$zXVy&3Gzl8^w3g_kF>D9XX@$3DLw{F!Dvs#U`C_M!a98o-=GR zh^&8I^zDnhzAa-|>E;NMswRPX9%OUVq9?@S!xOXakl2cxP8KEV#FS9&xeNeL6E}Jo z9GG9sot1fi;j&%O_h^8$8g-6m4qx64u14_@Jm);XhHavDEQ4w`pZj(I-J99g=2fwLO|d8 zo)<`ZZ`guFJOJt`*J*Iq%n8gaP+y@7RwjP>+ONY)mO9kE$V1?LBd4svD=RSwx%o(Z zwqU^Y{BABCES$o?ROvWm)N}wW3cz8rXAo|q;-xgfVv&kZ0?p|b<+2z)SC&DVB8?wu z+X12}yU1=mY9;LU-s5zV3S;9v=EQGC9M`o*;w0IkQUs=Sgudci^(oo5zL@o`$W(8NCd{>s~m z8n0`l#;m`GU@waQr9a+g{=46`Qr8<;_8N+6qobM?W*L{KvV$~5g)#t8h;p$;ld0uXxxsjiSy%FN zlpy3=cj;~eim-QpbX!>e7T{^M!yb08566_3mIQ38OzrP4Drk0JB&J9@`el68zxL{W zW6SttDuj<*{_xs=c}Xy1K7490z%Wy%*_p)eP}uIuyi zg9+$@m))wFv~pl$439gaD-)0iQc>3&8#(5^XWy{Fg&`$yy0*476I7mIA<6dD4qtvv zEflmf)Z$(LgbXMcyByp@5%Ed57mhdZbFI(f41{j4H&Gi7?~4+z=)KZyb6_y0% zP2A_0TDS5pR&;) z|5K9Z`C-k^w1nQ>h|;)X9B<(3G9!`eC0&miLg8qu(C9BBPX3DogNoGGTCV_7mSK`B zs;p0dV40#_H**nit1Y3Kd9#z@ofd2CMhtGrkMN=-1?_hw^CNBz2#~0$8B!`V1K&JwSuIbX|yegk8rfA zBA6Twzv(eE7&*8-fTOPRn_*=mehEP@j`wmo23m zF)V5PN50H<3P9!{Jd-d!oVcDD+G3K&#Y!dkuN$5MkxfFMxjc)obfT z_v}zZG^c7P1oA03rEh=cR**Vp0D+iUHayan->`)>SX@=2-I$FX@^5!*9M>xfS^c<+ zmw^{UwFd|byhHX=3Y7k~H7D1fGrr6l)V`jY%&a=T@5MJpZ6E4uoGBzb(7eh1j!w+w zf8P_ZbnXUXqAaWr%3f@if9%F`oZD-!Y9G@|U6C>M4}qy0PehcKN?1~wuS<;TFGsn> zZV?&Nl+^o;{*`)7=~tHF4abV$X9!07lTq1uY8Ho|c!T}VKXKSj?v3xSnPJ$D{-@-L zv8w-b@-BY4HBnSUB!?^cEdn=>#uUE#$iG-x?p1jv>Z<1q~w}`*(FdM@E z?k2!PGv7)C$SEDh36+tJdRJ^P+?fcubL`7K8({ykP=Wp1oaNJXBesMtQoa;qzrJ<^ zz%^iV@F)LPm)0*CiY9tAcTW+f05S)MiixLJn~6n?VIS(ucSrjgrwA7-@E0GmcLs}M zmTxePmfIe1*nP9w*=OUHkdxBkU2n0F)XHiP*{afVBmSCss*cZ635b8cTYiR+!Old5 z3aKx2Nkp(|nVP=VZl9aid~DzvuqIL;{cXaUOc};Ck=d-$HO&q{cuZXfgs&OCVqgKy z7}`FXBPh4g&78~7A$IQTEm0n5rl88Nr-<5p&2SrCInGDLvStzdF?5Iu{?n(DwqZOaSO3&BH{cUdurVd=lf06AG zM@rIHyzU8H+1fq6z+3II0%?(LcP9sd8Fm@wiqUrYf%)^U#0Kb@rOI(?kA`5^17C

*|2wPky155xg^lIitxJpDUB?DXYn5Ma90 z54N%aPVKWxb1pzvG=&r~6x&!6>WUli#2>BYe$^a&SJgcHgx<(#pZ>l#EU{d%FA zU$(@9a~kn+eM5uh8)i++mm77eK-wB)82)DxOMU}7-&N+9F8c6BuW74W!&!|l&}ko> z;J&JDwlT*a%~`O-mo3dK(tT&!jeg#KeBfo{agodt%kx|KNunTaq~QgaG@fCtX~wm{ z`xC;U3|7|rYX4`R|GuMpDqrlfkA6pawcUu)?yrJlL(PwyEMk%{xeWcs z?ClI6Z>$4v6KT(&9AYuzbTb((_B_@=kkxj)Y^oQ+WKJ_HcT?ju8w%MD=X6J3!MO2Fh&p9;t>{bkC)ru8bQ;}53ZMm#o68cU%&HGjizpDv={wXkl*dMx`-iZ3nEV?ID8ln|e){HrA}6>9ksS5zn2at%BN94oE-Ryc{St%F zy=Ruko9^zFgOVTbs-6^XGQ&m551JYJ51ygizES9Fj_+iFZf27d&p_J`M*ngFpocD znsa-4wQ*DTgJ9Tiv7PjxDbupXFlC^Hx5ww|4fLMgDg}th=MF7gE9w8`?^x&Q zgee21G>tvp7LW78pOYsDBI1%heZvE!yk6{+Ykvtk%n;X1WfPOvczBb5hSN;r_)R%J z@xjJsc@_UQihsunDBC8*;D(4%3d1O>B`6=fM1ka z)OG}O8ya}*4XG2T&k=UAh9(-$>@hdf{w@xwJKJ`QXsg6mZuZI}Mo#wR*j z+YJvkp&cw}R07AqO(OnF4(MWCzn=7AOx3!?mCJ7a;Vjksldt>VWxH8GNMmyy#uS=h z{Q>IaKte7$CGBl59t{KyP7lD5kL>S?m>*KTz1$X>SPf{o|1afX|Ceu~`*3gn!xD+V zykxKgFwJ%baTf8>14{U3$5z@^8=P#300;t<^S!I755oZu7Vv*?7sqZg-Q_2uU<b83Xm)OxD%BZ)uH#DrD>@mucpiWCLN5$a-R#x4$)S&dWckR+)EV1`A z`~oe{+qgjS^9l{&H7*K6K&U;r03-ifv`#u-6#vCTlz0NCBLzwhIyjV@b2ZvmUYKAEi^siY>V%Ti+3k zSxADd*cnVkin$NJXH7xS&r3W4otGO{3B2{2?AWSE5e8%!1HC_)mnfT2L-zPT+v(vN z)mbOVyEogJXs?u2xQ?Xb?K0tu&;jKy&IjJ7AIp?tSyybvFu6OM5GHr*5k!8 z8AR&BO{hgYI~bG#7!>^QJmPnI2i%`apGzkAzRpWP^*Mv2aO>~43Jnl^P>$AYYhlEr z+4D)5dCQqhCHDn$Egp-lTn;f;_c(6rMqyZw1_kw{Mv3qvQ+*v`1GCP%ObCD@dh?ga zq^;)OP)j{=mtYDv?g>E^68C%7W#5)GR=Iyydlxmdgl3NXc3VM2Af zYJp>wH+tcrJ@Rb2xy{k>B;#A!_Qj;figS|gjWkF8==4h;UAXDa79{Gj z=sg2X@G+>N7@b8qF$*&>$BO15iXYUkT$AmdxTkO!(p&3g!M=|(U8&y{hH5Zr;dwY) zT@EU_Wk&YfYj4|gtm)I^Uh)YEeNd*8Vk&fCu)21s1N$)QONPY%9>}W=|HfXFeh?b^ zd0%C>j$&bfhQ-40+9fr6E|soKUfR)pbXzO$P#V`rjZOMumyX{%v;CMs>B`Rf^cO0; z=~3b+bh2-hG8R)`!fJYxxmz*1+8`Y&kt24N+w}ukrBuJ_qp!LlTi#?s&@6PD3I;BO z%b+q)3^{W7s8PkY`Swm&E)30JZ5F-^b7$>ES?qZ2s6M_$lT52te}((NLJ>>y7xNN+ zs}?zW4dttTw^k>09WZqwKBGfrD& z9Pccwi7pqhXiqTH`weHS3*|=$Btj~91>+6+9>{pz)ZLL=D>eK#Z;lQ`*H6uc*pWy^lb)E-?xQ_5ay_m{+yy7oh4o3|`4Ve0ktJyObz5yy1O`fx?4t&54K3ugc(F(My1b~}sn z!bwoB&hH|UXbdS$0sZ}?UH)tL3G`88DbwvajjHRTx=y@ORBHl^9lV2Z$nG7E|24sP zZIr0YPOKQay5xwKVD>V7yrL6z)fz}^=gEe0U#b&>UJWk#zj!ywU6l-rh+wtrBL~F7 zl4;b~_ie^ecnzFZwh;D^`2EP(>o|>LrnqL-SfLQLbHW2@M!Dmbmkauu<+d7*dpSlk z{pwA5T62sJ9@&thY5{h&U69m&R}DE#@VCb5b9-m)^nz0JAyA%~r2124h{qrE^`Kv6 zmzk#g>a>_%r>Mr-WH|$~qUT)s2XeZ|NVqXCH|r+<5y<=aiSmf-TIodO8y5IY8LU6N(Eze$5`M*5K!GmEW=G7c6t?1{`+1ON3ELZk0(1lYY z79FBG>1R|mYDpirFC|L3*)ylNZHzR$cPZH$ODU9-M2t4IS31UPjAc~IL}iIui>C+7 zC8?~XYBggz*w29)L4TYz-!aH~0L|5>M+mN#PW>^)-lmh-{zHkb$~2i9A+<}+kovf4 zlF9O=)`lv(s~cOgeCnD3Z ziaaXhJZfir(U`eY^riYZ22b+NjcM*|rtI4`l>87%u6-qj#qiS^eGtc*Sti%wNl%IL z5j}U8DMP6@yq8@sg+8bg;ff0q$bV5X!;8fvPzh-hRcdYekl<=saZN3gxj-}iWwnYC zugp5>l4T6n4ZfiH?vqAX>5?GlT2qOh_ps)QXunAgSdI}rOL-HbyiR%I(fC=)z9<== z<&cf|>x!nN*?U;lG+Dlt6Qft()ZW|DW|;Mxd`gGp>xPSg_4HV! z#z#Dzdq7>mQw|q+I22Lph5dq>>Y+nnFNq6?QVy7jbGDljNz@t0CYTXR^f~CC+cGx0 zEUEt6;Zl^NhXD#3qGN^BSswN@7?B95V&80%zLU_R0`Mlf=illD!r@gPHW7q_GyC7m zasLMm|L^D&x#A0|T`Xz(0!7RZ;gPVq3DE7*yo!7H51hj?yTHTWe-H8gvK#)r6ym?i zs;GPX-~?k!No&u{71mY79(RB5p}u_<*Y|#=R#nwq5eSM-Z}yJ&oLl4-YS{jPoAcd=L`)||)OQ7|) zH_{LWWNFXR^l4ymvL}nx_bk+nb9meB5grYnWs_j=NAEQ>QXe zCil0wf}$c;X4hOiAMKwv&8pFT zpzcesYTaURsqMB$?f##c*`2;FJ|NivbQbQAq9Ch(Oo8r_?M6E@gAB8GfZAE0;9ri% z816CsA83q#L3(3Don>5djNit3LeGUg&Vw*|S#F7t%LH{$$0aej_n$UfAUg;K#S5KO zzyvbz@HpWnasLvR{=YH-L1ggI>wl{*`mau@zg(67dWia;O#lDC_5Z6QkF9n^Zm4st VS?$L7kkx{dmQWBc7kwA>e*gdx8qNR! literal 0 HcmV?d00001 From a96dc7b4cbf77975041b74b238f201b00cc1858b Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:36:03 +0800 Subject: [PATCH 32/37] docs(uav_flight_base): multi-scene evaluation figures --- docs/uav_flight_base/images/policy_sceneB.png | Bin 0 -> 28942 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/uav_flight_base/images/policy_sceneB.png diff --git a/docs/uav_flight_base/images/policy_sceneB.png b/docs/uav_flight_base/images/policy_sceneB.png new file mode 100644 index 0000000000000000000000000000000000000000..c9868fec20f41593986b93a8575fff6b41bcde4d GIT binary patch literal 28942 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 literal 0 HcmV?d00001 From e488cb86fcc10c944adc2afcbf62bbddd914a0b6 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 09:36:06 +0800 Subject: [PATCH 33/37] docs(uav_flight_base): multi-scene evaluation figures --- docs/uav_flight_base/images/policy_compare.png | Bin 0 -> 33061 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/uav_flight_base/images/policy_compare.png diff --git a/docs/uav_flight_base/images/policy_compare.png b/docs/uav_flight_base/images/policy_compare.png new file mode 100644 index 0000000000000000000000000000000000000000..9e726a8d031880bdb5ed18fe07b067980208c180 GIT binary patch literal 33061 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 literal 0 HcmV?d00001 From d7667dae89d18c4b9733676692ea86e40aa3ad8a Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 12:05:08 +0800 Subject: [PATCH 34/37] feat(uav_flight_base): policy width/optimizer sweep (task 4 comparison) --- .../scripts/uav_policy_sweep.py | 122 ++++++++++++++++++ 1 file changed, 122 insertions(+) create mode 100644 src/uav_flight_base/scripts/uav_policy_sweep.py diff --git a/src/uav_flight_base/scripts/uav_policy_sweep.py b/src/uav_flight_base/scripts/uav_policy_sweep.py new file mode 100644 index 0000000000..f77fdd3fd4 --- /dev/null +++ b/src/uav_flight_base/scripts/uav_policy_sweep.py @@ -0,0 +1,122 @@ +# -*- coding: utf-8 -*- +"""网络结构 / 优化器对比实验(作业要求:同算法不同模型结构的对比)。 + +数据: policy_data/scan_dataset.csv (90 维激光扫描 -> (v, w)) +对比: 隐层宽度 32 / 64 / 96 / 128 / 256 × {SGD+Momentum, Adam} +产出: policy_data/sweep_results.csv +""" +import csv +import os +import time + +import numpy as np +import pandas as pd + +BASE = os.path.dirname(os.path.abspath(__file__)) +CSV = os.path.join(BASE, "policy_data", "scan_dataset.csv") +OUT = os.path.join(BASE, "policy_data", "sweep_results.csv") + +EPOCHS = 300 +BATCH = 64 +L2 = 1e-5 +SEED = 0 + + +def load(): + df = pd.read_csv(CSV) + x = df.iloc[:, :-2].to_numpy(dtype=np.float32) + y = df.iloc[:, -2:].to_numpy(dtype=np.float32) + return x, y + + +def train(x, y, hidden, opt_name): + rng = np.random.RandomState(SEED) + n, d = x.shape + cut = int(n * 0.85) + xtr, ytr, xva, yva = x[:cut], y[:cut], x[cut:], y[cut:] + + xm, xs = xtr.mean(0), xtr.std(0) + 1e-6 + ym, ys = ytr.mean(0), ytr.std(0) + 1e-6 + xtr = (xtr - xm) / xs + xva = (xva - xm) / xs + ytr = (ytr - ym) / ys + yva = (yva - ym) / ys + + W1 = rng.randn(d, hidden).astype(np.float32) * np.sqrt(2.0 / d) + b1 = np.zeros(hidden, dtype=np.float32) + W2 = rng.randn(hidden, 2).astype(np.float32) * np.sqrt(2.0 / hidden) + b2 = np.zeros(2, dtype=np.float32) + + lr = 2e-3 if opt_name == "sgd" else 1e-3 + mom, b1m, b2m = 0.9, 0.9, 0.999 + mW1 = np.zeros_like(W1); mb1 = np.zeros_like(b1) + mW2 = np.zeros_like(W2); mb2 = np.zeros_like(b2) + vW1 = np.zeros_like(W1); vb1 = np.zeros_like(b1) + vW2 = np.zeros_like(W2); vb2 = np.zeros_like(b2) + t = 0 + + best = 1e9 + t0 = time.time() + for ep in range(EPOCHS): + perm = rng.permutation(len(xtr)) + for i in range(0, len(perm), BATCH): + b = perm[i:i + BATCH] + xb, yb = xtr[b], ytr[b] + h = np.maximum(xb @ W1 + b1, 0.0) + o = h @ W2 + b2 + go = (o - yb) * (2.0 / len(b)) + gW2 = h.T @ go + L2 * W2 + gb2 = go.sum(0) + gh = (go @ W2.T) * (h > 0) + gW1 = xb.T @ gh + L2 * W1 + gb1 = gh.sum(0) + + t += 1 + if opt_name == "sgd": + mW1 = mom * mW1 - lr * gW1; W1 += mW1 + mb1 = mom * mb1 - lr * gb1; b1 += mb1 + mW2 = mom * mW2 - lr * gW2; W2 += mW2 + mb2 = mom * mb2 - lr * gb2; b2 += mb2 + else: + for P, G, M, V in ((W1, gW1, mW1, vW1), (b1, gb1, mb1, vb1), + (W2, gW2, mW2, vW2), (b2, gb2, mb2, vb2)): + M *= b1m + M += (1 - b1m) * G + V *= b2m + V += (1 - b2m) * G * G + Mh = M / (1 - b1m ** t) + Vh = V / (1 - b2m ** t) + P -= lr * Mh / (np.sqrt(Vh) + 1e-8) + + hv = np.maximum(xva @ W1 + b1, 0.0) + vl = float(np.mean((hv @ W2 + b2 - yva) ** 2)) + if vl < best: + best = vl + + return { + "hidden": hidden, + "optimizer": opt_name, + "params": d * hidden + hidden + hidden * 2 + 2, + "val_loss": round(best, 5), + "seconds": round(time.time() - t0, 1), + } + + +def main(): + x, y = load() + print("samples:", x.shape) + rows = [] + for hidden in (32, 64, 96, 128, 256): + for opt in ("sgd", "adam"): + r = train(x, y, hidden, opt) + rows.append(r) + print(r) + with open(OUT, "w", newline="", encoding="utf-8") as f: + w = csv.DictWriter(f, fieldnames=["hidden", "optimizer", "params", "val_loss", "seconds"]) + w.writeheader() + w.writerows(rows) + print("saved:", OUT) + + +if __name__ == "__main__": + main() From 79a8670157b0ef1f58c11baf9fd31c0c586dcd96 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 12:05:10 +0800 Subject: [PATCH 35/37] feat(uav_flight_base): policy width/optimizer sweep (task 4 comparison) --- docs/uav_flight_base/data/sweep_results.csv | 11 +++++++++++ 1 file changed, 11 insertions(+) create mode 100644 docs/uav_flight_base/data/sweep_results.csv diff --git a/docs/uav_flight_base/data/sweep_results.csv b/docs/uav_flight_base/data/sweep_results.csv new file mode 100644 index 0000000000..adbd81e0a4 --- /dev/null +++ b/docs/uav_flight_base/data/sweep_results.csv @@ -0,0 +1,11 @@ +hidden,optimizer,params,val_loss,seconds +32,sgd,2978,0.06767,1.2 +32,adam,2978,0.06549,2.0 +64,sgd,5954,0.06723,1.5 +64,adam,5954,0.06803,2.3 +96,sgd,8930,0.07226,1.7 +96,adam,8930,0.06734,2.7 +128,sgd,11906,0.08125,2.0 +128,adam,11906,0.07058,3.0 +256,sgd,23810,0.07399,5.0 +256,adam,23810,0.06931,6.5 From a5040733e8cf4ebc06ec501a9445653bed7c74de Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 12:05:13 +0800 Subject: [PATCH 36/37] feat(uav_flight_base): policy width/optimizer sweep (task 4 comparison) --- .../images/policy_width_sweep.png | Bin 0 -> 34256 bytes 1 file changed, 0 insertions(+), 0 deletions(-) create mode 100644 docs/uav_flight_base/images/policy_width_sweep.png diff --git a/docs/uav_flight_base/images/policy_width_sweep.png b/docs/uav_flight_base/images/policy_width_sweep.png new file mode 100644 index 0000000000000000000000000000000000000000..7840e88e77a897bfc90867f7143fef5bdbdfe8ae GIT binary patch literal 34256 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 H===UJ=JNm& literal 0 HcmV?d00001 From 597c0d3e499260c01ead0ea59dbb141b2c15d462 Mon Sep 17 00:00:00 2001 From: sqrt-crypto <2991707065@qq.com> Date: Fri, 13 Nov 2026 12:05:15 +0800 Subject: [PATCH 37/37] feat(uav_flight_base): policy width/optimizer sweep (task 4 comparison) --- docs/uav_flight_base/README.md | 26 ++++++++++++++++++++++++++ 1 file changed, 26 insertions(+) diff --git a/docs/uav_flight_base/README.md b/docs/uav_flight_base/README.md index 0688acf789..50dac1527b 100644 --- a/docs/uav_flight_base/README.md +++ b/docs/uav_flight_base/README.md @@ -122,3 +122,29 @@ roslaunch uav_flight_base main.launch mode:=mock teleop:=false ![场景B](images/policy_sceneB.png) +### 网络结构与优化器对比 + +课程要求“同一模型比较不同算法、同一算法比较不同网络结构”。在固定数据(1757 组)、 +固定轮数(300)、固定随机种子的条件下,只改变隐层宽度与优化器,共 10 组实验。 + +| 隐层宽度 | 参数量 | 验证损失(SGD+动量) | 验证损失(Adam) | +|---|---|---|---| +| 32 | 2 978 | 0.06767 | **0.06549** | +| 64 | 5 954 | 0.06723 | 0.06803 | +| 96 | 8 930 | 0.07226 | 0.06734 | +| 128 | 11 906 | 0.08125 | 0.07058 | +| 256 | 23 810 | 0.07399 | 0.06931 | + +复现方式: + +```bash +rosrun uav_flight_base uav_policy_sweep.py # 输出 sweep_results.csv +``` + +**结论**:参数量从 2 978 增至 23 810(约 8 倍),验证损失并未下降;最优为宽度 32 配 Adam。 +说明在本数据集规模下网络容量已不是瓶颈,此后再加宽只会增加优化难度。 +这一结果与场景 B 的停滞现象互为印证——瓶颈在数据分布覆盖,而非模型容量。 + +![结构对比](images/policy_width_sweep.png) + +