工具开源

FAST_LIO_LOCALIZATION_HUMANOID

格灵深瞳中国

GitHub 仓库 deepglint/FAST_LIO_LOCALIZATION_HUMANOID

类别
框架与工具 · 工具
开放程度
开源
发布时间
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。版本更新后命令可能变化,以官方文档为准。

  1. 安装依赖库

    另需 Livox-SDK2、Livox-SDK、livox_ros_driver

    sudo apt install libc++-dev libc++abi-dev
    sudo apt-get install libeigen3-dev
  2. 配置 Open3D 路径

    写进 open3d_loc/CMakeLists.txt,路径换成解压目录

    set(Open3D_DIR "/home/liar/open3d141/lib/cmake/Open3D")
  3. 加载驱动环境并新建工作区

    下一步要在同一个终端里做

    cd ~/ws_livox/
    source devel/setup.bash
    mkdir -p ~/ws_loc/src
  4. 克隆并编译

    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
  5. 启动定位

    先改 path_map 指向点云地图;在 rviz 里给初始位姿

    source devel/setup.bash
    roslaunch open3d_loc localization_3d_g1.launch
  6. 启动雷达驱动

    用 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.md

README 列出的 ROS 发行版和对应系统

名称Ubuntu 版本分支
ROS Melodic18.04—
ROS Noetic20.04—
ROS Humble22.04humble

✓ 官方资料写明支持,— 资料没写,版本号照原文。没写不等于不支持。

常见报错

解法来自官方文档、维护者回复或提问者确认,部分报错出自旧版本。

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

星标、下载量等指标定期自动更新。

FAST_LIO_LOCALIZATION_HUMANOID:安装步骤、环境要求与常见报错 | 具身集