Description

JUNG — the Java Universal Network/Graph Framework--is a software library that provides a common and extendible language for the modeling, analysis, and visualization of data that can be represented as a graph or network.

Installation

The current version of griffon-jung-plugin is 0.1.1

To install just issue the following command

griffon install-plugin jung

Usage

The following nodes will become available on a View script upon installing this plugin

Node	Property	Type	Default	Required	Bindable	Notes
basicVisualizationViewer [BasicVisualizationViewer]	graph	Graph				either set a value for this property or set a value for the node
	graphLayout	Layout				either set a value for this property or set a value for the node
visualizationViewer [VisualizationViewer]	graph	Graph				either set a value for this property or set a value for the node
	graphLayout	Layout				either set a value for this property or set a value for the node
balloonLayout [BalloonLayout]	graph	Forest				either set a value for this property or set a value for the node
circleLayout [CircleLayout]	graph	Graph				either set a value for this property or set a value for the node
dagLayout [BalloonLayout]	graph	Graph				either set a value for this property or set a value for the node
frLayout [FRLayout]	graph	Graph				either set a value for this property or set a value for the node
frLayout2 [FRLayout2]	graph	Graph				either set a value for this property or set a value for the node
isomLayout [ISOMLayout]	graph	Graph				either set a value for this property or set a value for the node
kkLayout [KKLayout]	graph	Graph				either set a value for this property or set a value for the node
radialTreeLayout [RadialTreeLayout]	graph	Forest				either set a value for this property or set a value for the node
springLayout [SpringLayout]	graph	Graph				either set a value for this property or set a value for the node
springLayout2 [SpringLayout2]	graph	Graph				either set a value for this property or set a value for the node
staticLayout2 [StaticLayout]	graph	Graph				either set a value for this property or set a value for the node
treeLayout [RadialTreeLayout]	graph	Forest				either set a value for this property or set a value for the node
defaultModalGraphMouse [DefaultModalGraphMouse]						nest it inside a visualizationViewer

You can set a Graph value or graph: property on each layout node, if not specified it will use its parent's graph.

This plugin includes a few vertex decorators that will allow you to tweak a vertex's shape:

griffon.jung.visualization.decorators.BasicVertexShapeTransformer

Constructor signatures are:

• BasicVertexShapeTransformer(groovy.lang.Closure shapeTransformer, boolean cacheShapes = true)
• BasicVertexShapeTransformer(Transformer<V,Shape> shapeTransformer, boolean cacheShapes = true)
• BasicVertexShapeTransformer(Transformer vsf<V,Integer>, Transformer<V,Float> varf, groovy.lang.Closure shapeTransformer, boolean cacheShapes = true)
• BasicVertexShapeTransformer(Transformer vsf<V,Integer>, Transformer<V,Float> varf, Transformer<V,Shape> shapeTransformer, boolean cacheShapes = true)

Either set a Closure or a Transformer<V,Shape> that hols the logic of computing a vertex's (v) shape. This decorator will cache all generated shapes by default.

griffon.jung.visualization.decorators.TemplateVertexShapeTransformer

Constructor signatures are:

• TemplateVertexShapeTransformer(Shape template = new Rectangle2D.Double(0d,0d,1d,1d))
• TemplateVertexShapeTransformer(Transformer vsf<V,Integer>, Transformer<V,Float> varf, Shape template = new Rectangle2D.Double(0d,0d,1d,1d))

You just need to set a template Shape. All shapes will be cached.

Simplified Transitive Properties Both basicVisualizationViewer and visualizationViewer will attempt setting properties on their respective RenderContext and Renderer. This simplifies greatly the amount of code you'd had to write otherwise. The following example demonstrates this feature.

Here is an example graph visualization that uses TemplateVertexShapeTransformer coupled with jSilhouette's Star shape, it also attaches a few decorators and helpers.

import edu.uci.ics.jung.graph.Graph
import edu.uci.ics.jung.graph.SparseMultigraph
import edu.uci.ics.jung.visualization.decorators.ToStringLabeller
import edu.uci.ics.jung.visualization.renderers.Renderer
import org.apache.commons.collections15.Transformer
import org.apache.commons.collections15.functors.ConstantTransformer
import java.awt.Color
import org.kordamp.jsilhouette.geom.Star
import griffon.jung.visualization.decorators.TemplateVertexShapeTransformer

int max = 10
Graph g = new SparseMultigraph()
(1..max).each { Integer i -> g.addVertex(i) }
(1..<max).each { Integer x -> g.addEdge("Edge-$x", x, x+1) }
g.addEdge("Edge-${max}", max, 1)

def colorMap = [:]
Random r = new Random()
def paintTransformer = { Integer i ->
  colorMap.get(i, new Color(r.nextInt(64)+192i, 0i, 0i))
} as Transformer

bean(id: "star", new Star(), or: 40f, ir: 20f, count: 5i)
bean(id: "starrer", new TemplateVertexShapeTransformer(star), sizeTransformer: new ConstantTransformer(40i))

application(title: 'JUNG + Griffon',
  pack: true,
  locationByPlatform:true,
  iconImage: imageIcon('/griffon-icon-48x48.png').image,
  iconImages: [imageIcon('/griffon-icon-48x48.png').image,
               imageIcon('/griffon-icon-32x32.png').image,
               imageIcon('/griffon-icon-16x16.png').image]) {
  visualizationViewer(g, id: "gview", preferredSize: [350,350],
       vertexShapeTransformer: starrer, edgeLabelTransformer: new ToStringLabeller(),
       vertexLabelTransformer: new ToStringLabeller(), vertexFillPaintTransformer: paintTransformer) {
    circleLayout(size: [330, 330])
    defaultModalGraphMouse()
  }
  gview.renderer.vertexLabelRenderer.position = Renderer.VertexLabel.Position.CNTR
}

For more information consult JUNG's Documentation page, the tutorial is quite good!

History