Bokeh Glyph Quick Reference

This section is intended to give a quick overview of what properties all the various Bokeh glyphs support. For complete details, consult the full Reference Guide.

annular_wedge

The annular_wedge glyph displays annular wedges centered at the given coordinates with the corresponding start_radius, end_radius, start_angle and end_angle.

Note

the direction field may be used to indicate which direction the drawing should occur between start_radius and end_radius.

  • x, y - center point coordinates
  • start_radius
  • end_radius
  • start_angle
  • end_angle
  • direction
    • values: 'clock', 'anticlock'
    • default: 'anticlock'
  • Line Properties
  • Fill Properties

annulus

The annulus glyph displays annular rings centered at the given coordinates with the corresponding start_radius and end_radius.

arc

The annulus glyph displays circular line arcs centered at the given coordinates with the corresponding radius, start_angle and end_angle.

Note

the direction field may be used to indicate which direction the drawing should occur between start_radius and end_radius.

  • x, y - center point coordinates
  • radius
  • start_angle
  • end_angle
  • direction
    • values: ['clock' or 'anticlock']
    • default: 'anticlock'
  • Line Properties

asterisk

The asterisk glyph is a marker that displays asterisks at the given coordinates.

bezier

The bezier glyph displays Bezier curves with the given starting, ending, and control points.

  • x0, y0 - starting point coordinates
  • x1, y1 - ending point coordinates
  • cx0, cy0 - first control point coordinates
  • cx1, cy1 - second control point coordinates
  • Line Properties

circle

The circle glyph has two forms, a marker form that takes a size field or a non-marker form that takes a radius field.

circle_cross

The circle_cross glyph is a marker that displays circles together with a crossbar (+) at the given coordinates.

circle_x

The circle_x glyph is a marker that displays circles together with an X at the given coordinates.

cross

The cross glyph is a marker that displays crossbar symbols (+) at the given coordinates.

diamond

The diamond glyph is a marker that displays diamonds at the given coordinates.

diamond_cross

The diamond_cross glyph is a marker that displays diamonds together with a crossbar (+) at the given coordinates.

image

The image glyph takes each image as a two-dimensional array of data. A palette (string name of a built-in palette, currently) must also be supplied to use for color-mapping the scalar image.

Note

the dilate field may be used to indicate whether computed pixel distances (e.g. for dw, dh) should always be rounded up when rendering this glyph.

Note

The image glyph is vectorized like other glyphs, i.e. it may be used to display several images at once.

  • image - 2D array of data
  • x, y - lower left
  • dw - width on screen
  • dh- height on screen
  • palette
  • dilate
    • default: False

image_rgba

The image_rgba glyph takes each image as a two-dimensional array of RGBA values (encoded as 32-bit integers).

Note

the dilate field may be used to indicate whether computed pixel distances (e.g. for dw, dh) should always be rounded up when rendering this glyph.

Note

The image_rgba glyph is vectorized like other glyphs, i.e. it may be used to display several images at once.

  • image - 2D array of RGBA
  • x, y - lower left
  • dw - width on screen
  • dh- height on screen
  • dilate
    • default: False

image_url

The image_url glyph accepts the URLs of an images to display. The images are centered on the given coordinates and rotated by the given angles.

  • x, y - center point coordinates
  • url
  • angle

inverted_triangle

The inverted_triangle glyph is a marker that displays upside-down triangles at the given coordinates.

line

The line glyph displays a single line that connects several points given by the arrays of coordinates x and y.

multi_line

The multi_line glyph displays several lines, each with points given by the arrays of coordinates that are the elements of xs and ys. This glyph is especially useful for implementing parallel coordinates plots, or plotting several aligned series simultaneously.

Note

For this glyph, the vector data is not simply an array of scalars, it is really an “array of arrays”.

oval

The oval glyph displays ovals centered on the given coordinates with the given dimensions and angle.

patch

The patch glyph displays a single polygonal patch that connects several points given by the arrays of coordinates x and y.

patches

The patches glyph displays several patches, each with points given by the arrays of coordinates that are the elements of xs and ys. This glyph is especially useful for implementing stacked area charts and cartograms.

Note

For this glyph, the vector data is not simply an array of scalars, it is really an “array of arrays”.

quad

The quad glyph displays axis-aligned rectangles with the given dimensions.

quadratic

The quadratic glyph displays quadratic curves with the given starting, ending, and control points.

  • x0, y0 - starting point coordinates
  • x1, y1 - ending point coordinates
  • cx, cy - control point coordinates
  • Line Properties

ray

The ray glyph displays line segments starting at the given coordinate and extending the given length at the given angle.

  • x0, y0 - starting point coordinates
  • length - screen units
  • angle
    • default: 0
  • Line Properties

rect

The rect glyph displays rectangles centered on the given coordinates with the given dimensions and angle.

Note

the dilate field may be used to indicate whether computed pixel distances should always be rounded up when rendering this glyph.

segment

The segment glyph displays line segments with the given starting and ending coordinates.

  • x0, y0 - starting point coordinates
  • x1, y1 - ending point coordinates
  • Line Properties

square

The square glyph is a marker that displays squares at the given coordinates.

square_cross

The square_cross glyph is a marker that displays squares together with a crossbar (+) at the given coordinates.

square_x

The square_x glyph is a marker that displays squares together with an X at the given coordinates.

text

The text glyph displays text at the given coordinates rotated by the given angle. The location of the coordinates relative to the text is indicated by the text properties.

  • x, y - text coordinates (positioning determined by text properties)
  • text
  • angle
    • default: 0
  • Text Properties

triangle

The triangle glyph is a marker that displays triangles at the given coordinates.

wedge

The annular_wedge glyph displays circular wedges centered at the given coordinates with the corresponding radius, start_angle and end_angle.

Note

the direction field may be used to indicate which direction the drawing should occur between start_radius and end_radius.

  • x, y - center point coordinates
  • radius
  • start_angle
  • end_angle
  • direction
    • values: ['clock' or 'anticlock']
    • default: 'anticlock'
  • Line Properties
  • Fill Properties

x

The x glyph is a marker that displays X symbols at the given coordinates.