View source for D3 tree service module

The D3 tree module uses the [https://github.com/mbostock/d3/wiki/Tree-Layout D3 partition layout] to visualize hierarchial topic structures in Wandora. It uses the open source JavaScript visualization library [http://d3js.org/ D3.js]. The service module's alias in Wandora is '''d3tree''' and the URL of the visualization is 

 http://127.0.0.1:8898/d3tree

The visualization facilitates different hierarchies with HTTP parameters used to specify the hierarchy's root topic, child-parent-association and respective child and parent roles in the association. By default the depth of recursion through the hierarchy is limited to 5 recursions but may also be overridden with a HTTP parameter.

A complete description of the parameters is provided on the visualization page and an example of their use follows below.

Note that as with D3 the browser support of D3 visualizations in Wandora is limited to IE9+ and up to date versions of Firefox, Chrome (+Chromium), Safari and Opera.

By default the visualization shows a hierarchy where Wandora Class is the root topic, the parent role is superclass and the child role subclass in the superclass-subclass association. No topics need to be added to Wandora to view this hierarchy since the aforementioned topics are added to Wandora on startup.


[[Image:d3_tree_01.png|center]]


A larger set of topics shown here is achieved by using the [[Tree graph generator]] and specifying the following query string.

 http://127.0.0.1:8898/d3tree?rootSI=http%3A//www.wandora.org/topic/root&assocTypeSI=http%3A//www.wandora.org/topic/associationType&childRoleSI=http%3A//www.wandora.org/topic/child&parentRoleSI=http%3A//www.wandora.org/topic/parent

where

* The SI pointing to the root topic is http://www.wandora.org/topic/root
* The SI pointing to the association type topic is http://www.wandora.org/topic/associationType
* The SI pointing to the child role is http://www.wandora.org/topic/child
* The SI pointing to the parent role is http://www.wandora.org/topic/parent


[[Image:d3_tree_02.png|center]]


In a more complex example a data from the [http://www.wandora.org/download/exampleprojects/royal_query_2.wpr European royal families topicmap] is used. A [[Query topic map]] that creates child-parent associations has been added to the layer structure in the project file in order to visualize hierarchial family relations.


[[Image:d3_tree_03.png|center]]


The following query string is used to visualize four generations of George I's descendants

 http://127.0.0.1:8898/d3tree/?depth=4&rootSI=http%3A//www.wandora.org/gedcom/I341&assocTypeSI=http%3A//www.wandora.org/gedcom/schema/childparent&childRoleSI=http%3A//www.wandora.org/gedcom/schema/child&parentRoleSI=http%3A//www.wandora.org/gedcom/schema/parent

where 

* The SI pointing to the root topic is http://www.wandora.org/gedcom/I341
* The SI pointing to the association type topic is http://www.wandora.org/gedcom/schema/childparent
* The SI pointing to the child role is http://www.wandora.org/gedcom/schema/child
* The SI pointing to the parent role is http://www.wandora.org/gedcom/schema/parent
* The depth is limited to 4


[[Image:d3_tree_04.png|center]]


Reversing the child and parent roles and icreasing depth we get in turn 7 generations of George I's ancestors

 http://127.0.0.1:8898/d3tree/?depth=4&rootSI=http%3A//www.wandora.org/gedcom/I341&assocTypeSI=http%3A//www.wandora.org/gedcom/schema/childparent&childRoleSI=http%3A//www.wandora.org/gedcom/schema/parent&parentRoleSI=http%3A//www.wandora.org/gedcom/schema/child


[[Image:d3_tree_05.png|center]]