Skip to content

优化Carla-air文档：补充小白友好说明，略微调整结构,补充操作指南。 #35

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
shenxian-6 wants to merge 1 commit into
base: master
Choose a base branch
from
+15 −15
Open

优化Carla-air文档：补充小白友好说明，略微调整结构,补充操作指南。 #35

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 15 additions & 15 deletions docs/dev/Carla_Air.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -24,17 +24,17 @@ https://github.com/louiszengCN/CarlaAir/commit/6f913ae9efc512b8ceff6bbd82f8c0049

## ✨ 核心亮点 <span id="highlights"></span>

| | |
|---|---|
| 🏗️ **单进程组合式集成** | `CARLAAirGameMode` 继承 Carla 并组合 AirSim。仅修改上游 2 个文件（约 35 行）。无桥接，无延迟。 |
| 🎯 **绝对坐标对齐** | Carla（左手系）与 AirSim（北东地，NED）坐标系之间精确 `0.0000 m` 误差。 |
| 📸 **多达 18 种传感器模态** | RGB、深度图、语义分割、实例分割、LiDAR、雷达、表面法线、IMU、GNSS、气压计 -- 空地传感器逐帧对齐。 |
| 🔄 **零修改代码迁移** | 现有 Carla 和 AirSim Python 脚本及 ROS 2 节点可直接在 Carla-Air 上运行，无需任何代码改动。89/89 Carla API 测试全部通过。 |
| ⚡ **联合负载约 20 FPS** | 中等联合配置（车辆 + 无人机 + 8 个传感器）稳定运行在 19.8 +/- 1.1 FPS。通信开销 < 0.5 ms（对比桥接联合仿真的 1--5 ms）。 |
| 🛡️ **3 小时稳定性验证** | 357 次生成/销毁循环，零崩溃，零内存累积（R² = 0.11）。 |
| 🚁 **内置 FPS 无人机控制** | 在视口中使用 WASD + 鼠标直接驾驶无人机 -- 无需编写 Python 脚本。 |
| 🚦 **逼真城市交通** | 规则驱动的交通流、具有社会行为的行人、13 张城市地图。 |
| 🧩 **可扩展资产导入管线** | 支持导入自定义机器人平台、无人机配置、车辆模型和环境地图。 |
|亮点|技术说明|说白了|
Copy link
Copy Markdown
Member

@donghaiwang donghaiwang Apr 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

和技术说明有点重复了，可以完善技术说明就行，而且目前加的明显吹过头了

|---|---|---|
| 🏗️ **单进程组合式集成** | `CARLAAirGameMode` 继承 Carla 并组合 AirSim。仅修改上游 2 个文件（约 35 行）。无桥接，无延迟。 |不用复杂通信，一个程序就能同时跑汽车和无人机，延迟几乎为0，新手部署也容易。|
| 🎯 **绝对坐标对齐** | Carla（左手系）与 AirSim（北东地，NED）坐标系之间精确 `0.0000 m` 误差。 |车和无人机在同一个真实世界坐标里，不会出现车和无人机错位的情况。|
| 📸 **多达 18 种传感器模态** | RGB、深度图、语义分割、实例分割、LiDAR、雷达、表面法线、IMU、GNSS、气压计 -- 空地传感器逐帧对齐。 |能同时获取车和无人机的18种传感器数据，做AI训练、仿真实验数据全，满足课程作业需求。|
| 🔄 **零修改代码迁移** | 现有 Carla 和 AirSim Python 脚本及 ROS 2 节点可直接在 Carla-Air 上运行，无需任何代码改动。89/89 Carla API 测试全部通过。 |如果之前学的Carla/AirSim代码直接就能用，不用重新学，上手零成本，兼容性高。|
| ⚡ **联合负载约 20 FPS** | 中等联合配置（车辆 + 无人机 + 8 个传感器）稳定运行在 19.8 +/- 1.1 FPS。通信开销 < 0.5 ms（对比桥接联合仿真的 1--5 ms）。 |普通电脑也能流畅跑，做课程实验、写大作业完全够用，不会卡顿。|
| 🛡️ **3 小时稳定性验证** | 357 次生成/销毁循环，零崩溃，零内存累积（R² = 0.11）。 |平台稳定性强，长时间跑仿真、做实验不会崩溃，数据不会丢失。|
| 🚁 **内置 FPS 无人机控制** | 在视口中使用 WASD + 鼠标直接驾驶无人机 -- 无需编写 Python 脚本。 |不用写代码，键盘鼠标就能直接操控无人机，新手零门槛上手。|
| 🚦 **逼真城市交通** | 规则驱动的交通流、具有社会行为的行人、13 张城市地图。 |仿真环境高度还原，真实城市，有红绿灯、行人、车流，做场景实验更真实。|
| 🧩 **可扩展资产导入管线** | 支持导入自定义机器人平台、无人机配置、车辆模型和环境地图。 |可以自己加新的机器人、无人机、车辆模型，做个性化实验，扩展性强。|

![](../images/calar_air/teaser_final.jpg)

Expand Down Expand Up @@ -305,10 +305,10 @@ CARLA-Air 旨在支持空地一体具身智能的四大研究方向：
| `Mouse` | 偏航转向 |
| `Scroll` | 调节速度 |
| `N` | 切换天气 |
| `P` | 碰撞模式切换 |
| `H` | 帮助菜单 |
| `Tab` | 释放 / 捕获鼠标 |
| `1` / `2` / `3` | 传感器画面 |
| `P` | 碰撞模式切换(开启或关闭无人机碰撞检测) |
| `H` | 帮助菜单(忘记按键直接调出所有操作说明) |
| `Tab` | 释放 / 捕获鼠标(按tab切出鼠标，操作其他窗口) |
| `1` / `2` / `3` | 传感器画面(一键切换车/无人机/多传感器分屏画面) |
Copy link
Copy Markdown
Member

@donghaiwang donghaiwang Apr 3, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

优化时需要操作验证，这个有些地方是错的，比如这个地方，3个按键分别是不同传感器（可以细化说明是什么传感器）


---

Expand Down