Difference between revisions of "Wgraph"

From FollowTheScore
Jump to: navigation, search
 
(39 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 
== Wgraph -- the mediawiki graph definition tool ==
 
== Wgraph -- the mediawiki graph definition tool ==
  
''Wgraph'' is a mediawiki extension which supports graph drawing. With ''Wgraph'' you '''define the semantics of a graph''' in an abstract textual notation called WGL (''Wiki Graph Language''). You may add hints for layout, but the graph itself is being produced automatically. ''Wgraph'' is a powerful visualisation instrument for objects and their relations. It is NOT a 'wysiwyg' drawing tool.
+
''Wgraph'' is a mediawiki extension which supports graph drawing. With ''Wgraph'' you '''define the semantics of a graph''' in an abstract textual notation called WGL (''Wiki Graph Language''). You may add hints for layout, but the graph itself will be produced automatically. ''Wgraph'' is a powerful visualisation instrument for objects and their relations. It is NOT a 'wysiwyg' drawing tool.
  
 
{|
 
{|
Line 12: Line 12:
 
   node gdl        { type data    label "graph definition\n-- GDL --" }
 
   node gdl        { type data    label "graph definition\n-- GDL --" }
 
   edge gdl aisee  { }
 
   edge gdl aisee  { }
   node aisee      { type process  label "aiSee\nlayout generator" }
+
   node aisee      { type process  label "aiSee\nlayout generator"  
   edge aisee img  { kind leftnear }
+
                    href aiSee } // hyperlink to article (only svg)
 +
   edge aisee img  { kind leftnear color blue }
 
   node img        { type data    label "image\n-- png, svg --"  
 
   node img        { type data    label "image\n-- png, svg --"  
 
                     shape hexagon }
 
                     shape hexagon }
Line 31: Line 32:
 
   node gdl        { type data    label "graph definition\n-- GDL --" }
 
   node gdl        { type data    label "graph definition\n-- GDL --" }
 
   edge gdl aisee  { }
 
   edge gdl aisee  { }
   node aisee      { type process  label "aiSee\nlayout generator" }
+
   node aisee      { type process  label "aiSee\nlayout generator"  
   edge aisee img  { kind leftnear }
+
                    href aiSee } // hyperlink to article (only svg)
 +
   edge aisee img  { kind leftnear color blue }
 
   node img        { type data    label "image\n-- png, svg --"  
 
   node img        { type data    label "image\n-- png, svg --"  
 
                     shape hexagon }
 
                     shape hexagon }
Line 45: Line 47:
 
   
 
   
 
----
 
----
Graph layout is a very challenging task. ''Wgraph'' delegates most of this task to a brilliant product called '''[http://www.aisee.com aiSee]'''. aiSee came out of the German university area one decade ago and is now being marketed commercially by [http://www.absint.com ''AbsInt - Angewandte Informatik'', Saarbrücken, Germany]. You can download a [http://www.absint.com/aisee/download/ free 30-day trial license]. ''aiSee can be registered for free for non-commercial use.'' Non-commercial use is educational, academic research and private use. Non-commercial users can get a license key that extends the usage period of the trial version until February 14, 2008. After that you will have to download aiSee again (and the usage period will be extended for another year, provided the usage is still non-commercial).
+
Graph layout is a very challenging task. ''Wgraph'' delegates most of this task to a brilliant product called '''[http://www.aisee.com aiSee]'''. aiSee came out of the German university area 15 years ago and is now being marketed commercially by [http://www.absint.com ''AbsInt'', Saarbrücken, Germany]. You can download a free 30-day trial version. Here are direct download links for your convenience:
  
== The two modes to use ''Wgraph'' ==
+
* [http://www.absint.com/dla/wgraph/aiSee.exe aiSee 2.2.28 for Windows (3.5MB)]
 +
* [http://www.absint.com/dla/wgraph/aiSee_linux.tgz aiSee 2.2.28 for 32-bit Linux (1.9MB)]
 +
* [http://www.absint.com/dla/wgraph/aiSee_linux64.tgz aiSee 2.2.28 for 64-bit Linux (2.0MB)]
 +
* [http://www.absint.com/aisee/download/ Other platforms]
 +
 
 +
''aiSee can be registered for free for non-commercial use.'' Non-commercial use is educational, academic research and private use. Non-commercial users can get a license key that extends the usage period of the trial version until February 14, 2009. After that you will have to download aiSee again (and the usage period will be extended for another year, provided the usage is still non-commercial).
 +
 
 +
== The two modes to use ''Wgraph'' ==
  
 
''Wgraph'' is an interface between mediawiki and aiSee. It hides aiSee completely from the eyes of the user and adds a small additional abstraction layer to make graph definitions even more comfortable than with native aiSee.
 
''Wgraph'' is an interface between mediawiki and aiSee. It hides aiSee completely from the eyes of the user and adds a small additional abstraction layer to make graph definitions even more comfortable than with native aiSee.
  
* The direct way to use ''wgraph'' is to invoke the parser function ''#wgraph'' with your WGL code as a parameter.
+
* The direct way to use ''Wgraph'' is to invoke the parser function ''#wgraph'' with your WGL code as a parameter.
* In combination with another mediawiki extension (called DPL: ''Dynamic Page List'') you can even visualize structural aspects of your wiki as a '''wikigraph'''. In a [[wikigraph]] articles map to nodes, categories to nodetypes and relations are deduced from template calls.  
+
* In combination with another mediawiki extension (called DPL: ''Dynamic Page List'') you can even visualize structural aspects of your wiki as a '''wikigraph'''. In a [[Wgraph:Example 3|wikigraph]] articles map to nodes, categories to nodetypes and relations are deduced from template calls.
 +
 
 +
With ''Wgraph'' you can view a graph definition from different angles. You can '''hide''' certain nodes / edges and emphasize others. You can '''group nodes to subgraphs''' and show them in a special surrounding box. There are several '''layout strategies''' to choose from. You control the graphical representation of nodes and edges using '''shapes, colors, linestyles, arrows''' and even '''bitmap images'''. To avoid redundancy and reach a higher level of abstraction you can take advantage of the built-in WGL '''type concept'''.
  
With ''wgraph'' you can view a graph definition from different angles. You can '''hide''' certain nodes / edges and emphasize others. You can '''group nodes to subgraphs''' and show them in a special surrounding box. There are several '''layout strategies''' to choose from. You control the graphical representation of nodes and edges using '''shapes, colors, linestyles, arrows''' and even '''bitmap images'''. To avoid redundancy and reach a higher level of abstraction you can take advantage of the built-in WGL '''type concept'''.
+
Graphs are produced in png and svg format. In addition there is a png thumb image. Apart from viewing the generated graph in the browser, aiSee can be used as a local client application. This gives enhanced possibilities of edge concentration, subgraph folding etc. Make sure that you comply to the [http://www.absint.com licensing terms of AnsInt].
  
Graphs are produced in png and svg format. In addition there is a png thumb image. Apart from viewing the generated graph in the browser, aiSee can be used as a local client application. This gives enhanced possibilities of edge concentration, subgraph folding etc. Make sure that you comply to the licensing terms of [http://www.absint.com].
+
== [[mw:Extension:Wgraph|Wgraph]] &nbsp; -- &nbsp;  current release is <big> [[Wgraph:Version History|0.87]] </big> ==
  
 
{|class=wikitable
 
{|class=wikitable
 
!more to read ..
 
!more to read ..
!Other stuff
 
 
!Gallery
 
!Gallery
 
|-
 
|-
 
|
 
|
* '''[[Wgraph fundamentals]]'''
+
* '''[[Wgraph:Fundamentals]]'''
* [[Wgraph architecture]]
+
* [[Wgraph:Architecture]]
* [[Wgraph tutorial]]
+
* [[Wgraph:Command Reference|Command Reference (under construction)]]
* [[Wgraph commandline arguments]]
+
* [[Wgraph:Tutorial|Tutorial]]
* [[Wgraph manual]]
+
* [[:Category:Wgraph Manual|Manual]]
|
+
* [[Wgraph:Commandline arguments|Command line arguments]]
* [[Wgraph installation]]
+
* [[Wgraph:Requests for new features|Requests for new features]]
* [[Wgraph bugs]]
+
* [[Wgraph:Bug Reports|Bug Reports]]
* [[Wgraph to do | the author's to do list]]
+
* [[Wgraph:Known Bugs|Known Bugs]]
|
+
* [[Wgraph:Websites using Wgraph|Websites using Wgraph]]
* [[Wgraph Sample Genealogy]]
+
* [[Wgraph:Discussion|Discussion]]
* [[Wgraph demo 1]]
+
* [[Wgraph:Version History|History]]
* [[Wgraph demo 2]]
+
* [[Wgraph:Installation|Installation]]
* [[Wgraph demo 3]]
+
 
 +
|valign=top|
 +
* [[Wgraph:Example 1]]
 +
* [[Wgraph:Example 2]]
 +
* [[Wgraph:Example 3]]
 +
* [[Wgraph:Example 4]]
 +
* [[Wgraph:Ahnen|Sample from the aiSee website]]
 +
* [[Wgraph:Sample Genealogy]]
 +
* [[Wgraph:Example Timebar]]
 
|}
 
|}
  
== A first example ==
+
If you are using Wgraph please put a reference to your wiki in [[Wgraph:Websites using Wgraph]]. If you would like to have Wgraph as part of the Wikipedia, <!--[http://bugzilla.wikimedia.org/show_bug.cgi?id=9203 ,--> vote for it on bugzilla.
 
 
{|class=wikitable
 
![[wgraph sample 1.wgl|WGL source]]
 
!orientation = top_to_bottom<br>node.color = lightyellow
 
!align=left|orientation = left_to_right<br>node.color = lightmagenta<br>node.shape = hexagon<br>node.width = 30<br>edge.color = red
 
|-
 
|{{:wgraph sample 1.wgl}}
 
|{{#wgraph: name= wgraph_sample_1  | png | svg |
 
 
 
  {{:wgraph sample 1.wgl}}
 
    node.color = lightyellow
 
  }}
 
 
 
|{{#wgraph: name= wgraph_sample_1a | png | svg |
 
 
 
  {{:wgraph sample 1.wgl}}
 
    orientation = left_to_right
 
    node.color = lightmagenta
 
    node.shape = hexagon
 
    node.width = 30
 
    edge.color = red
 
  }}
 
|}
 
  
 
[[Category:Wgraph]]
 
[[Category:Wgraph]]

Latest revision as of 09:53, 7 February 2011

Wgraph -- the mediawiki graph definition tool

Wgraph is a mediawiki extension which supports graph drawing. With Wgraph you define the semantics of a graph in an abstract textual notation called WGL (Wiki Graph Language). You may add hints for layout, but the graph itself will be produced automatically. Wgraph is a powerful visualisation instrument for objects and their relations. It is NOT a 'wysiwyg' drawing tool.

{{#wgraph: svg | thumb = 40 |

 node wgl         { type data     label "text notation\n-- WGL --" }
 edge wgl wgraph  { kind rightnear color red }
 node wgraph      { type process  label "Wgraph\nmediawiki extension" }
 edge wgraph gdl  { }
 node gdl         { type data     label "graph definition\n-- GDL --" }
 edge gdl aisee   { }
 node aisee       { type process  label "aiSee\nlayout generator" 
                    href aiSee } // hyperlink to article (only svg)
 edge aisee img   { kind leftnear color blue }
 node img         { type data     label "image\n-- png, svg --" 
                    shape hexagon }
 nodetype data    { shape ellipse, color lightyellow,
                    bordercolor khaki, height 60 }
 nodetype process { shape box color lightmagenta 
                    bordercolor magenta height 60 }
 xspace=70, yspace=100

}}

{{#wgraph: svg | thumb = 40 |
  node wgl         { type data     label "text notation\n-- WGL --" }
  edge wgl wgraph  { kind rightnear color red }
  node wgraph      { type process  label "Wgraph\nmediawiki extension" }
  edge wgraph gdl  { }
  node gdl         { type data     label "graph definition\n-- GDL --" }
  edge gdl aisee   { }
  node aisee       { type process  label "aiSee\nlayout generator" 
                     href aiSee } // hyperlink to article (only svg)
  edge aisee img   { kind leftnear color blue }
  node img         { type data     label "image\n-- png, svg --" 
                     shape hexagon }
  nodetype data    { shape ellipse, color lightyellow,
                     bordercolor khaki, height 60 }
  nodetype process { shape box color lightmagenta 
                     bordercolor magenta height 60 }
  xspace=70, yspace=100
}}

Graph layout is a very challenging task. Wgraph delegates most of this task to a brilliant product called aiSee. aiSee came out of the German university area 15 years ago and is now being marketed commercially by AbsInt, Saarbrücken, Germany. You can download a free 30-day trial version. Here are direct download links for your convenience:

aiSee can be registered for free for non-commercial use. Non-commercial use is educational, academic research and private use. Non-commercial users can get a license key that extends the usage period of the trial version until February 14, 2009. After that you will have to download aiSee again (and the usage period will be extended for another year, provided the usage is still non-commercial).

The two modes to use Wgraph

Wgraph is an interface between mediawiki and aiSee. It hides aiSee completely from the eyes of the user and adds a small additional abstraction layer to make graph definitions even more comfortable than with native aiSee.

  • The direct way to use Wgraph is to invoke the parser function #wgraph with your WGL code as a parameter.
  • In combination with another mediawiki extension (called DPL: Dynamic Page List) you can even visualize structural aspects of your wiki as a wikigraph. In a wikigraph articles map to nodes, categories to nodetypes and relations are deduced from template calls.

With Wgraph you can view a graph definition from different angles. You can hide certain nodes / edges and emphasize others. You can group nodes to subgraphs and show them in a special surrounding box. There are several layout strategies to choose from. You control the graphical representation of nodes and edges using shapes, colors, linestyles, arrows and even bitmap images. To avoid redundancy and reach a higher level of abstraction you can take advantage of the built-in WGL type concept.

Graphs are produced in png and svg format. In addition there is a png thumb image. Apart from viewing the generated graph in the browser, aiSee can be used as a local client application. This gives enhanced possibilities of edge concentration, subgraph folding etc. Make sure that you comply to the licensing terms of AnsInt.

Wgraph   --   current release is 0.87

more to read .. Gallery

If you are using Wgraph please put a reference to your wiki in Wgraph:Websites using Wgraph. If you would like to have Wgraph as part of the Wikipedia, vote for it on bugzilla.