The Dendrogrammer
Dendrogram  Demo data
Look under the "Help" tab above for the Quick-start guide.

  

Load different data

Load a different data set by clicking one of the links in the table below.
1default.dat
200leaf.dat
300leaf.dat
400leaf.dat
500leaf.dat
EPSRC-Materials, Mechanical and Medical Engineering-Materials, Mechanical and Medical Engineering.dat
anexample6leafdata.dat
fourlinemanifest.dat
goodDemo.dat
matlabLinkageDataFromTom.dat
onehundredDfromFraser.dat
the_evaluation_data.dat

The current data

Below are details of the currently loaded data set:
The largest merge height (dissimilarity value) is 0.
There are 0 leaf nodes.

Dat file name=goodDemo.dat

It contains the following data file names and description text:
Line NoFile name
1onehundredDfromFraser.node.csv
2onehundredDfromFraser.leaf.csv
3Demo data with test leaf data using keywords from a report.
4http://www.google.co.uk/search?q=

Node file name=onehundredDfromFraser.node.csv

Line Nocol1col2col3
114300
288890.64285
354900.64287
421990.78571
578800.78573
644450.78573
752700.85714
837381.0714
9641031.1786
1027961.2857
11671061.3214
1247511.5
1333691.5
14771101.5714
1535841.7857
1691941.7857
1715311.8571
18361081.8928
1934851.9286
204972
211001132.0357
22201042.0412
23111142.0714
24741122.2555
2516172.2857
26631112.3571
2726292.4286
28411232.4821
291011152.5357
3024532.5769
313182.5769
3228612.6429
3391252.7198
34461162.75
35731192.75
361221332.7882
37751352.8334
387432.8627
3910712.934
40391213.0476
412663.1429
4259623.2143
4340573.2198
44601323.2555
45321403.3214
461021313.3956
47251283.4286
48501243.4322
4976813.4341
5042873.5
5181053.6072
52651393.6099
531071483.6992
5451203.7143
5522233.7143
561181493.7409
5748683.8571
5858723.8572
591923.9286
60791433.956
611271584
621381474.1099
63821524.1209
64131174.1429
65491644.1429
666834.1484
67861504.3214
681421514.3214
691461604.3718
7012984.5
71191574.5
721091264.6131
731541654.619
74561374.6607
75951554.8627
761301694.8968
771411704.9286
781591664.9835
791441715.0018
801531635.1699
811561755.2927
821611775.3572
831291735.4005
84551815.421
851741765.4338
861681855.5484
871671805.5528
881451845.7409
891791825.992
901781866.2567
91931876.7342
921831896.8079
931901916.8895
941341937.5422
951361947.8869
961881958.2711
971921968.6308
981721978.903
991621989.7272

Leaf file name=onehundredDfromFraser.leaf.csv

Line Nocol1col2
1ThisSetThisSet long description
2OfLeafOfLeaf long description
3LabelsLabels long description
4HasBeenHasBeen long description
5ConcoctedConcocted long description
6ForTestForTest long description
7PurposesPurposes long description
8interactiveinteractive long description
9web-basedweb-based long description
10applicationapplication long description
11renderrender long description
12dendrogramsdendrograms long description
13clusteringclustering long description
14createdcreated long description
15purposepurpose long description
16interestedinterested long description
17partiesparties long description
18visualisevisualise long description
19co-occurrenceco-occurrence long description
20EPSRCEPSRC long description
21GrantsGrants long description
22groupinggrouping long description
23logicallogical long description
24transparenttransparent long description
25effectiveeffective long description
26consultationconsultation long description
27formedformed long description
28similarsimilar long description
29exploitexploit long description
30technologiestechnologies long description
31cross platformcross platform long description
32cross browsercross browser long description
33accessaccess long description
34iPadiPad long description
35tablet computers.tablet computers. long description
36requirementsrequirements long description
37reportreport long description
38investigatesinvestigates long description
39backgroundbackground long description
40analysisanalysis long description
41producesproduces long description
42possiblepossible long description
43preliminarypreliminary long description
44investigationsinvestigations long description
45presentedpresented long description
46projectproject long description
47associatedassociated long description
48EngineeringEngineering long description
49PhysicalPhysical long description
50SciencesSciences long description
51ResearchResearch long description
52CouncilCouncil long description
53thousandthousand long description
54millionmillion long description
55planningplanning long description
56prioritisingprioritising long description
57expenditureexpenditure long description
58concernedconcerned long description
59ComputingComputing long description
60ICTICT long description
61exercisesexercises long description
62brain stormingbrain storming long description
63sessionssessions long description
64representativesrepresentatives long description
65variousvarious long description
66formationformation long description
67impartialimpartial long description
68transparenttransparent long description
69appliesapplies long description
70providesprovides long description
71commoncommon long description
72ruling outruling out long description
73likelylikely long description
74relatedrelated long description
75LiteratureLiterature long description
76ReviewReview long description
77availableavailable long description
78publicpublic long description
79web siteweb site long description
80FigureFigure long description
81thereforetherefore long description
82Texture LabTexture Lab long description
83Heriot WattHeriot Watt long description
84UniversityUniversity long description
85producingproducing long description
86depictingdepicting long description
87MATLABMATLAB long description
88word cloudsword clouds long description
89SectionSection long description
90FlashFlash long description
91processingprocessing long description
92card-sortingcard-sorting long description
93surveyssurveys long description
94elementelement long description
95adjustableadjustable long description
96similaritysimilarity long description
97 threshold threshold long description
98highlightinghighlighting long description
99commercialcommercial long description
100JavaScript JavaScript long description

