Lookup tables for estimating the likelihood of poverty using the
Poverty Probability Index
(previously called Progress out of Poverty
Index
) or PPI
from country-specific indicators collected from
cross-sectional surveys. These lookup tables are extracted from
documentation of the PPI
found at https://www.povertyindex.org.
You can install ppitables
from CRAN with:
install.packages("ppitables")
You can install the current development version from the Katilingban R-universe:
install.packages(
"ppitables",
c('https://nutriverse.r-universe.dev', 'https://cloud.r-project.org')
)
The ppitables
package contains PPI lookup tables for the 61
countries1 where PPI can currently be calculated. To be able
to use the lookup tables in ppitables
appropriately, you need to be
aware of the naming syntax used for the tables for each country. The
name for each table will always have three fixed or constant components
as follows:
ppiXXXYYYY
The name of any of the PPI tables contains:
ppi
in lower case letters;XXX
which is the the three letter ISO code
of the country of
interest (all capitals); and,YYYY
which is the specific year at which the country PPI table was
released.These three components are joined together without any spaces or gaps.
Some country lookup tables may have additional components to their name
which are added after the year separated with an underscore. These
usually signify that a lookup table released on a particular year has a
subset table in which the poverty likelihoods for a given PPI
score
are reported based on a different poverty definition or cut-off. This
additional component to the table name is usually a character value or
alphanumeric and is usually country-specific. To know more about what
this additional component to some PPI
tables refer to, read the index
table below of the PPI
tables available in this package.
Following are the available PPI country tables from the ppitables
package. This is updated as at 11 April 2023 using information from the
PPI site.
ppiAFG2012
PPI for Afghanistan based on 2007/8 National Risk and Vulnerability Survey (NRVA)
2012
ppiAGO2015
PPI for Angola based on the 2008/2009 Household Living Standards Survey
2015
ppiBEN2012
PPI for Benin based on 2010 data
2012
ppiBEN2022_11q
PPI for Benin based on 2018/9 Enquete Harmonisée sur le Conditions de Vie des Ménages (EHCVM) and using an 11 question score card
2022
ppiBEN2022_6q
PPI for Benin based on 2018/9 Enquete Harmonisée sur le Conditions de Vie des Ménages (EHCVM) and using a 6 question score card
2022
ppiBFA2011
PPI for Burkina Faso using Burkina Faso’s 2003 Household Living Standards Survey
2011
ppiBFA2014
PPI for Burkina Faso using Burkina Faso’s 2014 Permanent Multi-Sector Survey
2017
ppiBFA2017
PPI for Burkina Faso using Burkina Faso’s 2014 Enquête Multisectorielle Continue (EMC) based on IPA’s new approach to PPI calculation
2017
ppiBFA2023
PPI for Burkina FASO based on data from 2018 Enquête Harmonisée sur le Conditions de Vie des Ménages (EHCVM)
2023
ppiBGD2013
PPI for Bangladesh using Bangaldesh’s 2010 HIES Survey
2013
ppiBOL2015
PPI for Bolivia using Bolivia’s 2013 Household Survey
2015
ppiBOL2023
PPI for Bolivia using data from Encuesta de Hogares 2020
2023
ppiBRA2010
PPI for Brazil based on the 2008 PNAD
2010
ppiCIV2013
PPI for Ivory Coast using the Ivory Coast’s 2008 Household Living Standards Survey
2013
ppiCIV2018
PPI for Ivory Coast using the Ivory Coast’s 2015 Enquête sur le Niveau de Vie des Ménages
2018
ppiCMR2013
PPI for Cameroon using Cameroon’s 2007 Household Survey
2013
ppiCOL2012
PPI for Colombia based on Colombia’s 2009 Encuesta Integrada de Hogares. This table uses the old poverty definitions.
2012
ppiCOL2012_a
PPI for Colombia based on Colombia’s 2009 Encuesta Integrada de Hogares. This table uses the new poverty definitions for Colombia.
2012
ppiCOL2018
PPI for Colombia based on Colombia’s 2016 Gran Encuesta Integrada de Hogares (GEIH)
2018
ppiDOM2010
PPI for Dominican Republic based on the 2007 Encuesta Nacional de Ingresos y Gastos de los Hogares (ENIGH)
2010
ppiDOM2018
PPI for Dominican Republic based on the 2016 Encuesta Nacional de Fuerza de Trabajo (ENFT)
2018
ppiECU2015
PPI for Ecuador based on the 2013 Living Standards Survey
2015
ppiECU2022
PPI for Ecuador based on data from the Encuesta Nacional de Empleo, Desempleo y Subempleo (ENEMDU) from 2019, 2020 and 2021
2022
ppiEGY2010
PPI for Egypt based on the 2004/5 HIECS
2010
ppiETH2016
PPI for Ethiopia based on Ethiopia’s 2010/11 Household Consumption and Expenditure Survey
2016
ppiETH2023
PPI for Ethiopia based on data from the Socioeconomic Survey 2018/2019"
2023
ppiFJI2014
PPI for Fiji based on Fiji’s 2008/9 Household Income and Expenditure Survey
2014
ppiGHA2015
PPI for Ghana based on Ghana’s 2012/13 Living Standards Survey using legacy poverty lines
2015
ppiGHA2015_a
PPI for Ghana based on Ghana’s 2012/13 Living Standards Survey using the new-definition poverty lines deflated with Ghana’s CPI
2015
ppiGHA2015_b
PPI for Ghana based on Ghana’s 2012/13 Living Standards Survey using the new-definition poverty lines deflated with the change in 100% of national poverty line
2015
ppiGHA2019
PPI for Ghana based on Ghana’s 2016/2017 Living Standards Survey
2019
ppiGTM2016
PPI for Guatemala based on Guatemala’s 2014 Household Living Standards Survey
2016
ppiGTM2023
PPI for Guatemala based on data from Encuesta Nacional de Empleo e Ingresos of 2021
2023
ppiHND2010
PPI for Honduras based on the 2007 EPHPM
2010
ppiHND2023
PPI for Honduras based on data from the Encuesta Permanente de Hogares de Propósitos Múltiples (EPHPM) 2019
2023
ppiHTI2016
PPI for Haiti based on Haiti’s 2012 Post-Earthquake Living Standards Survey
2016
ppiIDN2012
PPI for Indonesia based on data from 2010 using legacy poverty lines
2012
ppiIDN2012_a
PPI for Indonesia based on data from 2010 using new definition poverty lines
2012
ppiIDN2020
PPI for Indonesia based on data from Indonesia’s SUSENA 2016
2020
ppiIDN2023
PPI for Indonesia based on data from the 2022 National Socioeconomic Survey (SUSENAS)
2023
ppiIND2016_r59
PPI for India using India’s 2011/12 Socio-Economic using the R59 legacy poverty lines using MRP consumption
2016
ppiIND2016_r62
PPI for India using India’s 2011/12 Socio-Economic using the R59 legacy poverty lines using MRP consumption
2016
ppiIND2016_r66
PPI for India using India’s 2011/12 Socio-Economic using the R66 legacy poverty lines using MRP consumption
2016
ppiIND2016_r68
PPI for India using India’s 2011/12 Socio-Economic using the R68 new poverty lines using MRP consumption
2016
ppiJOR2010
PPI for Jordan using Jordan’s 2006 Household Income and Expenditure Survey
2010
ppiKEN2011
PPI for Kenya using Kenya’s 2005/06 Integrated Household Budget Survey
2011
ppiKEN2018
PPI for Kenya using Kenya’s 2015 Integrated Household Budget Survey
2018
ppiKGZ2015
PPI for Kyrgyzstan Kyrgyz Republic’s 2012 Integrated Household Survey
2015
ppiKHM2105
PPI for Cambodia using Cambodia’s 2011 Socio-Economic Survey based using legacy poverty lines
2015
ppiKHM2015_gov
PPI for Cambodia using Cambodia’s 2011 Socio-Economic Survey based using government definition poverty lines
2015
ppiKHM2015_wb
PPI for Cambodia using Cambodia’s 2011 Socio-Economic Survey based using World Bank definition poverty lines
2015
ppiKHM2023
PPI for Cambodia using data from 2020 Living Standards Measurement Study - Plus (LSMS+)
2023
ppiLKA2016
PPI for Sri Lanka using Sri Lanka’s 2012/13 Household Income and Expenditure Survey
2016
ppiMAR2013
PPI for Morocco based on Morocco’s 2007 Households Living Standards Survey
2013
ppiMDG2015
PPI for Madagascar based on Madagascar’s 2010 Periodic Household Survey
2015
ppiMEX2017
PPI for Mexico based on Mexico’s Encuesta Nacional de Ingresos y Gastos de los Hogares de 2014 using legacy definitions of poverty
2017
ppiMEX2017_a
PPI for Mexico based on Mexico’s Encuesta Nacional de Ingresos y Gastos de los Hogares de 2014 using new definitions of poverty
2017
ppiMLI2010
PPI for Mali based on Mali’s 2001 Poverty Evaluation Survey
2010
ppiMMR2012
PPI for Myanmar based on Myanmar’s 2009/10 Integrated Household Living Conditions Assessment
2012
ppiMMR2019
PPI for Myanmar based on Myanmar’s 2015 Poverty and Living Conditions Survey
2019
ppiMNG2016
PPI for Mongolia based on Mongolia’s 2014 Household Socio-Economic Survey
2016
ppiMOZ2013
PPI for Mozambique based on 2008/9 Household Budget Survey
2013
ppiMOZ2019
PPI for Mozambique based on 2014 Inquerito Sobre Orcamento Familiar (IOF) Survey
2019
ppiMWI2015
PPI for Malawi based on Malawi’s 2010/11 Integrated Household Survey using legacy poverty definitions
2015
ppiMWI2015_gov
PPI for Malawi based on Malawi’s 2010/11 Integrated Household Survey using government poverty definitions
2015
ppiMWI2015_pbm
PPI for Malawi based on Malawi’s 2010/11 Integrated Household Survey using PBM poverty definitions
2015
ppiMWI2020
PPI for Malawi based on Malawi’s 2016-2017 Fourth Integrated Household Survey (IHS4) using new PPI definitions
2020
ppiMWI2023
PPI for Malawi based on data from the Fifth Integrated Household Survey 2019
2023
ppiNAM2013
PPI for Namibia based on Namibia’s 2009/10 Household Income and Expenditure Survey
2013
ppiNER2013
PPI for Niger based on Niger’s 2007/8 National Household Budget and Expenditure Survey
2013
ppiNGA2015
PPI for Nigeria based on Nigeria’s 2012/13 General Household Panel Survey
2015
ppiNIC2013
PPI for Nicaragua based on Nicaragua’s 2009 Living Standards Measurement Survey
2013
ppiNPL2013
PPI for Nepal using legacy poverty definition lines
2013
ppiNPL2013_a
PPI for Nepal using new poverty definition lines
2013
ppiPAK2009
PPI for Pakistan using Pakistan 2005/6 Social and Living Standards Measurement Survey
2009
ppiPER2012
PPI for Peru based on Peru’s 2010 National Household Survey
2012
ppiPER2018
PPI for Peru based on Peru’s 2016 Encuesta Nacional de Hogares sobre Condiciones de Vida y Pobreza (ENAHO)
2018
ppiPHL2014
PPI for the Philippines based on Philippines’ 2009 FIES/LFS.
2014
ppiPHL2018
PPI for the Philippines based on Philippines’ 2015 Family Income and Expenditure Survey (FIES)
2018
ppiPHL2023
PPI for the Philippines based on data from the 2018 Family Income and Expenditure Survey (FIES)
2023
ppiPNG2023
PPI for Papua New Guinea based on data from 2016-2018 Demographic and Health Survey (DHS)
2023
ppiPRY2012
PPI for Paraguay based on Paraguay’s 2011 EPH
2012
ppiPSE2014
PPI for Palestine based on Palestine’s 2011 Expenditure and Consumption Survey
2014
ppiROU2009
PPI for Romania based on the 2007 HBS
2009
ppiRUS2010
PPI for Russia based on 2007 HBS
2010
ppiRWA2016
PPI for Rwanda based on Rwanda’s 2010/11 Integrated Household Living Standards Survey
2016
ppiRWA2019
PPI for Rwanda based on Rwanda’s 2016/2017 Integrated Household Living Conditions Survey (EICV5) produced by the National Institute of Statistics of Rwanda (NISR) and the Ministry of Finance and Planning
2019
ppiSEN2009
PPI for Senegal based on Senegal’s 2005/6 Enquête de Suivi de la Pauvreté au Sénégal (ESPS)
2009
ppiSEN2018
PPI for Senegal based on Senegal’s 2011 Enquête de Suivi de la Pauvreté au Sénégal (ESPS)
2018
ppiSLE2011
PPI for Sierra Leone based on Sierra Leone’s 2003/4 HIS
2011
ppiSLV2010
PPI for El Salvador based on the 2008 EHPM
2010
ppiSLV2021
PPI for El Salvador based on data from 2019 Encuesta de Hogares de Propósitos Múltiples
2021
ppiSYR2010
PPI for Syria based on Syria’s 2006/7 Household Income and Expenditure Survey
2010
ppiTJK2015
PPI for Tajikistan based on 2007 data
2015
ppiTLS2013
PPI for Timor Leste based on Timor-Leste’s 2007 Survey of Living Standards
2013
ppiTZA2016
PPI for Tanzania based on Tanzania’s 2011/12 Household Budget Survey
2016
ppiTZA2022
PPI for Tanzania based on Tanzania’s 2017/2018 Household Budget Survey
2022
ppiTGO2018
PPI for Togo based on Togo’s 2015 Questionnaire des Indicateurs de Base du Bien-être (QUIBB)
2018
ppiTGO2023
PPI for Togo based on data from the 2018 Enquête Harmonisée sur le Conditions de Vie des Ménages (EHCVM)
2023
ppiUGA2015
PPI for Uganda based on Uganda’s 2012/13 National Household Survey
2015
ppiUGA2022
PPI for Uganda based on Uganda’s 2020 National Household Survey
2022
ppiVNM2009
PPI for Vietnam based on the 2006 VHLSS
2009
ppiVNM2023
PPI for Vietnam based on data from the 2021 Multiple Indicator Cluster Survey
2023
ppiYEM2009
PPI for Yemen based on 2005/06 HBS
2009
ppiZAF2009
PPI for South Africa based on the 2005/6 IES
2009
ppiZAF2023
PPI for South Africa based on data from the 2019 General Household Survey
2023
ppiZMB2013_got
PPI for Zambia based on Zambia’s 2010 Living Conditions Monitoring Survey (LCMS) using Göttingen poverty definitions
2013
ppiZMB2013_cso
PPI for Zambia based on Zambia’s 2010 Living Conditions Monitoring Survey (LCMS) using CSO poverty definitions
2013
ppiZMB2017
PPI for Zambia based on Zambia’s 2015 Living Conditions Monitoring Survey (LCMS) using legacy poverty definitions
2017
ppiZMB2017_a
PPI for Zambia based on Zambia’s 2015 Living Conditions Monitoring Survey (LCMS) using new PPI calculation approach
2017
This list of available PPI country tables can be retrieved in R using
the find_table()
function. View the complete list using the following
command in R:
find_table()
#> # A tibble: 110 × 7
#> region country survey_year release_year description type filename
#> <chr> <chr> <int> <int> <chr> <chr> <chr>
#> 1 Asia Afghan… 2007 2012 PPI for Af… sps ppiAFG2…
#> 2 Africa Angola 2008 2015 PPI for An… sps ppiAGO2…
#> 3 Asia Bangla… 2010 2013 PPI for Ba… sps ppiBEN2…
#> 4 Africa Benin 2010 2012 PPI for Be… sps ppiBGD2…
#> 5 Africa Benin 2018 2022 PPI for Be… ipa ppiBEN2…
#> 6 Africa Benin 2018 2022 PPI for Be… ipa ppiBEN2…
#> 7 Latin American a… Bolivia 2013 2015 PPI for Bo… sps ppiBOL2…
#> 8 Latin American a… Bolivia 2020 2023 PPI for Bo… ipa ppiBOL2…
#> 9 Latin American a… Brazil 2008 2010 PPI for Br… sps ppiBRA2…
#> 10 Africa Burkin… 2003 2011 PPI for Bu… sps ppiBFA2…
#> # ℹ 100 more rows
View the list of PPI country tables for Africa using the following command in R:
find_table(region = "Africa")
#> # A tibble: 48 × 7
#> region country survey_year release_year description type filename
#> <chr> <chr> <int> <int> <chr> <chr> <chr>
#> 1 Africa Angola 2008 2015 PPI for Angola … sps ppiAGO2…
#> 2 Africa Benin 2010 2012 PPI for Benin b… sps ppiBGD2…
#> 3 Africa Benin 2018 2022 PPI for Benin b… ipa ppiBEN2…
#> 4 Africa Benin 2018 2022 PPI for Benin b… ipa ppiBEN2…
#> 5 Africa Burkina Faso 2003 2011 PPI for Burkina… sps ppiBFA2…
#> 6 Africa Burkina Faso 2014 2017 PPI for Burkina… sps ppiBFA2…
#> 7 Africa Burkina Faso 2014 2017 PPI for Burkina… ipa ppiBFA2…
#> 8 Africa Burkina Faso 2018 2023 PPI for Burkina… ipa ppiBFA2…
#> 9 Africa Cameroon 2007 2013 PPI for Cameroo… sps ppiCMR2…
#> 10 Africa Cote d'Ivoire 2008 2013 PPI for Ivory C… sps ppiCIV2…
#> # ℹ 38 more rows
View the list of PPI country tables in Zambia using the the following command in R:
find_table(country = "Zambia")
#> # A tibble: 4 × 7
#> region country survey_year release_year description type filename
#> <chr> <chr> <int> <int> <chr> <chr> <chr>
#> 1 Africa Zambia 2010 2013 PPI for Zambia based o… sps ppiZMB2…
#> 2 Africa Zambia 2010 2013 PPI for Zambia based o… sps ppiZMB2…
#> 3 Africa Zambia 2015 2017 PPI for Zambia based o… sps ppiZMB2…
#> 4 Africa Zambia 2015 2017 PPI for Zambia based o… ipa ppiZMB2…
To extract the actual PPI tables, the get_table()
function can be
used. The get_table()
function wraps around the find_table()
function to make a search for a specific PPI table and then extracts the
table/s and puts them together into a tidy data frame.
For example, to get the actual PPI tables for all countries with PPI tables, the following command can be used in R:
get_table()
#> # A tibble: 117,902 × 7
#> country release_year filename type score poverty_definition ppi
#> <chr> <chr> <chr> <chr> <dbl> <chr> <dbl>
#> 1 Afghanistan 2012 ppiAFG2012 sps 0 nl 100
#> 2 Afghanistan 2012 ppiAFG2012 sps 0 nu150 100
#> 3 Afghanistan 2012 ppiAFG2012 sps 0 nu200 100
#> 4 Afghanistan 2012 ppiAFG2012 sps 0 extreme 100
#> 5 Afghanistan 2012 ppiAFG2012 sps 0 ppp125 100
#> 6 Afghanistan 2012 ppiAFG2012 sps 0 ppp250 100
#> 7 Afghanistan 2012 ppiAFG2012 sps 1 nl 100
#> 8 Afghanistan 2012 ppiAFG2012 sps 1 nu150 100
#> 9 Afghanistan 2012 ppiAFG2012 sps 1 nu200 100
#> 10 Afghanistan 2012 ppiAFG2012 sps 1 extreme 100
#> # ℹ 117,892 more rows
To get the actual PPI tables for all countries with PPI tables in Africa, the following command can be used in R:
get_table(region = "Africa")
#> # A tibble: 56,210 × 7
#> country release_year filename type score poverty_definition ppi
#> <chr> <chr> <chr> <chr> <dbl> <chr> <dbl>
#> 1 Angola 2015 ppiAGO2015 sps 0 nl100 100
#> 2 Angola 2015 ppiAGO2015 sps 0 nl150 100
#> 3 Angola 2015 ppiAGO2015 sps 0 nl200 100
#> 4 Angola 2015 ppiAGO2015 sps 0 half100 86.5
#> 5 Angola 2015 ppiAGO2015 sps 0 ppp125 100
#> 6 Angola 2015 ppiAGO2015 sps 0 ppp200 100
#> 7 Angola 2015 ppiAGO2015 sps 0 ppp250 100
#> 8 Angola 2015 ppiAGO2015 sps 0 ppp500 100
#> 9 Angola 2015 ppiAGO2015 sps 1 nl100 100
#> 10 Angola 2015 ppiAGO2015 sps 1 nl150 100
#> # ℹ 56,200 more rows
The {ppitables}
package is an independent development and is separate
from and not recognised and approved by the International Poverty
Alliance (IPA), the organisation that
produces and owns the copyright to the Poverty Probability
Index. The author and maintainer of this
package is not affiliated with International Poverty Alliance
(IPA) but is committed to ensuring that
the {ppitables}
package is compliant with the Poverty Probability
Index’s terms of use.
Any mistakes, problems and issues with the functionality and outputs of
the {ppitables}
package are that of the author and maintainer of the
package and not of International Poverty Alliance
(IPA). Hence any problems and issues to
the usage, functionality and outputs of the {ppitables}
package should
be addressed directly to the author and maintainer
here.
If you find the {ppitables}
package useful, please cite using the
suggested citation provided by a call to the citation
function as
follows:
citation("ppitables")
#> To cite ppitables in publications use:
#>
#> Ernest Guevarra (2024). _ppitables: Lookup Tables to Generate Poverty
#> Likelihoods and Rates using the Poverty Probability Index (PPI)_.
#> doi:10.5281/zenodo.4129982 <https://doi.org/10.5281/zenodo.4129982>,
#> R package version 0.5.5, <https://katilingban.io/ppitables/>.
#>
#> A BibTeX entry for LaTeX users is
#>
#> @Manual{,
#> title = {ppitables: Lookup Tables to Generate Poverty Likelihoods and Rates using the Poverty Probability Index (PPI)},
#> author = {{Ernest Guevarra}},
#> year = {2024},
#> note = {R package version 0.5.5},
#> url = {https://katilingban.io/ppitables/},
#> doi = {10.5281/zenodo.4129982},
#> }
Feedback, bug reports and feature requests are welcome; file issues or seek support here. If you would like to contribute to the package, please see our contributing guidelines.
Please note that the {ppitables}
project is released with a
Contributor Code of
Conduct. By
contributing to this project, you agree to abide by its terms.
1 Only 60 country PPI tables are shown here and available via the package. There is no lookup table for China because the China Poverty Scorecard is an expert-based scorecard. See this for further explanation.
Add the following code to your website.
For more information on customizing the embed code, read Embedding Snippets.