concatenate_graphs

concatenate_graphs(graph_list)[source]

Concatenates multiple graphs into a single graph.

This function merges a sequence of graphs by combining their non-fictitious addresses, hyper-edge sets, and shapes into one unified Graph instance. Address offsets are temporarily applied to avoid collisions between vertex indices during hyper-edge set concatenation, then reverted to preserve the integrity of the original Graph objects.

Parameters:

graph_list (list[Graph]) – A list of Graph instances to be concatenated.

Returns:

A new Graph object representing the concatenation of all input graphs.

Raises:

ValueError – If graph_list is empty.

Note:

The input graphs are temporarily modified to apply address offsets but are restored to their original state before the function returns.

Return type:

Graph