Chord ¶

Title
Graph Element
Dependencies
Matplotlib
Backends
Matplotlib
Bokeh
In [1]:
import pandas as pd
import holoviews as hv

from holoviews import dim, opts
from bokeh.sampledata.les_mis import data

hv.extension('matplotlib')
hv.output(fig='svg', size=200)


The  Chord  element allows representing the inter-relationships between data points in a graph. The nodes are arranged radially around a circle with the relationships between the data points drawn as arcs (or chords) connecting the nodes. The number of chords is scaled by a weight declared as a value dimension on the  Chord  element.

If the weight values are integers, they define the number of chords to be drawn between the source and target nodes directly. If the weights are floating point values, they are normalized to a default of 500 chords, which are divided up among the edges. Any non-zero weight will be assigned at least one chord.

The  Chord  element is a type of  Graph  element and shares the same constructor. The most basic constructor accepts a columnar dataset of the source and target nodes and an optional value. Here we supply a dataframe containing the number of dialogues between characters of the Les Misérables musical. The data contains  source  and  target  node indices and an associated  value  column:

In [2]:
links = pd.DataFrame(data['links'])

   source  target  value

In the simplest case we can construct the  Chord  by passing it just the edges:
hv.Chord(links)