RNKFAC: Create Rank Order Factors

Last updated 19 Nov 97

RNKFAC will create a rank order task factor of real values for any task factor. The output RNKFAC factor will be called TFxxxx/RNK where xxxx is the next available task factor sequence number.

Program Invocation

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

opt:      Program Options (none currently supported)
ssss:     The study number
TFf:      Input/output Task Factor file

RNKFAC Control Card

RNKFAC:  cc 01-06  The literal 'RNKFAC'
study:   cc 08-11  The study number for this run
title:   cc 13-72  The report title for this run.

RANK Cards

The RANK cards specify which task factors to create rank order factors for. Additionally, each card has options for handling ties and sort sequence.

RANK:    cc 01-04  The literal 'RANK'
factor:  cc 06-11  The input factor name
/:       cc 12     The literal '/'
type:    cc 13-15  The input factor type
seq:     cc 17     Rank sequence:
		   'A'  Ascending rank sequence.
			Lowest value gets the lowest rank.
		   'D'  Descending rank sequence.
			Highest value gets lowest rank (default).
tie:     cc 19     The tie method to use:
		   'L'  Give tied values the lowest rank of the tied values.
			(Default)
		   'H'  Give tied values the highest rank of the tied values.
		   'M'  Use the mean of the ranks for the tied values as
			the rank for each tied value.
title:   cc 21-80  Output factor title

These cards are terminated by an end-of-file or an '@eof' image.

Example

@codap rnkfac - ssss tf100
RNKFAC ssss Title for the RNKFAC report
RANK GP0001/PTS L D Title for GP0001/PTS rank factor
RANK TF0002/SMN H A Title for TF0002/SMN rank factor
@EOF

This RNKFAC will create a descending rank factor for GP0001/PTS with all ties given the lowest rank of the tied values and an ascending rank factor for TF0002/SMN.

Back to document index