R/rd-coffee_imports.R

In stevedata: Steve's Toy Data for Teaching About a Variety of Methodological, Social, and Political Topics

#' @importFrom tibble tibble
NULL

#' Coffee Imports for Select Importing Countries
#'
#' A simple panel on coffee imports for importing countries.
#'
#' @format A data frame with 4530 observations on the following 4 variables.
#' \describe{
#' \item{\code{country}}{a character vector for the country}
#' \item{\code{member}}{a numeric vector indicating whether the importer is or is not a member of the International Coffee Organization}
#' \item{\code{year}}{a numeric vector for the year}
#' \item{\code{value}}{a numeric vector for the coffee imports for all select importing countries (in thousand 60-kg bags)}
#' }
#'
#' @details Data come from the International Coffee Organization, of which I
#' feel I should be a member.
#'
#' Observations for the People's Republic of China are removed because those can
#' be obtained by adding together the values for "Macao", "Hong Kong", and
#' "China (Mainland)".
#'
#' The user may want to be mindful about when 0s in the value data are actually
#' communicating that the entry did not exist at the time, or no longer exists.
#' For example, there is no independent Armenia in 1990 (and whatever imports
#' Armenia had are lumped into the USSR value for 1990). Likewise, the 0s for
#' the USSR in 1992 are communicating the USSR no longer exists that year and you
#' should instead look into one of the constituent republics for the information
#' you want. You may want to benchmark this information to some kind of state
#' system membership data.
#'
"coffee_imports"