QGraphViz
A PyQT based GraphViz builder/renderer (100% opensource)
Introduction
I was searching for a handy tool to code graphs using python then visualize them within my software. I found about graphviz which is a great tool to build graphs.
The problem is that you need to install the graphviz software in order to compile your file and render it. There is a graphviz package on PYPI that allows creating dot code that can then be processed by graphviz, but in practice, you need to install graphviz and somehow add it to your path in order to execute the render command.
PyGraphviz is another package that can be used. But as you can read in their documentation, you still need to install Graphviz.
I also found this visualizer based on pyQt4. It is a simple Qt based visualizer that tracks the updates on the .gv file and redraws it in realtime: DDorch/GraphVizLiveUpdateViewer
So since I didn't find any package out there that satifies my needs, I decided to create a pyQT5 based Graphviz tool that can visualize Graphviz code without the need to install Graphviz and provide it with MIT licence, so that other people can simply use it in their software.
Objective
Build python pyQT5 based QWidget that can visualize graphs and allow realtime interaction with graphs add edges and nodes, change attributes ...
Requirements
As its name suggests, this module needs you to install pyqt5 package first.
pip install pyqt5
Installation
pip install QGraphViz
Actual status
- Simple graphs visualization (nodes + edges)
- Simple gv files read/write
- Graph nodes can hold custom parameters that can be used by the application
- Graph nodes are now manipulable and we can add nodes and link them using the QWidget gui, wa can also delete nodes.
- The application can accept or refuse edges creation and even add custom parameters to the edges
- The nodes can be double clicked and an event is sent to the application allowing it to do custom
- User application is informed wen a new connection is created between two nodes, when a node is selected or when it is double clicked.
- User application is informed when a edge is selected or double clicked.
- Only two supported node shapes (box or oval)
- Advanced nodes shapes are not yet implemented
- Subgraphs are not supported yet
- Only the dot layout is implemented
Example code
You can find an example code for manipulating graphs in examples/QGraphViewer.py.
Changelog
V 0.0.19 :
Bugfix in opening files with clusters Cluster paramters syntax is still incompatible with Standard GraphViz syntax: subgraph [parameters]{ put nodes here }
V 0.0.20 :
Better compatibility with Graphviz. Clusters can now have graphviz style parameters Semicolumn at the end of each line is no more needed
V 0.0.21 :
Fixed subgraph loading code
V 0.0.24 :
Added save and load json format graphs
V 0.0.25 :
Added the possibility to add multiple edges between the same nodes two nodes The cycles are still forbidden as they break the Dot engine
V 0.0.26 :
Edge selection when more than a single edge is used between two nodes
V 0.0.27 :
Added edge event. Now adding edge results in two events:
- The first event is new_edge_beingAdded_callback which asks the application to validate the edge adding.
- The second event is new_edge_created_callback whicj informs the application that the edge is created
V 0.0.28 :
Added node removed and edge removed events.
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
File details
Details for the file QGraphViz-0.0.28.tar.gz.
File metadata
- Download URL: QGraphViz-0.0.28.tar.gz
- Upload date:
- Size: 12.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
twine/1.13.0 pkginfo/1.5.0.1 requests/2.21.0 setuptools/41.0.0 requests-toolbelt/0.9.1 tqdm/4.28.1 CPython/3.6.6
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
94c1e3df3ba7b52d9b670478b789e583a6051cd1726d41da5924d92fb6d17879
|
|
| MD5 |
943c77d11a0e13d8f072cd5648067ee8
|
|
| BLAKE2b-256 |
b13a7319a1cf7915ef543d37f3487ed2a0f518dc2dbf039b2d0703cece53e9a9
|
