Matlab-inspired call syntax for bokeh plots
Project description
bokeh-plot
Installation:
pip install bokeh-plot
Usage:
To load this extension in jupyter notebook:
%load_ext bokeh_plot
The following syntax is supported:
plot([1,4,9]) # x is automatic
plot([1,4,9], '.-') # line and dots
plot([1,2,3], [1,4,9]) # x and y
plot([1,2,3], [1,4,9], '.-') # x, y and line style
Several plots in one figure:
Interactive controls:
click and drag = pan
mouse wheel = zoom,
wheel on x axis = scroll horizontally
wheel on y axis = scroll vertically
Multiple plot syntax (equivalent ways to draw it):
x = [1,5,10]
y1 = [1,4,9]
y2 = [1,8,27]
- plot(x, y1, '.-') # solid line with dots
plot(x, y2, '.-g') # the second plot is green
- plot([y1, y2]) # auto x, auto colors
- plot(x, [y1, y2])
- plot([y1, y2], '.-bg') # blue and green
- plot([y1, y2], style=['.', '.-'], color=['b', 'g'])
- plot(x, y1, '.-', x, y2, '.-g')
The following markers are supported so far:
'.' dots
'-' line
'.-' dots+line
The following colors are supported so far:
'b' blue
'g' green
'r' red
'O' orange (capital O to avoid clashes with 'o' for open dots)
NB The color specifier must go after the marker if both are present.
Legend:
- plot([1,2,3], [1,4,9], label='plot1')
plot([1,2,3], [2,5,10], label='plot2')
- plot([y1, y2], label=['y1', 'y2'])
Legend location:
- plot([1,2,3], [1,4,9], label='plot1', legend_loc='top_left')
plot([1,2,3], [2,5,10], label='plot2')
Other legend locations: https://docs.bokeh.org/en/latest/docs/user_guide/styling.html#location
Axes labels:
- plot([1,2,3], xlabel='time', ylabel='value')
- xlabel('time'); ylabel('value')
- xylabels('time', 'value')
Several images side by side:
(bp stands for bokeh.plot, bl is is a shortcut for bokeh.layouts)
There're three common layouts: bl.row
, bl.column
and bl.gridplot
(the former two accept list of figures,
the latter one accepts a list of lists of figures).
Other uses:
-
semilogx()
,semilogy()
andloglog()
show (semi)logarithmic plots with the same syntax asplot()
. -
hist(x)
displays a histogram of x -
plot(x, y, hover=True)
displays point coordinates on mouse hover. -
plot(x, y, vline=1, hline=1.5, vline_color='red')
in addition to the (x, y) plot displays an infinite vertical line with x=1 and custom red color and an infinite horizontal line with y=1.5 and the default pink color. -
plot(df)
plots all columns of the dataframe as separate lines on the same figure with column names displayed in the legend and with index taken as the x axis values. If the legend grows too long, it can be hidden withlegend_loc='hide'
(new in v0.1.13):
show_df(df)
displays pandas dataframe as a table (new in v0.1.14):
imshow(a)
displays an array as an image:
Complete list of palettes: https://docs.bokeh.org/en/latest/docs/reference/palettes.html
See also a contour plot example in the bokeh gallery page
Comparison to bokeh
bokeh-plot is a thin wrapper over the excellent bokeh library that cuts down the amount of boilerplate code.
The following two cells are equivalent:
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
File details
Details for the file bokeh_plot-0.1.22.tar.gz
.
File metadata
- Download URL: bokeh_plot-0.1.22.tar.gz
- Upload date:
- Size: 12.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/59.6.0 requests-toolbelt/0.9.1 tqdm/4.64.0 CPython/3.7.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 09eed693b289b384ec3e0342a6e2c1e5858a7f3dcae0c99679529a760a9d0da8 |
|
MD5 | 0729d7b1adb6673d096f421209e0e1ec |
|
BLAKE2b-256 | 0bcfe18a85bca4229430e718eb5783f1ab51e15c41c6cc2af085f38f28d091fe |
File details
Details for the file bokeh_plot-0.1.22-py3-none-any.whl
.
File metadata
- Download URL: bokeh_plot-0.1.22-py3-none-any.whl
- Upload date:
- Size: 13.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/2.0.0 pkginfo/1.5.0.1 requests/2.22.0 setuptools/59.6.0 requests-toolbelt/0.9.1 tqdm/4.64.0 CPython/3.7.7
File hashes
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1bfeee44de97e3c868586477fd34632e097fe199531e2a3c944f84e532174524 |
|
MD5 | 73c975c94e62752a67a8e5ef5e2db42e |
|
BLAKE2b-256 | 9f345c7fbd831dbc6f6a30bf512e5e481960a816790246818cdcb7bd5a996ad0 |