Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/facontidavide/plotjuggler

The Time Series Visualization Tool that you deserve.
https://github.com/facontidavide/plotjuggler

chart csv labstreaminglayer lua mqtt plot px4 qt5 ros rosbag time-series ulog visualize-data

Last synced: 21 days ago
JSON representation

The Time Series Visualization Tool that you deserve.

Awesome Lists containing this project

README 

          
![PlotJuggler](docs/plotjuggler3_banner.svg)



[![windows](https://github.com/facontidavide/PlotJuggler/actions/workflows/windows.yaml/badge.svg)](https://github.com/facontidavide/PlotJuggler/actions/workflows/windows.yaml)

[![ubuntu](https://github.com/facontidavide/PlotJuggler/actions/workflows/ubuntu.yaml/badge.svg)](https://github.com/facontidavide/PlotJuggler/actions/workflows/ubuntu.yaml)

[![macos](https://github.com/facontidavide/PlotJuggler/actions/workflows/macos.yaml/badge.svg)](https://github.com/facontidavide/PlotJuggler/actions/workflows/macos.yaml)

[![ROS1](https://github.com/facontidavide/PlotJuggler/workflows/ros1/badge.svg)](https://github.com/facontidavide/PlotJuggler/actions?query=workflow%3Aros1)

[![ROS2](https://github.com/facontidavide/PlotJuggler/workflows/ros2/badge.svg)](https://github.com/facontidavide/PlotJuggler/actions?query=workflow%3Aros2)

[![Tweet](https://img.shields.io/twitter/url/http/shields.io.svg?style=social)](https://twitter.com/intent/tweet?text=I%20use%20PlotJuggler%20and%20it%20is%20amazing%0D%0A&url=https://github.com/facontidavide/PlotJuggler&via=facontidavide&hashtags=dataviz,plotjuggler,GoROS,PX4)



## Gold Sponsor:

[![Greenzie](docs/sponsor_greenzie.png)](https://www.greenzie.com/)

[![Intermodalics](docs/sponsor_intermodalics.png)](https://www.intermodalics.ai/)

[![Greenzie](docs/sponsor_ark.png)](https://arkelectron.com/)



# PlotJuggler 3.15



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 reuse 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__.



![PlotJuggler](docs/plotjuggler3.gif)



## Data sources (file and streaming)



- Load CSV files.

- Load [ULog](https://docs.px4.io/main/en/dev_log/ulog_file_format) (PX4).

- Subscribe to many different streaming sources: MQTT, WebSockets, ZeroMQ, UDP, etc.

- Understand data formats such as JSON, CBOR, BSON, Message Pack, etc.

- Well integrated with [ROS](https://www.ros.org/): open *rosbags* and/or subscribe to ROS *topics* (both ROS1 and ROS2).

- Supports the [Lab Streaming Layer](https://labstreaminglayer.readthedocs.io/info/intro.html), that is used by [many devices](https://labstreaminglayer.readthedocs.io/info/supported_devices.html).

- Easily add your custom data source and/or formats...



![](docs/data_sources.svg)



## 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.



![](docs/function_editor.png)



Alternatively, you may use the Custom Function Editor, which allows you to create Multi-input / Single-output functions

using a scripting language based on [Lua](https://www.tutorialspoint.com/lua/index.htm).



If you are not familiar with Lua, don't be afraid, you won't need more than 5 minutes to learn it ;)



![](docs/custom_editor.png)



## Tutorials



To learn how to use PlotJuggler, check the tutorials here:



| Tutorial 1   |  Tutorial 2 | Tutorial 3 |

:-------------------------:|:-------------------------:|:-------------------------:

| [![](docs/tutorial_1.png)](https://slides.com/davidefaconti/introduction-to-plotjuggler) | [![](docs/tutorial_2.png)](https://slides.com/davidefaconti/plotjuggler-data) | [![](docs/tutorial_3.png)](https://slides.com/davidefaconti/plotjuggler-transforms) |



## Supported plugins



Some plugins can be found in a different repository. The individual README files

*should* include all the information needed to compile and use the plugin.



Please submit specific issues, Pull Requests and questions on the related Github repository:



- [MQTT DataStreamer](https://github.com/PlotJuggler/plotjuggler-mqtt).

- [Lab Streaming Layer DataStreamer](https://github.com/PlotJuggler/plotjuggler-lsl).

- [ROS plugins](https://github.com/PlotJuggler/plotjuggler-ros-plugins).

- [CAN .dbg DataLoader](https://github.com/PlotJuggler/plotjuggler-CAN-dbs).



If you want a simple example to learn how to write your own plugins, have a look at

[PlotJuggler/plotjuggler-sample-plugins](https://github.com/PlotJuggler/plotjuggler-sample-plugins)



# Installation



You can download the latest ready to use binaries from the [Release page](https://github.com/facontidavide/PlotJuggler/releases).






| 🐧 Linux | 🍎 macOS | 🪟 Windows | 📦 Debian |

|:--------:|:--------:|:----------:|:---------:|

| **AppImage** | **Installer** | **Installer** | **Packages** |

| x86 / arm64 | x86 / arm64 | x64 | bookworm, trixie |






## Snap (recommended in Ubuntu, to ROS users too)



The snap contains a version of PlotJuggler that works (with some limitations) with ROS2.



![Get it from the Snap Store](https://snapcraft.io/static/images/badges/en/snap-store-black.svg)



To install it in Ubuntu, run:



```

sudo snap install plotjuggler

```



### Debian packages for ROS User



Install the ROS packages with:



```

sudo apt install ros-$ROS_DISTRO-plotjuggler-ros

```

To launch PlotJuggler, use the command:



```

ros2 run plotjuggler plotjuggler

```



ROS plugins are available in a separate repository: https://github.com/PlotJuggler/plotjuggler-ros-plugins



Please take a look at the instructions in that repository if you want to compile PJ and its ROS plugins from source.



## Compile from source



You can find the detailed instructions here: [COMPILE.md](COMPILE.md).



# Sponsorship and commercial support



PlotJuggler required a lot of work to develop and maintain; my goal is to build the most

intuitive and powerful tool to visualize data and timeseries.



If you find PlotJuggler useful, consider donating [PayPal](https://www.paypal.me/facontidavide) or becoming a

[Github Sponsor](https://github.com/sponsors/facontidavide).



If you need to extend any of the functionalities of PlotJuggler to cover a specific

need or to parse your custom data formats, you can receive commercial

support from the main author, [Davide Faconti](mailto:davide.faconti@gmail.com).



# License



PlotJuggler is released under the [Mozilla Public License Version 2.0](LICENSE.md),

which allows users to develop closed-source plugins.



Please note that some third-party dependencies (including Qt) use the

**GNU Lesser General Public License**.



# Star History



[![Star History Chart](https://api.star-history.com/svg?repos=facontidavide/PlotJuggler&type=Date)](https://star-history.com/#facontidavide/PlotJuggler&Date)



# Contributors