A Python module for applying readability metrics graph and network visualizations.
Project description
graphreadability
Python module for applying readability metrics to network and graph visualizations. This project is a work in progress that is being developed by Philip Mathieu (MS DS Student) as part of the Research Apprenticeship program at Northeastern University's Khoury College of Computer Science.
Usage
import networkx as nx
import graphreadability as gr
# Create a basic graph using NetworkX
G = nx.Graph()
G.add_nodes_from(
[
(1, {"x": 1, "y": 1}),
(2, {"x": -1, "y": 1}),
(3, {"x": -1, "y": -1}),
(4, {"x": 1, "y": -1}),
(5, {"x": 2, "y": 1}),
]
)
G.add_edges_from([(1, 2), (2, 3), (3, 4), (4, 2), (1, 3)])
# Create a MetricsSuite to calculate readability metrics
M = gr.MetricsSuite(G)
M.calculate_metrics()
M.pretty_print_metrics()
Utilities
Graph Digitizer
This utility is a python package using matplotlib
to show and image and allowing the user to click to add nodes, right click to delete nodes, and click two nodes sequentially to add edges.
python graphreadability/utils/digitize_graphs.py -h
usage: digitize_graphs.py [-h] [-i IMAGE] [-o OUTPUT]
Create a graph from an image.
options:
-h, --help show this help message and exit
-i IMAGE, --image IMAGE
Path to the image to create a graph from.
-o OUTPUT, --output OUTPUT
Path to save the graph to.
Sources Cited
Metric definitions are derived from:
- C. Dunne, S. I. Ross, B. Shneiderman, and M. Martino. "Readability metric feedback for aiding node-link visualization designers," IBM Journal of Research and Development, 59(2/3) pages 14:1--14:16, 2015.
Initial inspiration was taken from rpgove/greadability.js.
Code in graphreadability/metrics/
is in part derived from code originally published at https://github.com/gavjmooney/graph_metrics/ associated with the following publication:
@Conference{citekey,
author = "Gavin J. Mooney, Helen C. Purchase, Michael Wybrow, Stephen G. Kobourov",
title = "The Multi-Dimensional Landscape of Graph Drawing Metrics",
booktitle = "2024 IEEE 17th Pacific Visualization Symposium (PacificVis)",
year = "2024",
}
License
Apache 2.0 - see LICENSE.txt
Project details
Release history Release notifications | RSS feed
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
Hashes for graphreadability-0.0.3-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 26400756198894be3360a5ebbfd330d3eb0a68dc8b180e56353de881989ba1c4 |
|
MD5 | 13cb3fec51c82356e369be5f8848265f |
|
BLAKE2b-256 | a70630254f4169df8986e1d3100f04aa9520a0774f70d0a4dacfb253a90a9af2 |