{smcl}
{* *! version 4.0 28Aug2010   UNDER CONSTRUCTION}{...}
{hline}
help for {hi:aidsproj}{right:{hi:Version 4.08, 15Feb2011}}
{right:dialog:  {bf:{dialog aidsproj}}}
{hline}

{title:AIDS Burden Projection}

{p 8 17 2}
{cmdab:aidsproj}
[{cmd:if} {it:exp}]
[{cmd:using }{it:filename} ]
{cmd:,}
    {cmdab:upt:ake:(}{it:pa_varname}{cmd:|}{it:pa_coef}{cmd:)}
[
    {cmdab:v:intage:(}{it:vyear}{cmd:)}
    {cmdab:ta:keoff:(}{it:tyear}{cmd:)}
    {cmdab:hor:izon:(}{it:phorizon}{cmd:)}
    {cmd:adrate1(}{it:####}{cmd:)}
    {cmd:adrate2(}{it:####}{cmd:)}
    {cmdab:bd:rate:(}{it:####}{cmd:)}
    {cmdab:f:ail1:(}{it:####}{cmd:)}
    {cmdab:e:rate:(}{it:####}{cmd:)}
    {cmdab:nd:rate:(}{it:####}{cmd:)}
    {cmdab:inc:mult:(}{it:####}{cmd:)}
    {cmdab:strtc:ov2:(}{it:####}{cmd:)}
    {cmdab:trgtc:ov2:(}{it:####}{cmd:)}
    {cmdab:strty:r:(}{it:####}{cmd:)}
    {cmdab:trgty:r:(}{it:####}{cmd:)}
    {cmd:complete}
    {cmd:impute}
    {cmdab:c:ountries:(}{it:clist}{cmd:)}
    {cmdab:r:egions:(}{it:rlist}{cmd:)}
    {cmdab:w:orld}
    {cmd:gr7}
    {cmdab:gra:ph}
    {cmdab:grc:ombine}
    {cmdab:noresc:ale}
    {cmdab:leg:end:(}{it:legend_options}{cmd:)}
    {cmd:titlen(}{it:titlen_options}{cmd:)}
    {cmd:titlec(}{it:titlec_options}{cmd:)}
    {cmd:titlep(}{it:titlep_options}{cmd:)}
    {cmd:titlee(}{it:titlee_options}{cmd:)}
    {cmdab:subt:itle:(}{it:subtitle_options}{cmd:)}
    {cmd:weo}
    {cmdab:sav:ing:(}{it:filename, [replace]}{cmd:)}
]

{title:Description}

{p 4 4 2}
{cmd:aidsproj} uses input data on a cross-section of countrires in the 
year prior to the "vintage year" of the data 
to project several measures of the future disease and fiscal burden of
the AIDS epidemic on individual countries and on specified aggregates of
those countries. The program has one "required option", sets of options to describe
patient recruitment, the health benefits of treatment, the costs of treatment, 
the incidence of new infections and a set of output options. 

{title:Input data file (on the `Main' tab of {dialog aidsproj} dialog)}

{p 4 4 2}
The program must be fed a cross-country panel dataset containing
specific variables. The program assumes that this file will be supplied
by the {cmd:using} {it:filename} specification on the command line.  That data set can be resident in memory when the
program is called or can be specified by {cmd:using }{it:filename}.

{title:Required option (on the `ART Uptake' tab of {dialog aidsproj} dialog)}

{p 4 4 2}
The program has only one required "option",
{cmdab:upt:ake:(}{it:pa_varname}{cmd:|}{it:pa_coef}{cmd:)} , which
specifies the speed at which the countries in the projection will
increase their coverage of the unmet need for antiretroviral treatment.
The speed of uptake is specified as a "partial adjustment coefficient"
{it:sigma}, where 0 <= {it:sigma} <= 1 gives the proportion of 
the unmet need for treatment who are enrolled for the first time 
in antiretroviral therapy each year. The model assumes that, once enrolled 
in treatment, a patient has a lifetime entitlement to treatment.   
Those familiar with the "partial adjustment model" in applied
econometrics will recognize that {it:sigma} is related to the partial 
adjustment coefficient {it:lambda} in that model by {it:sigma} = (1 - {it:lambda}).
The uptake parameter {it:sigma} is constant over time within
each country. It can be provided either as a variable {it:pa_varname}
which contains a single value for each country or as a constant
{it:pa_coef} which is then applied to all countries. For example,
specifying {cmd:uptake(}{it:0.95}{cmd:)} instructs {cmd:aidsproj} to
assume that in addition to treating all patients placed on treatment in
previous years who survive this year, all countries in the projection will in
each future year extend treatment to 95 % of those who are alive and need treatment. 

{title:Country inclusion criteria (on the `Main' tab of {dialog aidsproj} dialog)}

{p 4 8 2} {cmd:complete|impute} User can optionally sepcify either the
{cmd:complete} option or the {cmd:impute} option, but not both. Using
neither option allows {cmd:aidsproj} to perform some minor, relatively
innocuous imputations in order to add a few countries to the
projections. The {cmd:complete} option suppresses the countries for
which these innocuous imputations are required. The {cmd:impute} option
authorizes {cmd:aidsproj} to perform more daring imputations in order to
include more countries. As part of its routine output, {cmd:aidsproj}
tabulates the sample by the countries that are "complete" before any
imputations and those that are included by imputation. 

{p 4 4 2}
The user can select subsets of countries for inclusion in global or
regional aggregates by using the {cmd:if} {it:exp} criterion. 

{title:Main options}

{p 4 8 2} {cmdab:v:intage:(}{it:####}{cmd:)} Vintage of data.  Default is 2008

{p 4 8 10} {cmdab:hor:izon:(}{it:phorizon}{cmd:)} Specifies the last year to which
projections are computed. Default is 2020. Maximum is 2050. 

{p 4 8 10} {cmdab:take:off:(}{it:ptakeoff}{cmd:)} Specifies the first year for which
projections are displayed. Default is 2010. Maximum is 2050. 

{title:ART Uptake options}

{p 4 8 2} {cmd:cd4(}{it:####}{cmd:)} Median CD4 count at treatment initiation.
Default is 130. Choice of this parameter controls the first-year death-rate,
{cmd:adrate1}, the rate at which HIV+ convert to ART eligibility, {cmd:erate}, 
and the death rate among ART eligible not on ART, {cmd:ndrate}.

{p 4 8 2} {cmd:adrate1(}{it:####}{cmd:)} First year death rate on 1st
line ART. Default is an decreasing function of the {cmd:CD4}
option, but can be overidden by explicitly specifying the {cmd:adrate1} value. 

{p 4 8 2} {cmd:adrate2(}{it:####}{cmd:)} Subsequent annual death rate on
1st line ART. Default is 0.04. Not affected by choice of {cmd:CD4}
parameter.

{p 4 8 2} {cmdab:e:rate:(}{it:####}{cmd:)} Rate at which HIV+ convert to
be eligible for ART. Default is an increasing function of the {cmd:CD4}
option, but can be overidden by explicitly specifying the {cmd:erate} value. 

{p 4 8 2} {cmdab:nd:rate:(}{it:####}{cmd:)} Death rate among ART
eligible not on ART. Default is a decreasing function of the {cmd:CD4}
option, but can be overidden by explicitly specifying the {cmd:ndrate} value. 

{title:2nd Line options}

{p 4 8 2} {cmdab:strtc:ov2:(}{it:####}{cmd:)} Starting level of coverage
with 2nd line therapy. Default is 0.05. 

{p 4 8 2} {cmdab:trgtc:ov2:(}{it:####}{cmd:)} Target level of coverage
with 2nd line therapy. Default is 0.95. 

{p 4 8 2} {cmdab:strty:r:(}{it:####}{cmd:)} Starting year of coverage
with 2nd line therapy. Default is 200. 

{p 4 8 2} {cmdab:trgty:r:(}{it:####}{cmd:)} Year target level to be
reached with 2nd line therapy. Default is 2020. 

{p 4 8 2} {cmdab:bd:rate:(}{it:####}{cmd:)} Annual death rate on 2nd
line ART. Default is 0.04. 

{title:Incidence options}

{p 4 8 2} {cmd:iexog} Incidence to follow an exogenous trend controlled
by the parameter {cmd:incmult}.  On the `2nd Line/Incidence' tab of the
dialog box, check the box entitled `HIV incidence to follow an exogenous trend'.
The default, specified when {cmd:iexog} is absent, is for incidence to
be affected by the prevalence of HIV and by ART coverage.

{p 4 8 2} {cmdab:inc:mult:(}{it:####}{cmd:)} Multiple that each year's
incidence is of previous year. Default is 0.97. This parameter is ignored
unless the option {cmd:iexog} is specified.

{p 4 8 2} {cmd:ir0} 

{p 4 8 2} {cmd:pstrtyr(}{it:####}{cmd:)} 

{p 4 8 2} {cmd:ptrgtyr(}{it:####}{cmd:)} 

{p 4 8 2} {cmd:maxep(}{it:####}{cmd:)} 

{p 4 8 2} {cmd:maxcp(}{it:####}{cmd:)} 

{p 4 8 2} {cmd:vstrtyr}{it:####}{cmd:)} 

{p 4 8 2} {cmd:vtrgtyr}{it:####}{cmd:)} 

{p 4 8 2} {cmd:maxvp(}{it:####}{cmd:)} 

{p 4 8 2} {cmd:ve(}{it:####}{cmd:)} 

{p 4 8 2} {cmd:fp(}{it:####}{cmd:)} 

{p 4 8 2} {cmd:gp(}{it:####}{cmd:)} 

{p 4 8 2} {cmd:maxdt(}{it:####}{cmd:)} 

{p 4 8 2} {cmd:maxdu(}{it:####}{cmd:)} 


{title:Cost options}

cost(string) 
rxc1lb(real 88) 
rxc1ub(real 261)
rxc2lb(real 819) 
rxc2ub(real 2634) 
hsbedn(real 1.96) 
hsvstn(real 9.5) 
scale(real -0.146) 
nonrxcaf(real 750) 
DRate(passthru) 
REFYear(passthru) 



{title:Output options} 

{p 4 4 2} If no output options are specified, the program uses default
values of all the optional parameters, computes projections of the key
variables until the default horizon of 2020 and halts. If the user
specifies the option {cmd:countries(clist)}, then for each country in
{it:clist} the program presents the projection results in tabular form.
If the user specifies the option {cmd:world} or {cmd:regions(rlist)},
the program computes the totals or averages for the specified
aggregate(s). Quantity or cost/expenditure projections are summed across
the specified group of countries while percentages or rates are
averaged. Averages are weighted by the number of people receiving
antiretroviral treatment in the given year in the respective countries
(not by their number of HIV infected, total populations or GDP). 

{p 4 4 2} The three default output sets are (1) the epidemiological
projections of the number of people under treatment, in need of
treatment and dying in each future year until the projection horizon;
(2) the average unit cost of treatment and the total cost of treatment;
(3) the proportion of annual expenditure that treats ongoing patients
(called the "entitlement") and the proportion that treats new patients
(called "discretionary"). If the {cmd:weo} option is specified, a fourth
set of projections compares the projected total expenditures on ART to
three projected national budgets which are projected under a no_ART
scenario using the 
{browse "http://www.imf.org/external/pubs/ft/weo/2007/02/weodata/index.aspx": 2007 World Economic Outlook}. 
The three budget categories used as comparators are total health
expenditures, central government public health expenditures and total
central government expenditures. 

{p 4 8 2} {cmd:weo} Adds comparisons to the World Economic Outlook's
projected expenditure categories to three other sets of projections. See
the previous paragraph. 

{p 4 8 2} {cmdab:c:ountries:(}{it:clist}{cmd:)} Use World Bank's
3-letter country names to specify countries for which results are
tabulated and, if graph options specified, displayed. Specified
countries must not conflict with the {cmd:if} criterion. 

{p 4 8 2} {cmdab:r:egions:(}{it:rlist}{cmd:)} Use World Bank's 3-letter
region names to specify region aggregates for which results are
tabulated and, if graph options specified, displayed. Subject to the the
{cmd:if} criterion. 

{p 4 8 2} {cmdab:w:orld} Present tabulated results and, if graph options specified,
display global totals (or totals for all countries included by the
{cmd:if} criterion). 

{p 4 8 2} {cmd:gr7} Display and save graphs in version 7 style: Fast but
crude. 

{p 4 8 2} {cmdab:gra:ph} Display and save graphs in version 9.2 style:
Slow and elegant. 

{p 4 8 2} {cmdab:grc:ombine} Combines all 3 or 4 graphs into the panels
of a single graph. User must also specify either {cmd:gr7} or
{cmd:graph} graphing method. 

{p 4 8 2} {cmdab:noresc:ale} Unless this option is specified, the
numeric values on the vertical axes of all graphs are rescaled to powers
of 10 that assure that the labels of the tick marks are less than four
digits. (Variables are returned to their unscaled units before
{cmd:aidsproj} exits. Rescaling uses my -rescale.ado- command.) 

{p 4 8 2} {cmdab:leg:end:(}{help legend_options}{cmd:)} Legend
suboptions are passed to the graph commands. Omitting the legend option
is the same as selecting {cmd:legend(}{it:pos(12) ring(0)}{cmd:)} so
that the legend appears above the graph and inside its boundaries.
Useful suboptions include: 

             {it:off} suppresses the legend
             {it:ring(0)}     places legend inside the graph boundaries
             {it:pos(3)}      places legend on right of graph
             {it:size(small)} reduces the size of legend text
             {it:span}        stretches the legend box horizontally
         
{p 4 4 2} The following options work only with option {cmd:graph}, not
with options {cmd:gr7} or {cmd:grcombine}. 

{p 4 8 2} {cmd:titlen(}{it:titlen_options}{cmd:)} Replaces standard
title for quantity graphs. Specifying " " suppresses the title. 

{p 4 8 2} {cmd:titlec(}{it:titlec_options}{cmd:)} Replaces standard
title for cost graphs. Specifying " " suppresses the title. 

{p 4 8 2} {cmd:titlep(}{it:titlep_options}{cmd:)} Replaces standard
title for percent discretionary graphs. Specifying " " suppresses the
title. 

{p 4 8 2} {cmd:titlee(}{it:titlee_options}{cmd:)} Replaces standard
title for percent expenditure graphs. Specifying " " suppresses the
title. 

{p 4 8 2} {cmdab:subt:itle:(}{it:subtitle_options}{cmd:)} Replaces
standard subtitle for all graphs. Specifying " " suppresses the
subtitle. 

{title:Saving option}

{p 4 8 2} {cmdab:sav:ing:(}{it:filename, [replace]}{cmd:)} Specifies the
filename for the projections data file which the program then saves in
STATA's {help dta} format, which is also the stub of the filename for
saved graphics files. If {cmdab:sav:ing:(}{it:filename,
[replace]}{cmd:)} is omitted, neither the data file of projections nor
the {help gph} files are saved. 

{title:Examples}

{p 4 4 2} The following example generates projections of the worldwide
burden of the epidemic to the year 2020, using version 7 graphics. By
selecting the partial adjustment coefficient to equal 0.95, with the
option {cmd:uptake(}{it:0.95}{cmd:)}, the scenario assumes that all
countries in the world will expand at 95 % of unmet need for ART each
year. 

{p 8 8 2}
{cmd:aidsproj using aidssub2007, uptake(.95)  world gr7 grcombine}

{p 4 4 2} The following example changes only one epidemiologic
parameter, the assumption regarding the change in the rate of new cases
of HIV, or the incidence rate. Instead of the default assumption which
is that the number of new cases would decline by 5 % each year, this
example assumes that the rate of new cases would decline dramatically in
2007 by 90 % to only 10 % of its 2006 level and then continue to decline
by another 90 % every year. In other words it assumes that the rate of
new cases declines asymptotically to zero. 

{p 8 8 2}
{cmd:aidsproj using aidssub2007, uptake(.95) incmult(.10)}
{cmd:world gr7 grcombine} 

{p 4 4 2} The following example produces the identical epidemmiological
predictions as the previous one, but presents different output. In
addition to output on all countries, it specifies output on the
individual countries in the World Bank's South Asia region, on the South
Asian Region as a whole and also, for comparison, on the Sub-Saharan
African region as a whole. All nine graphs are presented and saved, with names
beginning with the character string: "adj95_weo". 

{p 8 12 20} {cmd:delimit ;}

{p 8 12 20} {cmd:aidsproj using aidssub2007, uptake(.95) incmult(.10)}
{cmd:graph grcombine weo world} {cmd:countries(BGD BTN IND LKA NPL PAK)}
{cmd:regions(SAS SSA) saving(adj95_weo, replace) ;}
 
{p 8 12 20} {cmd:delimit cr}

{title:Author}

{p 4 8 12} 
{browse "http://www.cgdev.org/content/experts/detail/10007/":Mead Over},
Center for Global Development, Washington, DC 20036 USA. Email:
{browse "mailto:mover@cgdev.org":MOver@CGDev.Org} if you observe any
problems. 

{title:References} 

{p 4 8 12} Over, M., "Prevention Failure: The Ballooning Entitlement
Burden of U.S. Global AIDS Treatment Spending and What to Do About It"
{browse "http://www.cgdev.org/content/publications/detail/15973":Working Paper 144},
Center for Global Development, 2008. 

{p 4 8 12} Over, M., "Opportunities for presidential leadership on AIDS:
From an "Emergency Plan" to a Sustainable Policy," in N. Birdsall (ed.),
{browse "http://www.cgdev.org/content/publications/detail/16560":The White House and the World: A Global Development Agenda for the Next US President},
Center for Global Development, 2008, Chapter 11, pp. 299-326. 

{p 4 8 12} Over, M., "AIDS Treatment in South Asia: Equity and
Efficiency Arguments for Shouldering the Fiscal Burden When Prevalence
Rates Are Low" 
{browse "http://www.cgdev.org/content/publications/detail/1421119":Working Paper 161},
Center for Global Development, 2009. 

