Retrieve and create a data.table, data.frame of United Nations International Migrant Stocks Time Series (1990-2019) data from the official United Nations Department of Economic and Social Affairs Population Division.

getUNstocks(version = "2019", wide = FALSE, range = c(1990, 2019))

Arguments

version

A character string indicating desired version for acquisition. Defaults to version = '2019'. The 2017 dataset is still available (version = '2017') See details below.

wide

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

range

A numeric vector of length 2 representing start year and end year of interest. Defaults to c(1990, 2019).

Value

Returns a dyadic data frame of host country and stock country populations in for the years 1990, 1995, 2000, 2005, 2010, 2015, 2017, and 2019.

Details

This dataset presents estimates of international migrant populations by origin. Estimates are presented for 1990, 1995, 2000, 2005, 2010, 2015, 2017, and 2019 and are available for all countries and areas of the world. The estimates are based on official statistics on the foreign-born or the foreign population.

This dataset may be acquired directly from the United Nations Department of Economic and Social Affairs Population Division website and placed in your working directory. The getUNref function will import and process the raw file if the original filenames are kept intact; otherwise they will be downloaded directly.The 2019 and 2017 are still available online.