Skip to contents

The source argument

Use the source argument in convertGDP to control the source of the underlying conversion factors (GDP deflators, MERs and PPPs). This can be a user-defined object or one of the sources shipped with the package.

User-defined ‘source’ objects

Any tibble with columns:

  • “iso3c” (character),
  • “year” (numeric),
  • “GDP deflator” (numeric),
  • “MER (LCU per US$)” (numeric),
  • “PPP conversion factor, GDP (LCU per international $)” (numeric)

can be used as a source of conversion factors.

library(GDPuc)

my_gdp <- tibble::tibble(
  iso3c = "USA", 
  year = 2010:2014, 
  value = 100:104
)

my_custom_source <- tibble::tibble(
  iso3c = "USA", 
  year = 2010:2014, 
  "GDP deflator" = seq(1, 1.1, 0.025),
  "MER (LCU per US$)" = 1,
  "PPP conversion factor, GDP (LCU per international $)" = 1,
)
print(my_custom_source)
#> # A tibble: 5 × 5
#>   iso3c  year `GDP deflator` `MER (LCU per US$)` PPP conversion factor, GDP (L…¹
#>   <chr> <int>          <dbl>               <dbl>                           <dbl>
#> 1 USA    2010           1                      1                               1
#> 2 USA    2011           1.02                   1                               1
#> 3 USA    2012           1.05                   1                               1
#> 4 USA    2013           1.08                   1                               1
#> 5 USA    2014           1.1                    1                               1
#> # ℹ abbreviated name: ¹​`PPP conversion factor, GDP (LCU per international $)`

convertGDP(
  gdp = my_gdp, 
  unit_in = "constant 2010 LCU", 
  unit_out = "constant 2014 Int$PPP",
  source = my_custom_source,
  verbose = TRUE
)
#>  Converting GDP with conversion factors from user_provided:
#> constant 2010 LCU  constant 2014 LCU
#> 2014 value of base 2010 GDP deflator in (constant 2014 LCU per constant 2010
#> LCU) used:
#> USA: 1.1
#> constant 2014 LCU  constant 2014 Int$PPP
#> 2014 PPP conversion factor in (LCU per international $) used:
#> USA: 1
#> # A tibble: 5 × 3
#>   iso3c  year value
#>   <chr> <int> <dbl>
#> 1 USA    2010  110 
#> 2 USA    2011  111.
#> 3 USA    2012  112.
#> 4 USA    2013  113.
#> 5 USA    2014  114.

Shipped ‘sources’

There are two source options shipped with the package, wb_wdi and wb_wdi_linked, with wb_wdi set as the default. Pass the name of a shipped source to the source argument to use it.

convertGDP(
  gdp = my_gdp, 
  unit_in = "constant 2010 LCU", 
  unit_out = "constant 2014 Int$PPP",
  source = "wb_wdi_linked",
  verbose = TRUE
)
#>  Converting GDP with conversion factors from wb_wdi_linked:
#> constant 2010 LCU  constant 2014 LCU
#> 2014 value of base 2010 GDP deflator in (constant 2014 LCU per constant 2010
#> LCU) used:
#> USA: 1.07786
#> constant 2014 LCU  constant 2014 Int$PPP
#> 2014 PPP conversion factor in (LCU per international $) used:
#> USA: 1
#> # A tibble: 5 × 3
#>   iso3c  year value
#>   <chr> <int> <dbl>
#> 1 USA    2010  108.
#> 2 USA    2011  109.
#> 3 USA    2012  110.
#> 4 USA    2013  111.
#> 5 USA    2014  112.

Use the function print_source_info to print information on a specific, or all available sources.

print_source_info("wb_wdi")
#> ── wb_wdi ──────────────────────────────────────────────────────────────────────
#> → Origin: The World Bank's World Development Indicator Database
#> → Date: Downloaded on the 30th of April 2024
#> → Html: https://databank.worldbank.org/source/world-development-indicators
#> → Note: Uses the GDP deflator.
#> ────────────────────────────────────────────────────────────────────────────────
print_source_info()
#>  Sources available:
#> ── wb_wdi ──────────────────────────────────────────────────────────────────────
#> → Origin: The World Bank's World Development Indicator Database
#> → Date: Downloaded on the 30th of April 2024
#> → Html: https://databank.worldbank.org/source/world-development-indicators
#> → Note: Uses the GDP deflator.
#> ────────────────────────────────────────────────────────────────────────────────
#> ── wb_wdi_linked ───────────────────────────────────────────────────────────────
#> → Origin: The World Bank's World Development Indicator Database
#> → Date: Downloaded on the 30th of April 2024
#> → Html: https://databank.worldbank.org/source/world-development-indicators
#> → Note: Uses the linked GDP deflator.
#> ────────────────────────────────────────────────────────────────────────────────
#> ── wb_wdi_cpi ──────────────────────────────────────────────────────────────────
#> → Origin: The World Bank's World Development Indicator Database
#> → Date: Downloaded on the 30th of April 2024
#> → Html: https://databank.worldbank.org/source/world-development-indicators
#> → Note: Uses the CPI as deflator.
#> ────────────────────────────────────────────────────────────────────────────────

Use the ::: operator to take a closer look at sources shipped with GDPuc.

GDPuc:::wb_wdi