Groups data will be displayed here.

Here will appear output in response to formation of groups using the green dragable threshold bar and the "Apply threshold" button, or the "Set no.of groups" toolbar.

Dendrogrammer v 1.0.5

The Dendrogrammer was created as one component in the analysis of multivariate data. In particular it is intended to allow already pre-processed data to be
  • classified into groups and then either
  • used in further analysis, or
  • used in some form of presentation about the data.
Current Features
  • Dendrogram construction
  • File read
  • File read now includes a manifest file which cues a clustering data file (node data) and a leaf description data file (leaf data).
  • File read now is integrated in the application page. Hard coded data loads if no data files are found.
  • Window width optimisation
  • Group formation by adjustable threshold
  • Cluster click/tap reports into dialog
  • Group formation reports with dialog, reports into separate tab, that tab pulses to notify. The pulsing stops when the tab is clicked
  • The threshold is a dragable element on the graph
  • The threshold can be adjusted also using toolbar buttons
  • The desired number of groups can be entered and it will set the threshold to fit
  • Leaf labels on the vertical axis. These are interactively styled in response to events.
  • Dialogs now guaranteed to be under 75% of window ht, scrolling if needed and using a default or wider width as appropriate on PC platform. Scrolling dialogs are not deployed on tablet platform as these are not suitable for tablets.
  • The group banding (and groups) can be removed with the "Remove" button
  • Summary dendrogram: For use in dendrograms with a very large number of leaves. Effectively truncating the dendrogram up from 0 ht to a level at which the structure can be discerned and then the clusters interrogated, rather than having hundreds of leaves along the bottom.
  • The Descendant Nodes Dialog contains a search link. The URL for this is specified in the .dat file which loads the data. The search link passes the cluster's leaf terms to a search engine.
Documentation The technologies deployed in the application include
  • JavaScript - The major part of the application is written in JavaScript
  • Raphael Javscript library (by Dmitry Baranovskiy) - Used to make the dendrogram graphic elements. Raphael is truly amazing.
  • (Indirectly) SVG and VML - Raphael uses SVG or VML to do the drawing. Raphael switches seemlessly depending on the browser
  • jQuery - For some of the cross browser Dynamic HTML
  • jQuery UI - For some of the user interface supporting the application
  • HTML5 - Although there is nothing especially HTML5 about it really.
  • PHP - the data files are loaded using PHP.
The Dendrogrammer was created
  • by David Allan Robb
  • for his MSc project at Heriot-Watt University
  • in summer 2011
Quick-start Guide

In a nutshell-
  • Drag the green bar (Threshold bar) to adjust the dissimilarity threshold for group formation. Then click the "Apply threshold" button to form groups.
  • "Remove" will get rid of the groups.
  • Or enter the desired no. of groups in the "no. of groups field" and click the "Apply no. of groups" button.
  • To create a summary dendrogram, drag the threshold, then click "Truncate".
  • "Restore" redraws the original dendrogram.
  • Another way to adjust the threshold is to enter a number in the "Threshold value field".
Help

