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


compose(G, H)[source]

Returns a new graph of G composed with H.

Composition is the simple union of the node sets and edge sets. The node sets of G and H do not need to be disjoint.


G, H (graph) – A NetworkX graph



Return type

A new graph with the same type as G


It is recommended that G and H be either both directed or both undirected. Attributes from H take precedent over attributes from G.

For MultiGraphs, the edges are identified by incident nodes AND edge-key. This can cause surprises (i.e., edge (1, 2) may or may not be the same in two graphs) if you use MultiGraph without keeping track of edge keys.