facontidavide/PlotJuggler
The Time Series Visualization Tool that you deserve.
repo name | facontidavide/PlotJuggler |
repo link | https://github.com/facontidavide/PlotJuggler |
homepage | https://www.plotjuggler.io |
language | C++ |
size (curr.) | 42018 kB |
stars (curr.) | 1931 |
created | 2016-03-01 |
license | GNU Lesser General Public License v3.0 |
PlotJuggler 3.0
PlotJuggler is a tool to visualize time series that is fast, powerful and intuitive.
Noteworthy features:
- Simple Drag & Drop user interface.
- Load data from file.
- Connect to live streaming of data.
- Save the visualization layout and configurations to re-use them later.
- Fast OpenGL visualization.
- Can handle thousands of timeseries and millions of data points.
- Transform your data using a simple editor: derivative, moving average, integral, etc…
- PlotJuggler can be easily extended using plugins.
Data sources (file and streaming)
- Load CSV files.
- Load ULog (PX4).
- Subscribe to many different streaming sources: MQTT, Websockets, ZeroMQ, UDP, etc.
- Understands data formats such as JSON, CBOR, BSON, Message Pack, etc.
- Well integrated with ROS: open rosbags and/or subscribe to ROS topics (both ROS1 and ROS2).
- Supports the Lab Streaming Layer, that is used by many devices.
- Easily add your custom data source and/or formats…
Transform and analyze your data
PlotJuggler makes it easy to visualize data but also to analyze it. You can manipulate your time series using a simple and extendable Transform Editor.
Alternatively, you may use the Custom Function Editor, that allows you to create Multi-input / Single-output functions using a scripting language based on Lua.
If you are not familiar with Lua, don’t be afraid, you won’t need more than 5 minutes to learn it ;)
Just “Download and Run”
On Linux, the simplest way to install PlotJuggler is through snaps:
Windows Installer: PlotJuggler_WIN_Installer-2.8.4.exe
How to build
Clone the repository as usual:
git clone --recurse-submodules 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 the command:
sudo apt -y install qtbase5-dev libqt5svg5-dev libqt5websockets5-dev libqt5opengl5-dev
On Fedora:
sudo dnf install qt5-qtbase-devel qt5-qtsvg-devel qt5-websockets-devel qt5-qtopendl-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.
Note for ROS users
To install PlotJuggler, just type:
sudo apt install ros-${ROS_DISTRO}-plotjuggler-ros
And run it with:
roslaunch plotjuggler_ros plotjuggler.launch
Since version 3.x, ROS plugins have been moved to a separate repository:
https://github.com/PlotJuggler/plotjuggler-ros-plugins
Refer to the instructions in the this repository if you want to compile PJ and its ROS plugins from source.
If you like PlotJuggler, support it.
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 become a Github Sponsor.
If you use PlotJuggler at work, your company can support the development of those specific features they need.
Contact me for more details.