Title: Download Data from the Wittgenstein Centre Human Capital Data Explorer
Version: 0.0.7
URL: https://guyabel.github.io/wcde/
BugReports: https://github.com/guyabel/wcde/issues/
Description: Download and plot education specific demographic data from the Wittgenstein Centre for Demography and Human Capital Data Explorer http://dataexplorer.wittgensteincentre.org/.
License: GPL-3
Encoding: UTF-8
LazyData: true
RoxygenNote: 7.2.3
Imports: dplyr, magrittr, tidyr, progress, countrycode, tibble, purrr, stringr, forcats, RCurl
Depends: R (≥ 2.10)
Suggests: spelling, knitr, rmarkdown, tidyverse, lemon
VignetteBuilder: knitr
Language: en-US
NeedsCompilation: no
Packaged: 2024-02-13 07:21:47 UTC; Guy
Author: Guy J. Abel ORCID iD [aut, cre, ctb], Samir K.C. ORCID iD [ctb], Michaela Potancokova [ctb], Claudia Reiter ORCID iD [ctb], Andrea Tamburini [ctb], Dilek Yildiz ORCID iD [ctb]
Maintainer: Guy J. Abel <g.j.abel@gmail.com>
Repository: CRAN
Date/Publication: 2024-02-13 08:10:02 UTC

Pipe operator

Description

See magrittr::%>% for details.

Usage

lhs %>% rhs

Education group sums

Description

Cleans epop data, downloaded using the wcde() function, for summations of population by 4, 6 or 8 education groups.

Usage

edu_group_sum(
  d = NULL,
  n = 4,
  strip_totals = TRUE,
  factor_convert = TRUE,
  year_edu_start = 2020
)

Arguments

d

Data frame downloaded from the

n

Number of education groups (from 4, 6 or 8)

strip_totals

Remove total sums in epop column. Will not strip education totals if year < year_edu_start and n = 8 as past data on population size by 8 education groups is unavailable.

factor_convert

Convert columns that are character strings to factors, with levels based on order of appearance.

year_edu_start

Year in which education splits are available for given groupings - in some versions past data is not available for some education groupings. Set to 2020 by default.

Details

Strips the epop data set to relevant rows for the n education groups.

Value

A tibble with the data selected.

Examples

library(tidyverse)
past_epop %>%
  filter(year == 2020) %>%
  edu_group_sum()

Select every other (nth) element from a vector

Description

Select every other (nth) element from a vector

Usage

every_other(x, n = 2, start = 1, fill = NULL)

Arguments

x

Vector to select (remove) elements from

n

Numeric value for the number of elements to skip. Default is 2, i.e. skips every second element

start

Numeric value to indicate which element of the vector to commence from.

fill

Character string to be used in place of skipped element. By default is NULL and hence skipped elements are removed rather than replaced.

Value

Vector with elements removed

Examples

every_other(x = letters)
every_other(LETTERS, n = 3, start = 6)
every_other(x = letters, fill = "")

Find available indicator code names in the Wittgenstein Centre Human Capital Data Explorer

Description

Find available indicator code names in the Wittgenstein Centre Human Capital Data Explorer

Usage

find_indicator(x)

Arguments

x

Character string on key word or name related to indicator of potential interest.

Value

A subset of the wic_indicators data frame with one or more of the indicator, description or definition columns matching the keyword given to x. Use the result in the indicator column to input to the get_wcde function for downloading data.

Examples

find_indicator("education")
find_indicator("migr")
find_indicator("fert")

Download data from the Wittgenstein Centre Human Capital Data Explorer

Description

Downloads data from the Wittgenstein Centre Human Capital Data Explorer. Requires a working internet connection.

Usage

get_wcde(
  indicator = "pop",
  scenario = 2,
  country_code = NULL,
  country_name = NULL,
  pop_age = c("total", "all"),
  pop_sex = c("total", "both", "all"),
  pop_edu = c("total", "four", "six", "eight"),
  include_scenario_names = FALSE,
  server = c("iiasa", "github", "1&1", "search-available", "iiasa-local"),
  version = c("wcde-v3", "wcde-v2", "wcde-v1")
)

Arguments

indicator

One character string based on the indicator column in the wic_indicators data frame, representing the variable to be downloaded.

scenario

Vector of length one or more with numbers corresponding the scenarios. See details for more information. Defaults to 2 for the SSP2 Medium scenario.

country_code

Vector of length one or more of country numeric codes based on ISO 3 digit numeric values.

