R/codelist.R

In altaf-ali/countrycode_gw: Convert Country Names and Country Codes

#' Country Code Translation Data Frame (Cross-Sectional)
#'
#' A data frame used internally by the \code{countrycode()} function. `countrycode` can use any valid code as destination, but only some codes can be used as origin.
#'
#' Origin and Destination:
#'
#' \itemize{
#'   \item country.name: country name (English)
#'   \item country.name.de: country name (German)
#'   \item cowc: Correlates of War character
#'   \item cown: Correlates of War numeric
#'   \item ecb: European Central Bank
#'   \item eurostat:  Eurostat
#'   \item fao: Food and Agriculture Organization of the United Nations numerical code
#'   \item fips: FIPS 10-4 (Federal Information Processing Standard)
#'   \item gaul: Global Administrative Unit Layers
#'   \item genc2c: GENC 2-letter code
#'   \item genc3c: GENC 3-letter code
#'   \item genc3n: GENC numeric code
#'   \item imf: International Monetary Fund
#'   \item ioc: International Olympic Committee
#'   \item iso2c: ISO-2 character
#'   \item iso3c: ISO-3 character
#'   \item iso2n: ISO-2 numeric
#'   \item iso3n: ISO-3 numeric
#'   \item p4n: Polity IV numeric country code
#'   \item p4c: Polity IV character country code
#'   \item un: United Nations M49 numeric codes
#'   \item unpd: United Nations Procurement Division
#'   \item vdem: Varieties of Democracy (V-Dem version 8, April 2018)
#'   \item wb: World Bank (very similar but not identical to iso3c)
#'   \item wvs: World Values Survey numeric code
#' }
#' Destination only:
#' \itemize{
#'   \item ar5: IPCC's regional mapping used both in the Fifth Assessment Report
#'              (AR5) and for the Reference Concentration Pathways (RCP)
#'   \item continent: Continent as defined in the World Bank Development Indicators
#'   \item cow.name: Correlates of War country name
#'   \item ecb.name: European Central Bank country name
#'   \item eurocontrol_pru:  European Organisation for the Safety of Air Navigation
#'   \item eurocontrol_statfor:  European Organisation for the Safety of Air Navigation
#'   \item eurostat.name:  Eurostat country name
#'   \item eu28: Member states of the European Union (as of December 2015),
#'               without special territories
#'   \item fao.name: Food and Agriculture Organization of the United Nations country name
#'   \item fips.name: FIPS 10-4 Country name
#'   \item genc.name: Geopolitical Entities, Names and Codes standard country names
#'   \item icao: International Civil Aviation Organization
#'   \item icao_region: International Civil Aviation Organization (Region)
#'   \item ioc.name: International Olympic Committee country name
#'   \item iso.name.en: ISO English short name
#'   \item iso.name.fr: ISO French short name
#'   \item p4.name: Polity IV country name
#'   \item region: Regions as defined in the World Bank Development Indicators
#'   \item un.name.ar: United Nations Arabic country name
#'   \item un.name.en: United Nations English country name
#'   \item un.name.es: United Nations Spanish country name
#'   \item un.name.fr: United Nations French country name
#'   \item un.name.ru: United Nations Russian country name
#'   \item un.name.zh: United Nations Chinese country name
#'   \item unpd.name: United Nations Procurement Division country name
#'   \item wvs.name: World Values Survey numeric code country name
#'   \item cldr.*: 622 country name variants from the UNICODE CLDR project.
#'   Inspect the `countrycode::cldr_examples` data.frame for a full list of
#'   available country names and examples.
#' }
#' @note The Correlates of War (cow) and Polity 4 (p4) project produce codes in
#' country year format. Some countries go through political transitions that
#' justify changing codes over time. When building a purely cross-sectional
#' conversion dictionary, this forces us to make arbitrary choices with respect
#' to some entities (e.g., Western Germany, Vietnam, Serbia). `countrycode`
#' includes a reconciled dataset in panel format:
#' `countrycode::countrycode_panel`. Instead of converting code, we recommend
#' that users dealing with panel data "left-merge" their data into this panel
#' dictionary.
#'
#' @docType data
#' @keywords datasets
#' @name codelist
#' @format data frame with codes as columns
NULL