Dynamic Live Plot is a simple way to plot data live and nonblocking. It is capable of dynamically adding and removing plots and graph glyphs during runtime. This is especially useful, if you do not know, which data will occour during runtime. This might be the case in a sensornetwork, where nodes may emerge, or disappear.
Its usage is extremely simplyfied. By calling just one method, plots can be updated by new data. Inbetween these updates of the plots, blocking computation can be done without stopping the live plot from working.
The software depends on Python Bokeh. It strongly utilizes features of Bokeh like its server or "next tick callbacks". Its main class basically is an abstraction of embedding Bokeh Server as a library (also see the standalone_embed.py). To make the update calls non-blocking it extends threading.Thread.
The only class method is push_data(). Its purpose is to tell BokehLivePlot which data to plot. It accepts a nested dictionary as argument:
- Outer dictionary: Figures to plot
- Inner dictionary: Lines of data, represented by numpy arrays (which is recommended by Python Bokeh)
Following example shows the usage of the class BokehLivePlot:
# import bokeh_live_plot
import dynamic_live_plot.bokeh_live_plot as blp
import time
# create BokehLivePlot object
myplot = blp.BokehLivePlot()
# inject data for plotting
myplot.push_d(dict(FirstPlot=dict(plotA=np.array([0.1, 0.2, 0.3]), plotb=np.array([0.2, 0.3, 0.4]))
# do blocking computation (maybe for data acquisition)
time.sleep(.2)
# inject further data for plotting
myplot.push_d(dict("FirstPlot"=dict("plotA=np.array([0.3, 0.2, 0.1]), plotb=np.array([0.4, 0.2, 0.3]))The easiest way to find out about JupyterLivePlot is the following
- clone or download this repository and cd to the bokeh folder (
git clone https://github.com/ticktronaut/dynamic_live_plot.git && cd dynamic_live_plot/notebooks) - start a jupyter server in this directory (
jupyter-server) - launch the jupyter_live_plot_sample.ipynb dictionary for further details on the usage of JupyterLivePlot
Go to the examples directory:
cd examplesStart the example script:
python blp_sample.pyBokehLivePlot strongly depends on Python Bokeh, which is licensed under BSD 3-Clause.
Clone (or download, if desired) the repository:
git clone https://github.com/ticktronaut/dynamic_live_plot.gitGo to the directory:
cd dynamic_live_plotInstall the package:
python setup.py install