kmapper.plotlyviz.plotlyviz

kmapper.plotlyviz.plotlyviz(scomplex, colorscale=None, title='Kepler Mapper', graph_layout='kk', color_function=None, color_function_name=None, dashboard=False, graph_data=False, factor_size=3, edge_linewidth=1.5, node_linecolor='rgb(200, 200, 200)', width=600, height=500, bgcolor='rgba(240, 240, 240, 0.95)', left=10, bottom=35, summary_height=300, summary_width=600, summary_left=20, summary_right=20, hist_left=25, hist_right=25, member_textbox_width=800, filename=None)[source]

Visualizations and dashboards for kmapper graphs using Plotly. This method is suitable for use in Jupyter notebooks.

The generated FigureWidget can be updated (by performing a restyle or relayout). For example, let us add a title to the colorbar (the name of the color function, if any), and set the title font size. To perform these updates faster, Plotly 3.+ provides a context manager that batches up all data and layout updates:

To display more info on the generated kmapper-graph, define two more FigureWidget(s): the global node distribution figure, and a dummy figure that displays info on the algorithms involved in getting the graph from data, as well as sklearn class instances.

A FigureWidget has event listeners for hovering, clicking or selecting. Using the first one for fw_graph we define, via the function hovering_widgets(), widgets that display the node distribution, when the node is hovered over, and two textboxes for the cluster size and the member ids/labels of the hovered node members.

Parameters:
  • scomplex (dict) – Simplicial complex is the output from the KeplerMapper map method.
  • title (str) – Title of output graphic
  • graph_layout (igraph layout;) – recommended ‘kk’ (kamada-kawai) or ‘fr’ (fruchterman-reingold)
  • colorscale – Plotly colorscale(colormap) to color graph nodes
  • dashboard (bool, default is False) – If true, display complete dashboard of node information
  • graph_data (bool, default is False) – If true, display graph metadata
  • factor_size (double, default is 3) – a factor for the node size
  • edge_linewidth (double, default is 1.5) –
  • node_linecolor (color str, default is "rgb(200,200,200)") –
  • width (int, default is 600,) –
  • height (int, default is 500,) –
  • bgcolor (color str, default is "rgba(240, 240, 240, 0.95)",) –
  • left (int, default is 10,) –
  • bottom (int, default is 35,) –
  • summary_height (int, default is 300,) –
  • summary_width (int, default is 600,) –
  • summary_left (int, default is 20,) –
  • summary_right (int, default is 20,) –
  • hist_left (int, default is 25,) –
  • hist_right (int, default is 25,) –
  • member_textbox_width (int, default is 800,) –
  • filename (str, default is None) – if filename is given, the graphic will be saved to that file.
Returns:

result (plotly.FigureWidget) – A FigureWidget that can be shown or editted. See the Plotly Demo notebook for examples of use.