Syntax | SAS.STAT 9.1 Users Guide (Vol. 4)

The following statements invoke the MODECLUS procedure:

PROC MODECLUS < options > ;
- BY variables ;
- FREQ FREQUENCY variable ;
- ID variable ;
- VAR VARIABLES variables ;

The PROC MODECLUS statement is required. All other statements are optional.

PROC MODECLUS Statement

PROC MODECLUS < options > ;

The PROC MODECLUS statement invokes the procedure.

Options available in the PROC MODECLUS statement are classified by function in Table 47.1. The corresponding default value for each option, if applicable , is also listed in this table.

Table 47.1: Functional Summary
Description	Option	Default Value
Data Sets
specify input data set name	DATA=	_LAST_
specify output data set name for observations	OUT=
specify output data set name for clusters	OUTC=
specify output data set name for cluster solutions	OUTS=
Variables in Output Data Sets
specify variable in the OUT= and OUTCLUS= data sets identifying clusters	CLUSTER=	CLUSTER
specify variable in the OUT= data set containing density estimates	DENSITY=	DENSITY
specify length of variables in the output data sets	OUTLENGTH=	8
Results and Data Processing before Clustering ^{[ *]}
request simple statistics	SIMPLE
standardize the variables to mean 0 and standard deviation 1	STANDARD
Smoothing Parameters
specify number of neighbors to use for k th- nearest -neighbor density estimation	DK=
specify number of neighbors to use for clustering	CK=
specify number of neighbors to use for k th-nearest-neighbor density estimation and clustering	K=
specify radius of the sphere of support for uniform-kernel density estimation	DR=
specify radius of the neighborhood for clustering	CR=
specify radius of the sphere of support for uniform-kernel density estimation and the neighborhood clustering	R=
Density Estimation Options
specify number of times the density estimates are to be cascaded	CASCADE=
compute the likelihood cross-validation criterion	CROSS or CROSSLIST
specify dimensionality to be used when computing density estimates	DIMENSION=	nvar ^{[ *]} or 1 ^{[ ]}
use arithmetic means for cascading density estimates	AM
use harmonic means for cascading density estimates	HM
use sums for cascading density estimates	SUM
Clustering Methods Options
dissolve clusters with n or fewer members	DOCK
stop the analysis after obtaining a solution with either no cluster or a single cluster	EARLY
request that nonsignificant clusters be hierarchically joined.	JOIN(=)
specify maximum number of clusters to be obtained with METHOD=6	MAXCLUSTERS=	no limit
specify clustering method to use	METHOD=
specify minimum members for either cluster to be designated a modal cluster when two clusters are joined using METHOD=5	MODE=	the value of K ^{[ ]} or 2 ^{[ §]}
specify power of the density used with METHOD=6	POWER=	2
specify approximate significance tests for the number of clusters	TEST
specify assignment threshold used with METHOD=6	THRESHOLD=	0.5
Miscellaneous Options
produce all optional output	ALL
display the density and cluster membership of observations with neighbors belonging to a different cluster	BOUNDARY
retain the neighbor lists for each observation in memory	CORE
display the estimated cross- validated log density of each observation	CROSSLIST
display the estimated density and cluster membership of each observation	LIST
display estimates of local dimensionality and write them to the OUT=data set	LOCAL
display the neighbors of each observation	NEIGHBOR
suppress the display of the output	NOPRINT
suppress the display of the summary of the number of clusters, number of unassigned observations, and maximum p -value for each analysis	NOSUMMARY
suppress the display of statistics for each cluster	SHORT
trace the cluster assignments for the METHOD=6 algorithm	TRACE
^{[ ]} for coordinate data only ^{[ ]} number of variables, for coordinate data ^{[ ]} for distance data ^{[ ]} When K= is specified ^{[ §]} When K= is not specified

You can specify at least one of the following options for smoothing parameters for density estimation: DK=, K=, DR=, or R=. To obtain a cluster analysis, you can specify the METHOD= option and at least one of the following smoothing parameters for clustering: CK=, K=, CR=, or R=. If you want significance tests for the number of clusters, you should specify either the DR= or R= option. If none of the smoothing parameters is specified, the MODECLUS procedure provides a default value for the R= option. See the section Density Estimation on page 2870 for the formula of a reasonable first guess for R= and a discussion of smoothing parameters.

You can specify lists of values for the DK=, CK=, K=, DR=, CR=, and R= options. Numbers in the lists can be separated by blanks or commas. You can include in the lists one or more items of the form start TO stop BY increment . Each list can contain either one value or the same number of values as in every other list that contains more than one value. If a list has only one value, that value is used in combination with all the values in longer lists. If two or more lists have more than one value, then one analysis is done using the first value in each list, another analysis is done using the second value in each list, and so on.

You can specify the following options in the PROC MODECLUS statement.

ALL

produces all optional output.

specifies arithmetic means for cascading density estimates. See the description of the CASCADE= option.

BOUNDARY

displays the density and cluster membership of observations with neighbors belonging to a different cluster.

