Contents - Index


TRANSFORM>DICHOTOMIZE 

PURPOSE Form a binary matrix from a valued matrix.

DESCRIPTION Given a specified cut-off value then the valued matrix is made binary by comparing each element with the cut-off value.  Comparisons can be strictly greater, greater than or equal, equal, less than or equal or strictly less than.

PARAMETERS 
Input dataset:
Name of matrix to be dichotomized. Data type: Matrix.

Cut-off value: (Default = 0).
Any user-specified value.  MEAN gives the average value of all the cells in the input matrix.
 
Diagonal OK?  (Default = No)
Yes means that diagonal elements are considered valid in calculating the mean.
No ignores diagonal values.

Cut-off operator: (Default = 'GT').
Choices are:

GT - Matrix values replaced by a 1 if they are strictly greater than the cut-off value and 0 otherwise.
GE - Matrix values replaced by a 1 if they are greater than or equal to the cut-off value and 0 otherwise.
EQ - Matrix values replaced by a 1 if they are equal to the cut-off value and 0 otherwise.
LE - Matrix values replaced by a 1 if they are less than or equal to the cut-off value and 0 otherwise.
LT - Matrix values replaced by a 1 if they are strictly less than the cut-off value and 0 otherwise.

Output dataset: (Default = 'Dichotomize').
Name of file which contains dichotomized matrix.


LOG FILE Dichotomized matrix.

TIMING O(N^2).

COMMENTS None.

REFERENCES None.