*! version 0.1.4 8 Nov 2022

mpitb gafvars -- generates variables for the AF-framework.

Syntax

mpitb gafvars , [options]

options

* indvars(varlist) the deprivation indicator variables

* indw(numlist) the indicator weights

* wgtsid(name) name of the weighting scheme

† klist(numlist) poverty cutoffs for which to generate the AF-variables

† cvector generate uncensored (weighted) deprivation scores

indicator generate indicator-specific variables

replace potentially existing variables will be replaced

double generate non-byte variables as double; default is float

* required options; † at least one of these options is required.

Description

mpitb gafvars generates variables of the Alkire-Foster framework. Specifically,
it may be used to create censored and uncensored deprivation scores, and binary
variables identifying (i) the poor and (ii) the poor and deprived in a particular
indicator. The default is to only generate the censored deprivation score and the
binary poverty status indicator.

mpitb gafvars is intended for advanced users and programmers. Note that mpitb est
also provides a gen option to generate the underlying variables.

Options

indvars(varlist) specifies the underlying deprivation indicator variables.

indw(numlist) specifies the indicator weights. The number of weights must
equal the number of indicators, as provided by mpitb set.

wgtsid(string) sets a name for the weighting scheme, which will also be used
in variable names.

klist(numlist) specifies the cutoffs for which the variables are to be
generated.

cvector generates a variable containing the (uncensored) deprivation score.

indicator generates variables for the estimation of indicator-specific
quantities (e.g., censored headcount ratios).

replace will replace potentially existing variables.

double generates non-byte variables as double; the default is float.

Remarks

1. mpitb gafvars currently generates variables according to specific naming
conventions, which include a prefix followed by the value of k and the name
of the weighting scheme where appropriate. Generated variables currently include
the deprivation score (c_wgtsname), the censored deprivation score
(c_k_wgtsname), a binary variable identifying the poor (I_k)
and a variable indicating the sample used for estimations (sample). Additionally,
variables used to estimate the censored headcount ratio (cdvar_k_wgtsname),
the absolute contribution (actb_dvar_k_wgtsname) and the percentage
contribution (pctb_dvar_k_wgtsname) are generated for every
deprivation indicator dvar.
Note that calling mpitb gafvars repeatedly may, therefore, either require the
replace option or to rename or drop previously created variables.

2. As mpitb gafvars does not read any information from data characteristics,
everything must be provided via options.

3. Currently mpitb gafvars does not perform any consistency checks on the input
provided by the user. In particular, inconsistent input may lead to the
gcvec(): 3200 conformability error.

Examples

1. To generate censored and uncensored deprivation scores and a binary variable
indicating the poverty status for a three indicator measure, one may issue

mpitb gafvars , indv(d_cm d_nutr d_satt) indw(.5 .25 .25) wgtsid(eql) k(33) cvec