Skip to main content

A PyQt5 widget to manipulate (build, render, interact, load and save) Graphviz graphs

Project description

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

  1. Simple graphs visualization (nodes + edges)
  2. Simple gv files read/write
  3. Graph nodes can hold custom parameters that can be used by the application
  4. Graph nodes are now manipulable and we can add nodes and link them using the QWidget gui, wa can also delete nodes.
  5. The application can accept or refuse edges creation and even add custom parameters to the edges
  6. The nodes can be double clicked and an event is sent to the application allowing it to do custom
  7. User application is informed wen a new connection is created between two nodes, when a node is selected or when it is double clicked.
  8. Only two supported node shapes (box or oval)
  9. File parsing is not implemented yet
  10. Advanced nodes coloring and shapes are not yet implemented
  11. Subgraphs are not supported yet
  12. Only the dot layout is partially implemented

Example code

You can find an example code for manipulating graphs in examples/QGraphViewer.py.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

QGraphViz-0.0.14.tar.gz (8.1 kB view hashes)

Uploaded Source

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page