The Big Picture
The KIELER Lightweight Diagrams (KLighD) project aims at offering transient lightweight representations of models or parts of them, without incorporating complex editing facilities like graphical editors.
Instead graphical or textual representations are to be synthesized from a chosen fraction of a model base and dismissed if they are not needed anymore. This way the Model-View-Controller paradigm (MVC) shall be established at the users' front end of modeling tools. Although KLighD is intended to address graphical as well as textual transient views, the graphical ones are currently in the focus. The automatic arrangement of those views (macro layout) is contributed by KIML.
Feel free to watch the following videos illustrating the idea and possibilities of transient views of models:
For details on the objectives of our KLighD framework have a look at the above mentioned publication Just Model! – Putting Automatic Synthesis of Node-Link-Diagrams into Practice (Sec. I, III, & V) first.
In order to build up your own diagrams by means of KLighD we suggest to install some of our provided features from our update site http://rtsys.informatik.uni-kiel.de/~kieler/updatesite/release_pragmatics_0.10.0: (If you seek for diagrams with nodes and edges connected via ports (as depicted in Figure 2 in Just Model! - ...), there's a new example illustrating this that is not part of our latest release. Hence, refer to the latest nightly build, or checkout our source code (get the repository url via 'Clone' in the upper right corner)):
- KIELER Lightweight Diagrams – Developer Resources & Examples:
This feature includes KLighD's & KIML's runtime as well as a few developer tools (e.g. a convenient project wizard) and a few prepared example diagram synthesis implementations. Besides, all source bundles will be installed.
- KIELER Layout – Graphviz support (optional):
This feature enables the employment of Graphviz' layouters,
dotis very popular for simple graphs with edge labels. Note that employing Graphviz requires to also install the native library, see http://www.graphviz.org/
- KIELER Layout – OGDF support (optional):
This feature enables the employment of OGDF' layouters, its
planarizationis the recommended algorithm for arranging UML Class Diagrams. The required OGDF Server Binaries will be automatically installed, too!
Create first diagrams
In order to let the framework draw your desired diagrams for representing given data we need to tell KLighD how obtain nodes, edges, and hierarchy levels from the provided data. To this end we need to implement a so called diagram synthesis. Getting an initial stub of such an implementation is most easiest done by means of our KLighD project wizard (if the entry is not visible, switch the perspective or close and reopen it, or simply choose Other... → KIELER Light-weight diagrams):
Provide the source model type, e.g. via the 'Browse' button. Note that the project containing that class must exist in the workspace or at least any other workspace project must have this class in its class path, e.g. via a bundle dependency. Otherwise it won't be offered by the list of available classes. Of course you might alter the project's name, the name of the diagram synthesis implementation and its containing package. Finally choose your favorite implementation language - we like Xtend very much for this purpose!
You will get the following implementation template, it is already registered at KLighD's dedicated extension point (see the project's plugin.xml).
createNode()) for each element comprised by the given instance
model (usually called the business, domain, or semantic model) of your data type, here
EPackage. Add those nodes to the children of
root. Create a
KEdge for each relation or link to be contained in your diagram. Similarly to
createNode() there is
createEdge() for that purpose. Set source and target node of those edges accordingly, this will implicitly add the edges to the diagram (via EMF's
EOpposite mechanism). You can reveal an already created node representing a certain domain element by calling domainElement.
getNode(), or simply domainElement.
node. Have a look at UML2UseCaseDiagramSynthesis, which is part of our examples project, on how to do that. If you interested in diagrams with nodes and edges connected via ports (as depicted in Figure 2 in Just Model! - ...) have a look at CircuitDiagramSynthesis. Note that this example is not part of our latest release yet so install a nightly build (sorry for its bugs ) or checkout our source code (get the repository url via 'Clone' in the upper right corner).
Finally attach figure specifications to the nodes and edges, most conveniently by means of the extension methods provided by the
...Extension classes - see the use case example on that, too. A documentation of those methods in form of a list of all extension methods sorted by the type they can be used with can be found here. (And yes, there is still some lack of documentation...)
For convenience you might also want to import the examples project into your workspace. Simply switch to the Plug-ins view and import
de.cau.cs.kieler.klighd.examples as Source Project.
Invoking the diagram synthesis
Testing the diagram synthesis is most easiest done by means of some menu contribution. Here are some instructions using the Eclipse 3.X API: Register a command with some arbitrary id and a default handler. In the
execute() method of your handler call
This statements will open an eclipse view part showing your desired diagram.
<<someId>> is an the Id that can be used to access, update, or close the view part later on programmatically, and
<<someName>> is the name of the view (shown at the view's tab),
<<yourConcreteData>> is an instance of the input type of your diagram synthesis implementation. Via the last parameter some additional instructions can be handed over. For those that are not yet familiar with Eclipse menu stuff have a look on at a corresponding tutorial, e.g. at vogella.com.
An exemplary use case diagram created according to the UML2UseCaseDiagramSynthesis is shown in following screenshot, the source UML model is part of the examples project, too.
Advanced diagram synthesis features
Now you might want to use some advanced features of KLighD diagrams, like sophisticated figure styling or diagram synthesis options. Details on that will follow soon, the
EcoreDiagramSynthesis, which allows to create appealing class diagrams from Ecore model and which you will also find in the examples project, illustrates those features already. The following picture shows such a diagram, and a list of options for tailoring such diagrams in the side bar on the right.
- Be sure to compile your Eclipse plug-in project with Java 5 or Java 6 compatibility.
- Increase the
perm memorysize with the VM argument
-XX:MaxPermSize=128M(Arguments tab of your Eclipse run configuration) if you get a