Manual TF Calibration Tools

Move /tf frames around using your keyboard or interactive markers - a simple calibration-by-eye tool!

TF Keyboard Calibration developed by Andy McEvoy and Dave Coleman at the University of Colorado Boulder, TF Interactive Marker developed by Sammy Pfeiffer at PAL Robotics.

Status:

• Travis CI
• Devel Job Status
• AMD64 Debian Job Status

Screenshot of calibration using keyboard shortcuts

Screenshot of calibration using interactive markers and the mouse

Video example of interactive marker tf calibration.

Install

Ubuntu Debian

sudo apt-get install ros-indigo-tf-keyboard-cal

Build from Source

To build this package, git clone this repo into a catkin workspace and be sure to install necessary dependencies by running the following command in the root of your catkin workspace:

rosdep install -y --from-paths src --ignore-src --rosdistro indigo

Code API

See Class Reference

Usage of TF Keyboard Cal:

To test, create a new /thing coordinate from the following demo:

roslaunch tf_keyboard_cal tf_keyboard_world_to_thing.launch

Start Rviz and use the TF display to visualize its effect.

roslaunch tf_keyboard_cal rviz_demo.launch

You can now use the keyboard shorcuts below to move the frame around. NOTE: Be sure to have the little black window focused on to recieve keyboard input. Once the TF has been positioned, press p to save the settings to the config file. The TF will use these new settings when relaunched.

Manual alignment of camera to world CS:
=======================================
MOVE: X  Y  Z  R  P  YAW
------------------------
up    q  w  e  r  t  y
down  a  s  d  f  g  h
Fast: u
Med:  i
Slow: o
Save: p

Create a launch file and configuration file similar to the demos in the package’s config/ and launch/ folders.

Usage of TF Interactive Marker

Interactive marker /tf calibration is implemented in an entirely seperate python node from the keyboard functionality and it is self contained. You can copy tf_interactive_marker.py and it will work in a standalone fashion. Use -h to get help on this node’s various command line arguments.

To test, first run Rviz:

roslaunch tf_keyboard_cal rviz_demo.launch

Next run the following demo to create a /thing tf:

roslaunch tf_keyboard_cal tf_im_world_to_thing.launch

Now you should be able to move the Interactive Marker and the TF transform will be published (can be stopped with right click menu of the IM) and you’ll see an output in the terminal like:

Static transform publisher command (with roll pitch yaw):
  rosrun tf static_transform_publisher 1.0 0.0 1.0 0.0 -0.0 1.57 base_footprint new_frame 50

Static transform publisher command (with quaternion):
  rosrun tf static_transform_publisher 1.0 0.0 1.0 0.0 0.7068 0.7074 0.0 base_footprint new_frame 50

Roslaunch line of static transform publisher (rpy):
  <node name="from_base_footprint_to_new_frame_static_tf" pkg="tf" type="static_transform_publisher" args="1.0 0.0 1.0 0.0 -0.0 1.57 base_footprint new_frame 50" />

URDF format:
  <origin xyz="1.0 0.0 1.0" rpy="0.0 -0.0 1.57" />

Which hopefully makes your life easier :-)

Demo TF Listener

If you want to get the Eigen or ROS message formatted pose from the interactive marker or keyboard calibration, see the template code:

src/demo_tf_listener.cpp1;2802;0c

Changelog for package tf_keyboard_cal

0.1.0 (2016-02-09)

• Install launch files
• Added new screenshot for imarkers
• Updated README, tweaked arrow
• Adding TF Interactive marker
• Contributors: Dave Coleman, Gaël Ecorchard, Sammy Pfeiffer

0.0.6 (2016-01-13)

• API deprecation fix for rosparam_shortcuts
• Contributors: Dave Coleman

0.0.5 (2015-12-27)

• Fix roslaunch file
• Updated README
• Contributors: Dave Coleman

0.0.4 (2015-12-05)

• catkin lint cleanup
• Fixed travis
• Contributors: Dave Coleman

0.0.3 (2015-12-03)

• Rename dependency ros_param_shortcuts to rosparam_shortcuts
• Contributors: Dave Coleman

0.0.2 (2015-12-03)

• Initial Commit
• Contributors: Andy McEvoy, Dave Coleman