ROS LEAP MOTION

ROS driver for the Leap Motion Controller

REQUIREMENTS

You should have ROS Kinetic or a newer version installed on your device and the Leap Motion SDK for Linux.

FEATURES

Currently, this ROS package supports one person (left and right arm), publishing raw camera images from the controller, basic visualization using RViz and a pointcloud2 generated from stereo_image_proc node.

There is also a filter node implementing a 2nd-order Butterworth lowpass filter that is used to filter the hand x, y, z coordinates coming from the Leap Controller via Human.msg. For more information refer to Julius O. Smith III, Intro to Digital Filters with Audio Applications.

INSTALLATION

Python API installation

1. If you wish to use the old deprecated Python API you need to append the location of your LeapSDK to your environment variables. This step differs depending on where you saved the SDK. The LeapSDK folder should contain the following files: lib/Leap.py, lib/x86/LeapPython.so, lib/x86/libLeap.so, lib/x64/LeapPython.so, lib/x64/libLeap.so lib/LeapPython.so, lib/libLeap.dylib.

Example:

# 64-bit operating system
export PYTHONPATH=$PYTHONPATH:$HOME/LeapSDK/lib:$HOME/LeapSDK/lib/x64

# 32-bit operating system
export PYTHONPATH=$PYTHONPATH:$HOME/LeapSDK/lib:$HOME/LeapSDK/lib/x86

2. (OPTIONAL) You can edit your ~/.bashrc file to remove the need to export the location of your LeapSDK every time you open a new shell. Just append the LeapSDK location to the end of the PYTHONPATH.

# 64-bit operating system
echo "export PYTHONPATH=$PYTHONPATH:$HOME/LeapSDK/lib:$HOME/LeapSDK/lib/x64" >> ~/.bashrc
source ~/.bashrc

# 32-bit operating system
echo "export PYTHONPATH=$PYTHONPATH:$HOME/LeapSDK/lib:$HOME/LeapSDK/lib/x86" >> ~/.bashrc
source ~/.bashrc

Usage

1. Just go to the src folder of your catkin workspace.

    cd ~/catkin_ws/src
    git clone https://github.com/ros-drivers/leap_motion.git
    cd ~/catkin_ws
    catkin_make

2. Start the Leap control panel in another terminal.

LeapControlPanel

3. (OPTIONAL) If it gives you an error about the leap daemon not running, stop the LeapControlPanel have a look here and use the following command:

sudo service leapd restart

4. Source your current catkin workspace.

source ~/catkin_ws/devel/setup.bash

5. Launch the demo.launch file to see if you have set everything up correctly. If you wish to enable a lowpass filter change “enable_filter” to true in filter_params.yaml file.

roslaunch leap_motion demo.launch

6. You are done! You should see an RViz window opening up displaying the detected hands from the controller.

Changelog for package leap_motion

0.0.12 (2018-03-06)

• Reimplementation of the entire Leap Motion driver for ROS
• Old implementation of the driver is now deprecated and will be removed in a year.
• Contributors: Nowittyusername

0.0.11 (2017-01-14)

• [fix] ROS Hydro onward requires queue_size option #31
• Contributors: Kei Okada

0.0.10 (2016-06-18)

• [fix][sys] launch and camera_info directory should be installed [fix][sys] a bug of the check method of LEAP_SDK environment value #27
• [sys] Add tests #25
• Contributors: Kenta Yonekura, Isaac I.Y. Saito

0.0.9 (2015-12-14)

• [feat] Added individual coordinates for each finger bone (#23)
• [feat] Better way of parameter declaration (#17)
• [sys] Update travis conf to Ubuntu Trusty and ROS I-J (#22)
• Contributors: Isaac I.Y. Saito, Tu-Hoa Pham

0.0.8 (2015-04-30)

• (Feature) Take ROS msg publish frequency from commandline, set it to Parameter Server
• (Maintenance) Add unittest structure.
• Contributors: Isaac I.Y. Saito

0.0.7 (2014-12-24)

• Build some binaries only when SDK is installed (Fix to https://github.com/ros-drivers/leap_motion/issues/7).
• Contributors: Isaac I.Y. Saito, Yu Ohara

0.0.6 (2014-11-18)

• Fix typo in dependency. #5 from 130s/typo_dependency
• Contributors: Isaac IY Saito

0.0.5 (2014-11-17)

• Enhancements for skeleton/finger tf frame publishing as well as code cleanup
• Code cleanup
• skeleton sender added
• Adjusted to new LeapMotion API (Fall 2013)
• Changed license to BSD
• Contributors: Florian Lier, Igor Zubrycki, Mirza Shah, Isaac IY Saito

0.0.4 (2013-10-28)

0.0.3 (2013-10-24)

• Initial release as ROS package.
• Provides basic publisher for Leap Motion device.