fastplotlib

A fast plotting library built using the pygfx render engine that can use Vulkan, so it is very fast!

Checkout pygfx! https://github.com/pygfx/pygfx

fastplotlib is in the alpha stage and experimental but you're welcome to try it out or contribute!

Questions, ideas? Chat on gitter: https://gitter.im/fastplotlib/community?utm_source=share-link&utm_medium=link&utm_campaign=share-link

Examples

See the examples directory. Start out with simple.ipynb which uses the high level API.

Simple image plot

from fastplotlib import Plot
import numpy as np

plot = Plot()

data = np.random.rand(512, 512) * 255
plot.image(data=data,  vmin=0, vmax=255, cmap='viridis')

plot.show()

Fast image updates (video)

from fastplotlib import Plot
import numpy as np

plot = Plot()

data = np.random.rand(512, 512) * 255
image = plot.image(data=data,  vmin=0, vmax=255, cmap='viridis')

def update_data():
    new_data = np.random.rand(512, 512) * 255
    image.update_data(new_data)

plot.add_animations([update_data])

plot.show()

Installation

Install directly from GitHub.

git clone https://github.com/kushalkolar/fastplotlib.git
cd fastplotlib
pip install -r requirements.txt
pip install -e .

# try the examples
cd examples
jupyter lab

Don't install from PYPI, fastplotlib is in the alpha stage, the pip package is not regularly updated yet.

You will need a GPU that supports Vulkan (iGPUs in CPUs should be fine). Generally if your GPU is from 2017 or later it should support Vulkan.

Install Vulkan drivers and other stuff

For more information see: https://github.com/pygfx/wgpu-py#platform-requirements

Windows:

Apparently Vulkan should be installed by default on Windows 11.

Linux:

Debian based distros:

sudo apt install mesa-vulkan-drivers
# for better performance with the remote frame buffer install libjpeg-turbo
sudo apt install libjpeg-turbo

For other distros install the appropriate vulkan driver package.

Mac OSX:

You will need at least MacOSX v10.13, not sure how to install Vulkan drivers on Mac. If anyone knows you can add instructions here!

Extremely fast image updates, 5 x 5 gridplot

https://www.youtube.com/embed/-_0Gp_EqepI

Very fast image updates with some synced controllers

fpl_fast_image_updates.mp4

Scatter plot

fastplotlib_scatter-2022-04-27_01.47.27.mp4

Lineplot

fpl_lineplot.mp4