Graph Visualization for Python by Neo4j
neo4j-viz is a Python package for creating interactive graph visualizations.
The output is of type IPython.display.HTML and can be viewed directly in a Jupyter Notebook or Streamlit application.
Alternatively, you can export the output to a file and view it in a web browser.
The package wraps the Neo4j Visualization JavaScript library (NVL).
Some notable features
- Easy to import graphs represented as:
- projections in the Neo4j Graph Data Science (GDS) library
- graphs from Neo4j query results
- pandas DataFrames
- Node features:
- Sizing
- Colors
- Captions
- Pinning
- On hover tooltip
- Relationship features:
- Colors
- Captions
- On hover tooltip
- Graph features:
- Zooming
- Panning
- Moving nodes
- Using different layouts
- Additional convenience functionality for:
- Resizing nodes, optionally including scale normalization
- Coloring nodes based on a property
- Toggle whether nodes should be pinned or not
Please note that this list is by no means exhaustive.
Getting started
Installation
Simply install with pip:
pip install neo4j-viz
Basic usage
We will use a small toy graph representing the purchase history of a few people and products.
We start by instantiating the Nodes and Relationships we want in our graph. The only mandatory fields for a node are the "id", and "source" and "target" for a relationship. But the other fields can optionally be used to customize the appearance of the nodes and relationships in the visualization.
Lastly we create a
VisualizationGraph object with the
nodes and relationships we created, and call its render method to display the graph.
from neo4j_viz import Node, Relationship, VisualizationGraph
nodes = [
Node(id=0, size=10, caption="Person"),
Node(id=1, size=10, caption="Product"),
Node(id=2, size=20, caption="Product"),
Node(id=3, size=10, caption="Person"),
Node(id=4, size=10, caption="Product"),
]
relationships = [
Relationship(
source=0,
target=1,
caption="BUYS",
),
Relationship(
source=0,
target=2,
caption="BUYS",
),
Relationship(
source=3,
target=2,
caption="BUYS",
),
]
VG = VisualizationGraph(nodes=nodes, relationships=relationships)
VG.render()
This will return a IPython.display.HTML object that can be rendered in a Jupyter Notebook or streamlit application.
Please refer to the documentation for more details on the API and usage.
Examples
For more extensive examples, including how to import graphs from Neo4j GDS projections and Pandas DataFrames, checkout the tutorials chapter in the documentation.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file neo4j_viz-1.8.0.tar.gz.
File metadata
- Download URL: neo4j_viz-1.8.0.tar.gz
- Upload date:
- Size: 5.4 MB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e0d052beb1d1d184442303a368d5620830c50f29ea4ba373fbcb22e5bfb0f623
|
|
| MD5 |
cb673a625f119e98b0833a1ac4e5d877
|
|
| BLAKE2b-256 |
ebd17de2c121c0e93b8bfefdf51c4b1a7a29eaf249bb798f07c1b9fcadacda36
|
File details
Details for the file neo4j_viz-1.8.0-py3-none-any.whl.
File metadata
- Download URL: neo4j_viz-1.8.0-py3-none-any.whl
- Upload date:
- Size: 5.5 MB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/7.0.0 CPython/3.14.7
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ba0a3cc0cc36aa9c824ad4858ba7aa76b44465c42f2dcc61aab2c93d56caf8f7
|
|
| MD5 |
6af0e24232f5dde841cf59836e9823b4
|
|
| BLAKE2b-256 |
a5d2fdcd4c6dfdc41687670226118a25e731d0eb7baa6edc6ffb858b57706a33
|
