View source for D3 partition service module

The D3 partition module uses the [http://github.com/mbostock/d3/wiki/Partition-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 '''d3partition''' and the URL of the visualization is 

 http://127.0.0.1:8898/d3/partition

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. Finally a set of colorSchemes is provided to help visualize the hierarchy's structure.

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:d3partition_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/d3/partition?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:d3partition_02.png|center]]


In a more complex example a recursive [[http://www.freebase.com/ Freebase]] query data is used. Extracting data around Claude Monet gives us a hierarchy of influences. The influence node association is not strictly hierarchial since authors and artists may have multiple persons who have influenced them. The navigation aspect of the visualization should nonetheless be meaningful.

We first use the Freebase extractor in '''File > Extract > Topics > Freebase extractor...''' with the following options to extract data from Freebase. 


[[Image:d3_partition_freebase_01.png|center]]


[[Image:d3_partition_freebase_02.png|center]]


Influence node is a single association extracted from the data and other hierarchial associations may as well be displayed in the visualization.

After the extraction the influence node hierarchy can be viewed using the URL:

 http://127.0.0.1:8898/d3/partition/?rootSI=http://www.freebase.com/en/ovid&assocTypeSI=http://www.freebase.com/influence/influence_node/influenced_by&parentRoleSI=http://www.wandora.org/freebase/target&childRoleSI=http://www.wandora.org/freebase/source


[[Image:d3partition_03.png|center]]


The visualization can be navigated by clicking on a topic expanding it and revealing more of it's child topics.


[[Image:d3partition_04.png|center]]


Appending &colorScheme=n, where n = {1,2,3,4,5,6}, to the query string we can color the topics according to a scheme.


[[Image:d3partition_05.png|center]]