Project Homepage | Source Code Logo
2.5
  • Install
  • Tutorial
  • Gallery
  • Reference
    • Introduction
    • Graph types
    • Algorithms
    • Functions
    • Graph generators
    • Linear algebra
    • Converting to and from other data formats
    • Relabeling nodes
    • Reading and writing graphs
      • Adjacency List
      • Multiline Adjacency List
      • Edge List
      • GEXF
      • GML
      • Pickle
      • GraphML
      • JSON
      • LEDA
      • YAML
      • SparseGraph6
      • Pajek
      • GIS Shapefile
    • Drawing
    • Randomness
    • Exceptions
    • Utilities
    • Glossary
  • Developer Guide
  • Release Log
  • License
  • About Us
  • Citing
  • Bibliography
NetworkX
  • »
  • Reference »
  • Reading and writing graphs »
  • JSON »
  • networkx.readwrite.json_graph.node_link_data

networkx.readwrite.json_graph.node_link_data¶

node_link_data(G, attrs=None)[source]¶

Returns data in node-link format that is suitable for JSON serialization and use in Javascript documents.

Parameters
  • G (NetworkX graph)

  • attrs (dict) – A dictionary that contains five keys ‘source’, ‘target’, ‘name’, ‘key’ and ‘link’. The corresponding values provide the attribute names for storing NetworkX-internal graph data. The values should be unique. Default value:

    dict(source='source', target='target', name='id',
         key='key', link='links')
    

    If some user-defined graph data use these attribute names as data keys, they may be silently dropped.

Returns

data – A dictionary with node-link formatted data.

Return type

dict

Raises

NetworkXError – If values in attrs are not unique.

Examples

>>> from networkx.readwrite import json_graph
>>> G = nx.Graph([("A", "B")])
>>> data1 = json_graph.node_link_data(G)
>>> H = nx.gn_graph(2)
>>> data2 = json_graph.node_link_data(
...     H, {"link": "edges", "source": "from", "target": "to"}
... )

To serialize with json

>>> import json
>>> s1 = json.dumps(data1)
>>> s2 = json.dumps(
...     data2, default={"link": "edges", "source": "from", "target": "to"}
... )

Notes

Graph, node, and link attributes are stored in this format. Note that attribute keys will be converted to strings in order to comply with JSON.

Attribute ‘key’ is only used for multigraphs.

See also

node_link_graph(), adjacency_data(), tree_data()

Next Previous

© Copyright 2004-2020, NetworkX Developers Last updated on Aug 22, 2020.

Built with Sphinx using a theme provided by Read the Docs.