Skip to contents

{ForcedDisplacementStat}: A data package with UNHCR Statistics Database

The package is inspired from tutorial @ https://r-pkgs.org/data.html (the code used to build the package is in data-raw/build.R). Data are pulled from HDX @ unhcr-population-data-for-world and are then conveniently packaged for R users intending to build data stories. Note, that you can also explore data through Refugee Data Finder.

please check {UnhcrDataPackage} to access the chart library

Install

If you are on Windows, you might first need to install Rtools on the top of R and Rstudio in order to install the package locally.

install.packages("pak")
pak::pkg_install("edouard-legoupil/ForcedDisplacementStat")

Data Content

The data presented in this website consists of the following dataset:

  • End-year population figures - these are stock figures for specific types of populations at the end of each year, including refugees, IDPs and asylum seekers.
  • Demographics – are available for the UNHCR data, IDMC and UNRWA data. No demographics are available for resettlement and naturalization data
  • Asylum applications by asylum-seekers
  • Asylum decisions taken on asylum claims of asylum-seekers
  • Solutions – these are flow figures, with the total number of individuals that have availed each solution in each year.

Data structure

Details is provided for each dataset

All data is disaggregated by year, since 1951 for stock figures, type of population, country/territory of asylum and origin.

Note that the term country/territory of asylum has a range of contexts depending on the dataset chosen

  • Resettlement – in this context this is the country of arrival – i.e. the country to which a refugee has been resettled
  • Returns – in this context this is the country of departure – i.e. the country from which a refugee has voluntarily repatriated.

Country/territory of asylum and origin – the full list of UN countries is available on the UNSD methodology page . ISO3 country codes are included. UNHCR uses the following non-standard ISO3 country codes:

  • UNK for Various/unknown
  • STA for Stateless

Data protection & Statistical Disclosure Risk Treatment

Before publishing any statistics on the refugee statistics website, UNHCR applies safeguards to protect confidentiality. Small numbers less than five are rounded to the nearest multiple of five. Additionally data relating to pending asylum applications, new applications and decisions is rounded between five and ten.

Data between tables remains additive therefore the totals should be considered approximations.