`UMLGraph dds`

UMLGraph - Declarative Drawing of UML Diagrams

UMLGraph allows the declarative specification and drawing of UML class and sequence diagrams. The current features are part of an ongoing effort aiming to provide support for all types UML diagrams. An IEEE Software article titled On the declarative specification of models explains the rationale behind this approach. The tehnology behind UMLGraph was used to draw many of the diagrams appearing in the book Code Reading: The Open Source Perspective (Addison Wesley, 2003). In addition, LightUML integrates UMLGraph into Eclipse, and Dotuml integrates UMLGraph into Maven. Furthermore, the Politecnico Di Torino SoftEng group has extended UMLGraph into the XUG reverse engineering tool, and Adam Feuer's PyUMLGraph system applies the concept to Python programs, Finally, Martin Fowler writes:

I thought I'd send you a note saying how much I enjoyed discovering UML Graph. I've long fancied a text based way of describing UML diagrams, but never felt sufficiently time-rich to develop anything.

Martin has created a bliki entry describing his ideas of what an ideal textual language might look like.

Class Diagrams

One specifies a class diagram using the Java syntax complemented by javadoc tags. Running the UmlGraph doclet on the specification will generate a Graphviz diagram specification that can be automatically processed to create Postscript, GIF, SVG, JPEG, fig, or Framemaker drawings.

The following is an example of a class diagram specification and the resulting UML diagram:

class Person {
	String Name;
}

class Employee extends Person {}

class Client extends Person {}

Sequence Diagrams

One specifies a sequence diagram using pic macros to define objects and method invocations. The GNU plotutils pic2plot program can then process the sequence diagram to create a PNG, PNM, (pseudo)GIF, SVG, AI, Postscript, CGM, FIG, PCL, HPGL, Regis, or TEK drawing.

The following is an example of a sequence diagram specification and the resulting UML diagram:

# Define the objects
object(O,"o:Toolkit");
placeholder_object(P);
step();

# Activation and messages
active(O);
message(O,O,"callbackLoop()");
create_message(O,P,"p:Peer");
message(O,P,"handleExpose()");
active(P);
return_message(P,O,"");
inactive(P);
destroy_message(O,P);
inactive(O);

# Complete the lifeline of O
step();
complete(O);

Download and Links

UMLGraph is hereby made freely available as Open Source Software. The current version of UMLGraph is VERSION. You can download UMLGraph and its documentation from the following links:

UmlGraph package version VERSION - .tar.gz (compressed tar file containing the source code, the compiled doclet, and the complete documentation in HTML format).
UmlGraph package version VERSION - .zip (zip file containing the source code, the compiled doclet, and the complete documentation in HTML format).
Documentation (table of contents - suitable for web browsing).
Printable documentation (the above as a single printable page).
Version history
freshmeat.net page (use it to subscribe and post comments).
UmlGraph package version 2.10 - .tar.gz (The last version compatible with Java 1.4; compressed tar file containing the source code, the compiled doclet, and the complete documentation in HTML format).
UmlGraph package version 2.10 - .zip (The last version compatible with Java 1.4; zip file containing the source code, the compiled doclet, and the complete documentation in HTML format).
UmlGraph binary - UmlGraph-VERSION.jar (jar file containing only the UmlGraph classes; please use this only for pulling UmlGraph into other projects).
MD5 checksums for each of the above .zip, .tar.gz, and jar archives.

Diomidis Spinellis home page

(C) Copyright 2002-2005 D. Spinellis. May be freely uploaded by WWW viewers and similar programs. All other rights reserved.
Last modified: $Date$