Home > brede > brede_mat_rankindicator.m

brede_mat_rankindicator

PURPOSE ^

brede_mat_rankindicator - Construct a 'rank indicator' matrix

SYNOPSIS ^

function Mout = brede_mat_rankindicator(Min, varargin)

DESCRIPTION ^

 brede_mat_rankindicator - Construct a 'rank indicator' matrix

        Mout = brede_mat_rankindicator(Min)

        Input:  Min    'Mat' structure

        Output: Mout   'Mat' structure with rank indicators

        This function constructs a (-1,0,1)-matrix by looking at the
        ranks of the elements in each row.
 
        The first element in the output matrix indicate with a '1'
        whether the first element in a rows is smaller than the second
        element. The element will be -1 if the first element is
        larger, and 0 if they are equal or one of the values in NaN. 
        The second element in rows of the output matrix indicate the
        relation between the first and third element in the input
        matrix. 

        Example: 
          X = [   2   1   3   4  NaN NaN NaN NaN ; ...
                NaN NaN   1   2    2   2   4   5 ; ...
         NaN NaN   4   3    2   1 NaN NaN ];
          M = brede_mat_rankindicator(X);
          D = brede_mat_dist(M, 'distance', 'innerproduct')
          D.matrix

        See also BREDE, BREDE_MAT.

 $Id: brede_mat_rankindicator.m,v 1.1 2005/02/04 18:46:50 fnielsen Exp $

CROSS-REFERENCE INFORMATION ^

This function calls: This function is called by:
Generated on Fri 27-Nov-2009 18:11:22 by m2html © 2005