Skip to main content

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() and loglog() show (semi)logarithmic plots with the same syntax as plot().

  • 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 with legend_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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

bokeh_plot-0.1.22.tar.gz (12.2 kB view details)

Uploaded Source

Built Distribution

bokeh_plot-0.1.22-py3-none-any.whl (13.7 kB view details)

Uploaded Python 3

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

Hashes for bokeh_plot-0.1.22.tar.gz
Algorithm Hash digest
SHA256 09eed693b289b384ec3e0342a6e2c1e5858a7f3dcae0c99679529a760a9d0da8
MD5 0729d7b1adb6673d096f421209e0e1ec
BLAKE2b-256 0bcfe18a85bca4229430e718eb5783f1ab51e15c41c6cc2af085f38f28d091fe

See more details on using hashes here.

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

Hashes for bokeh_plot-0.1.22-py3-none-any.whl
Algorithm Hash digest
SHA256 1bfeee44de97e3c868586477fd34632e097fe199531e2a3c944f84e532174524
MD5 73c975c94e62752a67a8e5ef5e2db42e
BLAKE2b-256 9f345c7fbd831dbc6f6a30bf512e5e481960a816790246818cdcb7bd5a996ad0

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page