Warning

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

read_gml

read_gml(path, relabel=False)[source]

Read graph in GML format from path.

Parameters:

path : filename or filehandle

The filename or filehandle to read from.

relabel : bool, optional

If True use the GML node label attribute for node names otherwise use the node id.

Returns:

G : MultiGraph or MultiDiGraph

Raises:

ImportError

If the pyparsing module is not available.

See also

write_gml, parse_gml

Notes

Requires pyparsing: http://pyparsing.wikispaces.com/ The GML specification says that files should be ASCII encoded, with any extended ASCII characters (iso8859-1) appearing as HTML character entities.

References

GML specification: http://www.infosun.fim.uni-passau.de/Graphlet/GML/gml-tr.html

Examples

>>> G=nx.path_graph(4)
>>> nx.write_gml(G,'test.gml')
>>> H=nx.read_gml('test.gml')