*! version 0.1.4 8 Nov 2022

mpitb set -- specifies the deprivation indicators for a MPI

Syntax

mpitb set , [options]

options

name(mpiname) name of the MPI

description(text) short description of the MPI specified

d1(varlist, subopts) specification of dimension 1

... ...

d10(varlist, subopts) specification of dimension 10

clear clear all specifications

replace replace specification if existing

Description

mpitb set specifies the deprivation indicators for a MPI and stores this
information with the currently loaded dataset. One may store several specifications
with one data set.

Options

name(mpiname) specifies the name of a particular MPI or, more precisely, its
indicator selection. Internally, mpiname also serves as an ID and it is recommended
to use short names (at most 10 characters are permitted).

description(text) allows to add some extra information of the particular MPI
to the data. This text may help to distinguish different specifications.

d1(varlist, subopts) assigns the variables in varlist as deprivation indicators to
dimension 1. It is recommended to use short variable names (at most 10 characters are
permitted). A total of 10 dimensions is permitted. One may set the following
subopts:

name(dimname) allows to choose a name for a particular dimension (optionally).
It is recommended to use short names (at most 6 characters are permitted). If no
name is provided dimensions are generically named d1, d2, etc.

clear removes all information on MPIs stored with the current data.

replace replaces the information for the specified MPI.

Remarks

(1) mpitb set stores all MPI-related information as data characteristics, see
char and [U] 12.8 Characteristics. Specifically,
mpitb set stores information about mpiname, the names of deprivation
indicators and the names of dimensions.

(2) Deprivation indicators (e.g., for child mortality and nutrition) of MPIs
are usually organized in dimensions (e.g., health). This organization may affect
the weight a particular indicator is effectively assigned. mpitb set
supports up to ten dimensions each containing an arbitrary number of indicators.

(3) mpitb imposes constraints on the length of names for indicators, dimensions,
and the MPI specification to prevent exceeding Stata internal limits
(e.g., variable name length).

Examples

1. A multidimensional poverty measure similar to the global MPI with 10 indicators
organized in three dimensions (health, education, and living standards) may be set
as follows:

mpitb set , name(mympi) d1(d_cm d_nutr, name(hl)) ///

d2(d_satt d_educ, name(ed)) ///

d3(d_elct d_wtr d_sani d_hsg d_ckfl d_asst, name(ls))

2. One may specify several different trial measures before moving to the actual
estimations:

mpitb set , name(trial01) d1(d_cm d_nutr_v01, name(hl)) ///

d2(d_satt_v01 d_educ, name(ed)) ///

d3(d_elct d_wtr d_sani_v01 d_hsg d_ckfl d_asst_v01, name(ls))

mpitb set , name(trial02) d1(d_cm d_nutr_v02, name(hl)) ///

d2(d_satt_v02 d_educ, name(ed)) ///

d3(d_elct d_wtr d_sani_v02 d_hsg d_ckfl d_asst_v02, name(ls))

3. Clear all information on MPI specifications previously stored with data
using mpitb set.

mpitb set , clear