CASCADE= n

CASC= n

specifies the number of times the density estimates are to be cascaded (see the section Density Estimation on page 2870). The default value 0 performs no cascading.
You can specify a list of values for the CASCADE= option. Each value in the list is combined with each combination of smoothing parameters to produce a separate analysis.

CK= n

specifies the number of neighbors to use for clustering. The number of neighbors should be at least 2 but less than the number of observations. See the section Density Estimation on page 2870.

CLUSTER= name

provides a name for the variable in the OUT= and OUTCLUS= data sets identifying clusters. The default name is CLUSTER.

CORE

keeps the neighbor lists for each observation in the computer memory to make small problems run faster.

CR= n

specifies the radius of the neighborhood for clustering. See the section Density Estimation on page 2870.

CROSS

computes the likelihood cross-validation criterion (Silverman 1986, pp. 52 “55). This option appears to be of limited usefulness (see the section Density Estimation on page 2870).

CROSSLIST

displays the cross-validated log density of each observation.

DATA= SAS-data-set

specifies the input data set containing observations to be clustered. If you omit the DATA= option, the most recently created SAS data set is used.
If the data set is TYPE=DISTANCE, the data are interpreted as a distance matrix. The number of variables must equal the number of observations in the data set or in each BY group . The distances are assumed to be Euclidean, but the procedure accepts other types of distances or dissimilarities. Unlike the CLUSTER procedure,
PROC MODECLUS uses the entire distance matrix, not just the lower triangle; the distances are not required to be symmetric. The neighbors of a given observation are determined solely from the distances in that observation. Missing values are considered infinite. Various distance measures can be computed from coordinate data using the DISTANCE procedure (for detailed information, see Chapter 26, The DISTANCE Procedure, ).
If the data set is not TYPE=DISTANCE, the data are interpreted as coordinates in a Euclidean space, and Euclidean distances are computed. The variables can be discrete or continuous and should be at the interval level of measurement.

DENSITY= name

provides a name for the variable in the OUT= data set containing density estimates. The default name is DENSITY.

DIMENSION= n

DIM= n

specifies the dimensionality to be used when computing density estimates. The default is the number of variables if the data are coordinates; the default is 1 if the data are distances.

DK= n

specifies the number of neighbors to use for k th-nearest-neighbor density estimation. The number of neighbors should be at least 2 but less than the number of observations. See the section Density Estimation on page 2870.

DOCK= n

dissolves clusters with n or fewer members by making the members unassigned.

DR= n

specifies the radius of the sphere of support for uniform-kernel density estimation. See the section Density Estimation on page 2870.

EARLY

stops the cluster analysis after obtaining either a solution with no cluster or a solution with one cluster to which all observations are assigned. The smoothing parameters should be specified in increasing order. This can reduce the computer time required for the analysis but may occasionally miss some multiple-cluster solutions.

uses harmonic means for cascading density estimates. See the description of the CASCADE= option.

JOIN < = p >

requests that nonsignificant clusters be hierarchically joined. The JOIN option implies the TEST option. After each solution is obtained, the cluster with the largest approximate p -value is either joined to a neighboring cluster or, if there is no neighboring cluster, dissolved by making all of its members unassigned. After two clusters are joined, an analysis of the remaining clusters is displayed.
If you do not specify a p -value with the JOIN= option, joining continues until only one cluster remains, and the results are written to the output data sets after each analysis. If you specify a p -value with the JOIN= option, joining continues until the greatest approximate p -value is less than the value given in the JOIN= option, and only if there is more than one cluster are the results for that analysis written to the output data sets.
Any value of p less than 1E ˆ’ 8 is set to 1E ˆ’ 8.

K= n

specifies the number of neighbors to use for k th-nearest-neighbor density estimation and clustering. The number of neighbors should be at least 2 but less than the number of observations. Specifying K= n is equivalent to specifying both DK= n and CK= n . See the section Density Estimation on page 2870.

LIST

displays the estimated density and cluster membership of each observation.

LOCAL

requests estimates of local dimensionality (Tukey and Tukey 1981, pp. 236 “237).

MAXCLUSTERS= n

MAXC= n

specifies the maximum number of clusters to be obtained with the METHOD=6 option. By default, there is no fixed limit.

METHOD= n

MET= n

M= n

specifies what clustering method to use. Since these methods do not have widely recognized names , the methods are indicated by numbers from 0 to 6. The methods are described in the section Clustering Methods on page 2874. For most purposes, METHOD=1 is recommended, although METHOD=6 may occasionally produce better results in return for considerably greater computer time and space requirements. METHOD=1 is not good for discrete coordinate data with only a few equally spaced values. In this case, METHOD=6 or METHOD=3 works better. METHOD=4 or METHOD=5 is less desirable than other methods when there are ties, since a general characteristic of agglomerative hierarchical clustering methods is that the results are indeterminate in the presence of ties.
You must specify the METHOD= option to obtain a cluster analysis.
You can specify a list of values for the METHOD= option. Each value in the list is combined with each combination of smoothing and cascading parameters to produce a separate cluster analysis.