Dendrogram tab - View and interact with the dendrogram made from the clustering data.

  • Click or tap a cluster (element on the graph). Then read about that cluster in the dialog that appears.
  • That dialog also contains a search link. The URL for this is specified in the .dat file which loads the data. The search link passes the cluster's leaf terms to a search engine. It should open in a browser pop-up window or browser tab.
  • Adjust the green threshold bar and click the button to form groups of leaves (data points)
  • See more detail about the groups you form under the "Groups" tab.
  • The threshold can be adjusted by click-and-drag on the green bar, or using the threshold toolbar buttons, or entering a number in the "Threshold value field".
  • If you are using a tablet computer then drag on the green bar with your finger. If you find you can't drag the bar accurately then use the toolbar buttons to move the threshold. You might find that after moving the threshold bar away from the max with a button then you can get a better feel for how it drags using your finger.
  • If using the toolbar fine adjust buttons (plus and minus), note that the amount of movement with minus is set slightly less that with plus. This allows even more fine adjustment if you alternate from plus to minus around the point you are looking for.
  • To specify a given number of groups, enter the desired number in the field next to the "Apply no.of groups" button and click the button. The threshold will be chosen automatically for you.
  • To view a summary dendrogram (or truncated dendrogram), drag the threshold to some point below which you wish to discard the leaf detail. Then click the "Truncate" button. The resulting summary dendrogram will have everything below the threshold removed and be reshaped to fit the previous space. The origin is at the dissimilarity ht. you chose with the threshold bar. Tapping/clicking a cluster will still report all the leaf detail as before, despite the leaves being invisible. Groups can be formed in the same manner as before.
  • The "Restore" button will restore the original full dendrogram and the leaves as it was when you first viewed the current data. Loading new data or the same data again will have the same effect, as will reloading the page with your browser.
  • Use Control and + or - to zoom in and out ( or pinch on a tablet ). Look in your browser's View menu for more zoom controls.
  • What equipment to use: The dendrogrammer was designed to be cross platform (works on PCs with mouse and tablets with tap)
  • What browser to use: The dendrogrammer was designed to be cross browser. It is written in JavaScript (with a little bit of PHP to load the data). So it works in pretty much any browser that has Javascript enabled. However it is my experience that if one considers the latest browsers, the JavaScript interpreters in Firefox (Gekko with Tracemonkey), Safari (Webkit with Squirrelfish), and Chrome (Webkit with V8) are significantly faster (e.g. by a factor of 2 and more) than the "JScript" engine in Internet Explorer 8 and below (However, IE9 32-bit is good, but IE9 64-bit is reputed to be slow). So if one is seeking faster smoother performance with this particular application then one might wish to use Firefox, Chrome, or Safari (as at July 2011).

Data tab - Load different data or find out about the current data used to make the dendrogram.

  • A table of links is shown representing all the available data sets. Clicking a link loads that data set and makes a dendrogram from it.
  • The currently loaded data set is described and displayed in 3 tables
  • One table shows the contents of the .dat (or manifest) file. This contains meta data about the data set: the names of the two data files and a description of the data set.
  • The next table shows the contents of the clustering data file (or node file). This should be a csv file generated by MATLAB. It should have 3 columns. The first two columns are cluster or leaf designation numbers. The third column contains the merge height or similarity measure for that cluster.
  • The last table shows the contents of the leaf description data file (or leaf file). This is a csv file. The first row describes leaf number one. The second row describes leaf number two and so on. It should contain two columns. Column one should hold the short leaf descriptions or labels. Column 2 should contain a longer description for each leaf (this can be a repeat of the short label).
  • Loading a new data set or the same data set again will result in a page refresh and will clear any displayed groups or summary dendrogram which you may be displayed on the Dendrogram tab.
  • Adding further data sets can only be done by someone with write-access to the web space where the application resides (See 'Documentation' in the About tab.)

Groups tab- View the detail of the groups formed using the threshold adjuster and toolbar.

  • The detail can be copied and pasted into other software for further analysis or presentation.

About tab - Read about the application.

Help tab - This page you are reading now is the Help.

Zoom Help

If you find the leaf labels too small you may wish to zoom in. If you find your screen height too small to fit a large dendrogram you may wish to zoom out.

How to zoom on a PC or laptop

  • On most browsers Control and + will zoom in.
  • Control and - will zoom out.
  • Control and mouse wheel works too on most browsers.
  • Look in your browser's View menu for more zoom commands. E.g. Some browsers offer a separate zoom for text only. If using that, bear in mind that your browser sees the entire dendrogram including leaf labels as graphics.
  • Once you have zoomed, refreshing the page will adjust the dendrogram to fit the width you have chosen.

On a tablet device

  • Use the open or close pinch gesture to zoom.
  • Once you have zoomed in, as you would expect, refreshing the page does not affect the dendrogram size. It remains zoomed until you zoom back.

Summary Dendrogram feature

  • By setting the threshold bar and clicking "Truncate" you can reduce the amount of leaf detail displayed and reduce the height of the dendrogram.
  • Clicking a cluster on a summary dendrogram still reveals all of its descendant leaf detail in the dialogs. Group formation works as normal.
  • The "Restore" button restores the normal dendrogram.