CarlaAir × ROS 2集成完全指南:63个话题将车辆与无人机多传感器数据流式推送到RViz 2

原创2026-10-14 23:07:491,907 阅读

CarlaAir × ROS 2集成完全指南:63个话题将车辆与无人机多传感器数据流式推送到RViz 2

CarlaAir 是一个把 CARLA 城市交通与 AirSim 无人机飞行融合进同一进程的空地一体仿真平台。本指南将带你完成 CarlaAir × ROS 2 集成:无需编译 carla-ros-bridge,3 个终端即可把车辆与无人机的多传感器数据通过 ROS 2 话题流式推送到 RViz 2 实时可视化,全流程已通过 63 个话题验证。

CarlaAir 空地一体仿真平台架构总览

为什么需要 CarlaAir 的 ROS 2 集成?

做空地协同研究时,最头疼的往往是"两个仿真器怎么对账":

  • 传统方案:CARLA 跑车、AirSim 跑无人机,靠外部桥接做坐标系同步与时间对齐,通信开销 1~5 ms,且两套渲染器画面无法严格对齐;
  • CarlaAir 方案:CARLA 与 AirSim 运行在同一个 Unreal Engine 进程内,坐标系误差校准到 0.0000 m,通信开销 < 0.5 ms,一次天气修改同时影响地面与空中所有传感器。

在 ROS 2 一侧,CarlaAir 提供了极简 Python 桥接:直接用 carla / airsim Python API 读取传感器,转成标准 rclpy 消息发布——车辆侧 RGB、深度、语义分割、LiDAR 点云,无人机侧 FPV 相机、IMU、里程计,全部挂在同一个 map TF 根坐标下,一个 RViz 2 窗口即可同屏查看车与机。

环境准备:最快配置方法

软硬件要求(来自 examples/ros2/README.md):

组件 要求
系统 Ubuntu 22.04
ROS 2 Humble(sudo apt install ros-humble-desktop)
模拟器 CarlaAir v0.1.7 正在运行(./CarlaAir.sh)
Python conda 环境 carlaAir(含 carla、airsim、numpy、opencv-python)
Python 包 rclpy(apt 自带)、cv_bridge(ros-humble-cv-bridge)

💡 还没有 CarlaAir?先按 CarlaAir_Release/guide/Quick-Start.md 用 env_setup/setup_env.sh 一键配好 conda 环境并验证。

关键技巧——双 Python 环境共存:ROS 2 Humble 使用系统 Python 3.10(/opt/ros/humble),而 carla/airsim 装在 conda 环境里。项目提供的 examples/ros2/ros2_env.sh 用"保留系统解释器 + 把 conda 的 site-packages 追加到 PYTHONPATH"的方式解决冲突,避免 rclpy C 扩展与 conda Python 的 ABI 不兼容问题。

# 只需这一行,自动完成 ROS 2 Humble + carlaAir 环境挂载
source examples/ros2/ros2_env.sh

三终端启动步骤:从仿真到 RViz 2

终端 1:启动 CarlaAir 模拟器

./CarlaAir.sh Town10HD

等待 Ready! Both servers are running. 出现即可。两个端口同时就绪:

服务 端口 用途
CARLA API localhost:2000 车辆、行人、天气、传感器
AirSim API localhost:41451 无人机飞行控制与相机

终端 2:启动 ROS 2 桥接节点

source examples/ros2/ros2_env.sh
python3 examples/ros2/air_ground_ros_demo.py

examples/ros2/air_ground_ros_demo.py 会把两个桥接节点放进同一个 rclpy 多线程执行器(4 线程),所以你只需一个终端:

  • 车辆桥 carla_vehicle_bridge.py:生成一辆 Tesla Model 3 挂自动驾驶,车上挂载 4 个传感器——RGB 相机(640×480、90° FOV)、深度相机、语义分割相机、32 线 LiDAR(60 m 探测半径、30 万点/秒,见 carla_vehicle_bridge.py);
  • 无人机桥 airsim_drone_bridge.py:自动起飞爬升到 10 m,读取 FPV 与下视相机、IMU、里程计,并在启动时自动标定 CARLA↔AirSim 坐标偏移(airsim_drone_bridge.py)。

终端 3:打开 RViz 2 预设布局

source /opt/ros/humble/setup.bash
rviz2 -d examples/ros2/rviz/carlaair.rviz

