Ubuntu 14.04 build (Semaphore):

ROS Indigo/Kinetic build (Travis):

PlotJuggler 2.1.X

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

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.

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

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

PlotJuggler-2.1.2-x86_64.AppImage.

Do not forget to make it executable with the command

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

How to build (non ROS users)

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

On Fedora:

sudo dnf install qt5-qtbase-devel qt5-qtsvg-devel qt5-qtdeclarative-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 ros-kinetic-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 any of these platforms: BuyMeACoffe, PayPal or LiveraPay.

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.1.2 (2019-02-13)

• legend button now has three states: left/right/hide
• replace tracker text when position is on the right side
• allow again to use the header.stamp
• fix problem with legend visibility
• Save all tab plots as images in a folder. (#137)
• Make default filename for tab image the tab name (#136)
• Update README.md
• adding instructions to build AppImage
• Contributors: Davide Faconti, d-walsh

2.1.1 (2019-02-07)

• Added filter to function editor
• ask for support
• cleanup
• fix issue with Datetime and cheatsheet dialog
• further stylesheet refinements
• fixing visualization of fucntion editor dialog
• fixing html of cheatsheet
• Contributors: Davide Faconti

2.1.0 (2019-02-07)

• minor change
• stylesheet fix
• Cheatsheet added
• fixing style
• improved magnifier ( issue #135)
• added zoom max
• Contributors: Davide Facont, Davide Faconti

2.0.7 (2019-02-06)

• fix for dark layout
• fix issue with edited function transforms
• about dialog updated
• added more key shortcuts
• reverted behaviour of Dialog \"delete previous curves\"?
• fix glitches related to drag and drop
• update timeSlider more often
• play seems to work properly for both sim_time and rewritten timestamps
• play button added
• clock published
• remove timestamp modifier
• Contributors: Davide Faconti

2.0.5 (2019-02-05)

• fix problem in build farm
• bug fix plot XY
• Contributors: Davide Faconti

2.0.4 (2019-01-29)

• add parent to message boxes
• ask confirmation at closeEvent()
• fix problem with selection of second column
• fix issue 132
• simplification
• minor bug fixed in filter of StatePublisher
• Contributors: Davide Facont, Davide Faconti

2.0.3 (2019-01-25)

• adding descard/clamp policy to large arrays
• fix problem with table view resizing
• make size of fonts modifiable with CTRL + Wheel (issue #106)
• Update .travis.yml
• Contributors: Davide Faconti

2.0.2 (2019-01-23)

• should solve issue #127 : stop publishers when data reloaded or deleted
• fixing issues whe disabling an already disabled publisher
• solved problem with time slider (issue #125)
• fix issue #126
• StatePublisher improved
• Contributors: Davide Faconti

2.0.1 (2019-01-21)

• important bug fix. Removed offset in X axis of PlotXY
• fix minor visualization issue.
• Contributors: Davide Faconti

1.9.0 (2018-11-12)

• version bump
• Spurious DragLeave fixed? (The worst and most annoying bug of PlotJuggler)
• adjust font size in left panel
• CMAKE_INSTALL_PREFIX flag fix for non-ROS user (#114)
• adding improvements from \@aeudes , issue #119 1) Improved RemoveCurve dialog (colors and immediate replot) 2) Fixed QMenu actions zoom horizontally and vertically 3) Fix issue with panner and added Mouse Middle Button
• minor changes
• Merge branch \'master\' of https://github.com/facontidavide/PlotJuggler
• speed up loading rosbags (5%-10%)
• custom qFileDialog to save the Layout
• minor changes
• Contributors: Davide Faconti, Mat&I

1.8.4 (2018-09-17)

• add tooltip
• fix issue #109
• CMakeLists.txt add mac homebrew qt5 install directory (#111)
• Merge pull request #107 from v-lopez/master
• Fix dragging/deletion of hidden items
• Contributors: Andrew Hundt, Davide Faconti, Victor Lopez

1.8.3 (2018-08-24)

• bug fix (crash when detaching a _point_marker)
• more informative error messages
• cleanups
• more compact view and larger dummyData
• Contributors: Davide Faconti

1.8.2 (2018-08-19)

• bug fix (crash from zombie PlotMatrix)
• Contributors: Davide Faconti

1.8.1 (2018-08-18)

• message moved back to the ROS plugin
• More informative dialog (issue #100)
• many improvements related to FilteredTableListWidget, issue #103
• Contributors: Davide Faconti

1.8.0 (2018-08-17)

• fixing splash time
• minor update
• fix issue #49
• README and splashscreen updates
• Update ISSUE_TEMPLATE.md
• F10 enhancement
• preparing release 1.8.0
• (speedup) skip _completer->addToCompletionTree altogether unless Prefix mode is active
• avoid data copying when loading a datafile
• fix issue #103
• workaround for issue #100
• trying to fix problem with time offset durinh streaming
• removed enableStreaming from StreamingPlugins
• several useless replot() calls removed
• more conservative implementation of setTimeOffset
• optimization
• reduced a lot the amount of computation related to addCurve()
• bug fix
• Update .appveyor.yml
• bug fix (_main_tabbed_widget is already included in TabbedPlotWidget::instances())
• remove bug (crash at deleteDataOfSingleCurve)
• make PlotData non-copyable
• change in sthe state publisher API
• shared_ptr removed. To be tested
• WIP: changed the way data is shared
• added suggestion from issue #105
• skip empty dataMaps in importPlotDataMap() . Issue #105
• fix issue #102 (grey background)
• Contributors: Davide Faconti

1.7.3 (2018-08-12)

• enhancement discussed in #104 Can clear buffer while streaming is active
• adding enhancements 4 and 5 from issue #105
• fixed bug reported in #105
• fix critical error
• fix issue #101
• Contributors: Davide Faconti

1.7.2 (2018-08-10)

• Update .travis.yml
• fixed potential thread safety problem
• trying to apply changes discussed in issue #96
• add transport hint
• make hyperlinks clickable by allowing to open external links (#95)
• Contributors: Davide Faconti, Romain Reignier
• Update .travis.yml
• fixed potential thread safety problem
• trying to apply changes discussed in issue #96
• add transport hint
• make hyperlinks clickable by allowing to open external links (#95)
• Contributors: Davide Faconti, Romain Reignier

1.7.1 (2018-07-22)

• catch exceptions
• fix resize of PlotData size. Reported in issue #94
• Contributors: Davide Faconti

1.7.0 (2018-07-19)

• fixing issue #93 (thread safety in XYPlot and streaming)
• fix issue #92
• bug fix
• Issue #88 (#90)
• Reorder header files to fix conflicts with boost and QT (#86)
• Contributors: Davide Faconti, Enrique Fern