Ecosyste.ms: Awesome

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

Awesome Lists | Featured Topics | Projects

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: 5 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](https://www.greenzie.com/)



# PlotJuggler 3.9



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



![PlotJuggler](docs/plotjuggler3.gif)



## Data sources (file and streaming)



- Load CSV files.

- Load [ULog](https://dev.px4.io/v1.9.0/en/log/ulog_file_format.html) (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



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



The snap contains a version of PlotJuggler that can work with either ROS1 or ROS2.



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



To install it in Ubuntu 22.04, with ROS2 support, run:



```

sudo snap install plotjuggler

```



If you are still using ROS1 (Ubuntu 20.04), install instead:



```

sudo snap install plotjuggler-ros

```



### Windows Binary installer



This installer does __not__ include ROS plugins.



**Windows Installer**:

[PlotJuggler-Windows-3.9.3-installer](https://github.com/facontidavide/PlotJuggler/releases/download/3.9.3/PlotJuggler-Windows-3.9.3-installer.exe)



### Debian packages for ROS User



Install the ROS packages with:



```

sudo apt install ros-$ROS_DISTRO-plotjuggler-ros

```

To launch PlotJuggler on ROS, use the command:



```

rosrun plotjuggler plotjuggler

```



or, if are using ROS2:



```

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:[email protected]).



# 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