[Documentation] [TitleIndex] [WordIndex

Only released in EOL distros:  

carl_bot: carl_bringup | carl_description | carl_dynamixel | carl_interactive_manipulation | carl_phidgets | carl_teleop | carl_tools

Package Summary

Miscellaneous Tools for CARL


The carl_tools package contains miscellaneous functionality and tools for the CARL robot. This currently includes an automatic calibration system for the transforms between CARL's sensors and their respective mounts, and an arm current logger.



This node automatically determines transformations between CARL's depth sensors and their respective mounts.

Subscribed Topics

asus_marker_tracker/ar_pose_marker (ar_track_alvar_msgs/AlvarMarkers)

Published Topics

asus_controller/command (std_msgs/Float64)


calibration_marker_id (int, default: 200)


Log currents on the JACO arm and finger joints to a text file.

Subscribed Topics

jaco_arm/joint_states (sensor_msgs/JointState)


filename (string, default: "arm_currents.txt")


To install the carl_bot package, you can install from source with the following commands:


External camera calibration can be started with the following launch command:

Optionally, an rviz interface for visualizing the calibration process and final calculated transforms can be launched with:

Current logging can be started by running the current_logger node, with an optional parameter for the output file name (replace <output_filename>), and it will continue to log currents until the node is terminated.

Calibration Procedure

To calibrate the cameras, first make sure a unique AR tag is placed in a known location with respect to the robot. By default, the calibration node expects a maximum size (12 cm) AR marker with ID 200 centered on the screw holes of CARL's top plate. Once this marker is placed and unobstructed, simply launch the calibration node and wait. When the transform is calculated, further instructions will be provided in the terminal where the node was launched.

2020-03-28 12:29