{smcl}
{* 16aug2--8; prior: 21apr2008}
{hline}
help for {hi:povguide}
{hline}

{title:Generate the U.S. Poverty Guideline value for a given family size and year}

{p 8 17 2}
{cmd:povguide, gen(}{it:newvar}{cmd:)}
{cmd:famsize(}{it:famsize}{cmd:)}
{cmd:year(}{it:year}{cmd:)}


{title:Description}

{p 4 4 2}
{cmd:povguide} generates a numeric variable representing the official
U.S. poverty guideline.

{p 4 4 2}
Important: this is one of two official poverty levels
in use by the United States government. See more on this matter below,
under Remarks.


{title:Options}
{p 4 4 2}
All of these options are required.

{p 4 4 2}
{cmd:gen(}{it:newvar}{cmd:)} specifies the name of a new variable to be generated,
which will contain the poverty guideline (in U.S. dollars). By default is will be of an integer
type, typically int.

{p 4 4 2}
{cmd:famsize(}{it:famsize}{cmd:)} specifies an expression representing the
family size. It will be truncated to an integer and bottom-coded at 1 (values
below 1 will be coerced to 1).

{p 4 4 2}
{cmd:year(}{it:year}{cmd:)} specifies an expression representing the year
for which the computation is to be made. It will be truncated to an integer.
Presently, the acceptable values
are 1973-2008. Out-of-bounds values will result in a warning and missing
values in the result.


{title:Remarks}

{p 4 4 2}
The poverty guideline is a "base value" for the first person in the famly,
plus an increment for each additional person; the base value and increment vary, depending on the
year. For example, in 2005, it is 9570 + 3260 for each additional
person. To be concise, it is,{p_end}
{p 8 8 2}basevalue + (familysize - 1) * increment{p_end}

{p 4 4 2}
Poverty guideline values exist prior to 1973, however the increment is not
uniform in those early years, so this scheme does not apply.

{p 4 4 2}
These values are valid for all states of the U.S. and the District of Columbia, excluding
Alaska and Hawaii; Alaska and Hawaii
have their own distinct standards which are not presently covered in this program.

{p 4 4 2}
Official standards are issued by the U.S. Department of Health and Human
Services, and can be found at such locations as{p_end}
{p 8 8 2}http://aspe.hhs.gov/poverty/figures-fed-reg.shtml{p_end}
{p 8 8 2}http://aspe.hhs.gov/poverty/99poverty.htm{p_end}
{p 8 8 2}www.ssa.gov/policy/docs/statcomps/2006/3e.html#table3.e8{p_end}

{p 4 4 2}
The 1982 standards are for nonfarm families.

{p 4 4 2}
The Poverty Guideline is one of two standards in use; the other is the Poverty
Threshold, a more complex calculation, involving
the number of children and elderly. The Poverty Threshold is the original
standard, based on the work of Mollie Orshansky; the Poverty Guideline is
regarded as a simplified alternative. Also, the Threshold is used for statistical
purposes (e.g., by the U.S. Census Bureau), whereas the Guideline is used for
program eligibility.


{title:Examples}

{p 4 8 2}
{cmd:. povguide, gen(povguide) famsize(num_persons) year(2002)}

{p 4 8 2}
{cmd:. povguide, gen(povguide) famsize(num_persons) year(year)}

{p 4 4 2}
Typically, you would follow this with something like...{p_end}
{p 4 8 2}
{cmd:. gen byte pov = faminc < povguide if ~mi(povguide) & ~mi(faminc)}


{title:Author}
{p 4 4 2}
David Kantor.
Email {browse "mailto:kantor.d@att.net":kantor.d@att.net} if you observe any
problems. Check with the author for the availablilty of a program for Poverty
Threshold.