01ip0SrSSKJr SSKrSSKJrJrJrJr \(aSSK J r \R"\ 5r Sr\\4SSjjrS4SS jjrS S 4SS jjrS S 4SSjjrS/S/SSS4SSjjrg)aConvert (to and) from rdflib graphs to other well known graph libraries. Currently the following libraries are supported: - networkx: MultiDiGraph, DiGraph, Graph - graph_tool: Graph Doctests in this file are all skipped, as we can't run them conditionally if networkx or graph_tool are available and they would err otherwise. see `../../test/test_extras_external_graph_libs.py` for conditional tests ) annotationsN) TYPE_CHECKINGAnyDictList)GraphcU$)N)xs [/home/james-whalen/.local/lib/python3.13/site-packages/rdflib/extras/external_graph_libs.py _identityr s Hc[U5(de[U5(de[U5(deSSKnUHupxn U"U5U"U 5pURX5n U b[XR5(a*U"XxU 5n U(aSU S'UR "X40U D6 MmU(a U S==S- ss'SU ;dMU"XxU 5n U SR U S5 M g)aHelper method for multidigraph, digraph and graph. Modifies nxgraph in-place! Args: graph: an rdflib.Graph. nxgraph: a networkx.Graph/DiGraph/MultiDigraph. calc_weights: If True adds a 'weight' attribute to each edge according to the count of s,p,o triples between s and o, which is meaningful for Graph/DiGraph. edge_attrs: Callable to construct edge data from s, p, o. 'triples' attribute is handled specially to be merged. 'weight' should not be generated if calc_weights==True. (see invokers below!) transform_s: Callable to transform node generated from s. transform_o: Callable to transform node generated from o. rNweighttriples)callablenetworkx get_edge_data isinstance MultiDiGraphadd_edgeextend)graphnxgraph calc_weights edge_attrs transform_s transform_onxspotstodatads r _rdflib_to_networkx_graphr(s2 J    K  K  aQQB$$R, <:g??aA&D!"X   R ,t ,X!#D qQ'Y&&q|4rc SU0$)Nkeyr r!r"r#s r r,NseQZrc JSSKnUR5n[XSU40UD6 U$)aConverts the given graph into a networkx.MultiDiGraph. The subjects and objects are the later nodes of the MultiDiGraph. The predicates are used as edge keys (to identify multi-edges). Args: graph: a rdflib.Graph. edge_attrs: Callable to construct later edge_attributes. It receives 3 variables (s, p, o) and should construct a dictionary that is passed to networkx's add_edge(s, o, \*\*attrs) function. By default this will include setting the MultiDiGraph key=p here. If you don't want to be able to re-identify the edge later on, you can set this to `lambda s, p, o: {}`. In this case MultiDiGraph's default (increasing ints) will be used. Returns: networkx.MultiDiGraph Example: ```python >>> from rdflib import Graph, URIRef, Literal >>> g = Graph() >>> a, b, l = URIRef('a'), URIRef('b'), Literal('l') >>> p, q = URIRef('p'), URIRef('q') >>> edges = [(a, p, b), (a, q, b), (b, p, a), (b, p, l)] >>> for t in edges: ... g.add(t) ... >>> mdg = rdflib_to_networkx_multidigraph(g) >>> len(mdg.edges()) 4 >>> mdg.has_edge(a, b) True >>> mdg.has_edge(a, b, key=p) True >>> mdg.has_edge(a, b, key=q) True >>> mdg = rdflib_to_networkx_multidigraph(g, edge_attrs=lambda s,p,o: {}) >>> mdg.has_edge(a, b, key=0) True >>> mdg.has_edge(a, b, key=1) True ``` rNF)rrr()rrkwdsr mdgs r rdflib_to_networkx_multidigraphr0Ms*b // Ce%DtD JrTcSXU4/0$Nrr r+s r r,r, Q1I;7rc HSSKnUR5n[XX40UD6 U$)aConverts the given graph into a networkx.DiGraph. As an rdflib.Graph() can contain multiple edges between nodes, by default adds the a 'triples' attribute to the single DiGraph edge with a list of all triples between s and o. Also by default calculates the edge weight as the length of triples. Args: graph: a rdflib.Graph. calc_weights: If true calculate multi-graph edge-count as edge 'weight' edge_attrs: Callable to construct later edge_attributes. It receives 3 variables (s, p, o) and should construct a dictionary that is passed to networkx's add_edge(s, o, \*\*attrs) function. By default this will include setting the 'triples' attribute here, which is treated specially by us to be merged. Other attributes of multi-edges will only contain the attributes of the first edge. If you don't want the 'triples' attribute for tracking, set this to `lambda s, p, o: {}`. Returns: networkx.DiGraph Example: ```python >>> from rdflib import Graph, URIRef, Literal >>> g = Graph() >>> a, b, l = URIRef('a'), URIRef('b'), Literal('l') >>> p, q = URIRef('p'), URIRef('q') >>> edges = [(a, p, b), (a, q, b), (b, p, a), (b, p, l)] >>> for t in edges: ... g.add(t) ... >>> dg = rdflib_to_networkx_digraph(g) >>> dg[a][b]['weight'] 2 >>> sorted(dg[a][b]['triples']) == [(a, p, b), (a, q, b)] True >>> len(dg.edges()) 3 >>> dg.size() 3 >>> dg.size(weight='weight') 4.0 >>> dg = rdflib_to_networkx_graph(g, False, edge_attrs=lambda s,p,o:{}) >>> 'weight' in dg[a][b] False >>> 'triples' in dg[a][b] False ``` rN)rDiGraphr()rrrr.r dgs r rdflib_to_networkx_digraphr7s'r BeJTJ IrcSXU4/0$r2r r+s r r,r,r3rc HSSKnUR5n[XX40UD6 U$)aConverts the given graph into a networkx.Graph. As an [`rdflib.Graph()`][rdflib.Graph] can contain multiple directed edges between nodes, by default adds the a 'triples' attribute to the single DiGraph edge with a list of triples between s and o in graph. Also by default calculates the edge weight as the `len(triples)`. Args: graph: a rdflib.Graph. calc_weights: If true calculate multi-graph edge-count as edge 'weight' edge_attrs: Callable to construct later edge_attributes. It receives 3 variables (s, p, o) and should construct a dictionary that is passed to networkx's add_edge(s, o, \*\*attrs) function. By default this will include setting the 'triples' attribute here, which is treated specially by us to be merged. Other attributes of multi-edges will only contain the attributes of the first edge. If you don't want the 'triples' attribute for tracking, set this to `lambda s, p, o: {}`. Returns: networkx.Graph Example: ```python >>> from rdflib import Graph, URIRef, Literal >>> g = Graph() >>> a, b, l = URIRef('a'), URIRef('b'), Literal('l') >>> p, q = URIRef('p'), URIRef('q') >>> edges = [(a, p, b), (a, q, b), (b, p, a), (b, p, l)] >>> for t in edges: ... g.add(t) ... >>> ug = rdflib_to_networkx_graph(g) >>> ug[a][b]['weight'] 3 >>> sorted(ug[a][b]['triples']) == [(a, p, b), (a, q, b), (b, p, a)] True >>> len(ug.edges()) 2 >>> ug.size() 2 >>> ug.size(weight='weight') 4.0 >>> ug = rdflib_to_networkx_graph(g, False, edge_attrs=lambda s,p,o:{}) >>> 'weight' in ug[a][b] False >>> 'triples' in ug[a][b] False ``` rN)rrr()rrrr.r gs r rdflib_to_networkx_graphr;s'r  Ae IDI Hrtermc SU0$Nr<r r+s r r,r,  rc SU0$r>r r+s r r,r, r?rc SU0$r>r r+s r r,r, r?rcSSKnUR5nUVs/sHoURS54PM n nU HupXRU'M UV s/sHoUR S54PM n n U HupXR U 'M 0nUHunnnUR U5nUc3UR5nUX'U"UUU5nU H upUUU U'M UnUR U5nUc4UR5nUUU'U"UUU5nU H upUUU U'M UnURUU5nU"UUU5nU H upUU U U'M M U$s snfs sn f)aConverts the given graph into a graph_tool.Graph(). The subjects and objects are the later vertices of the Graph. The predicates become edges. Args: graph: a rdflib.Graph. v_prop_names: a list of names for the vertex properties. The default is set to ['term'] (see transform_s, transform_o below). e_prop_names: a list of names for the edge properties. transform_s: callable with s, p, o input. Should return a dictionary containing a value for each name in v_prop_names. By default is set to {'term': s} which in combination with v_prop_names = ['term'] adds s as 'term' property to the generated vertex for s. transform_p: similar to transform_s, but wrt. e_prop_names. By default returns {'term': p} which adds p as a property to the generated edge between the vertex for s and the vertex for o. transform_o: similar to transform_s. Returns: graph_tool.Graph() Example: ```python >>> from rdflib import Graph, URIRef, Literal >>> g = Graph() >>> a, b, l = URIRef('a'), URIRef('b'), Literal('l') >>> p, q = URIRef('p'), URIRef('q') >>> edges = [(a, p, b), (a, q, b), (b, p, a), (b, p, l)] >>> for t in edges: ... g.add(t) ... >>> mdg = rdflib_to_graphtool(g) >>> len(list(mdg.edges())) 4 >>> from graph_tool import util as gt_util >>> vpterm = mdg.vertex_properties['term'] >>> va = gt_util.find_vertex(mdg, vpterm, a)[0] >>> vb = gt_util.find_vertex(mdg, vpterm, b)[0] >>> vl = gt_util.find_vertex(mdg, vpterm, l)[0] >>> (va, vb) in [(e.source(), e.target()) for e in list(mdg.edges())] True >>> epterm = mdg.edge_properties['term'] >>> len(list(gt_util.find_edge(mdg, epterm, p))) == 3 True >>> len(list(gt_util.find_edge(mdg, epterm, q))) == 1 True >>> mdg = rdflib_to_graphtool( ... g, ... e_prop_names=[str('name')], ... transform_p=lambda s, p, o: {str('name'): unicode(p)}) >>> epterm = mdg.edge_properties['name'] >>> len(list(gt_util.find_edge(mdg, epterm, unicode(p)))) == 3 True >>> len(list(gt_util.find_edge(mdg, epterm, unicode(q)))) == 1 True ``` rNobject) graph_toolrnew_vertex_propertyvertex_propertiesnew_edge_propertyedge_propertiesget add_vertexr)r v_prop_names e_prop_namesr transform_prgtr:vpnvpropsvpropepnepropsepropnode_to_vertexr!r"r#svv tmp_propsoves r rdflib_to_graphtoolr[sF  A@L M A))(34 F M #(C >J KlsA''12lF K !&#%'N1a    " : A !N #Aq!,I$ $S>a%B    " : A !N1 #Aq!,I$ $S>a%B JJr2 1a(  JC ~E!H!+. H=NLs EE)rrrbool)rr)rrrK List[str]rLr])__doc__ __future__rloggingtypingrrrr rdflib.graphr getLogger__name__loggerr r(r0r7r;r[r rr rfs #11"   8 $  -5 -5-5b85 5t7= ==D7= = = D &h%h+++ e e e e r