.-
help for ^altrank^                                 [STB-51: dm72; STB-52: dm72.1]
.-

Alternative ranking procedures
------------------------------

        ^egen^ [type] newvar ^=^ fcn^(^exp^)^ [^if^ exp] [^in^ range]
        [^, by(^varlist^)^ ]


Description
-----------

(This is the general specification modified from the help for ^egen^.)

^egen^ creates newvar of the optionally specified storage type equal to
fcn^(^exp^)^, where exp denotes an expression.

Note that ^egen^ may change the sort order of your data.


^egen^ functions for alternative ranking procedures 
-------------------------------------------------

^rankf(^exp^)^ [ ^by(^varlist^)^ ] calculates the field rank of exp:  
the highest value is ranked 1, and there is no correction for ties.
Two values that are 2nd equal remain rank 2. 

^rankt(^exp^)^ [ ^by(^varlist^)^ ] calculates the track rank of exp: 
the lowest value is ranked 1, and there is no correction for ties. 
Two values that are 2nd equal remain rank 2. 

^ranku(^exp^)^ [ ^by(^varlist^)^ ] calculates the unique rank of exp: 
values are ranked 1, ... , #values and ties are broken arbitrarily. 
Two values that are second equal are ranked 2 and 3. 


Options
-------

^by(^varlist^)^ specifies that ranks are to be calculated separately for 
the distinct groups defined by varlist. 


Examples
--------

	. ^egen mpgrank = rankt(mpg)^ 
	. ^lbleqrnk mpgrank^  
	. ^l make mpg mpgrank in 1/10^ 


Authors
-------

         Nicholas J. Cox, University of Durham, U.K.
         n.j.cox@@durham.ac.uk

	 Richard Goldstein
	 richgold@@ix.netcom.com


Also see
--------

 Manual:  ^[R] egen^
On-line:  help for @egen@, @lbleqrnk@ (if installed)