read_gml#

read_gml(path, label='label', destringizer=None)[source]#

path 读取 GML 格式的图。

参数:
path文件名或文件句柄

要读取的文件名或文件句柄。

label字符串,可选

如果不为 None,解析的节点将根据 label 指示的节点属性进行重命名。默认值:‘label’。

destringizer可调用对象,可选

一个 destringizer,用于恢复 GML 中存储为字符串的值。如果它无法将字符串转换为值,则会引发 ValueError。默认值:None。

返回:
GNetworkX 图

解析后的图。

引发:
NetworkXError

如果输入无法解析。

注意

GML 文件使用 7 位 ASCII 编码存储,任何扩展 ASCII 字符 (iso8859-1) 显示为 HTML 字符实体。如果不指定 stringizer/destringizer,代码能够按照 GML 规范的要求写入 int/float/str/dict/list 数据。对于写入其他数据类型以及读取 str 以外的数据,您需要明确提供 stringizer/destringizer

有关 GML 文件格式的更多文档,请参阅 GML 网址

有关更多详细信息,请参阅模块文档字符串 networkx.readwrite.gml

示例

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

默认情况下,GML 值被解释为字符串

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

提供 destringizer 时,GML 值会转换为提供的类型。例如,整数节点可以按如下方式恢复

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