JGraLab

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 chosen.

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 jgralab.

jgsrc/               # your jgralab workspace
+-> jgralab/         # this project, i.e., jgralab itself
+-> mygraphproject   # your app has to sit next to jgralab

To build jgralab you need to have Apache Ant. Build jgralab.

$ cd jgsrc/jgralab/
$ ant

The jgralab folder contains an Eclipse .project and .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 arg0.

Documentation

API Documentation

You can find the API documentation for the current JGraLab master branch at our API Docs Page. This documentation is regenerated every night.

Coverage Report

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.

Getting Help

Join us on the official JGraLab IRC Channel (channel #jgralab on 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.

Publications

• 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

License

Copyright (C) 2006-2014 The JGraLab Team ist@uni-koblenz.de

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.