[Documentation] [TitleIndex] [WordIndex

There are a number of tools to help you debug tf related problems. Most of them are located inside the bin directory or the scripts directory. This page gives a description of each tool, and explains what type of problems you can resolve with each tool.

Frame poses


Tf echo is the simplest tool to look at the numeric values of a specific transform. Tf echo takes two arguments: the reference frame and the target frame. The output of tf echo is the target frame represented in the reference frame. E.g. to get the transformation from turtle1 to turtle2, type:

  $ rosrun tf tf_echo turtle1 turtle2

The expected output looks something like this:

At time 1253924110.083
- Translation: [-1.877, 0.415, 0.000]
- Rotation: in Quaternion [0.000, 0.000, -0.162, 0.987]
            in RPY [0.000, -0.000, -0.325]
At time 1253924111.082
- Translation: [-1.989, 0.151, 0.000]
- Rotation: in Quaternion [0.000, 0.000, -0.046, 0.999]
            in RPY [0.000, -0.000, -0.092]



Tf tree introspection

Viewing TF trees

Save as a file by view_frames

View frames can generate a pdf file with a graphical representation of the complete tf tree. It also generates a number of time-related statistics. To run view frames, type:

  $ rosrun tf view_frames

In the current working folder, you should now have a file called "frames.pdf". Open the file:

  $ evince frames.pdf

and you should see something like this: frames2.png

Query a running node

If a specific node is having trouble its exact data can be queried using the following command.

rosrun tf view_frames --node=NODE_NAME

This will produce the same frames.pdf.

Dynamically introspect during runtime

rqt_tf_tree provides a GUI to introspect tf tree during runtime.


Tf monitor can give you a lot of detailed information about a specific transformation you care about. The monitor will break down the chain between two frames into individual transforms, and provide statistics about timing, broadcasters, etc.

E.g. you want more information about the transformation between the frame "map" and the frame "torso_lift_link", simply type:

  $ rosrun tf tf_monitor base_link torso_lift_link 

The output should look something like this:

RESULTS: for /turtle1 to /turtle2
Chain currently is: /turtle2 -> /turtle1
Net delay     avg = 0.008786: max = 0.02799


Node: /turtle1_tf_broadcaster 40.01705 Hz, Average Delay: 0.0001427 Max Delay: 0.0003479
Node: /turtle2_tf_broadcaster 40.01705 Hz, Average Delay: 0.0001515 Max Delay: 0.00034

You can see that the transformation between "map" and "torso_lift_link" consists of 5 different frames: map -> odom_combined -> base_footprint -> base_link -> torso_lift_link.

Each of these frames can be published by a different broadcaster.


RosWTF is a tool that inspects a running system, and reports everything that looks suspicious. Roswtf is used for more than just debugging tf, but its output includes a section with specific tf debugging information.

Run roswtf:

  $ roswtf

and in the output, look for the section about tf:

Loaded plugin tf.tfwtf
Package: tf
Static checks summary:

Found 2 warning(s).
Warnings are things that may be just fine, but are sometimes at fault

WARNING The following packages need genmsg() in CMakeLists.txt:
 * tf

WARNING The following packages need gensrv() in CMakeLists.txt:
 * tf

2024-06-15 13:48