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

PlotJuggler 2.1.10

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 to get your hands dirty, just download this AppImage:

PlotJuggler-2.1.10-x86_64.AppImage.

Do not forget to make it executable with the command

chmod +x ./PlotJuggler-2.1.10-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 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.10 (2019-03-29)

• critical bug fixed in CustomFunctions
• Contributors: Davide Faconti

2.1.9 (2019-03-25)

• QwtRescaler replaced
• fix issues related to #118 (PlotZoom)
• Contributors: Davide Faconti

2.1.8 (2019-03-24)

• bug fixes
• xy equal scaling seems to work
• Super fancy Video cheatsheet (#164)
• better date display
• Fix issue #161 and remember last directory used
• mainwindow - use yyyy-MM-dd_HH-mm-ss name when saving a plot as png. This allows to save several times without having to rename the previous image (#162)
• Contributors: Davide Faconti, bresch

2.1.7 (2019-03-20)

• Date time visualization on X axis
• fix slow PLAY when rendering takes more than 20 msec
• new way to zoom a single axis (issues #153 and #135)
• Inverted mouse wheel zoom #153
• On MacOS there are several mime formats generated in addition to \"curveslist\", this fix will keep curves array with names collected instead of resetting it for each new mime format. (#159)
• ulog_parser: fixed parsing of array topics (#157) Signed-off-by: Roman <bapstroman@gmail.com>
• fis issue #156 : catch expections
• remember if the state of _action_clearBuffer
• QSettings cleanups
• Contributors: Alexey Zaparovanny, Davide Faconti, Roman Bapst

2.1.6 (2019-03-07)

• removed obsolate question
• remember RemoveTimeOffset state
• add clear buffer from data stream
• reject non valid data
• fix sorting in ULog messages
• Fix Ulog window
• ulog plugin improved
• Update .appveyor.yml
• yes, I am sure I want to Quit
• simplifications in RosoutPublisher
• better double click behavior in FunctionEditor
• adding Info and parameters
• big refactoring of ulog parser. Fix issue #151
• download links updated
• Contributors: Davide Faconti

2.1.5 (2019-02-25)

• reintroducing timestamp from header
• added way to create installer
• disable zooming during streaming and reset tracker when new file loaded
• Contributors: Davide Faconti

2.1.4 (2019-02-21)

• Fix issues #146: ULog and multiple instances of a message
• close issue #138
• remove svg dependency
• Appveyor fixed (#144)
• fancy menubar
• Contributors: Davide Faconti

2.1.3 (2019-02-18)

• BUG: fixed issue with Customtracker when the plot is zoomed
• new icons
• ULog plugin added
• Allow to build the DataStreamClientSample on Linux (#143)
• Update README.md
• Contributors: Davide Faconti, Romain Reignier

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