R/rd-gas_demand.R

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

#' @importFrom tibble tibble
NULL

#' Gasoline Demand in the OECD, 1960-1978
#'
#' A data set on gasoline demand in the OECD countries from 1960 to 1978
#'
#' @format A data frame with 342 observations on the following 6 variables.
#' \describe{
#' \item{\code{country}}{a character vector for an English country name}
#' \item{\code{year}}{a numeric vector for the year of observation}
#' \item{\code{gas}}{gasoline consumption per car, log-transformed}
#' \item{\code{income}}{real per capita income, log-transformed}
#' \item{\code{price}}{real gasoline price, log-transformed}
#' \item{\code{cars}}{the stock of cars per capita, log-transformed}
#' }
#'
#' @details The data are a simple port from the \pkg{AER} package. Users should
#' read Baltagi and Griffin (1983) for more information. The data are purely for
#' illustration about panel models.
#'
#' Generally, per capita income should not be negative when log-transformed,
#' especially for this set of countries. While it is clear that such negative
#' values arise from the logarithmic transformation of values less than 1, but
#' more than 0, it is not clear why per capita income would be on that particular
#' scale.
#'
#' The same curiosities emerge for the stock of cars per capita and real
#' gasoline price, though proportional values between 0 and 1 are seemingly
#' plausible (absent my willingness to look further into these details).
#'
#' No matter, the data are sufficient for replication of Baltagi and Griffin
#' (1983) without any further effort from the user. That's always nice.
#'
#' @references
#'
#' Baltagi, Badi H. and James M. Griffin. 1983. "Gasoline Demand in the OECD: An
#' Application of Pooling and Testing Procedures" *European Economic Review*
#' 22: 117-137.
#'
"gas_demand"