Documentation Status

Cannot load information on name: rqt_plot, distro: electric, which means that it is not yet in our index. Please see this page for information on how to submit your repository to our index.


First time running

$ sudo apt-get install ros-<distro>-rqt
$ sudo apt-get install ros-<distro>-rqt-common-plugins


$ rosdep install rqt_plot

Also if you're on Ubuntu and like to know the most recommended plotting result, simply get a .deb file of pyqtgraph here, which is not available via rosdep. And run it by something like:

$ dpkg -i %NAME_OF_DOT_DEB_FILE%.deb

How to run in general

$ rqt_plot

To specify topic(s) to plot, you need full path name of the topics published. You can find them easily for instance by the command below:

$ rostopic list
/rosout         #  these are only example topics.

To give topic names to plot

There are two ways to give the topic names to rqt_plot as explained in following sections. In both ways, topics that are set in previous run is resumed (as far as the program was shut down without error).

Run from commandline

Both of the following lines plot the same topics.

$ rqt_plot /turtle1/pose/x:y:z
$ rqt_plot /turtle1/pose/x /turtle1/pose/y /turtle1/pose/z

Obviously, if you want to change the topics to plot, you need to restart the program and give the new topic names.

From GUI

Type in the "Topic" input field the full path of the topic name, and press "+" button. ROS/Tutorials/UnderstandingTopics/rqt_plot.png

"Topic" field auto-completes the topic name (although it's not fully working as noticed).

To choose plotting backend type

Currently rqt_plot has three plotting backend options (numbered in recommended order) which can be configured using the setting dialog available via the gear icon in the window title bar:

  1. pyqtgraph (fast and needs pyqtgraph to be manually installed which is not in the Ubuntu binary repository as of Sep 2013)

  2. matplotlib (slow but always available)

  3. qwt plot (fast, but not using message timestamps and needs python-qwt bindings)

By default, backend option is chosen in the order above; the first one found on your system gets used (eg. if your system has matplotlib but not pyqtgraph, your rqt_plot runs with the matplotlib).

User can also select one of them from GUI; click "gear" icon next to question symbol and a dialog should pop up.

Trouble shooting

Topic is not plotted

Check the following:


Data type

TODO need to figure out which data types are supported

No trajectory supported

See this discussion.

Spline curve is not supported either.

Wiki: rqt_plot (last edited 2014-06-06 02:58:02 by michael gregg)