Warning

This documents an unmaintained version of NetworkX. Please upgrade to a maintained version and see the current NetworkX documentation.

networkx.readwrite.graphml.read_graphml

read_graphml(path, node_type=<class 'str'>, edge_key_type=<class 'int'>)[source]

Read graph in GraphML format from path.

Parameters:
  • path (file or string) – File or filename to write. Filenames ending in .gz or .bz2 will be compressed.
  • node_type (Python type (default: str)) – Convert node ids to this type
  • edge_key_type (Python type (default: int)) – Convert graphml edge ids to this type as key of multi-edges
Returns:

graph – If no parallel edges are found a Graph or DiGraph is returned. Otherwise a MultiGraph or MultiDiGraph is returned.

Return type:

NetworkX graph

Notes

Default node and edge attributes are not propagated to each node and edge. They can be obtained from G.graph and applied to node and edge attributes if desired using something like this:

>>> default_color = G.graph['node_default']['color']  # doctest: +SKIP
>>> for node, data in G.nodes(data=True):  # doctest: +SKIP
...     if 'color' not in data:
...         data['color']=default_color
>>> default_color = G.graph['edge_default']['color']  # doctest: +SKIP
>>> for u, v, data in G.edges(data=True):  # doctest: +SKIP
...     if 'color' not in data:
...         data['color']=default_color

This implementation does not support mixed graphs (directed and unidirected edges together), hypergraphs, nested graphs, or ports.

For multigraphs the GraphML edge “id” will be used as the edge key. If not specified then they “key” attribute will be used. If there is no “key” attribute a default NetworkX multigraph edge key will be provided.

Files with the yEd “yfiles” extension will can be read but the graphics information is discarded.

yEd compressed files (“file.graphmlz” extension) can be read by renaming the file to “file.graphml.gz”.