Process UNHCR Populations of Concern Time Series Data

prepUNref(
  x,
  groups = c("refugees", "asylum_seekers"),
  range = c(min(x$year), max(x$year)),
  wide = FALSE,
  sum_groups = FALSE,
  sum_years = FALSE
)

Arguments

x

A data frame or data table of United Nations High Commissioner Populations of Concern Time Series Dataset retrieved from getUNref.

groups

A character vector of one or more desired populations. Defaults to c('refugee','asylum_seekers'). See below.

range

A numeric vector of length 2 representing start year and end year of interest. Defaults to c(min(x), max(x)).

wide

A logical switch indicating whether the return object is in wide or long (default) format.

sum_groups

A logical switch indicating whether the return object should sum populations across groups or maintain column with separate groups.

sum_years

A logical switch indicating whether the return object should sum populations across years (default) or maintain the time series (default).

Value

A prepared dyadic data.table, data.frame of United Nations High Commissioner of Refugees Populations of Concern Time Series raw data summarized by specified groups of migrants with ISO3c country codes.

Population Designations

The United Nations High Commissioner for Refugees (UNHCR) Populations of Concern Time Series dataset contains annual dyadic flows between countries for populations of concern. This dataset tracks 8 distinct populations:

Refugees (refugees)

These are individuals recognized under the Geneva Convention of 1951 as refugees or persons in "refugee like situations." These persons are defined as 1) being present outside of their home country, 2) have a well-founded fear of persecution, and 3) lack the protection of their own country.

Asylum-seekers (asylum_seekers)

Individuals seeking international protection, but whose refugee status has yet to be verified.

Internally Displaced Persons (idps)

Individuals or groups of people forced from their home as a result of armed conflict, natural or man-made disasters, or human rights violations, but have not crossed an international border.This group of IDPs are tracked by UNHCR and differ from estimates available from the Global Internal Displacement Database (GIDD), which is also available from the UNHCR Data Finder

Venezuelans Displaced Abroad (vda)

persons of Venezuelan origin who are likely to be in need of international protection under the criteria contained in the Cartagena Declaration, but who have not applied for asylum in the country in which they are present.

Stateless Persons (stateless)

Individuals defined under international law not considered as belonging to any Nation-State.

Others of Concern (ooc)

Individuals who are not covered by any of the aforementioned legal declarations, but are under UNHCR protection or receiving UNHCR assistance.

Returned IDPs returned_idps

Returned internally displaced persons.

Returned Refugees returned_refugees

Returned refugees.