MODE= n

specifies that when two clusters are joined using the METHOD=5 option (no other methods are affected by the MODE= option), each must have at least n members for either cluster to be designated a modal cluster. In any case, each cluster must also have a maximum density greater than the fusion density for either cluster to be designated a modal cluster. If you specify the K= option, the default value of the MODE= option is the same as the value of the K= option because the use of k th-nearest-neighbor density estimation limits the resolution that can be obtained for clusters with fewer than k members. If you do not specify the K= option, the default is MODE=2. If you specify MODE=0, the default value is used instead of 0. If you specify a FREQ statement, the MODE= value is compared to the number of observations in each cluster, not to the sum of the frequencies.

NEIGHBOR

displays the neighbors of each observation in a table called Nearest Neighbor List.

NOPRINT

suppresses the display of the output. Note that this option temporarily disables the Output Delivery System (ODS). For more information, see Chapter 14, Using the Output Delivery System.

NOSUMMARY

suppresses the display of the summary of the number of clusters, number of unassigned observations, and maximum p -value for each analysis.

OUT= SAS-data-set

specifies the output data set containing the input data plus density estimates, cluster membership, and variables identifying the type of solution. There is an output observation corresponding to each input observation for each solution. Therefore, the OUT= data set can be very large.

OUTCLUS= SAS-data-set

OUTC= SAS-data-set

specifies the output data set containing an observation corresponding to each cluster in each solution. The variables identify the solution and contain statistics describing the clusters.

OUTSUM= SAS-data-set

OUTS= SAS-data-set

specifies the output data set containing an observation corresponding to each cluster solution giving the number of clusters and the number of unclassified observations for that solution.

OUTLENGTH= n

OUTL= n

specifies the length of those output variables that are not copied from the input data set but are created by PROC MODECLUS.
The OUTLENGTH= option applies only to the following variables that appear in all of the output data sets: _K_, _DK_, _CK_, _R_, _DR_, _CR_, _CASCAD_, _METHOD_, _NJOIN_, and _LOCAL_.
The minimum value is 2 or 3, depending on the operating system. The maximum value is 8. The default value is 8.

POWER= n

POW= n

specifies the power of the density used with the METHOD=6 option. The default value is 2.

R= n

specifies the radius of the sphere of support for uniform-kernel density estimation and the neighborhood for clustering. Specifying R= n is equivalent to specifying both DR= n and CR= n . See the section Density Estimation on page 2870.

SHORT

suppresses the display of statistics for each cluster.

SIMPLE

displays means, standard deviations, skewness , kurtosis , and a coefficient of bimodality. The SIMPLE option applies only to coordinate data.

STANDARD

STD

standardizes the variables to mean 0 and standard deviation 1. The STANDARD option applies only to coordinate data.

SUM

uses sums for cascading density estimates. See the description of the CASCADE= option on page 2865.

TEST

performs approximate significance tests for the number of clusters. The R= or DR= option must also be specified with a nonzero value to obtain significance tests.
The significance tests performed by PROC MODECLUS are valid only for simple random samples, and they require at least 20 observations per cluster to have enough power to be of any use. See the section Significance Tests on page 2876.

THRESHOLD= n

THR= n

specifies the assignment threshold used with the METHOD=6 option. The default is 0.5.

TRACE

traces the cluster assignments for the METHOD=6 algorithm.

BY Statement

BY variables ;

You can specify a BY statement with PROC MODECLUS to obtain separate analyses on observations in groups defined by the BY variables. When a BY statement appears, the procedure expects the input data set to be sorted in order of the BY variables.

If your input data set is not sorted in ascending order, use one of the following alternatives:

Sort the data using the SORT procedure with a similar BY statement.
Specify the BY statement option NOTSORTED or DESCENDING in the BY statement for the MODECLUS procedure. The NOTSORTED option does not mean that the data are unsorted but rather that the data are arranged in groups (according to values of the BY variables) and that these groups are not necessarily in alphabetical or increasing numeric order.
Create an index on the BY variables using the DATASETS procedure.

For more information on the BY statement, refer to the discussion in SAS Language Reference: Concepts . For more information on the DATASETS procedure, refer to the discussion in the SAS Procedures Guide

FREQ Statement

FREQ FREQUENCY variable ;

If one variable in the input data set represents the frequency of occurrence for other values in the observation, specify the variable s name in a FREQ statement. PROC MODECLUS then treats the data set as if each observation appeared n times, where n is the value of the FREQ variable for the observation. Nonintegral values of the FREQ variable are truncated to the largest integer less than the FREQ value.

ID Statement

ID variable ;

The values of the ID variable identify observations in the displayed results and in the OUT= data set. If you omit the ID statement, each observation is identified by its observation number, and a variable called _OBS_ is written to the OUT= data set containing the original observation numbers.

VAR Statement

VAR VARIABLES variables ;

The VAR statement specifies numeric variables to be used in the cluster analysis. If you omit the VAR statement, all numeric variables not specified in other statements are used.