Platform	Build Status
Windows (Appveyor)
Ubuntu (Semaphore)
Ubuntu ROS (Travis)

PlotJuggler 2.5.0

QT5 based application to display time series in plots, using an intuitive "drag and drop" interface.

It can be used either to:

• load static data from file or
• connect to live streaming of data.

Its functionality can be easily extended through plugins.

To understand what PlotJuggler can do for you, take a look to the following video PlotJuggler on Vimeo

Supported formats

• CSV
• Rosbags / ROS topics
• ULog (PX4)
• Your custom format... contact me to know more.

New in version 2.X

It is now possible to create custom timeseries! Simply write your own JavaScript function and apply it to one of more existing timeseries.

Many thanks to @1r0b1n0, who developed the initial version of this feature, and to our first sponsor, a robotics company that made a donation, but prefers to remain anonymous for the time being.

Watch this video to learn how to use it.

Windows Installer (experimental)

PlotJugglerInstaller-2.1.5.exe

"Download and Run" (Ubuntu 16.04 Xenial or later)

For those of you that can't wait and want to get their hands dirty, just download this AppImage:

PlotJuggler-2.5.0-x86_64.AppImage.

Do not forget to make it executable with the command

chmod +x ./PlotJuggler-*-x86_64.AppImage

How to build (without ROS plugins)

Clone the repository as usual:

  git clone https://github.com/facontidavide/PlotJuggler.git

The only binary dependency that you need installed in your system is Qt5. On Ubuntu the debians can be installed with the command:

sudo apt-get -y install qtbase5-dev libqt5svg5-dev qtdeclarative5-dev qtmultimedia5-dev libqt5multimedia5-plugins

On Fedora:

sudo dnf install qt5-qtbase-devel qt5-qtsvg-devel qt5-qtdeclarative-devel qt5-qtmultimedia-devel

Then compile using cmake (qmake is NOT supported):

 mkdir build; cd build
 cmake ..
 make
 sudo make install

Note: the plugins need to be installed in the same folder of the executable or in /usr/local/lib/PlotJuggler/.

How to build (ROS users)

The following instructions are for ROS Kinetic. Adapt them accordingly if you are using a different version of ROS.

The easiest way to install PlotJuggler is through the command:

sudo apt-get install ros-kinetic-plotjuggler 

Nevertheless, if you want to compile it from source, for instance to try the very latest version on the master branch, you must build PlotJuggler using catkin, otherwise the ROS related plugins will not be included.

Follow these instructions:

sudo apt-get install qtbase5-dev libqt5svg5-dev libqt5multimedia ros-$ROS_DISTRO-ros-type-introspection
mkdir -p ws_plotjuggler/src; cd ws_plotjuggler/src
git clone https://github.com/facontidavide/PlotJuggler.git
cd ..
catkin_make
source devel/setup.bash

You should see the following message at the beginning of the compilation step:

"PlotJuggler is being built using CATKIN. ROS plugins will be compiled"

Both the executable and the plugins will be created in ws_plotjuggler/devel/lib/plotjuggler.

To run the application, use the command:

rosrun plotjuggler PlotJuggler 

If you like PlotJuggler...

PlotJuggler required a lot of work to be developed; my goal is to build the most intuitive and powerfull tool to visualize data and timeseries.

If you find PlotJuggler useful, consider making a donation on PayPal or

If you use PlotJuggler at work, your company can become a sponsor and support the development of those specific features they need.

Contact me for more details.

Changelog for package plotjuggler

2.5.0 (2019-12-19)

• Fix issues #196 and #236: allow user to use deterministic color sequence
• fix the edit button
• fix issue #235
• Update appimage_howto.md
• fix timestamp problem in streaming
• Contributors: Davide Faconti

2.4.3 (2019-11-21)

• less dark theme
• bug fix
• Contributors: Davide Faconti

2.4.2 (2019-11-18)

• multithread ROS DataLoader
• directories moved
• manually resizable columns of table view
• Contributors: Davide Faconti

2.4.1 (2019-11-11)

• considerable speed improvement when MANY timeseries are loaded
• bug fix: slow update of left curve table
• AppImage update
• meme update
• Contributors: Davide Faconti

2.4.0 (2019-11-10)

• Tree view (#226)
• fix issue #225
• add version number of the layout syntax
• fix issue #222
• more readable plugin names
• fix issue #221
• Merge branch \'master\' of github.com:facontidavide/PlotJuggler
• minor bug fix
• Contributors: Davide Faconti

2.3.7 (2019-10-30)

• Dont take invisible curve into account for axis limit computation (#185)
• consistent line width
• do not close() a rosbag unless you accepted the dialog
• important bug fix: stop playback when loading new data
• fix bug in TopicPublisher
• do complete reset of globals in custom functions
• apply changes discussed in #220
• Merge branch \'master\' of github.com:facontidavide/PlotJuggler
• cherry picking bug fix from #220 : update custom functions Thanks \@aeudes
• Fix F10 is ambiguous (#219)
• fix compilation and add feature #218
• qwt updated
• appImage instructions updated
• Contributors: Davide Faconti, alexandre eudes

2.3.6 (2019-10-16)

• fix issue #215
• Contributors: Davide Faconti

2.3.5 (2019-10-11)

• remember the size of the splitter
• fix inveted XY
• Contributors: Davide Faconti
• remember last splashscreen
• Update README.md
• Update appimage_howto.md
• fix warning
• meme fixed
• Contributors: Davide Faconti

2.3.4 (2019-10-03)

• prepare \"meme edition\"
• Merge branch \'master\' of https://github.com/facontidavide/PlotJuggler
• RosMsgParsers: add cast to be clang compatible (#208)
• Update README.md
• Update FUNDING.yml
• Correct \"Github\" to \"GitHub\" (#206)
• 2.3.3
• fix issue with FMT
• Contributors: Dan Katzuv, Davide Faconti, Timon Engelke

2.3.3 (2019-10-01)

• removed explicit reference to Span
• remove abseil dependency (to be tested)
• Contributors: Davide Faconti

2.3.2 (2019-09-30)

• always use random color in addCurveXY
• Fix issue #204
• Fix issue #203
• Add missed absl Span<T> header include
• Add missed abseil_cpp depend
• Contributors: Davide Faconti, Enrique Fernandez

2.3.1 (2019-09-24)

• Fix #202 use_header_stamp not initialized for built-in types
• Merge pull request #200 from aeudes/multiple_streamer data stream topic plugin
• new color palette
• Allow to have working datastreamtopic plugin in more than one plotjuggler instance
• adding covariance to Odometry msg again
• fix issue #187
• Fix segfault when swap plotwidget on archlinux (qt5.12.3). This bug is introduced in: 7959e54 Spurious DragLeave fixed? And produce a segfault(nullptr) in QCursor::shape() call by QBasicDrag::updateCursor(Qt::DropAction) [trigger by plotwidget.cpp:1352 drag->exec();]. It seems to me that the change of global application cursor on leave event during drag drop operation cause the problem [is it the drop widget duty to reset cursor?].
• minor fixes related to dark theme
• Contributors: Alexandre Eudes, Davide Faconti

2.3.0 (2019-07-11)

• Countless changes and merges of PR.
• Contributors: Alexandre Eudes, Davide Faconti, Juan Francisco Rasc