#

Note

This documents the development version of NetworkX. Documentation for the current release can be found here.

#

networkx.drawing.nx_pylab.draw_networkx_edge_labels

draw_networkx_edge_labels(G, pos, edge_labels=None, label_pos=0.5, font_size=10, font_color='k', font_family='sans-serif', font_weight='normal', alpha=None, bbox=None, horizontalalignment='center', verticalalignment='center', ax=None, rotate=True)[source]

Draw edge labels.

Parameters

  • G (graph) – A networkx graph

  • pos (dictionary) – A dictionary with nodes as keys and positions as values. Positions should be sequences of length 2.

  • ax (Matplotlib Axes object, optional) – Draw the graph in the specified Matplotlib axes.

  • alpha (float or None) – The text transparency (default=None)

  • edge_labels (dictionary) – Edge labels in a dictionary keyed by edge two-tuple of text labels (default=None). Only labels for the keys in the dictionary are drawn.

  • label_pos (float) – Position of edge label along edge (0=head, 0.5=center, 1=tail)

  • font_size (int) – Font size for text labels (default=12)

  • font_color (string) – Font color string (default=’k’ black)

  • font_weight (string) – Font weight (default=’normal’)

  • font_family (string) – Font family (default=’sans-serif’)

  • bbox (Matplotlib bbox) – Specify text box shape and colors.

  • clip_on (bool) – Turn on clipping at axis boundaries (default=True)

  • horizontalalignment ({‘center’, ‘right’, ‘left’}) – Horizontal alignment (default=’center’)

  • verticalalignment ({‘center’, ‘top’, ‘bottom’, ‘baseline’, ‘center_baseline’}) – Vertical alignment (default=’center’)

  • ax (Matplotlib Axes object, optional) – Draw the graph in the specified Matplotlib axes.

Returns

dict of labels keyed on the edges

Return type

dict

Examples

>>> G = nx.dodecahedral_graph()
>>> edge_labels = nx.draw_networkx_edge_labels(G, pos=nx.spring_layout(G))

Also see the NetworkX drawing examples at https://networkx.github.io/documentation/latest/auto_examples/index.html

See also

draw(), draw_networkx(), draw_networkx_nodes(), draw_networkx_edges(), draw_networkx_labels()