country_name

Vector of length one or more of country names. The corresponding country code will be guessed using the countrycodes package.

pop_age

Character string for population age groups if indicator is set to pop. Defaults to no age groups total, but can be set to all.

pop_sex

Character string for population sexes if indicatoris set to pop. Defaults to no sex total, but can be set to both or all.

pop_edu

Character string for population educational attainment if indicator is set to pop. Defaults to total, but can be set to four, six or eight.

include_scenario_names

Logical vector of length one to indicate if to include additional columns for scenario names and short names. FALSE by default.

server

Character string for server to download from. Defaults to iiasa, but can use github or 1&1 if IIASA server is down. Can check availability by setting to search-available.

version

Character string for version of projections to obtain. Defaults to wcde-v3, but can use wcde-v2 or wcde-v1. Scenario and indicator availability vary between versions.

Details

If no country_name or country_code is provided data for all countries and regions are downloaded. A full list of available countries and regions can be found in the wic_locations data frame.

indicator must be set to a value in the first column in the table below of available demographic indicators:

indicator Indicator Description
pop Population Size (000's)
bpop Population Size by Broad Age (000's)
epop Population Size by Education (000's)
prop Educational Attainment Distribution
bprop Educational Attainment Distribution by Broad Age
growth Average Annual Growth Rate
nirate Average Annual Rate of Natural Increase
sexratio Sex Ratio
mage Population Median Age
tdr Total Dependency Ratio
ydr Youth Dependency Ratio
odr Old-age Dependency Ratio
ryl15 Age When Remaining Life Expectancy is Below 15 years
pryl15 Proportion of Population with a Remaining Life Expectancy below 15 Years
mys Mean Years of Schooling by Age
bmys Mean Years of Schooling by Broad Age
ggapmys15 Gender Gap in Mean Years Schooling (15+)
ggapmys25 Gender Gap in Mean Years Schooling (25+)
ggapedu15 Gender Gap in Educational Attainment (15+)
ggapedu25 Gender Gap in Educational Attainment (25+)
tfr Total Fertility Rate
etfr Total Fertility Rate by Education
asfr Age-Specific Fertility Rate
easfr Age-Specific Fertility Rate by Education
cbr Crude Birth Rate
macb Mean Age at Childbearing
emacb Mean Age at Childbearing by Education
e0 Life Expectancy at Birth
cdr Crude Death Rate
assr Age-Specific Survival Ratio
eassr Age-Specific Survival Ratio by Education
net Net Migration
netedu Net Migration Flows by Education
emi Emigration Flows
imm Immigration Flows

See wic_indicators data frame for more details.

scenario must be set to one or values in the first column table below of the available future scenarios:

scenario description version
1 Rapid Development (SSP1) V1, V2, V3
2 Medium (SSP2) V1, V2, V3
3 Stalled Development (SSP3) V1, V2, V3
4 Inequality (SSP4) V1, V3
5 Conventional Development (SSP5) V1, V3
20 Medium - Constant Enrollment Rate (SSP2-CER) V1
21 Medium - Fast Track Education (SSP2-FT) V1
22 Medium - Zero Migration (SSP2-ZM) V2, V3
23 Medium - Double Migration (SSP2-DM) V2, V3

See wic_scenarios data frame for more details.

Value

A tibble with the data selected.

Examples


# SSP2 tfr for Austria and Bulgaria
get_wcde(indicator = "tfr", country_code = c(40, 100))

# SSP1 and SSP2 life expectancy for Vietnam and United Kingdom (guessing the country codes)
get_wcde(scenario = c(1, 2), indicator = "e0", country_name = c("Vietnam", "UK"))

# SSP1 and SSP3 population by education for all countries
get_wcde(scenario = c(1, 3), indicator = "tfr")

# population totals (aggregated over age, sex and education)
get_wcde(indicator = "pop", country_name = "Austria")

# population totals by education group
get_wcde(indicator = "pop", country_name = "Austria", pop_edu = "four")

# population totals by age-sex group
get_wcde(indicator = "pop", country_name = "Austria", pop_age = "all", pop_sex = "both")

Pull multiple vectors for a given indicator, scenarios and .Rdata file names

Description

Requires a working internet connection. Intended for internal use.

Usage

get_wcde_single(
  indicator = NULL,
  scenario = 2,
  country_code = NULL,
  server = NULL,
  version = NULL
)

Arguments

indicator

One character string based on the name column in the wic_indicators data frame, representing the variable to be interested.

scenario

Vector with a numbers corresponding the scenarios. See details in wcde for more information.

country_code

Vector of length one or more of country numeric codes based on ISO 3 digit numeric values.

server

Character string for server to download from. Defaults to iiasa, but can use github if IIASA server is down.

version

Character string for version of projections to obtain. Defaults to wcde-v3, but can use wcde-v2 and wcde-v1. Scenario and indicator availability vary between versions.

Value

A tibble with multiple columns.

Past population sizes for all countries by education

Description

A data set containing population sizes for all countries by education between 1950 and 2020

Usage

past_epop

Format

A data frame with 840,126 rows and 7 variables, including:

name

Area name

country_code

ISO 3 digit country code

year

Year of observation from 1950 to 2020 in five-year steps

age

Five-year age groups

education

Education group

sex

Sex

epop

Population size in thousands for each age, sex and education group

Source

http://dataexplorer.wittgensteincentre.org/

Test if country code or codes are in wic_locations

Description

Intended for internal use.

Usage

wcde_location(country_code, version = c("wcde-v3", "wcde-v2", "wcde-v1"))

Arguments

country_code

vector of integers representing country codes

Value

TRUE if all codes given to country_code are in wic_locations, FALSE if one or more are not.

Examples

wcde_location(country_code = c(-11, 44))
wcde_location(country_code = c(100, 44))
wcde_location(country_code = 3)

Colours used in Wittgenstein Centre for Demography and Human Capital Data Explorer

Description

Three sets of colours used for filling education based plots based on the different availability of detailed education categories (four, six or eight groups)

Usage

wic_col4

Format

A named vector

Colours used in Wittgenstein Centre for Demography and Human Capital Data Explorer

Description

Three sets of colours used for filling education based plots based on the different availability of detailed education categories (four, six or eight groups)

Usage

wic_col6

Format

A named vector

Colours used in Wittgenstein Centre for Demography and Human Capital Data Explorer

Description

Three sets of colours used for filling education based plots based on the different availability of detailed education categories (four, six or eight groups)

Usage

wic_col8

Format

A named vector

Indicators used in the Wittgenstein Centre Human Capital Data Explorer

Description

A data set containing the indicator codes, names and further details used in the Wittgenstein Centre Human Capital Data Explorer

Usage

wic_indicators

Format

A data frame with 37 rows and 11 variables, including:

indicator

Short name of indicator to be used in the indicator argument of the get_wcde() function

description

Brief description of indicator

wcde-v3

Availability in wcde-v3 of projection-only or past-available (in addition to projections) of indicator. If value is NA then indicator not available in version.

wcde-v2

Availability in wcde-v2 of projection-only or past-available (in addition to projections) of indicator. If value is NA then indicator not available in version.

wcde-v1

Availability in wcde-v1 of projection-only or past-available (in addition to projections) of indicator. If value is NA then indicator not available in version.

age

Availability of indicator by five-year age groups

bage

Availability of indicator by broad age groups

sage

Availability of indicator with a new born age group

sex

Availability of indicator by sex

edu

Availability of indicator by education

period

Indicator is a period (flow)

definition_latest

Full definition for indicator based on latest available version

Source

http://dataexplorer.wittgensteincentre.org/

Locations used in the Wittgenstein Centre Human Capital Data Explorer

Description

A dataset containing the location codes, names and further details used in the Wittgenstein Centre Human Capital Data Explorer

Usage

wic_locations

Format

A data frame with 232 rows and 8 variables, including:

name

Area name

isono

ISO 3 digit country code

continent

Continent of country

region

UN region of country

dim

Category or country/region/area

wcde-v3

Availability of area in Version 3

wcde-v2

Availability of area in Version 2

wcde-v1

Availability of area in Version 1

Source

http://dataexplorer.wittgensteincentre.org/

Scenarios used in the Wittgenstein Centre Human Capital Data Explorer

Description

A data set containing the scenario codes, names short names used in the Wittgenstein Centre Human Capital Data Explorer

Usage

wic_scenarios

Format

A data frame with 9 rows and 6 variables, including:

scenario_name

Full scenario name

scenario

Code to match help file of get_wcde function

scenario_abb

Short scenario name

wcde-v3

Availability of area in Version 3

wcde-v2

Availability of area in Version 2

wcde-v1

Availability of area in Version 1

Source

http://dataexplorer.wittgensteincentre.org/