- 类别
- 框架与工具 · 工具
- 开放程度
- 开源
- 发布时间
- 2025 年 3 月
- 开源协议
- 未声明
- 发布方所在地
- 中国
项目简介
格灵深瞳开源的人形与四足机器人激光雷达重定位方案,基于 FAST-LIO 和 Open3D,在离线点云地图上做配准定位,可从粗略初始位姿启动,长时间运行不产生累计误差。针对 Unitree G1 上倒装的 Livox MID-360 修改了 livox_ros_driver2,使点云和 IMU 外参都可配置,并在 Go2 上做了验证。支持 ROS Melodic / Noetic 和 ROS 2 Humble。
FAST_LIO_LOCALIZATION_HUMANOID 安装要点
来源:README.md依据官方资料的 main 版本整理,核验于 2026-11-06。版本更新后命令可能变化,以官方文档为准。
安装依赖库
另需 Livox-SDK2、Livox-SDK、livox_ros_driver
sudo apt install libc++-dev libc++abi-dev sudo apt-get install libeigen3-dev配置 Open3D 路径
写进 open3d_loc/CMakeLists.txt,路径换成解压目录
set(Open3D_DIR "/home/liar/open3d141/lib/cmake/Open3D")加载驱动环境并新建工作区
下一步要在同一个终端里做
cd ~/ws_livox/ source devel/setup.bash mkdir -p ~/ws_loc/src克隆并编译
ROS 2 Humble 用 humble 分支
cd ~/ws_loc/src git clone https://github.com/deepglint/FAST_LIO_LOCALIZATION_HUMANOID.git cd .. catkin_make -DROS_EDITION=ROS1启动定位
先改 path_map 指向点云地图;在 rviz 里给初始位姿
source devel/setup.bash roslaunch open3d_loc localization_3d_g1.launch启动雷达驱动
用 rosbag 回放时不需要这一步
source devel/setup.bash roslaunch livox_ros_driver2 msg_MID360.launch
环境要求
来源:README.md- 测试环境
- 纯净的 Ubuntu 20.04 / 22.04 虚拟机
- PCL 和 Eigen
- Melodic 和 Noetic 用默认版本即可
- Open3D
- 官方建议用预编译的 open3d141,x86 已测试,arm 未充分测试
- Livox-SDK2
- 按官方仓库说明安装
- livox_ros_driver
- fast_lio 必需,还要装 Livox-SDK
- G1 上的雷达
- MID360 倒装,要用项目修改过的 livox_ros_driver2
适配矩阵
来源:README.mdREADME 列出的 ROS 发行版和对应系统
| 名称 | Ubuntu 版本 | 分支 |
|---|---|---|
| ROS Melodic | 18.04 | — |
| ROS Noetic | 20.04 | — |
| ROS Humble | 22.04 | humble |
✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。
常见报错
解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。
undefined reference to `ros::console::initializeLogLocation解决让 Open3D 和 open3d_loc 的 CMakeLists.txt 里 ABI 都设为 1;#12 的提问者改用 cmake 3.24.1 也编译通过
来源:Issue #26
适配机器人
- Unitree G1
- Unitree Go2
获取方式
同类项目
开发工具数据来源
本页信息均整理自以下公开资料。
3 条来源核验于 2026-10-01