Title
Path3D Element
Dependencies
Plotly
Backends
Matplotlib
Plotly

In [ ]:
import numpy as np
import holoviews as hv
from holoviews import opts

hv.extension('plotly')

A Path3D element represents one more lines, connecting arbitrary points in three-dimensional space. Path3D supports plotting an individual line or multiple subpaths, which should be supplied as a list. Each path should be defined in a columnar format such as NumPy arrays, DataFrames or dictionaries for each column. For a full description of the path geometry data model see the Geometry Data User Guide.

As a simple example we will genrate a random walk through 3D space as a single array with three columns:


In [ ]:
line = np.random.randn(500, 3).cumsum(axis=0)
path = hv.Path3D(line)

path

Like the 2D equivalent Path also allows drawing multiple paths by supplying a list and styling each path by a value dimensions:


In [ ]:
paths = [{('x', 'y', 'z'): np.random.randn(500, 3).cumsum(axis=0), 'index': i} for i in range(3)]

hv.Path3D(paths, vdims='index').opts(color='index')

Just like all regular 2D elements, Path3D types can be overlaid with other 2D and 3D elements:


In [ ]:
scatter = hv.Scatter3D({('x', 'y', 'z'): line, 'index': np.arange(500)}, vdims='index')

(path * scatter.iloc[::2]).opts(
    opts.Scatter3D(color='index', cmap='viridis', size=3))

For full documentation and the available style and plot options, use hv.help(hv.Path3D).