networkx.readwrite.gml.read_gml¶
-
read_gml
(path, label='label', destringizer=None)[source]¶ Read graph in GML format from
path
.Parameters: - path (filename or filehandle) – The filename or filehandle to read from.
- label (string, optional) – If not None, the parsed nodes will be renamed according to node
attributes indicated by
label
. Default value: ‘label’. - destringizer (callable, optional) – A
destringizer
that recovers values stored as strings in GML. If it cannot convert a string to a value, aValueError
is raised. Default value : None.
Returns: G – The parsed graph.
Return type: NetworkX graph
Raises: NetworkXError
– If the input cannot be parsed.See also
Notes
GML files are stored using a 7-bit ASCII encoding with any extended ASCII characters (iso8859-1) appearing as HTML character entities. Without specifying a
stringizer
/destringizer
, the code is capable of handlingint
/float
/str
/dict
/list
data as required by the GML specification. For other data types, you need to explicitly supply astringizer
/destringizer
.For additional documentation on the GML file format, please see the GML website.
See the module docstring
networkx.readwrite.gml
for additional details.Examples
>>> G = nx.path_graph(4) >>> nx.write_gml(G, 'test.gml') >>> H = nx.read_gml('test.gml')