1. Home
  2. DMST procedure

DMST procedure

Gives a high resolution plot of an ordination with minimum spanning tree (A.W.A. Murray).

Options

DIMENSIONS = scalars Two numbers specifying the dimensions to display on the y- and x-axes; default 2,1
TITLE = text Title for the graph
WINDOW = scalar Window for the graph; default 1
KEYWINDOW = scalar Window for the key; default 2
SCREEN = string token Controls screen (clear, keep); default clea

Parameters

COORDINATES = matrices or datamatrices Coordinates from ordination
TREE = matrices Minimum spanning tree
SIMILARITY = symmetric matrices Association matrix used to derive ordination
SYMBOLS = factors or texts Symbols to label the coordinates
PENCOORDINATES = scalars Pen to use for the coordinates
PENTREE = scalars Pen to use for the minimum spanning tree

Description

DMST plots a minimum spanning tree using coordinates saved, for example, from a PCO. The COORDINATES parameter specifies the coordinates for the units in the plot, using either a matrix or a pointer to a set of variates (that is, a “datamatrix”). The minimum spanning tree can be supplied using the TREE parameter, or it can be calculated from the original association matrix specified using the SIMILARITY parameter. If TREE supplies a matrix with no values, these will be set to the tree calculated from the SIMILARITY matrix. If the COORDINATES structure was originally declared with row labels the procedure will automatically use these to label the plots. Alternative symbols can be defined using the SYMBOLS parameter. You can also specify the pens to be used to plot the coordinates and tree, using parameters PENCOORDINATES and PENTREE respectively. The definition of these pens, outside the procedure, thus allows the colour, size, font and linestyle of links in the tree to be controlled. By default the coordinates are plotted with colour black and the tree with colour red, symbols are 0.8 of normal size, and the tree is plotted with a dotted line.

Options TITLE, WINDOW, KEYWINDOW and SCREEN function as usual for high resolution graphics. If the WINDOW is unset a default layout with appropriately labelled axes is produced in window 1. Axes will be scaled automatically unless limits have already been set outside the procedure.

Options: DIMENSIONS, TITLE, WINDOW, KEYWINDOW, SCREEN.

Parameters: COORDINATES, TREE, SIMILARITY, SYMBOLS, PENCOORDINATES, PENTREE.

Method

A two dimensional representation of the results of a multivariate analysis, such as a PCO, is plotted on the current high resolution graphics device. A minimum spanning tree is calculated (by HDISPLAY) from an input similarity matrix if not supplied. The tree is superimposed on the plot. The procedure uses GETATTRIBUTE to access the row labels (if any) of the input structures. The input structures are converted to variates if necessary and DGRAPH is used to plot the desired data.

Action with RESTRICT

Restrict is irrelevant with matrix input structures. It should work as expected with variates.

See also

Directives: HDISPLAY, PCO, PCP.

Commands for: Multivariate and cluster analysis, Graphics.

Example

CAPTION 'DMST example',\
        !t('Data from Table 1.5 of Digby & Kempton (1987), Multivariate',\
        'Analysis of Ecological Communities, Chapman & Hall, London.');\
        STYLE=meta,plain
TEXT    Spp,title, Spp; VALUES=!t(Agr,Alo,Anx,Arr,Dac,Fes,Hel,Hol,Ppr,Ptr,\ 
                                  Lol,Lat,Tri,Anr,Her,Leo,Pla,Pot,Ran,Tar),\
        'Association of species on Park Grass (Czekanowski measure)'
SYMMETRICMATRIX [ROWS=Spp] PGsim
READ    [PRINT=errors]  PGsim
100
75 100
88 83 100
72 95 81 100
63 87 73 93 100
85 84 93 85 77 100
57 68 65 65 67 69 100
84 89 91 88 80 87 62 100
76 88 81 90 81 85 65 91 100
63 84 73 85 88 77 62 80 81 100
33 38 33 39 44 36 50 29 22 44 100
58 79 69 85 83 73 60 76 77 83 40 100
61 64 65 70 71 69 71 62 61 71 58 80 100
29 60 46 62 58 49 40 50 57 63 20 56 40 100
46 73 59 79 82 63 50 67 67 82 46 81 67 69 100
43 32 37 38 42 40 48 37 38 36 40 45 64  0 22 100
73 68 73 69 67 77 81 69 69 62 52 70 81 30 51 57 100
29 23 25 24 27 27 36 25 29 20 17 21 36  0  8 62 40 100
67 73 70 75 73 71 72 67 67 68 54 71 78 38 53 52 87 42 100
77 92 85 93 89 89 71 91 93 89 37 85 71 59 76 41 78 28 76 100 :
LRV   [ROWS=Spp; COLUMNS=3] L3
PCO   [PRINT=roots] PGsim; LRV=L3
FRAME 3; SCALING=xyequal
YAXIS 3; TITLE='PCO axis 2'
XAXIS 3; TITLE='PCO axis 1'
DMST  [WINDOW=3; KEY=0; TITLE=title] L3['Vectors']; SIM=PGsim
Updated on March 8, 2019

Was this article helpful?