.-
help for ^poverty^                                           (Philippe Van Kerm
> )
.-

Poverty Measures
----------------

      ^poverty^ varname [^if^ exp] [^in^ range] ^[^weight^]^ [^, ^options]

^aweight^s and ^fweight^s are allowed; see help @weights@.


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

^poverty^ computes a series of poverty measures based on the (income)
distribution described by varname.

The poverty measures that can be computed by ^poverty^ are: 

 headcount ratio     aggregate poverty gap    poverty gap ratio
 income gap ratio    Watts index              Sen index
 Takayama index      Thon index, 

and series of Foster, Greer and Thorbecke indices with parameters :
                   0.5, 1.5, 2, 2.5, 3, 3.5, 4, 4.5, 5
              Clark et al. indices with parameters :
                   0.1, 0.25, 0.5, 0.75, 0.9


The poverty line is either directly specified by the user or computed relative
to the median of varname (half or two-third), see under "options" below.


Options
-------

^l^ine^(^#^)^ sets the value of the poverty line. If # is set equal to -1, the
    poverty line is computed as half the median of varname. If # is set equal
    to -2, it is computed as two-third of the median of varname. Default is -1.

^g^en^(^newvarname^)^ creates a new variable that takes on the value of 1 for
    all observations identified as poor and 0 for observations identified as
    non-poor. "newvarname" is set to missing for observations with missing 
    "varname" or falling outside the ^if in^ statements.
    
^A^ll requests that all possible measures are computed and reported. 
    By default, no measure is produced.


The following options specify the measures to be computed and reported.
        ^H^    : headcount ratio [FGT(0)]     
        ^APG^  : aggregate poverty gap
        ^PGR^  : poverty gap ratio [FGT(1)]
        ^IGR^  : income gap ratio 
        ^W^    : Watts index 
        ^S^    : Sen index 
        ^TA^k  : Takayama index
        ^TH^on : Thon index
        ^FGT1^ : Foster, Greer and Thorbecke -FGT(0.5)-
        ^FGT2^ : Foster, Greer and Thorbecke -FGT(1.5)-
        ^FGT3^ : Foster, Greer and Thorbecke -FGT(2)-
        ^FGT4^ : Foster, Greer and Thorbecke -FGT(2.5)-
        ^FGT5^ : Foster, Greer and Thorbecke -FGT(3)-
        ^FGT6^ : Foster, Greer and Thorbecke -FGT(3.5)-
        ^FGT7^ : Foster, Greer and Thorbecke -FGT(4)-
        ^FGT8^ : Foster, Greer and Thorbecke -FGT(4.5)-
        ^FGT9^ : Foster, Greer and Thorbecke -FGT(5)-
        ^CHU1^  : Clark, Ulph and Hemming index with beta of 0.10
        ^CHU2^  : Clark, Ulph and Hemming index with beta of 0.25
        ^CHU3^  : Clark, Ulph and Hemming index with beta of 0.50
        ^CHU4^  : Clark, Ulph and Hemming index with beta of 0.75
        ^CHU5^  : Clark, Ulph and Hemming index with beta of 0.90


Saved Results
-------------

    S_1  = total number of observations in the data
    S_2  = number of observations used to compute the indices
    S_3  = weighted number of observations
    S_4  = value of the poverty line
    S_5  = weighted number of observations identified as poor

(the following results are only available if the measure has been requested)
    S_6  = headcount ratio [FGT(0)]     
    S_7  = aggregate poverty gap
    S_8  = poverty gap ratio [FGT(1)]
    S_9  = income gap ratio 
    S_10 = Watts index
    S_11 = FGT(0.5)
    S_12 = FGT(1.5)
    S_13 = FGT(2)
    S_14 = FGT(2.5)
    S_15 = FGT(3)
    S_16 = FGT(3.5)
    S_17 = FGT(4)
    S_18 = FGT(4.5)
    S_19 = FGT(5)
    S_20 = Clark et al. index (0.10)
    S_21 = Clark et al. index (0.25)
    S_22 = Clark et al. index (0.5)
    S_23 = Clark et al. index (0.75)
    S_24 = Clark et al. index (0.90)
    S_25 = Sen index
    S_26 = Thon index
    S_27 = Takayama index



Author
------

        Philippe VAN KERM <philippe.vankerm@@fundp.ac.be>
        University of Namur, Department of Economics
        Rempart de la Vierge 8
        B-5000 Namur, Belgium.


Also see
--------

        on-line: @povdeco@ if installed