Easy_HandEye2 安装与配置指南

1. 项目基础介绍

Easy_HandEye2 是一个用于 ROS2 的自动化、硬件无关的手眼标定工具。它提供了功能性和图形用户界面 (GUI)，用于从机器人位置和跟踪系统输出中采样，通过 OpenCV 库的手眼标定算法（例如 Tsai-Lenz）计算手眼校准矩阵，存储校准结果，并在每次系统启动时发布校准结果。该工具的主要目的是简化校准过程，并保持校准结果始终更新。

主要编程语言：C++ 和 Python

2. 项目使用的关键技术和框架

• ROS2：机器人操作系统（Robot Operating System）的第二个版本，用于机器人应用的框架。
• OpenCV：开源计算机视觉库，提供了手眼标定算法的实现。
• TF (Transform Framework)：ROS2 中的变换框架，用于在不同坐标系之间转换。
• MoveIt!：ROS2 中的一个机器人运动规划库，用于生成机器人的运动路径。
• rqt：ROS2 中的一个图形工具，用于可视化和管理 ROS 节点和主题。

3. 项目安装和配置的准备工作及详细安装步骤

准备工作

• 确保系统已安装 ROS2。
• 确保系统已安装 Catkin 工作空间。

安装步骤

克隆项目仓库

首先，将 Easy_HandEye2 仓库克隆到你的 Catkin 工作空间中：

cd ~/catkin_ws/src  # 替换为你的 Catkin 工作空间路径
git clone https://github.com/marcoesposito1988/easy_handeye2.git

安装依赖

回到 Catkin 工作空间的根目录，安装项目的依赖：

cd ..
rosdep install -iyr --from-paths src

编译项目

在 Catkin 工作空间的根目录下，编译项目：

colcon build

使用项目

根据你的具体需求，你可以使用以下两种方式之一来使用 Easy_HandEye2。

手眼标定（Eye-in-Hand）

创建一个新的 calibrate.launch.py 文件，包括机器人的 MoveIt! 栈和跟踪系统的启动文件，以及 Easy_HandEye2 的 calibrate.launch.py 文件：

<launch>
  <!-- 启动你的机器人 MoveIt! 栈，例如包含它的 moveit_planning_execution.launch.py -->
  <!-- 启动你的跟踪系统的 ROS 驱动程序 -->
  <include file="$(find easy_handeye2)/launch/calibrate.launch.py">
    <arg name="calibration_type" value="eye_in_hand"/>
    <arg name="name" value="my_eih_calib"/>
    <arg name="robot_base_frame" value="/base_link"/>
    <arg name="robot_effector_frame" value="/ee_link"/>
    <arg name="tracking_base_frame" value="/optical_origin"/>
    <arg name="tracking_marker_frame" value="/optical_target"/>
  </include>
</launch>

基于基座的手眼标定（Eye-on-Base）

创建一个新的 calibrate.launch.py 文件，包括机器人的 MoveIt! 栈和跟踪系统的启动文件，以及 Easy_HandEye2 的 calibrate.launch.py 文件：

<launch>
  <!-- 启动你的机器人 MoveIt! 栈，例如包含它的 moveit_planning_execution.launch.py -->
  <!-- 启动你的跟踪系统的 ROS 驱动程序 -->
  <include file="$(find easy_handeye2)/launch/calibrate.launch.py">
    <arg name="calibration_type" value="eye_on_base"/>
    <arg name="name" value="my_eob_calib"/>
    <arg name="robot_base_frame" value="/base_link"/>
    <arg name="robot_effector_frame" value="/ee_link"/>
    <arg name="tracking_base_frame" value="/optical_origin"/>
    <arg name="tracking_marker_frame" value="/optical_target"/>
  </include>
</launch>

以上步骤应该可以帮助你成功安装和配置 Easy_HandEye2 项目。如果你在安装过程中遇到任何问题，请检查项目的官方文档或寻求社区帮助。