*! version 0.1.4 8 Nov 2022

mpitb setwgts -- sets weights for a particular specification

Syntax

mpitb setwgts , [options]

options

* name(mpiname) name of the MPI

* wgtsname(wname) name of the weighting scheme

† dimw(numlist) dimensional weights

† indw(numlist) indicator weights

store stores weighting scheme to the data

* required options; † exactly one of these options is required.

Description

mpitb setwgts may calculate and set the weighting scheme for a particular
MPI specification. First, it calculates indicator weights for given dimensional
weights or vice versa, depending on what the user provided. Moreover, mpitb setwgts stores both sets of weights for a particular MPI with the active data set.

mpitb setwgts is intended for advanced users and programmers who wish to
implement their own tools of analysis. For conventional analyses one may access
all relevant functionality of mpitb setwgts also from mpitb est.

Options

name(mpiname) mpiname is the name of the particular MPI for which the
weights are to be set. This option is required.

wgtsname(wname) wname is a name to be assigned to the chosen weighting
scheme. Since weighting schemes are critical parameters, wname will be
attached to every estimation, so short and concise names are strongly encouraged.
This option is required.

dimw(numlist) specifies the weighting scheme for dimensions. Number of weights
must equal number of dimensions, as provided by mpitb set.

indw(numlist) specifies the weighting scheme for indicators. Number of weights
must equal number of indicators, as provided by mpitb set.

store stores the weighting scheme as characteristics for the particular MPI
with the data for later reference.

Remarks

(1) In setting the indicator weights, mpitb setwgts takes the missing indicator
policy of the global MPI into account. According to this policy, a missing indicator
for a particular country implies that the remaining indicators of that dimension are
re-weighted such that the weights of dimensions remain unchanged. The motivation for
this policy is to balance a comprehensive coverage of countries in the world
and cross-country comparability. For more details see the
methodological notes.
Technically, to detect a missing indicator the respective variable must exist and
exclusively contain missing values.

Examples

First, the indicators of the MPI have to be set. Subsequently, one may specify
the weight of dimensions and let mpitb setwgts calculate and set the
indicator weights.

mpitb set , d1(d_cm d_nutr, name(hl)) d2(d_satt d_educ, name(ed)) ///

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

mpitb setwgts , dimw(.5 .25 .25) wgtsname(myname) name(mympi)

Stored Results

setwgts stores the following in r():

Macros

r(wgtsname) name of weighting scheme

r(misind) missing indicator

r(wgts_dep) indicator weights

r(wgts_dim) dimensional weights

r(dim_names) names of dimensions

r(dep_vars_act) indicators actually found (not completely missing)

r(cmd) command name of last r() posting

Matrices

r(wgts_dim_m) matrix of dimensional weights

r(wgts_dep_m) matrix of indicator weights