R/data.R

In igoR: Intergovernmental Organizations Database

#' Intergovernmental Organizations (IGO) by year
#'
#' @name igo_year_format3
#'
#' @docType data
#'
#' @description
#' Data on IGOs from 1815-2014, at the IGO-year level. Contains one record per
#' IGO-year (with years listed at 5 year intervals through 1965, and annually
#' thereafter).
#'
#' @source
#' [Intergovernmental Organizations
#' (v3)](https://correlatesofwar.org/data-sets/IGOs/),
#' The Correlates of War Project (IGO Data Stata Files).
#'
#' @details
#' Possible value of the status of that state in the IGO are:
#'
#' ```{r, echo=FALSE}
#' t <- tibble::tribble(
#'   ~Category, ~"Numerical value",
#'   "No Membership", 0 ,
#'   "Full Membership ", 1 ,
#'   "Associate Membership ", 2 ,
#'   "Observer ", 3,
#'   "Missing data ", -9 ,
#'   "State Not System Member ", -1 )
#'
#' knitr::kable(t)
#' ```
#'
#' @format data frame with
#' `r prettyNum(nrow(igoR::igo_year_format3), big.mark=",")` rows.
#' Relevant fields:
#'   * **ioname**: Short abbreviation of the IGO name.
#'   * **orgname**: Full IGO name.
#'   * **year**: Calendar Year.
#'   * **afghanistan...zimbabwe**: status of that state in the IGO.
#'     See Details.
#'   * **sdate**: start date (year) that the IGO started.
#'   * **deaddate**: dead date (year) that the IGO dead.
#'   * **longorgname**: a longer version of the IGOs name (including previous
#'     names)
#'   * **ionum**: IGO id number in v2.1 and v3.0 of the data.
#'   * **version**: COW version number.
#'
#' See
#' [**Codebook Version 3 IGO Data**](https://correlatesofwar.org/data-sets/IGOs/)
#' for full reference.
#'
#' @family datasets
#'
#' @note Raw data used internally by **igoR**.
#'
#' @references
#' Pevehouse, Jon CW, Timothy Nordstrom, Roseanne W McManus, and Anne Spencer
#' Jamison. "Tracking Organizations in the World: The Correlates of War
#' IGO Version 3.0 Datasets." *Journal of Peace Research* 57, no. 3
#' (May 2020): 492-503.
#' @examples
#' data("igo_year_format3")
#' dplyr::tibble(igo_year_format3)
NULL

#' @title Country membership to IGO by year
#'
#' @name state_year_format3
#'
#' @docType data
#'
#' @description Data on IGOs from 1815-2014, at the country-year level.
#' Contains one record per country-year (with years listed at 5 year
#' intervals through 1965, and annually thereafter).
#'
#' @source
#' [Intergovernmental Organizations
#' (v3)](https://correlatesofwar.org/data-sets/IGOs/),
#' The Correlates of War Project (IGO Data Stata Files)
#'
#' @details
#' Possible value of the status of that state in the IGO are:
#'
#' ```{r, echo=FALSE}
#' t <- tibble::tribble(
#'   ~Category, ~"Numerical value",
#'   "No Membership", 0 ,
#'   "Full Membership ", 1 ,
#'   "Associate Membership ", 2 ,
#'   "Observer ", 3,
#'   "Missing data ", -9 ,
#'   "IGO Not In Existence", -1 )
#'
#'  knitr::kable(t)
#' ```
#' @format data frame with
#' `r prettyNum(nrow(igoR::state_year_format3), big.mark=",")` rows.
#' Relevant fields:
#'   * **ccode**: COW country number, see [states2016].
#'   * **year**: Calendar Year.
#'   * **state**: Abbreviated state name, identical to variable names in
#'     [igo_year_format3].
#'   * **aaaid...wassen**: IGO variables containing information on state
#'     membership status. See Details.
#'
#' See
#' [**Codebook Version 3 IGO Data**](https://correlatesofwar.org/data-sets/IGOs/)
#'
#' @seealso [countrycode::countrycode()] to convert between different country
#' code schemes.
#'
#' @family datasets
#'
#' @note Raw data used internally by **igoR**.
#' @references
#' Pevehouse, Jon CW, Timothy Nordstrom, Roseanne W McManus, and Anne Spencer
#' Jamison. "Tracking Organizations in the World: The Correlates of War
#' IGO Version 3.0 Datasets." *Journal of Peace Research* 57, no. 3
#' (May 2020): 492-503.
#'
#' @examples
#' data("state_year_format3")
#' dplyr::tibble(state_year_format3)
#'
NULL


#' @title State System Membership (v2016)
#' @name states2016
#' @docType data
#' @description The list of states with COW abbreviations and ID numbers, plus
#' the field `state` from [state_year_format3].
#' @source
#' [State System Membership
#' (v2016)](https://correlatesofwar.org/data-sets/state-system-membership/),
#' The Correlates of War Project.
#' @format data frame with
#' `r prettyNum(nrow(igoR::states2016), big.mark=",")` rows.
#' Relevant fields:
#' * **ccode**: COW country number.
#' * **stateabb**: COW state abbreviation (3 characters).
#' * **statenme**: COW state name.
#' * **styear...endday**: Fields to identify the begining
#' and the end of each tenure.
#' * **version**: Data file version number.
#' * **state**: Abbreviated state name as appear in
#' [state_year_format3].
#'
#' @family datasets
#' @details This data set contains the list of states in the international
#' system as updated and distributed by the Correlates of War Project.
#'
#' This data set contains the list of states in the international system as
#' updated and distributed by the Correlates of War Project.
#' These data sets identify states, their standard Correlates of War
#' "country code" or state number (used throughout the Correlates of War
#' project data sets), state abbreviations, and dates of membership as
#' states and major powers in the international system.
#'
#' The Correlates of War project includes a state in the international system
#' from 1816-2016 for the following criteria:
#' * **Prior to 1920** the entity must have had a population greater than
#'   500,000 and have had diplomatic missions at or above the rank of charge
#' d'affaires with Britain and France.
#'
#' * **After 1920** the entity must be a member of the League of Nations
#' or the United Nations, or have a population greater than 500,000 and
#' receive diplomatic missions from two major powers.
#'
#'
#' @note `state` variable added to original data to help comparison across
#' datasets on this package.
#'
#' @references
#' Correlates of War Project. 2017 "State System Membership List, v2016."
#' Online, <https://correlatesofwar.org/>.
#'
#' @examples
#' # example code
#' data("states2016")
#' dplyr::tibble(states2016)
NULL