CurveEdit

Download this notebook from GitHub (right-click to download).

---

Title: CurveEdit Stream

Description: A linked streams example demonstrating how to use the CurveEdit stream.

Dependencies: Bokeh

Backends: Bokeh

import numpy as np

import holoviews as hv
from holoviews import opts, streams
from holoviews.plotting.links import DataLink

hv.extension('bokeh')

The CurveEdit stream adds a bokeh tool to the source plot, which allows drawing, dragging and deleting points and making the drawn data available to Python. The tool supports the following actions:

Move vertex

Tap and drag an existing vertex, the vertex will be dropped once you let go of the mouse button.

Delete vertex

Tap a vertex to select it then press BACKSPACE or DELETE key while the mouse is within the plot area.

As a simple example we will create a CurveEdit stream and attach it to a Curve with a simple timeseries. By using a DataLink we then link the tool to a Table.

If we select the PointDraw tool () the vertices will appear and allow us to drag and delete vertex. We can also see the x/y position change in the table and edit it. To change the appearance of the vertices we can supply a style to the CurveEdit stream:

curve = hv.Curve(np.random.randn(10).cumsum())

curve_stream = streams.CurveEdit(data=curve.columns(), source=curve, style={'color': 'black', 'size': 10})

table = hv.Table(curve).opts(editable=True)
DataLink(curve, table)

(curve + table).opts(
    opts.Table(editable=True))

Whenever the data source is edited the data is synced with Python, both in the notebook and when deployed on the bokeh server. The data is made available as a dictionary of columns:

curve_stream.data

{'x': [np.float64(0.0),
  np.float64(1.0),
  np.float64(2.0),
  np.float64(3.0),
  np.float64(4.0),
  np.float64(5.0),
  np.float64(6.0),
  np.float64(7.0),
  np.float64(8.0),
  np.float64(9.0)],
 'y': [np.float64(-2.8672234298470953),
  np.float64(-2.6289078051555426),
  np.float64(-2.4261500550899653),
  np.float64(-1.684768826231626),
  np.float64(0.34528955071159806),
  np.float64(-0.16698408981726132),
  np.float64(-0.7636218134849678),
  np.float64(-1.9341867799370314),
  np.float64(-3.680144232365058),
  np.float64(-1.6512239534280324)]}

Alternatively we can use the element property to get an Element containing the returned data:

curve_stream.element

This web page was generated from a Jupyter notebook and not all interactivity will work on this website. Right click to download and run locally for full Python-backed interactivity.

---

Download this notebook from GitHub (right-click to download).