Welcome to nxviz’s documentation!


Join the chat at https://gitter.im/ericmjl/nxviz https://img.shields.io/pypi/v/nxviz.svg https://img.shields.io/travis/ericmjl/nxviz.svg Documentation Status

nxviz is a graph visualization package for NetworkX. With nxviz, you can create beautiful graph visualizations by a declarative API. Here’s an example.

# Assume we have a professional network of physicians belonging to hospitals.
c = CircosPlot(G, node_color='affiliation', node_grouping='affiliation')
plt.show()  # only needed in scripts
  • This is free software distributed under the MIT License.


For requirements, consult the requirements.txt file in the GitHub repository. As a matter of practice, nxviz development will try (where relevant) to take advantage of the latest Python features. As of 18 September 2017, this means Python 3.6 is the “officially” supported version, as there are places where we use f-string formatting to simplify logging and debugging.


  • Declarative API.
  • Works with NetworkX, one of the more popular graph libraries in Python.

Feature Requests

If you have a feature request, please post it as an issue on the GitHub repository issue tracker. Even better, put in a PR for it! I am more than happy to guide you through the codebase so that you can put in a contribution to the codebase - and I’ll give you a digital nxviz contributor badge that you can put on your personal website, as a way of saying thanks!

Because nxviz is currently maintained by volunteers and has no fiscal support, any feature requests will be prioritized according to what maintainers encounter as a need in our day-to-day jobs. Please temper expectations accordingly.

Indices and tables