Welcome to polt’s documentation!
polt
is a Python package for live data visualization via
matplotlib
. It includes a Command-Line Interface designed to be a universal tool to
plot data from various sources simulataneously. Check out the Data Flow for an overview of how data is gathered, processed and
displayed.
Note
polt
is not built for speed! It is intended to be easy to
use and quick to setup. If you need to display fast (i.e. rates
higher than hundreds of Hz) data in real time, you might be better off with
PyQtGraph.
polt
in action
You can use the Command-Line Interface to quickly visualize numbers from a process’ output:
polt generate -c walk --max-rate 20 | polt live
But the Command-Line Interface can do more like reading data in different formate from multiple sources and splitting the data into subplots:
polt generate \
-c "sensor1_temperature_celsius=uniform(20,25)" \
-c "sensor1_pressure_hPa=uniform(990,1020)" \
-c "sensor2_pressure_hPa=uniform(990,1020)" \
-c "sensor3_humidity_percent=uniform(10,90)" \
-c "sensor3_temperature_kelvin=uniform(0,300)" \
--max-rate 5 \
| polt \
add-source -p csv -o name=Data -o header-regex=key-quantity-unit \
live -o extrapolate=yes -o subplots-for=unit
Check the Command-Line Interface documentation to learn how to use it properly.
- Installation
- Quickstart
- Command-Line Interface
- Parsers
- Filters
- Animators
- Customizing
polt
- Extending
polt
- Changelog
- v1.1.0 - More filters
- v1.0.0 - MacOS Fixes and a MosquittoParser
- v0.12.1 - Changelog in the Sphinx Documenatation
- v0.12.0 - Keyboard Shortcut for Pretty Xaxis Date Format
- v0.11.1 - Fix automated PyPI upload
- v0.11.0 - Tight Layout Keyboard Shurtcut
- v0.10.0 - Introduce Filters
- v0.9.0 - Structural Improvements
- v0.8.0 - Live Histograms and Spectra and Data Generation
- v0.7.0 - Pausing, Custom Animators, Rate Limiting and More Documentation
- v0.6.0 - Prettier Subplots Arrangement
- v0.5.0 - Improved Timeseries Plotting
- v0.4.0 - Multiple Improvements
- v0.3.0 - Improved Command-Line Interface
- v0.2.0 - Improve Parsers
- v0.1.0 - Initial Version
- polt