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=200leaf.dat

It contains the following data file names and description text:
Line NoFile name
1200leaf.node.csv
2200leaf.leaf.csv
3DR generated by spreadsheet and repetitious test leaf data using keywords from a report.
4http://www.researchperspectives.org/?page_id=43&CORDIS=checked&EPSRC=checked&NSF=checked&SEARCH=
5

Node file name=200leaf.node.csv

Line Nocol1col2col3
1120.1
220130.1495
320240.199
420350.2485
520460.298
620570.3475
720680.397
820790.4465
9208100.496
10209110.5455
11210120.595
12211130.6445
13212140.694
14213150.7435
15214160.793
16215170.8425
17216180.892
18217190.9415
19218200.991
20219211.0405
21220221.09
22221231.1395
23222241.189
24223251.2385
25224261.288
26225271.3375
27226281.387
28227291.4365
29228301.486
30229311.5355
31230321.585
32231331.6345
33232341.684
34233351.7335
35234361.783
36235371.8325
37236381.882
38237391.9315
39238401.981
40239412.0305
41240422.08
42241432.1295
43242442.179
44243452.2285
45244462.278
46245472.3275
47246482.377
48247492.4265
49248502.476
50249512.5255
51250522.575
52251532.6245
53252542.674
54253552.7235
55254562.773
56255572.8225
57256582.872
58257592.9215
59258602.971
60259613.0205
61260623.07
62261633.1195
63262643.169
64263653.2185
65264663.268
66265673.3175
67266683.367
68267693.4165
69268703.466
70269713.5155
71270723.565
72271733.6145
73272743.664
74273753.7135
75274763.763
76275773.8125
77276783.862
78277793.9115
79278803.961
80279814.0105
81280824.06
82281834.1095
83282844.159
84283854.2085
85284864.258
86285874.3075
87286884.357
88287894.4065
89288904.456
90289914.5055
91290924.555
92291934.6045
93292944.654
94293954.7035
95294964.753
96295974.8025
97296984.852
98297994.9015
992981004.951
1002991015.0005
1013001025.05
1023011035.0995
1033021045.149
1043031055.1985
1053041065.248
1063051075.2975
1073061085.347
1083071095.3965
1093081105.446
1103091115.4955
1113101125.545
1123111135.5945
1133121145.644
1143131155.6935
1153141165.743
1163151175.7925
1173161185.842
1183171195.8915
1193181205.941
1203191215.9905
1213201226.04
1223211236.0895
1233221246.139
1243231256.1885
1253241266.238
1263251276.2875
1273261286.337
1283271296.3865
1293281306.436
1303291316.4855
1313301326.535
1323311336.5845
1333321346.634
1343331356.6835
1353341366.733
1363351376.7825
1373361386.832
1383371396.8815
1393381406.931
1403391416.9805
1413401427.03
1423411437.0795
1433421447.129
1443431457.1785
1453441467.228
1463451477.2775
1473461487.327
1483471497.3765
1493481507.426
1503491517.4755
1513501527.525
1523511537.5745
1533521547.624
1543531557.6735
1553541567.723
1563551577.7725
1573561587.822
1583571597.8715
1593581607.921
1603591617.9705
1613601628.02
1623611638.0695
1633621648.119
1643631658.1685
1653641668.218
1663651678.2675
1673661688.317
1683671698.3665
1693681708.416
1703691718.4655
1713701728.515
1723711738.5645
1733721748.614
1743731758.6635
1753741768.713
1763751778.7625
1773761788.812
1783771798.8615
1793781808.911
1803791818.9605
1813801829.01
1823811839.0595
1833821849.109
1843831859.1585
1853841869.208
1863851879.2575
1873861889.307
1883871899.3565
1893881909.406
1903891919.4555
1913901929.505
1923911939.5545
1933921949.604
1943931959.6535
1953941969.703
1963951979.7525
1973961989.802
1983971999.8515
1993982009.901

Leaf file name=200leaf.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
101ThisSetThisSet long description
102OfLeafOfLeaf long description
103LabelsLabels long description
104HasBeenHasBeen long description
105ConcoctedConcocted long description
106ForTestForTest long description
107PurposesPurposes long description
108interactiveinteractive long description
109web-basedweb-based long description
110applicationapplication long description
111renderrender long description
112dendrogramsdendrograms long description
113clusteringclustering long description
114createdcreated long description
115purposepurpose long description
116interestedinterested long description
117partiesparties long description
118visualisevisualise long description
119co-occurrenceco-occurrence long description
120EPSRCEPSRC long description
121GrantsGrants long description
122groupinggrouping long description
123logicallogical long description
124transparenttransparent long description
125effectiveeffective long description
126consultationconsultation long description
127formedformed long description
128similarsimilar long description
129exploitexploit long description
130technologiestechnologies long description
131cross platformcross platform long description
132cross browsercross browser long description
133accessaccess long description
134iPadiPad long description
135tablet computers.tablet computers. long description
136requirementsrequirements long description
137reportreport long description
138investigatesinvestigates long description
139backgroundbackground long description
140analysisanalysis long description
141producesproduces long description
142possiblepossible long description
143preliminarypreliminary long description
144investigationsinvestigations long description
145presentedpresented long description
146projectproject long description
147associatedassociated long description
148EngineeringEngineering long description
149PhysicalPhysical long description
150SciencesSciences long description
151ResearchResearch long description
152CouncilCouncil long description
153thousandthousand long description
154millionmillion long description
155planningplanning long description
156prioritisingprioritising long description
157expenditureexpenditure long description
158concernedconcerned long description
159ComputingComputing long description
160ICTICT long description
161exercisesexercises long description
162brain stormingbrain storming long description
163sessionssessions long description
164representativesrepresentatives long description
165variousvarious long description
166formationformation long description
167impartialimpartial long description
168transparenttransparent long description
169appliesapplies long description
170providesprovides long description
171commoncommon long description
172ruling outruling out long description
173likelylikely long description
174relatedrelated long description
175LiteratureLiterature long description
176ReviewReview long description
177availableavailable long description
178publicpublic long description
179web siteweb site long description
180FigureFigure long description
181thereforetherefore long description
182Texture LabTexture Lab long description
183Heriot WattHeriot Watt long description
184UniversityUniversity long description
185producingproducing long description
186depictingdepicting long description
187MATLABMATLAB long description
188word cloudsword clouds long description
189SectionSection long description
190FlashFlash long description
191processingprocessing long description
192card-sortingcard-sorting long description
193surveyssurveys long description
194elementelement long description
195adjustableadjustable long description
196similaritysimilarity long description
197 threshold threshold long description
198highlightinghighlighting long description
199commercialcommercial long description
200JavaScript 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.