Bokeh Tutorial

A1. Additional resources

Additional resources

There are lots of things we haven't had time to tell you about. In general to learn more about bokeh, the following resources will hopefully be helpful:

Doumentation

Main Page - http://bokeh.pydata.org/en/latest

The main documentation front page, with links to many other resources


User's Guide - http://bokeh.pydata.org/en/latest/docs/user_guide.html

The user's guide has many top-oriented subsections, for example "Plotting with Basic Glyphs", "Configuring Plot Tools", or "Adding Interactions". Each user's guide section typically example code and corresponding live plots that demomnstrate how to accomplish various tasks.


One of the best ways to learn is to find an existing example similar to what you want, and to study it and then use it as a starting place. Starting from a known working example can often save time and effort when getting started by allowing you to make small, incremental changes and observing the outcome. The Bokeh docs have a large thumbnail gallery that links to live plots and apps with corresponding code.


Reference Guide - http://bokeh.pydata.org/en/latest/docs/reference.html

If you are already familiar with Bokeh and have questions about specific details of the obejcts you are already using, the reference guide is a good resource for finding information. The reference guide is automatically generated from the project source code and is a complete resources for all bokeh models and their properties.


Search page - http://bokeh.pydata.org/en/latest/search.html

If you want to search the Bokeh docs, the search page on the site is the best place. General web searches can sometime return results for old versions or out of date information. The site search always returns information for the latest version, and results for any older versions in separate tabs.

Example apps and Scripts

In addition to all the live gallery examples, Bokeh has many additional scripts and apps that can be instructive to study and emulate.

Examples folder - https://github.com/bokeh/bokeh/tree/master/examples/

The examples directory has many subfolders dedicated to different kinds of topics. Some of the hightlights are:

  • app - example Bokeh apps, run with "bokeh serve"
  • charts - examples using the bokeh.charts interface
  • howto - some examples arranged around specific topics such as layout or notebook comms
  • plotting - a large collections of examples using the bokeh.plotting interface
  • webgl - some examples demonstrating WebGL usage

Example zipfile

To make the things easier to obtain, a zip file of just the examples is also available at

https://cdn.pydata.org/bokeh/examples/examples-<x.y.z>.zip

For example, the examples zipfile for the 0.12.2 release can be found at:

https://cdn.pydata.org/bokeh/examples/examples-0.12.2.zip

General Commnity Support

Bokeh has a large and growing community. The best place to go for general support questions (either to ask, or to answer!) is one of the community support resources listed below.

Project Development

Source code - https://github.com/bokeh/bokeh

Go here to clone the GitHub repo (in order to contribute or get the examples), or to submit issues to the issue tracker


Issue tracker - https://github.com/bokeh/bokeh/issues

The GitHub issue tracker is the place to go to submit bug reports and feature requests. For general support questions, see the "General Community Support" links above.


Developer's Guide - http://bokeh.pydata.org/en/latest/docs/dev_guide.html

If you are interesting in becoming a conributor to Bokeh, the developer's guide is the place to start. It has information about getting a development environment set up, the library arhcitecture, writing and running tests,