+ jt0Rt.R Ot^RIt^RIHtR Rlt]!^RR7RRl4t]P!RRR7RR l4t ]!^R R7]P!RRR7RR l44t R#)a ************************* Multi-line Adjacency List ************************* Read and write NetworkX graphs as multi-line adjacency lists. The multi-line adjacency list format is useful for graphs with nodes that can be meaningfully represented as strings. With this format simple edge data can be stored but node or graph data is not. Format ------ The first label in a line is the source node label followed by the node degree d. The next d lines are target node labels and optional edge data. That pattern repeats for all nodes in the graph. The graph with edges a-b, a-c, d-e can be represented as the following adjacency list (anything following the # in a line is a comment):: # example.multiline-adjlist a 2 b c d 1 e N) open_filec #"VP4'Ed~VP4'dVP4Fwr#VP4UUUUu.uF!wrEVP4FwrgWG3NK K# ppppp\ V4p \ V4V,\ V 4,xVF<wrJV f\ V4xK\ V4V,\ V 4,xK> K R#VP4Fwr#\ V4p \ V4V,\ V 4,xVP4F<wrJV f\ V4xK\ V4V,\ V 4,xK> K R#VP4'd\ 4p VP4Fwr#VP4UUUUu.uF)wrEWK9gK VP4FwrgWG3NK K+ ppppp\ V4p \ V4V,\ V 4,xVF<wrJV f\ V4xK\ V4V,\ V 4,xK> V PV4K R#\ 4p VP4Fwr#VP4UU u.uFwrJWK9gK WJ3NK ppp \ V4p \ V4V,\ V 4,xVF<wrJV f\ V4xK\ V4V,\ V 4,xK> V PV4K R#uuppppiuuppppiuup pi5i)a<Generate lines representing the graph `G` in multiline adjacency list format. Parameters ---------- G : NetworkX graph delimiter : str, optional (default=" ") Separator for node labels. Yields ------ str A line of data in multiline adjacency list format for a node or one of its neighbors in `G`. Examples -------- >>> G = nx.lollipop_graph(4, 3) >>> for line in nx.generate_multiline_adjlist(G): ... print(line) 0 3 1 {} 2 {} 3 {} 1 2 2 {} 3 {} 2 1 3 {} 3 1 4 {} 4 1 5 {} 5 1 6 {} 6 0 See Also -------- write_multiline_adjlist, read_multiline_adjlist N) is_directed is_multigraph adjacencyitemslenstrsetadd) G delimitersnbrsudatadictkeydata nbr_edgesdegdseens && e/home/luca/screen-checking/.venv/lib/python3.14/site-packages/networkx/readwrite/multiline_adjlist.pygenerate_multiline_adjlistr'sT }} ??  ;;=(,zz|'3 %-^^%5 I%5'3 )n!fy(3s833%DAy!!f !!fy03q699 &);;=$i!fy(3s833 JJLDAy!!f !!fy03q699 )) ??  5D;;=(,zz|'3 }&.^^%5 I&6'3 )n!fy(3s833%DAy!!f !!fy03q699 &  ) 5D;;=04 N  VaV N)n!fy(3s833%DAy!!f !!fy03q699 &  )S2"OsC-N*N'M0 D+N-4N! M8 0 M8 B?N NN%B!Nwb)modec^RIp^RIpVRPVP4,pV R2V,RVP VP 44 R2,V,RVP R2,pVPVPV44\W4F,p V R, p VPV PV44K. R#)anWrite the graph G in multiline adjacency list format to path Parameters ---------- G : NetworkX graph path : string or file Filename or file handle to write to. Filenames ending in .gz or .bz2 will be compressed. comments : string, optional Marker for comment lines delimiter : string, optional Separator for node labels encoding : string, optional Text encoding. Examples -------- >>> from pathlib import Path >>> import tempfile >>> tmp_path = Path(tempfile.gettempdir()) >>> G = nx.path_graph(4) >>> fpath = tmp_path / "test.multi_adjlist" >>> nx.write_multiline_adjlist(G, fpath) View the data as stored in the file, ignoring header lines which start with the comment character ("#" by default): >>> with open(fpath) as fh: ... lines_from_file = fh.readlines() >>> print("".join(l for l in lines_from_file if not l.startswith("#"))) 0 1 1 {} 1 1 2 {} 2 1 3 {} 3 0 The path can be a file handle or a string with the name of the file. If a file handle is provided, it has to be opened in 'wb' mode. >>> fpath = tmp_path / "test.multi_adjlist2" >>> with open(fpath, "wb") as fh: ... nx.write_multiline_adjlist(G, fh) >>> with open(fpath) as fh: ... lines_from_file = fh.readlines() >>> print("".join(l for l in lines_from_file if not l.startswith("#"))) 0 1 1 {} 1 1 2 {} 2 1 3 {} 3 0 See Also -------- read_multiline_adjlist N  z GMT ) systimejoinargvasctimegmtimenamewriteencoder) r pathr commentsencodingrr pargsheader multilines &&&&& rwrite_multiline_adjlistr.sH sxx) )E '   $,,t{{}-.b 1 2   affXR.    JJv}}X&'/= T  9##H-.>T)graphs returns_graphc j^RIHp\P!^V4pVEFNpVP V4p V ^8dVRV pV'gK+VP R4P V4wr\V 4p Te T!T 4p TPT 4\T 4Fp \T4pTP T4p T ^8dTRT pT'gK4TP R4P T4p\T4pT^8dKlTP^4pR P!T4pTe T!T4pTe R T!T4/pM T!T4pTP"!T T3/TBK EKQ V# \dp \RT R24T hRp ? ii;i \dp \RT RT 24T hRp ? ii;i \dp RT R2p\T4T hRp ? ii;i \dp \RT RT 24T hRp ? ii;i \dp \R T RT 24T hRp ? ii;i /pL;i) aParse lines of a multiline adjacency list representation of a graph. Parameters ---------- lines : list or iterator of strings Input data in multiline adjlist format create_using : NetworkX graph constructor, optional (default=nx.Graph) Graph type to create. If graph instance, then cleared before populated. nodetype : Python type, optional Convert nodes to this type. edgetype : Python type, optional Convert edges to this type. comments : string, optional Marker for comment lines delimiter : string, optional Separator for node labels. The default is whitespace. Returns ------- G: NetworkX graph The graph corresponding to the lines in multiline adjacency list format. Examples -------- >>> lines = [ ... "1 2", ... "2 {'weight':3, 'name': 'Frodo'}", ... "3 {}", ... "2 1", ... "5 {'weight':6, 'name': 'Saruman'}", ... ] >>> G = nx.parse_multiline_adjlist(iter(lines), nodetype=int) >>> list(G) [1, 2, 3, 5] ) literal_evalNrz(Failed to read node and degree on line ()zFailed to convert node (z ) to type z"Failed to find neighbor for node (weightzFailed to convert edge data ()astr3nx empty_graphfindrstripsplitint BaseException TypeErroradd_noderangenext StopIterationrpopr!add_edge)linesr)r create_usingnodetypeedgetyper3r lineprrerrimsgvlistnumbvredgedatas&&&&&& rparse_multiline_adjlistrSsvZ! q,'A IIh  68D  Y{{4(..y9HQc(C   QK 1 sA2;DIIh'68D4KK%++I6Eu:Dax ! A775>D#  A # ((4.9H "+D1H JJq! (x (K't Hc YFtfANOUX X Y ! .qcH:F %2>qcCC#C.c12"%#21#ZzJ%#7vZzR"!Hs -E5>F' F=5G" HH,5 FFF F:#F55F:= GGG" H-G??H H)H$$H),H2rbc >aV3RlV4p\VVVVVVR7#)anRead graph in multi-line adjacency list format from path. Parameters ---------- path : string or file Filename or file handle to read. Filenames ending in .gz or .bz2 will be decompressed. create_using : NetworkX graph constructor, optional (default=nx.Graph) Graph type to create. If graph instance, then cleared before populated. nodetype : Python type, optional Convert nodes to this type. edgetype : Python type, optional Convert edge data to this type. comments : string, optional Marker for comment lines delimiter : string, optional Separator for node labels. The default is whitespace. Returns ------- G : NetworkX graph Examples -------- >>> from pathlib import Path >>> import tempfile >>> tmp_path = Path(tempfile.gettempdir()) >>> G = nx.path_graph(4) >>> fpath = tmp_path / "test.multi_adjlistP4" >>> nx.write_multiline_adjlist(G, fpath) >>> H = nx.read_multiline_adjlist(fpath) Data read from the file are interpreted as strings by default, regardless of the node type of the original graph. >>> G.edges EdgeView([(0, 1), (1, 2), (2, 3)]) >>> H.edges EdgeView([('0', '1'), ('1', '2'), ('2', '3')]) The node data can be converted to a specific type with the `nodetype` parameter. >>> H = nx.read_multiline_adjlist(fpath, nodetype=int) >>> H.edges EdgeView([(0, 1), (1, 2), (2, 3)]) >>> nx.utils.edges_equal(G.edges, H.edges) True Since nodes must be hashable, the function `nodetype` must return hashable types (e.g. int, float, str, frozenset - or tuples of those, etc.) The optional `create_using` parameter indicates the type of NetworkX graph created. The default is ``nx.Graph``, an undirected graph. To read the data as a directed graph use: >>> H = nx.read_multiline_adjlist(fpath, create_using=nx.DiGraph) >>> H.is_directed() True The path can be a file or a string with the name of the file. If a file is provided, it has to be opened in 'rb' mode. >>> with open(fpath, "rb") as fh: ... H = nx.read_multiline_adjlist(fh, nodetype=int) >>> H.edges EdgeView([(0, 1), (1, 2), (2, 3)]) Notes ----- This format does not store graph, node, or edge data. See Also -------- write_multiline_adjlist c3D<"TFqPS4xK R#5i)N)decode).0rJr*s& r )read_multiline_adjlist..s 4tt[[ " "ts )r)r rGrHrI)rS)r(r)r rGrHrIr*rFs&&&&&&f rread_multiline_adjlistr[Ls/z 5t 4E " !  r/)rr.rSr[)r)r#utf-8)r\NNNN)r\NNNNr]) __doc____all__networkxr8networkx.utilsrrr. _dispatchablerSr[r/rrds6 $_D 14R/R/jT2i 3i X 14T2c3cr/