MultiDiGraph.out_edges#

property MultiDiGraph.out_edges#

作为 G.edges 或 G.edges() 的图的 OutMultiEdgeView。

edges(self, nbunch=None, data=False, keys=False, default=None)

OutMultiEdgeView 提供对边元组的集合式操作以及边属性查找。调用时,它还提供一个 EdgeDataView 对象,该对象允许控制对边属性的访问(但不提供集合式操作)。因此,G.edges[u, v, k]['color'] 提供从 uv 键为 k 的边的颜色属性值,而 for (u, v, k, c) in G.edges(data='color', default='red', keys=True): 迭代所有边,生成颜色属性,如果不存在颜色属性则使用默认值 'red'

边以元组形式返回,带有可选数据和键,顺序为 (节点, 邻居, 键, 数据)。如果未提供 keys=True,元组将仅是 (节点, 邻居, 数据),但当两个节点之间存在多条边时,将生成多个具有相同节点和邻居的元组。

参数
nbunch单个节点、容器或所有节点(默认=所有节点)

该视图将只报告来自这些节点的边。

data字符串或布尔值,可选(默认=False)

在三元组 (u, v, ddict[data]) 中返回的边属性。如果为 True,在三元组 (u, v, ddict) 中返回边属性字典。如果为 False,返回二元组 (u, v)。

keys布尔值,可选(默认=False)

如果为 True,随每条边返回边键,当也请求数据时创建 (u, v, k, d) 元组(默认),当未请求数据时创建 (u, v, k) 元组。

default值,可选(默认=None)

用于没有请求的属性的边的值。仅当 data 不为 True 或 False 时相关。

返回
edgesOutMultiEdgeView

一个边属性视图,通常迭代边的 (u, v)、(u, v, k) 或 (u, v, k, d) 元组,但也可以用于属性查找,如 edges[u, v, k]['foo']

另请参阅

in_edges, out_edges

注意

nbunch 中不在图中的节点将被(悄悄地)忽略。对于有向图,这将返回出边。

示例

>>> G = nx.MultiDiGraph()
>>> nx.add_path(G, [0, 1, 2])
>>> key = G.add_edge(2, 3, weight=5)
>>> key2 = G.add_edge(1, 2)  # second edge between these nodes
>>> [e for e in G.edges()]
[(0, 1), (1, 2), (1, 2), (2, 3)]
>>> list(G.edges(data=True))  # default data is {} (empty dict)
[(0, 1, {}), (1, 2, {}), (1, 2, {}), (2, 3, {'weight': 5})]
>>> list(G.edges(data="weight", default=1))
[(0, 1, 1), (1, 2, 1), (1, 2, 1), (2, 3, 5)]
>>> list(G.edges(keys=True))  # default keys are integers
[(0, 1, 0), (1, 2, 0), (1, 2, 1), (2, 3, 0)]
>>> list(G.edges(data=True, keys=True))
[(0, 1, 0, {}), (1, 2, 0, {}), (1, 2, 1, {}), (2, 3, 0, {'weight': 5})]
>>> list(G.edges(data="weight", default=1, keys=True))
[(0, 1, 0, 1), (1, 2, 0, 1), (1, 2, 1, 1), (2, 3, 0, 5)]
>>> list(G.edges([0, 2]))
[(0, 1), (2, 3)]
>>> list(G.edges(0))
[(0, 1)]
>>> list(G.edges(1))
[(1, 2), (1, 2)]