directed_havel_hakimi_graph#

directed_havel_hakimi_graph(in_deg_sequence, out_deg_sequence, create_using=None)[source]#

Returns a directed graph with the given degree sequences.

Parameters:
in_deg_sequencelist of integers

Each list entry corresponds to the in-degree of a node.

out_deg_sequencelist of integers

Each list entry corresponds to the out-degree of a node.

create_usingNetworkX graph constructor, optional (default DiGraph)

Graph type to create. If graph instance, then cleared before populated.

Returns:
GDiGraph

A graph with the specified degree sequences. Nodes are labeled starting at 0 with an index corresponding to the position in deg_sequence

Raises:
NetworkXError

If the degree sequences are not digraphical.

Notes

Algorithm as described by Kleitman and Wang [1].

References

[1]

D.J. Kleitman and D.L. Wang Algorithms for Constructing Graphs and Digraphs with Given Valences and Factors Discrete Mathematics, 6(1), pp. 79-88 (1973)