DIAGRM: Print Graphic Representation of a Clustering

Last updated 18 Nov 97

DIAGRM shows how the groups in a clustering merged together to form a single composite stage. The final output report is a tree structure which may be up to fifty printed pages in length and 20 in width. A DIAGRM report can be added to a report file only if the F option is specified on the program invocation line. It should be noted that using the F option will cause special page breaks to be inserted into the output report. When the F option is not used, the report flows continuously without page breaks.

Program Invocation

The specific syntax for program invocation varies between operating systems. This document diplays the code for the AIX version.


@codap diagrm <opt> <ssss> <CSf>

opt:  F   Format report for the Report file
ssss:     The study number 
CSf:      Input Cluster Solution file 

DIAGRM Control Card


DIAGRM <study> <pseq> <strtgp>

DIAGRM:   cc 01-06  The literal 'DIAGRM'
study:    cc 08-11  Four digit study number
pseq:     cc 13-18  The presentation sequence 
strtgp:   cc 20-23  The starter group selection method.  'STRT' is
                    used if this field is blank. The following values are
                    available for starter group selection:
                    STRT Use standard general method for selecting starter
                         groups.

ALL Use all individual members as starter groups. The membership must be less than 221.

Title Card (Optional)

The title supplied is printed at the top of each column on the output report. If this card is used and the title field is blank or if it is not used at all, the title will come from the input Cluster Solution file.


TITLE <title>

TITLE:    cc 01-05  The literal 'TITLE'
title:    cc 07-66  Any report title information desired

Note Cards (optional)

These cards, if used, appear at the beginning of the DIAGRM report. They are started by the literal "NOTE" and, if used, must be terminated with an "@eof".


NOTE <text> @EOF

Starter Group Selection Card

The starter group selection card format depends on the method to be used for selecting starter groups. The following box shows the general form. In the sections following the general form, the specific format needed for each starter group selection option is described. Multiple cards are allowed.


STRTGP <start>

STRTGP:   cc 01-06  The literal 'STRTGP'
start:    cc 08-80  The starter group selection criterion.  Use the form which
                    corresponds to the option chosen on the DIAGRM control card

STRT: General Starter Group Selection Criterion

This is the normal means used for selecting the starter groups for a diagram. This method selects groups based on average between values computed during the clustering. Only groups of at least a certain specified size are selected.


STRTGP <x> <y> <w> <nov> <low> <high>

STRTGP:   cc 01-06  The literal 'STRTGP'
x:        cc 08-12  The minimum acceptable average between for the first
                    pass of the stage data.  This pass is called the Ascending
                    Homogeneity Pass.  The default value is 50.00.
y:        cc 14-18  The minimum acceptable average between for the second
                    pass of the stage data. This is the absolute lowest value
                    that will be accepted for any starter group. The default
                    value is 20.00.
w:        cc 20-24  The minimum acceptable number of members for a starter
                    group or printing a group on the diagram report. The 
                    default is 10.
nov:      cc 26-30  The stage to begin the Ascending Homogeneity pass.
                    This pass will be made using the x value for the minimum
                    acceptable between. The default is set to the number of
                    stages divided by 2.
low:      cc 32-35  The lowest acceptable KPATH range value for a starter
                    group.  The default is 1.
high:     cc 37-40  The highest acceptable KPATH range value for a starter
                    group.  The default is the number of cases.

ALL: Total Starter Group Selection

This method does not impose size restrictions on the starter groups. It selects each individual member in the KPATH range given and will create up to 220 starter groups.


STRTGP <low> <high>

STRTGP:   cc 01-06  The literal 'STRTGP'
low:      cc 08-11  The lowest acceptable KPATH range value for a starter
                    group.  The default is 1.
high:     cc 13-16  The  highest acceptable KPATH range value for a starter
                    group.  The default is the number of cases.

The control cards are terminated by an end-of-file or an @eof image.

Example

@codap diagrm - ssss cs100
DIAGRM ssss ps0002
TITLE  This is the title for a DIAGRM run
NOTE
DIAGRM will accept any number of cards with each card
up to 80 characters in length.  
It is also acceptable to have no note cards.
@eof
STRTGP 50.00 20.00    10   100    1  200
@eof

The example above illustrates some of the parameters that may be changed in a run of DIAGRM.

Back to document index