Define MPI specifications: dimensions, indicators, and weights

Use to define MPI dimensions, indicators and its corresponding weights using any of the accessible file types: .xlsx (Excel), .json, .csv, or .txt (TSV). You can also set the poverty cutoff or list of poverty cutoffs (to achieve gradient list of MPIs) that will be used in the computation of MPI.

Usage

define_mpi_specs(
  .mpi_specs_file = NULL,
  .indicators = NULL,
  .poverty_cutoffs = 1/3,
  .unit_of_analysis = NULL,
  .aggregation = NULL,
  .uid = NULL,
  .source_of_data = NULL,
  .names_separator = ">",
  .save_as_global_options = TRUE
)

Arguments

.mpi_specs_file

Accepts .xlsx (Excel), .json, .csv, or .txt (TSV) file format. This file should contain the following columns/variables: Dimension, Indicator, Variable, Weight, and Description (optional). See example below.

.indicators

A data frame of MPI indicators. Useful if prefer define your indicators instead of using an external file.

.poverty_cutoffs

Accepts single value or a vector of poverty cutoffs. This parameter (usually denoted by k) reflects the minimum level of deprivations or deprivation score an individual or household must be suffering simultaneously to be considered poor. See example below.

.unit_of_analysis

e.g. individuals, families, households, or communities. Default value is NULL.

.aggregation

Column name in the dataset that defines an aggregation level.

.uid

Column name containing unique ID of the dataset which defines the lowest level of disaggregation (usually unit of analysis).

.source_of_data

Source of data used in the computation. This will be used in the footnote of the table when generating an output.

.names_separator

Column separator that defines the hierarchy of the column header.

.save_as_global_options

Whether to save the specs globally. Equivalent to invoking options().

Value

MPI specifications data frame required in compute_mpi function. As as side effect, a global option named `mpi_specs` will be saved for efficiency. See `getOption('mpi_specs')`.

See also

compute_mpi

Examples

# Use sample specs file included in the package
specs_file <- system.file(
  "extdata",
  "global-mpi-specs.csv",
  package = "mpindex"
)
# To see other sample specs file (with different supported file format)
system.file("extdata", package = "mpindex") |>
  list.files()
#> [1] "global-mpi-specs.csv"  "global-mpi-specs.json" "global-mpi-specs.txt" 
#> [4] "global-mpi-specs.xlsx"