{smcl}
{* *! version 1.1.0 18nov2012}{...}
{hline}
help for {hi:svyrich}{right:Michal Brzezinski (November 2012)}

{hline}

{title:Title}

{p2colset 5 16 20 2}{...}
{p2col: {hi:svyrich} {hline 2}}Compute richness indices and their standard errors from survey data{p_end}
{p2colreset}{...}

{title:Syntax}

{p 4 4 2}
{cmd:svyrich} {it:varname} {ifin} [, {cmd:rline(}{it:#}{cmd:)}
{cmd:stat(}{it:string}{cmd:)}
{cmd: perc(}{it:#}{cmd:)}
{cmd: mult({it:#})}]

{p 4 4 2}
Data must be {cmd:svyset} before using this command; see {help svyset}.


{title:Description}

{p 4 4 2}
{cmd:svyrich} computes distributionally-sensitive richness indices and their standard errors. 
For formulas to compute richness indices, see Peichl et al. (2010). Asymptotic variance
for richness indices is computed using methods introduced in Brzeinski (2011). 
The command allows to compute standard errors of richness indices with 1) fixed richness line;
2) richness line estimated from the sample as a multiple of the mean or median value.
The command takes into account the sampling design of a survey and for this reason the 
data must be {cmd:svyset} before the command is used.


{title:Options}

{synoptset}
{synopthdr}
{synoptline}
{synopt:{cmd:rline(}{it:#}{cmd:)}}specifies the value of the fixed richness line.

{synopt:{cmd:stat(}{it:string}{cmd:)}} is used when poverty line is estimated
from the data and takes one of two values: 1) "pct" - percentile; 2) "mean" - mean. 

{synopt:{cmd:perc(}{it:#}{cmd:)}}specifies the value of the percentile on which
the richness line when estimated from data is based. It takes values between 0 and 100.

{synopt:{cmd:mult(}{it:#}{cmd:)}}specifies the value by which the mean or a percentile 
is multiplied when richness line is defined as a multiple of the mean or the percentile.


{title:Examples}

{phang2}{cmd:. svyrich income, rline(2000)}{p_end}
{phang2}{cmd:. svyrich income, stat("pct") perc(50) mult(3)}{p_end}
{phang2}{cmd:. svyrich income, stat("mean") mult(2)}{p_end}


{title:References}

{phang}
Andreas Peichl & Thilo Schaefer & Christoph Scheicher, 2010.
"Measuring Richness And Poverty: A Micro Data Application To Europe And Germany," 
Review of Income and Wealth, , vol. 56(3), p. 597-619.

{phang}
Michal Brzezinski, 2011.
Variance estimation for richness measures.
LWS Working Papers 11. 

{title:Also see}

{p 4 13 2}
Online: help for {help richness}, if installed. 


{title:Author}

{p 4 4 2}
Michal Brzezinski <mbrzezinski@wne.uw.edu.pl>, Faculty of Economic Sciences, University of Warsaw, Poland.