Skip to contents

Download population projections

Source: R/download_population_projections.R
download_pop_projections.Rd

This function downloads population projections and back projections taken from the National Population and Dwelling Census of 2018 (CNPV), adjusted after COVID-19. Available years are different for each spatial level:

  • "national": 1950 - 2070.

  • "national" with sex: 1985 - 2050.

  • "department": 1985 - 2050.

  • "department" with sex: 1985 - 2050.

  • "municipality": 1985 - 2035.

  • "municipality" with sex: 1985 - 2035.

  • "municipality" with sex and ethnic groups: 2018 - 2035.

Usage

download_pop_projections(
  spatial_level,
  start_year,
  end_year,
  include_sex = FALSE,
  include_ethnic = FALSE
)

Arguments

spatial_level

character with the spatial level to be consulted. Can be either "national", "department" or "municipality".

start_year

numeric with the start year to be consulted.

end_year

numeric with the end year to be consulted.

include_sex

logical for including (or not) division by sex. Default is FALSE.

include_ethnic

logical for including (or not) division by ethnic group (only available for "municipality"). Default is FALSE.

Value

data.frame object with downloaded data.

Examples

pop_proj <- download_pop_projections("national", 2020, 2030)
#> Original data is retrieved from the National Administrative Department
#> of Statistics (Departamento Administrativo Nacional de Estadística -
#> DANE).
#> Reformatted by package authors.
#> Stored by Universidad de Los Andes under the Epiverse TRACE iniative.
head(pop_proj)
#>   codigo_departamento   departamento  ano                              area
#> 1                  00 Total nacional 2020                          cabecera
#> 2                  00 Total nacional 2020 centros_poblados_y_rural_disperso
#> 3                  00 Total nacional 2020                             total
#> 4                  00 Total nacional 2021                          cabecera
#> 5                  00 Total nacional 2021 centros_poblados_y_rural_disperso
#> 6                  00 Total nacional 2021                             total
#>      total
#> 1 38235229
#> 2 12172418
#> 3 50407647
#> 4 38850492
#> 5 12266886
#> 6 51117378