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: about 2 months ago
JSON representation

The Time Series Visualization Tool that you deserve.

Host: GitHub
URL: https://github.com/facontidavide/PlotJuggler
Owner: facontidavide
License: mpl-2.0
Created: 2016-03-01T21:05:42.000Z (almost 9 years ago)
Default Branch: main
Last Pushed: 2024-08-10T14:19:23.000Z (4 months ago)
Last Synced: 2024-10-17T16:41:27.970Z (about 2 months ago)
Topics: chart, csv, labstreaminglayer, lua, mqtt, plot, px4, qt5, ros, rosbag, time-series, ulog, visualize-data
Language: C++
Homepage: https://www.plotjuggler.io
Size: 54.6 MB
Stars: 4,392
Watchers: 87
Forks: 614
Open Issues: 168
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.rst
- Funding: .github/FUNDING.yml
- License: LICENSE.md

Awesome Lists containing this project

awesome-robotics - PlotJuggler - Quickly plot and re-plot data on the fly! Includes optional ROS integration. (Uncategorized / Uncategorized)
awesome-time-series - time series visualization tools
awesome-ros-tools - PlotJuggler - 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 ![PlotJuggler](https://img.shields.io/github/stars/facontidavide/PlotJuggler.svg?style=flat&label=Star&maxAge=86400) (Visualization / Extracting data)
awesome-robotic-tooling - PlotJuggler - The timeseries visualization tool that you deserve. (Data Visualization and Mission Control / Command Line Interface)
awesome-robotic-tooling - PlotJuggler - The timeseries visualization tool that you deserve (Interaction / Data Visualization and Mission Control)
AwesomeCppGameDev - PlotJuggler
awesome-canbus - PlotJuggler - The Powerful Time Series Visualization Tool (With panda hardware, cabana and plotjuggler, you can quickly RE the entire car in a few days). (Utils / GUI Tools)
awesome-starred - facontidavide/PlotJuggler - The Time Series Visualization Tool that you deserve. (lua)

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.0-installer](https://github.com/facontidavide/PlotJuggler/releases/download/3.9.0/PlotJuggler-Windows-3.9.0-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