networkx 2.8.2 Pypi GitHub Homepage
Other Docs
NotesParametersRaisesReturnsBackRef
read_gml(path, label='label', destringizer=None)

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 :None:None:`stringizer`/destringizer , the code is capable of writing :None:None:`int`/:None:None:`float`/:None:None:`str`/:None:None:`dict`/:None:None:`list` data as required by the GML specification. For writing other data types, and for reading data other than :None:None:`str` you need to explicitly supply a :None:None:`stringizer`/destringizer .

For additional documentation on the GML file format, please see the GML url.

See the module docstring networkx.readwrite.gml for more details.

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 :None:None:`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, a :None:None:`ValueError` is raised. Default value : None.

Raises

NetworkXError

If the input cannot be parsed.

Returns

G : NetworkX graph

The parsed graph.

Read graph in GML format from :None:None:`path`.

See Also

literal_destringizer
parse_gml
write_gml

Examples

>>> G = nx.path_graph(4)
... nx.write_gml(G, "test.gml")

GML values are interpreted as strings by default:

>>> H = nx.read_gml("test.gml")
... H.nodes NodeView(('0', '1', '2', '3'))

When a destringizer is provided, GML values are converted to the provided type. For example, integer nodes can be recovered as shown below:

>>> J = nx.read_gml("test.gml", destringizer=int)
... J.nodes NodeView((0, 1, 2, 3))
See :

Back References

The following pages refer to to this document either explicitly or contain code examples using this.

networkx.readwrite.gml.read_gml networkx.readwrite.gml.write_gml networkx.readwrite.gml.parse_gml

Local connectivity graph

Hover to see nodes names; edges to Self not shown, Caped at 50 nodes.

Using a canvas is more power efficient and can get hundred of nodes ; but does not allow hyperlinks; , arrows or text (beyond on hover)

SVG is more flexible but power hungry; and does not scale well to 50 + nodes.

All aboves nodes referred to, (or are referred from) current nodes; Edges from Self to other have been omitted (or all nodes would be connected to the central node "self" which is not useful). Nodes are colored by the library they belong to, and scaled with the number of references pointing them


GitHub : /networkx/readwrite/gml.py#116
type: <class 'function'>
Commit: