deepgraph.DeepGraph.plot_2d

DeepGraph.plot_2d(x, y, edges=False, C=None, C_split_0=None, kwds_scatter=None, kwds_quiver=None, kwds_quiver_0=None, ax=None)[source]

Plot nodes and corresponding edges in 2 dimensions.

Create a scatter plot of the nodes in v, and optionally a quiver plot of the corresponding edges in e.

The xy-coordinates of the scatter plot are determined by the values of v[x] and v[y], where x and y are column names of v (the arrow’s coordinates are determined automatically).

In order to map colors to the arrows, either C or C_split_0 can be be passed, an array of the same length as e. Passing C creates a single quiver plot (qu). Passing C_split_0 creates two separate quiver plots, one for all edges where C_split_0 == 0 (qu_0), and one for all other edges (qu). By default, the arrows of qu_0 have no head, indicating “undirected” edges. This can be useful, for instance, when C_split_0 represents an array of temporal distances.

In order to control the plotting parameters of the scatter, quiver and/or quiver_0 plots, one may pass keyword arguments by setting kwds_scatter, kwds_quiver and/or kwds_quiver_0.

Can be used iteratively by passing ax.

Parameters:

x (int or str) – A column name of v, determining the x-coordinates of the scatter plot of nodes.
y (int or str) – A column name of v, determining the y-coordinates of the scatter plot of nodes.
edges (bool, optional (default=True)) – Whether to create a quiver plot (2-D field of arrows) of the edges between the nodes.
C (array_like, optional (default=None)) – An optional array used to map colors to the arrows. Must have the same length es e. Has no effect if C_split_0 is passed as an argument.
C_split_0 (array_like, optional (default=None)) – An optional array used to map colors to the arrows. Must have the same length es e. If this parameter is passed, C has no effect, and two separate quiver plots are created (qu and qu_0).
kwds_scatter (dict, optional (default=None)) – kwargs to be passed to scatter.
kwds_quiver (dict, optional (default=None)) – kwargs to be passed to quiver (qu).
kwds_quiver_0 (dict, optional (default=None)) – kwargs to be passed to quiver (qu_0). Only has an effect if C_split_0 has been set.
ax (matplotlib axes object, optional (default=None)) – An axes instance to use.

Returns:

obj – If C_split_0 has been passed, return a dict of matplotlib objects with the following keys: [‘fig’, ‘ax’, ‘pc’, ‘qu’, ‘qu_0’]. Otherwise, return a dict with keys: [‘fig’, ‘ax’, ‘pc’, ‘qu’].

Return type:

dict

Notes

When passing C_split_0, the color of the arrows in qu_0 can be set by passing the keyword argument color to kwds_quiver_0. The color of the arrows in qu, however, are determined by C_split_0.

The default drawing order is set to: 1. quiver_0 (zorder=1) 2. quiver (zorder=2) 3. scatter (zorder=3) This order can be changed by setting the zorder in kwds_quiver_0, kwds_quiver and/or kwds_scatter. See also http://matplotlib.org/examples/pylab_examples/zorder_demo.html