JGraLab is a Java graph library implementing so-called TGraphs: typed, attributed, ordered, and directed graphs. Beyond the plain data structure, the library contains an extensive algorithm library, the graph query language GReQL, the transformation API GReTL, and tons of utilities.
Installation and Building
Building from Sources
The following assumes that you create (or use) a workspace folder
jgsrc for JGraLab
and your JGraLab applications. Name and location of that workspace can be arbitrarily
When you plan to use Eclipse as IDE, the easiest is to put the
jgralab folder into
your Eclipse workspace folder.
The Ant build scripts require that your applications are located
in sibling folders next to
jgsrc/ # your jgralab workspace +-> jgralab/ # this project, i.e., jgralab itself +-> mygraphproject # your app has to sit next to jgralab
jgralab you need to have Apache Ant.
$ cd jgsrc/jgralab/ $ ant
jgralab folder contains an Eclipse
.classpath file, so that you
can import it in Eclipse as existing project. This import step is necessary also when
you initially decided to put JGraLab into the Eclipse workspace since
Eclipse does not automatically scan its workspace for new projects.
JGRaLab's Ant build generates many source files. Each time you run
ant, you have
to refresh the project in Eclipse, so that the changes get reflected in the IDE.
Getting Releases via Maven or Leiningen
The current and past JGraLab releases are pushed to the JGraLab Clojars site so that you can fetch them easily as project dependency via the Maven or Leiningen build and project management systems.
Downloading a Pre-Compiled Jar
You can download nightly builds from our
snapshots page. The
source jars contain the compiled class files and the source files. As such,
they are preferrable to the binary-only builds when you intend to develop
applications using JGraLab, because then you get nicer code completion, e.g.,
the real names of method parameters instead of just
You can find the API documentation for the current JGraLab master branch at our API Docs Page. This documentation is regenerated every night.
Every night, we run all our test cases against the current master branch and measure our coverage using Atlassian Clover. The results are accessible at our Coverage Report Page.
Tutorials and Getting Started
We've started writing a tutorial in the JGraLab Wiki. It's not yet complete, but we'll keep working on extending it.
Join us on the official JGraLab IRC Channel
irc.freenode.net). If you don't have or don't want to
install an IRC client, you can also
chat directly in your browser.
- GReTL: an extensible, operational, graph-based transformation language, Jürgen Ebert and Tassilo Horn, In: Software and Systems Modeling, 2012, http://dx.doi.org/10.1007/s10270-012-0250-3
- The GReTL Transformation Language, Tassilo Horn and Jürgen Ebert, In: Theory and Practice of Model Transformations - 4th International Conference, ICMT 2011, http://dx.doi.org/10.1007/978-3-642-21732-6_11
- Solving the TTC 2011 Compiler Optimization Case with GReTL, Tassilo Horn, TTC 2011, http://arxiv.org/abs/1111.4745v1
- Solving the TTC 2011 Reengineering Case with GReTL, Tassilo Horn, TTC 2011, http://arxiv.org/abs/1111.4747
- Saying Hello World with GReTL - A Solution to the TTC 2011 Instructive Case, Tassilo Horn, TTC 2011, http://arxiv.org/abs/1111.4762
- Reverse Engineering Using Graph Queries, Jürgen Ebert and Daniel Bildhauer, In: Schürr, Andy; Lewerentz, Claus; Engels, Gregor; Schäfer, Wilhelm; Westfechtel, Bernhard: Graph Transformations and Model Driven Engineering, 2010, http://uni-koblenz.de/~ist/documents/Ebert2010REU.pdf
Copyright (C) 2006-2014 The JGraLab Team firstname.lastname@example.org
Distributed under the General Public License, Version 3 with the following additional grant:
Additional permission under GNU GPL version 3 section 7 If you modify this Program, or any covered work, by linking or combining it with Eclipse (or a modified version of that program or an Eclipse plugin), containing parts covered by the terms of the Eclipse Public License (EPL), the licensors of this Program grant you additional permission to convey the resulting work. Corresponding Source for a non-source form of such a combination shall include the source code for the parts of JGraLab used as well as that of the covered work.