yedextended 1.0.9

Python library extending yEd functionality through programmatic interface to graphs.

Extended Python Support for yEd

This Python library extends the functionality of the readily available and free interactive graph editing program yEd, through providing a programmatic interface to graphs (of the GraphML file format), including the following use case or functions:

• creating graphs
• formatting graphs
• reading graphs
• bulk data addition or management (MS excel-based)
• management of the yEd application (starting, killing, maximizing)
• enforcing rules on graphs
• additional layout methods
• graph comparison tools

Basic Usage

Below are some basic usages of yEdExtended in interfacing with yEd and GraphML files:

Installing yEdExtended

From PyPI, using pip:

$ pip install yedextended  

From GITHUB, using pip:

$ python -m pip install git+https://github.com/cole-st-john/yEdExtended

From GITHUB, using git:

$ git clone https://github.com/cole-st-john/yedextended

Importing yEdExtended for usage

import yedextended as yed

Programmatically creating GraphML files

With yEdExtended you can easily create graphs, either through hardcoding, or more practically, through porting data from any data source (databases, csv, xml, etc) into a graph and graph objects (nodes, groups, edges, properties):

Hardcoding Example:

# Instantiate graph instance
graph1 = yed.Graph()

# Add arbitrary graph detail - nodes and edges
graph1.add_node("a")
graph1.add_node("b")
graph1.add_edge("a", "b")

# Add arbitrary graph detail - group and group objects
group1 = graph1.add_group("group 1", shape="rectangle")
group1.add_node("c")
group1.add_node("d")
group1.add_edge("c", "d")

Programmatic Example:

# Adding graph objects based on csv input
import csv
with open("examples/test.csv", encoding="utf-8-sig") as csv_file: 
	csv_reader = csv.reader(csv_file)
	for row in csv_reader:
	    graph1.add_node(row)

Reading existing GraphML files

yEdExtended can read GraphML files into a Python class structure, allowing for simple programmatic analysis and modification:

# Read graph file into python graph objects
graph1 = yed.Graph().from_existing_graph("examples/yed_created_edges.graphml")

Using formatting

yEdExtended provides for the majority of formatting one expects in yEd graphs.

# Add graph nodes and edges with some examples of non-default formatting
graph1.add_node(
    "foo",
    font_family="Zapfino",
)

graph1.add_node(
    "foo2",
    shape="roundrectangle",
    font_style="bolditalic",
    underlined_text="true",
)

graph1.add_edge(
    "foo1",
    "foo2",
)
graph1.add_node(
    "abc",
    font_size="72",
    height="100",
)

graph1.add_node(
    "bar",
    label="Multi\nline\ntext",
)
graph1.add_node(
    "foobar",
    label="""Multi
Line
Text!""",
)

graph1.add_edge(
    "foo",
    "foo1",
    label="EDGE!",
    width="3.0",
    color="#0000FF",
    arrowhead="white_diamond",
    arrowfoot="standard",
    line_type="dotted",
)

Manipulating data in MS Excel

Sometimes, it is practical to mass edit or enter data in an interactive way. yEdExtended includes functionality to enter basic to complex data and relationships using an interface to MS Excel interface. Note: to use this functionality, MS Excel must be installed and on path:

# Manage data in excel (add/remove/modify objects)
graph1.manage_graph_data_in_excel() # default is object and hierachy management

# Manage data in excel (add/remove/modify relations)
graph1.manage_graph_data_in_excel(type="relations")

Excel - Adding Objects / Groups:

Result:

Excel - Adding Relationships:

Result:

Possible outputs of Graph

Eventually, one normally wants to visualize or transmit the graph in some format. Here are a few options:

# Demonstrate stringified GraphML version of structure
print(graph1.stringify_graph())

# Several methods of writing graph to file ==============================

with open("test_graph.graphml", "w") as fp:  # using standard python functionality
    fp.write(graph1.stringify_graph())

graph_file = graph1.persist_graph("test.graphml")   # using tool specific method

graph_file = graph1.persist_graph("pretty_example.graphml", pretty_print=True)  #  tool specific with formatting

Opening files in yEd Application (assumes yEd installed and on PATH)

To ease task switching between Python and yEd, functionality has been added to open graphs in yEd directly from Python. Note: ensure you have installed yEd application from here and that the app is on PATH (Win: "where yed.exe" in CMD should output a path).

# From existing handle
graph_file.open_with_yed(force=True)

# From file path
yed.open_yed_file("examples/test.graphml")

Visualizing in yEd Application (Layout)

Following programmatic creation or modification of a graph, consider using the following keystrokes in yEd to improve layout / positioning (yEdExtended does not currently include functionality for layout, which is readily available in yEd):

• Tools -> Fit Node to Label (Win: Alt + T + N)
• Layout -> Hierarchical (Win: Alt + Shift + H)

Options

Provides comprehensive support for great variety of node_shapes, line_types, font_styles, arrow_types, custom parameters, UML, complex and deeply nested relationship structures and more.

Development

Interested in contributing or co-managing further development? Just reach out!

Dev. Requirements:

$ pip install pytest

To run the tests:

$ PYTHONPATH=. pytest tests

References:

• pyyed
• GraphML Primer
• NetworkX