Discontinued Projects - Editor for Graphs (KEG) 

Page / - last modified by msp on 2012/10/09 13:21 

Editor for Graphs (KEG) 
last modified by msp
on 2012/10/09 13:21

Table of Contents
Random Graph Creation
Importing Graphs
Exporting Graphs
Automatic Layout
Graph Analysis

Legacy Project
KEG is not maintained anymore and hence not part of any release. To test layout algorithms, we now use the KGraph Text Editor with KLighD.
Project Overview
Responsible:
•	@msp 
Related Theses:
•	Martin Rieß, A Graph Editor for Algorithm Engineering, September 2010 (pdf)
The KIELER Editor for Graphs (KEG) is an Eclipse-based graph editor designed for the development of graph algorithms, especially layout algorithms. To fit this purpose the KEG is able to represent most of the structures which are of interest in graph theory and supplies tools to construct and verify graph instances:
•	Nodes
•	Directed and undirected edges
•	Hyperedges, using a combination of hypernodes and common directed or undirected edges
•	Ports
•	Compound nodes
•	Node and edge labels
To start using the editor create a new KEG Diagram with the appropriate wizard. This will automatically open a new diagram editor and create the two required files: the *.keg file containing the KEG model and the *.kegdi file containing the GMF notation model, that is a GMF specific model to hold information about the layout of the diagram and the linkage of diagram elements to model elements.
Create an empty graph
File → New → Other... → KIELER → KEG Diagram
Random Graph Creation
An alternative to starting with an empty diagram is the random graph wizard, which allows the user to generate a KEG graph utilizing one of several configurable creation algorithms. The used algorithm determines the general structure of the generated graph:
•	Any Graph - can create any kind of graph, customizations can restrict the randomness by disallowing self-loops, multi-edges and cycles
•	Tree - creates a rooted tree with specified maximum degree and width
•	Biconnected Graph - creates a biconnected graph
•	Triconnected Graph - creates a triconnected graph
•	Acyclic graph without transitive edges - creates an acyclic graph without transitive edges, can be customized to force planarity
For all selected algorithms the number of nodes in the generated graph has to be specified, and in most cases the number of edges can be specified directly. The implemented graph creation algorithms are based upon the implementations found in the OGDF library.
Create a random graph
File → New → Other... → KIELER → Random KEG Graph
Importing Graphs
There are many use-cases in which it is not required or desired to construct a graph by hand or generating a random graph, because a preexisting graph library fulfills all required criteria. In this cases importing those graph files is the best solution. The graph import wizard provided by KEG can import from the following graph formats:
•	GraphML
•	KGraph
•	OGML
•	Dot
Note that in some cases the interpretation of values in those models is not clearly specified and can differ in other implementations.
Import an existing graph
File → Import... → KIELER → Graphs to KEG Graphs
Exporting Graphs
Graphs created with KEG can be exported to different formats (a list is shown on the generated layout web service page).
Export a KEG graph
File → Export... → KIELER → Export Graph
Automatic Layout
The layout algorithms provided by the Layout project can be applied to KEG diagrams using the KIML user interface. The KEG editor is a good choice for testing these algorithms.
Invoke automatic layout
Hit first Ctrl + R, then L (on MacOS: Cmd + R, then L)
Graph Analysis
KIML provides various graph analysis algorithms for obtaining information on the structure and the drawing of a graph. This can also be applied in batch mode in order to analyze a large number of graphs.