S,jr'S-r(S.r)S/r*S0r+S1r,g)?Networkz The Network class is the focus of this library. All viz functionality should be implemented off of a Network instance. To instantiate: >>> nt = Network() FNc T/Ul/UlXlX lXlSUlSUlXlX0lXl SUl SUl [U 5Ul SUl/Ul0UlSUlSUlXPlX`lXplU S;dS5eSUl[.R,R1[25S-Ul[7[9UR45S 9UlU S :XaUS :Xa [=S 5 XlU(aURA5 gg) a :param height: The height of the canvas :param width: The width of the canvas :param directed: Whether or not to use a directed graph. This is false by default. :param notebook: True if using jupyter notebook. :param select_menu: sets the option to highlight nodes and the neighborhood :param filter_menu: sets the option to filter nodes and edges based on attributes :param bgcolor: The background color of the canvas. :param cdn_resources: Where to pull resources for css and js files. Defaults to local. Options ['local','in_line','remote']. local: pull resources from local lib folder. in_line: insert lib resources as inline script tags. remote: pull resources from hash checked cdns. :font_color: The color of the node labels text :layout: Use hierarchical layout if this is set :type height: num or str :type width: num or str :type directed: bool :type notebook: bool :type select_menu: bool :type filter_menu: bool :type bgcolor: str :type font_color: str :type layout: bool :type cdn_resources: str dotFN)localin_lineremotez.cdn_resources not in [local, in_line, remote]. template.htmlz /templates/loaderrTzWarning: When cdn_resources is 'local' jupyter notebook has issues displaying graphics on chrome/safari. Use cdn_resources='in_line' or cdn_resources='remote' if you have issues viewing graphics in a notebook.)!nodesedgesheightwidthheadinghtmlshape font_colordirectedbgcoloruse_DOTdot_langr optionswidgetnode_idsnode_maptemplateconfneighborhood_highlight select_menu filter_menupathosdirname__file__ template_dirrr templateEnvprint cdn_resources prep_notebook) selfrrr!notebookr+r,r-r"r layoutrr5s G/home/james-whalen/.local/lib/python3.13/site-packages/pyvis/network.py__init__Network.__init__sR       $    v      &<#&& >>p@pp># GGOOH5 E&.>t?P?P.QR G #D(8 4 5+      c [[R"URURUR UR URS.SS95$)z, override print to show readable graph data )NodesEdgesHeightWidthHeading)indent)strjsondumpsr'rrrrr7s r:__str__Network.__str__jsJ JJ!]]!ZZ"kk!ZZ#||    r=ctSRURUR5UR55$)Nz{} |N|={} |E|={:,})format __class__ num_nodes num_edgesrIs r:__repr__Network.__repr__{s.#** NNDNN,dnn.>  r=c [U[5(d[U[5(deU(aUnOUnXR;aSU;a[ X4X`R S.UD6nO[ X4XdUR S.UD6nUR RUR5 URRU5 URURU'gg)a8 This method adds a node to the network, given a mandatory node ID. Node labels default to node ids if no label is specified during the call. >>> nt = Network("500px", "500px") >>> nt.add_node(0, label="Node 0") >>> nt.add_node(1, label="Node 1", color = "blue") :param n_id: The id of the node. The id is mandatory for nodes and they have to be unique. This should obviously be set per node, not globally. :param label: The label is the piece of text shown in or under the node, depending on the shape. :param borderWidth: The width of the border of the node. :param borderWidthSelected: The width of the border of the node when it is selected. When undefined, the borderWidth * 2 is used. :param brokenImage: When the shape is set to image or circularImage, this option can be an URL to a backup image in case the URL supplied in the image option cannot be resolved. :param group: When not undefined, the node will belong to the defined group. Styling information of that group will apply to this node. Node specific styling overrides group styling. :param hidden: When true, the node will not be shown. It will still be part of the physics simulation though! :param image: When the shape is set to image or circularImage, this option should be the URL to an image. If the image cannot be found, the brokenImage option can be used. :param labelHighlightBold: Determines whether or not the label becomes bold when the node is selected. :param level: When using the hierarchical layout, the level determines where the node is going to be positioned. :param mass: The barnesHut physics model (which is enabled by default) is based on an inverted gravity model. By increasing the mass of a node, you increase it's repulsion. Values lower than 1 are not recommended. :param physics: When false, the node is not part of the physics simulation. It will not move except for from manual dragging. :param shape: The shape defines what the node looks like. There are two types of nodes. One type has the label inside of it and the other type has the label underneath it. The types with the label inside of it are: ellipse, circle, database, box, text. The ones with the label outside of it are: image, circularImage, diamond, dot, star, triangle, triangleDown, square and icon. :param size: The size is used to determine the size of node shapes that do not have the label inside of them. These shapes are: image, circularImage, diamond, dot, star, triangle, triangleDown, square and icon. :param title: Title to be displayed when the user hovers over the node. The title can be an HTML element or a string containing plain text or HTML. :param value: When a value is set, the nodes will be scaled using the options in the scaling object defined above. :param x: This gives a node an initial x position. When using the hierarchical layout, either the x or y position is set by the layout engine depending on the type of view. The other value remains untouched. When using stabilization, the stabilized position may be different from the initial one. To lock the node to that position use the physics or fixed options. :param y: This gives a node an initial y position. When using the hierarchical layout,either the x or y position is set by the layout engine depending on the type of view. The other value remains untouched. When using stabilization, the stabilized position may be different from the initial one. To lock the node to that position use the physics or fixed options. :type n_id: str or int :type label: str or int :type borderWidth: num (optional) :type borderWidthSelected: num (optional) :type brokenImage: str (optional) :type group: str (optional) :type hidden: bool (optional) :type image: str (optional) :type labelHighlightBold: bool (optional) :type level: num (optional) :type mass: num (optional) :type physics: bool (optional) :type shape: str (optional) :type size: num (optional) :type title: str or html element (optional) :type value: num (optional) :type x: num (optional) :type y: num (optional) group)labelr )rUcolorr N) isinstancerFintr'r r rappendr%r()r7n_idrUrrVr% node_labelns r:add_nodeNetwork.add_nodesX$$$ 4(=(=== JJ }} $'!^J??^V]^kJPTP_P_kcjk JJ  aii ( MM  &"#))DMM$  %r=c 4/SQnUHnXC;aM SU-S-5e [[5n[[U55HtnUR 5H]upG[U5[U5:Xd&SU<S[U5<S[U5<S35eXQUR XGU05 M_ Mv UH$n[ U5nUR"U40XXD6 M& g! [U[5(deUR"U40XXD6 MZ=f) aR This method adds multiple nodes to the network from a list. Default behavior uses values of 'nodes' for node ID and node label properties. You can also specify other lists of properties to go along each node. Example: >>> g = net.Network() >>> g.add_nodes([1, 2, 3], size=[2, 4, 6], title=["n1", "n2", "n3"]) >>> g.nodes >>> [{'id': 1, 'label': 1, 'shape': 'dot', 'size': 2, 'title': 'n1'}, Output: >>> {'id': 2, 'label': 2, 'shape': 'dot', 'size': 4, 'title': 'n2'}, >>> {'id': 3, 'label': 3, 'shape': 'dot', 'size': 6, 'title': 'n3'}] :param nodes: A list of nodes. :type nodes: list )sizevaluetitlexyrUrVrz invalid arg ''z keyword arg z [length z] does not match[length z ] of nodesN) rdictrangelenitemsupdaterXr]rWrF) r7rkwargs valid_argskndivnodes r: add_nodesNetwork.add_nodess01 A? =Oa$7#$= =? s5z"A A#e*, #a&#e*, 8 ##Q!I.'#D 04y d/bh/   0!$,,,, d/bh/s  C&&.Dc,[UR5$)z3 Return number of nodes :returns: :py:class:`int` )rhr'rIs r:rONetwork.num_nodes-s 4==!!r=c,[UR5$)z3 Return number of edges :returns: :py:class:`int` )rhrrIs r:rPNetwork.num_edges5s 4::r=c SnXR5;dS[U5-S-5eX R5;dS[U5-S-5eUR(d7URH'nUSnUSnX:XaX&:XdX:XdMX':XdM%SnM) U(d=[ XUR40UD6nURR UR 5 gg)a Adding edges is done based off of the IDs of the nodes. Order does not matter unless dealing with a directed graph. >>> nt.add_edge(0, 1) # adds an edge from node ID 0 to node ID >>> nt.add_edge(0, 1, value = 4) # adds an edge with a width of 4 :param arrowStrikethrough: When false, the edge stops at the arrow. This can be useful if you have thick lines and you want the arrow to end in a point. Middle arrows are not affected by this. :param from: Edges are between two nodes, one to and one from. This is where you define the from node. You have to supply the corresponding node ID. This naturally only applies to individual edges. :param hidden: When true, the edge is not drawn. It is part still part of the physics simulation however! :param physics: When true, the edge is part of the physics simulation. When false, it will not act as a spring. :param title: The title is shown in a pop-up when the mouse moves over the edge. :param to: Edges are between two nodes, one to and one from. This is where you define the to node. You have to supply the corresponding node ID. This naturally only applies to individual edges. :param value: When a value is set, the edges' width will be scaled using the options in the scaling object defined above. :param width: The width of the edge. If value is set, this is not used. :type arrowStrikethrough: bool :type from: str or num :type hidden: bool :type physics: bool :type title: str :type to: str or num :type value: num :type width: num Fznon existent node 'refromtoTN) get_nodesrFr!rrrYr%)r7sourcerzr% edge_existsefrmdests r:add_edgeNetwork.add_edge=sb )) 6 !CK /# 5 6)^^%% 2 !CG +c 1 2%}}ZZiwBI2:#'K V:':A JJ  aii (r=cUHFn[U5S:XaURUSUSUSS9 M.URUSUS5 MH g)a~ This method serves to add multiple edges between existing nodes in the network instance. Adding of the edges is done based off of the IDs of the nodes. Order does not matter unless dealing with a directed graph. :param edges: A list of tuples, each tuple consists of source of edge, edge destination and and optional width. :type arrowStrikethrough: list of tuples rr)rN)rhr)r7redges r: add_edgesNetwork.add_edgessMD4yA~ d1gtAwd1g > d1gtAw/ r=c[UR[5(aXURURUR UR UR[R"UR54$URURUR UR URURR54$)a Extract relevant information about this network in order to inject into a Jinja2 template. Returns: nodes (list), edges (list), height ( string), width (string), options (object) Usage: >>> nodes, edges, heading, height, width, options = net.get_network_data() ) rWr%rfrrrrrrGrHto_jsonrIs r:get_network_dataNetwork.get_network_datas dllD ) )JJ DLL$++JJ 4<< 8: :JJ DLL$++JJ 4 4 68 8r=c<[U5 URU5 g)z Save the graph as html in the current directory with name. :param name: the name of the html file to save as :type name: str N)r write_html)r7names r: save_graphNetwork.save_graphs 4 r=Tc.[U5 SnURH)nURSS5nU(dMSU;dM&Sn O U(d&URR UR 5nO UR nUR5uppp[UR[5(a9SUR;a&SURS;aURSSnO#SnO URRRnURU U UU U U UURURUR UR"UR$UUR&UR(UR*UUR,S9UlUR.$) z This method gets the data structures supporting the nodes, edges, and options and updates the template to write the HTML holding the visualization. :type name_html: str FrbNhrefTphysicsenabled)rrrrrr%physics_enabledr#r$r&r"r* tooltip_linkr+r,r-r8r5)r rgetr3 get_templater.r)rrWr%rfrrrenderr#r$r&r"r*r+r,r-r5r)r7rrr8use_link_templater\rbr)rrrrrr%rs r: generate_htmlNetwork.generate_htmlsi 4!AEE'4(EuU? )-%''44TYY?H}}H8<8M8M8O5gu dllD ) )DLL(Y$,,y:Q-Q"&,,y"9)"D"&"ll22::OOO6*/*/*/,3,34C,0LL-1]]+/;;,0LL)-1B;?;V;V040@0@040@0@-5262D2D#$& &yyr=cUn[U5 URUS9UlURS:XGa[R R S5(d[R"S5 [R R S5(d;[R"[R R[5S3S5 [R R [R"5S-5(d;[R"[R R[5S3S5 [R R [R"5S -5(d;[R"[R R[5S 3S 5 [US 5nURUR5 S S S 5 ORURS:XdURS:Xa1[US 5nURUR5 S S S 5 OU(a[R"U5 g g !,(df  N-=f!,(df  N>=f)a This method gets the data structures supporting the nodes, edges, and options and updates the template to write the HTML holding the visualization. To work with the old local methods local is being depricated, but not removed. :type name_html: str @param name: name of the file to save the graph as. @param local: Depricated parameter. Used to be used to determine how the graph needs deploy. Has been removed in favor of using the class cdn_resources instead. @param notebook: If true, this object will return the iframe document for use in juptyer notebook. @param open_browser: If true, will open a web browser with the generated graph. )r8rlibz lib/bindingsz/templates/lib/bindingsz/lib/tom-selectz/templates/lib/tom-selectzlib/tom-selectz/lib/vis-9.1.2z/templates/lib/vis-9.1.2z lib/vis-9.1.2zw+Nrr)r rrr5r/r.existsmakedirsshutilcopytreer0r1getcwdopenwrite webbrowser)r7rrr8 open_browser getcwd_nameouts r:rNetwork.write_htmls ;&&&9    (77>>%(( E"77>>.11277??8#<"==T UWef77>>"))+.?"?@@277??8#<"==V WYij77>>"))+.>">??277??8#<"==U VXghk4(C $))$)(   9 ,0B0Bh0Nk4(C $))$)(K  OOK ( )()(sII) I&) I7c[U5 U(aURUSSS9 OURUSS9 U(a[XRURS9$g)z Writes a static HTML file and saves it locally before opening. :param: name: the name of the html file to save as :type name: str FT)rr8)r)rrN)r4rrrr)r7rrr8s r:show Network.showsM d  OODudO C OODtO 4 $jjE E r=cU(aU(aURU5 URRUR5Ulg)a6 Loads the template data into the template attribute of the network. This should be done in a jupyter notebook environment before showing the network. Example: >>> net.prep_notebook() >>> net.show("nb.html") :param path: the relative path pointing to a template html file :type path: string N) set_templater3rr.r))r7custom_templatecustom_template_paths r:r6Network.prep_notebook(s7 3   2 3((55dii@ r=path_to_templateczURS5nURSRUSS5S-US5 g)a\ Path to full template assumes that it exists inside of a template directory. Use `set_template_dir` to set the relative template path to the template directory along with the directory location itself to change both values otherwise this function will infer the results. :path_to_template path: full os path string value of the template directory /N)splitset_template_dirjoin)r7r str_partss r:rNetwork.set_template=s<%**3/  chhy"~6t?P?P.QRr=cSUl[US5n[UR55nSR UR 55UlUR RSS5Ulg)a` This method takes the contents of .DOT file and converts it to a PyVis visualization. Assuming the contents of test.dot contains: digraph sample3 { A -> {B ; C ; D} C -> {B ; A} } Usage: >>> nt.Network("500px", "500px") >>> nt.from_DOT("test.dot") >>> nt.show("dot.html") :param dot: The path of the dotfile being converted. :type dot: .dot file Tr "z\"N)r#rrFreadr splitlinesr$replace)r7rfiless r:from_DOTNetwork.from_DOTRsT* C~  0  --c59 r=c0nURHn[5XS'M UR(a2URH nUSnUSnXR U5 M" U$URHGnUSnUSnXQU;dMXAU;dM!XR U5 XR U5 MI U$)z This method returns the user an adjacency list representation of the network. :returns: dictionary mapping of Node ID to list of Node IDs it is connected to. idryrz)rsetr!radd)r7a_listror~r|rs r: get_adj_listNetwork.get_adj_listmsA!eFT7O ==ZZ6w""4(  ZZ6wf~-&t 2LN&&t,L$$V,   r=c[U[5(d([U[5(dS[U5-5eXR;d SU-5eUR 5U$)z Given a node id, return the set of neighbors of this particular node. :param node: The node to get the neighbors from :type node: str or int :returns: set z.error: expected int or str for node but got %szerror: %s node not in network)rWrFrXtyper'r)r7rqs r: neighborsNetwork.neighborssg4%%D#)>)> QCd4jP Q> %N(G$(NN%  "4((r=cU$Nrcs r:Network.sAr=cU$rrrs r:rrs^_r= rc[U[R5(deURSS9nUR SS9n [ U5S:GaPUGHIn SXSR 5;a XIU SS'[U"XSS55XSS'SXSR 5;a XIU SS'[U"XSS55XSS'UR"U S40XSD6 UR"U S40XSD6 SU S;d SU S;aXU(aSn OSn S U SR 5;aXZSS 'U"U SS 5U SU 'U SRS 5U SU 'UR"U SU S40U SD6 GML [R"U5H5n SXR 5;aXIU S'UR"U 40XD6 M7 g ) a This method takes an exisitng Networkx graph and translates it to a PyVis graph format that can be accepted by the VisJs API in the Jinja2 template. This operation is done in place. :param nx_graph: The Networkx graph object that is to be translated. :type nx_graph: networkx.Graph instance :param node_size_transf: function to transform the node size for plotting :type node_size_transf: func :param edge_weight_transf: function to transform the edge weight for plotting :type edge_weight_transf: func :param default_node_size: default node size if not specified :param default_edge_weight: default edge weight if not specified >>> nx_graph = nx.cycle_graph(10) >>> nx_graph.nodes[1]['title'] = 'Number 1' >>> nx_graph.nodes[1]['group'] = 1 >>> nx_graph.nodes[3]['title'] = 'I belong to a different group!' >>> nx_graph.nodes[3]['group'] = 10 >>> nx_graph.add_node(20, size=20, title='couple', group=2) >>> nx_graph.add_node(21, size=15, title='couple', group=2) >>> nx_graph.add_edge(20, 21, weight=5) >>> nx_graph.add_node(25, size=25, label='lonely', title='lonely node', group=3) >>> nt = Network("500px", "500px") # populates the nodes and edges data structures >>> nt.from_nx(nx_graph) >>> nt.show("nx.html") T)datarr`rrarrweightN) rWnxGraphrrrhkeysrXr]poprisolates) r7nx_graphnode_size_transfedge_weight_transfdefault_node_sizedefault_edge_weightshow_edge_weights edge_scalingrrr~ width_typerqs r:from_nxNetwork.from_nxs:(BHH--.-nnDn)nnDn) u:>t!1!1!33(9!A$K'$'(8tV9L(M$Nd F#t!1!1!33(9!A$K'$'(8tV9L(M$Nd F# ad2eaDk2 ad2eaDk2!A$&'1*=#%, %, qtyy{2)>> g.show_buttons(filter_=['nodes', 'edges', 'physics']) Or to show all options: >>> g.show_buttons() :param status: When set to True, the widgets will be shown. Default is set to False. :param filter_: Only include widgets specified by `filter_`. Valid options: True (gives all widgets) List of `nodes`, `edges`, `layout`, `interaction`, `manipulation`, `physics`, `selection`, `renderer`. :type status: bool :type filter_: bool or list: T)rfilter_N)r*r r% configurer&)r7r.s r: show_buttonsNetwork.show_buttonss%. !*4!I  r=c8XRRlg)z Toggles physics simulation :param status: When False, nodes are not part of the physics simulation. They will not move except for from manual dragging. Default is set to True. :type status: bool N)r%rrr!s r:toggle_physicsNetwork.toggle_physicss(. $r=c8XRRlg)z Toggles the dragging of the nodes in the network. :param status: When set to True, the nodes can be dragged around in the network. Default is set to True. :type status: bool N)r%r dragNodesr!s r:toggle_drag_nodesNetwork.toggle_drag_nodess.4   *r=cNURRRU5 g)zf Toggles the stablization of the network. :param status: Default is set to True. :type status: bool N)r%rtoggle_stabilizationr!s r:r:Network.toggle_stabilizations 11&9r=cDURRU5Ulg)a Overrides the default options object passed to the VisJS framework. Delegates to the :meth:`options.Options.set` routine. :param options: The string representation of the Javascript-like object to be used to override default options. :type options: str N)r%r)r7r%s r: set_optionsNetwork.set_optionss||''0 r=)r"r5r*r!r$rr-r rrrr+r'r(rr%r.r,rr)r3r2r#r&r) 600pxz100%FFFFFz#ffffffFNrr)Nrz#97c2fc)z index.htmlTF)TFF)TT)FN)r)ig333333?gMbP? ףp= ?r)dg?g?rA)xgrB{Gz?rA)irErBg{Gz?g?r)rr)-__name__ __module__ __qualname____firstlineno____doc__r;rJrQr]rrrOrPrrrrrrrr6rFrrrrrrr{rrrr r rrrr#r'r+r0r3r7r:r=__static_attributes__rr=r:rrsh (-"""!&K!Z " x,t10f"H)T0&8(:x")J F CGA*MSM S:62 )3>T_#%1PTch</|#!"6L  5>  6>  &>PD5$ : :26 . 4: 1r=r)rGr/rtempfiler collectionsrrnetworkxrIPython.displayrjinja2rrrrrqr r%r r utilsr objectrrr=r:rSs= #"0'[1f[1r=