预设布局文件 examples/ros2/rviz/carlaair.rviz 已配置好 Fixed Frame: map,并分组显示:车辆里程计箭头、RGB 图像、语义分割、LiDAR 点云、无人机里程计与 FPV 画面——无需手动拖拽。

CarlaAir ROS 2 集成:63 个话题将车辆与无人机多传感器数据流式推送到 RViz 2

话题清单与 TF 坐标树

本示例共发布 13 个核心话题(项目整体 ROS2 验证覆盖 63 个话题,横跨 CARLA 与 AirSim 双后端,完整发布器源码见 LibCarla/source/carla/ros2/publishers/):

话题名 消息类型 频率
/tf、/tf_static tf2_msgs/TFMessage —
/carla/ego_vehicle/odom nav_msgs/Odometry 30 Hz
/carla/ego_vehicle/rgb/image sensor_msgs/Image 实时
/carla/ego_vehicle/rgb/camera_info sensor_msgs/CameraInfo 实时
/carla/ego_vehicle/depth/image sensor_msgs/Image(mono8) 实时
/carla/ego_vehicle/semantic/image sensor_msgs/Image(CityScapes 配色) 实时
/carla/ego_vehicle/lidar sensor_msgs/PointCloud2 实时
/airsim/drone_1/odom nav_msgs/Odometry 50 Hz
/airsim/drone_1/imu sensor_msgs/Imu 50 Hz
/airsim/drone_1/fpv/image sensor_msgs/Image ~10 Hz
/airsim/drone_1/fpv/camera_info sensor_msgs/CameraInfo ~10 Hz
/airsim/drone_1/down/image sensor_msgs/Image ~10 Hz

所有帧统一挂在 map 根坐标之下:

map
├── ego_vehicle        (来自 CARLA 世界位姿)
│   ├── ego_vehicle/rgb
│   ├── ego_vehicle/depth
│   ├── ego_vehicle/semantic
│   └── ego_vehicle/lidar
└── drone_1            (来自 AirSim 位姿,启动时自动标定偏移)
    ├── drone_1/fpv
    └── drone_1/down

QoS 策略也做了合理区分:里程计/TF 用 RELIABLE,图像/点云等大数据用 BEST_EFFORT + 深度 1,保证 RViz 流畅不积压。

CarlaAir 与 AirSim 坐标系换算对照图

坐标系对齐:车机同屏的关键

CARLA(左手系、z-up)、AirSim(NED、z-down)、ROS(REP-103、+Y 向左)三套坐标系各不相同。两个桥接脚本内部已完成全部换算:

  • 车辆侧:carla_to_ros_quaternion() 翻转 pitch/yaw,carla_loc_to_ros_xyz() 翻转 Y 轴(carla_vehicle_bridge.py);
  • 无人机侧:airsim_ned_to_ros_xyz() 把 NED 转成 ROS 系,启动时通过双端同时读同一架无人机位置自动算出偏移量,让无人机和车辆落在同一 map 系中(airsim_drone_bridge.py)。

更详细的标定公式与参数表见 CarlaAir_Release/guide/COORDINATE_SYSTEMS.md。

⚠️ 偏移量依赖地图与 AirSim PlayerStart 配置,换地图后会自动重新标定,无需手工干预。

常见问题排查(Troubleshooting)

现象 原因与解决
ModuleNotFoundError: carla conda 环境未挂载到 PYTHONPATH,重新执行 source examples/ros2/ros2_env.sh
RViz 里没有画面 用 ros2 topic hz /carla/ego_vehicle/rgb/image 检查;若为 0 Hz,说明 CarlaAir 未启动或自车尚未生成(桥接最多等待 30 s)
Could not find a matching AirSim drone 先启动 CarlaAir,等 AirSim API(默认端口 41451)就绪再跑桥接
RViz 报 Fixed Frame 错误 Fixed Frame 必须设置为 map

相关文件与延伸阅读

CarlaAir 多模态传感器数据流:12 路同步、1 帧对齐

掌握这套流程后,你就可以在 RViz 2 里同时观察自车与无人机的实时传感器流,进一步接入自己的感知、融合与导航节点,开展空地协同研究。更多示例脚本可参考 examples/ 目录,祝你实验顺利!

登录后查看全文
CarlaAir