ppeldata: Datasets Useful for PPEL

#' Quality of Government dataset
#'
#' The full cross-section standard panel data.
#'
#' See the codebook here: https://qog.pol.gu.se/data/datadownloads/qogstandarddata.
#'
#' @docType data
#'
#' @usage data(qog)
#'
#' @keywords datasets
#'
#' @references Teorell, Jan et al. 2018. The Quality of Government Standard Dataset,
#'    Version Jan18. University of Gothenburg: The Quality of Government Institute.
#' (\href{https://qog.pol.gu.se/data/datadownloads/qogstandarddata}{Quality of Government Institute})
#'
#' @source \href{https://qog.pol.gu.se/data/datadownloads/qogstandarddata}{Quality of Government Institute}
#'
#' @examples
#' data(qog)
#'
"qog"


#' Varieties of Democracy full dataset
#'
#' The full cross-section panel data: Country-Year: V-Dem Full+Others
#' All 450+ V-Dem indicators and indices + 59 other indicators from other data sources.
#'
#' See the codebook here: https://github.com/vladtarko/ppeldata/tree/master/codebooks.
#'
#' @docType data
#'
#' @usage data(vdem)
#'
#' @keywords datasets
#'
#' @references
#' Coppedge, Michael, John Gerring, Carl Henrik Knutsen, Staffan I. Lindberg, Jan Teorell,
#' David Altman, Michael Bernhard, M. Steven Fish, Adam Glynn, Allen Hicken, Anna Lührmann,
#' Kyle L. Marquardt, Kelly McMann, Pamela Paxton, Daniel Pemstein, Brigitte Seim, Rachel Sigman,
#' Svend-Erik Skaaning, Jeffrey Staton, Steven Wilson, Agnes Cornell, Lisa Gastaldi, Haakon Gjerløw,
#' Nina Ilchenko, Joshua Krusell, Laura Maxwell, Valeriya Mechkova, Juraj Medzihorsky, Josefine Pernes,
#' Johannes von Römer, Natalia Stepanova, Aksel Sundström, Eitan Tzelgov, Yi-ting Wang, Tore Wig,
#' and Daniel Ziblatt. 2019. "V-Dem [Country-Year/Country-Date] Dataset v9",
#' _Varieties of Democracy (V-Dem) Project_. \href{https://doi.org/10.23696/vdemcy19}
#'
#' Pemstein, Daniel, Kyle L. Marquardt, Eitan Tzelgov, Yi-ting Wang, Juraj Medzihorsky, Joshua Krusell,
#' Farhad Miri, and Johannes von Römer. 2019. “The V-Dem Measurement Model: Latent Variable Analysis
#' for Cross-National and Cross-Temporal Expert-Coded Data”, V-Dem Working Paper No. 21. 4th edition.
#' University of Gothenburg: Varieties of Democracy Institute.
#'
#' @source \href{https://www.v-dem.net/en/data/data-version-9/}{Varieties of Democracy}
#'
#' @examples
#' data(vdem)
#'
"vdem"

#' United States State Policies
#'
#' The Ruger and Sorens Database of State and Local Public Policies and Policy Ideology Indices (2018)
#'
#' The `statepolicy_meta` contains the variable descriptions and original sources.
#' The `statepolicy` constains the data.
#'
#' @docType data
#'
#' @usage
#'    data(statepolicy)
#'    data(statepolicy_meta)
#'
#' @keywords datasets
#'
#' @references
#' Jason Sorens, Fait Muedini and William P. Ruger. 2008. "U.S. State and Local Public Policies in 2006: A New Database." _State Politics and Policy Quarterly_
#' vol 8, no 3, pp 309-326.
#'
#' @source \href{http://www.statepolicyindex.com/data/}{State Policy Database}
#'
#' @examples
#' data(statepolicy)
#' data(statepolicy_meta)
#'
"statepolicy"

#' Fraser Economic Freedom of the World
#'
#' The components of the Fraser index of Economic Freedom.
#'
#' The following variables are the five aggregated subcomponents:
#' Size_of_Government, Property_Rights, Sound_Money, Trade, Regulation.
#'
#' The variables range from 0 to 10, with 10 describing highest economic freedom. E.g.
#' if Size_of_Government is closer to 10 it means the government involvement in the economy
#' is smaller; if Regulation is closer to 10 it means there are fewer regulations.
#'
#' @docType data
#'
#' @usage
#'    data(fraser)
#'
#' @keywords datasets
#'
#' @references
#' Gwartney, James D., Robert Lawson, and Joshua Hall. 2017. _Economic Freedom of the World 2017 Annual Report_.
#' Vancouver: The Fraser Institute.
#  \href{https://www.fraserinstitute.org/economic-freedom/dataset}
#'
#' @source \href{https://www.fraserinstitute.org/economic-freedom}{Fraser}
#'
#' @examples
#' data(fraser)
#'
"fraser"

#' Total Economy Database
#'
#' Cross-country panel data (1950-2019) on:
#'
#' "Total GDP, in millions of 2018 US$"
#' "Persons employed (thousands)"
#' "Average annual hours worked per worker"
#' "Total annual hours worked (millions)"
#' "Midyear population (thousands)"
#' "Labor productivity per person employed in 2018 US$"
#' "Labor productivity per hour worked in 2018 US$"
#' "GDP per capita in 2018 US$"
#' "Growth of GDP, percent change"
#' "Growth of employment, percent change"
#' "Growth of total hours worked, percent change"
#' "Growth of population, percent change"
#' "Growth of Labor Productivity per person employed, percent change"
#' "Growth of Labor Productivity per hour worked, percent change"
#' "Growth of GDP per capita, percent change"
#'
#' See the codebook here: https://github.com/vladtarko/ppeldata/tree/master/codebooks.
#'
#' @docType data
#'
#' @usage
#'    data(ted)
#'
#' @keywords datasets
#'
#' @source \href{https://www.conference-board.org/data/economydatabase/}{Total Economy}
#'
#' @examples
#' data(ted)
#'
"ted"

#' Manifesto Project Main Dataset of Party Preferences
#'
#' Cross-country panel data (1920-2018).
#'
#' See the codebook here: https://github.com/vladtarko/ppeldata/tree/master/codebooks.
#'
#' @docType data
#'
#' @usage
#'    data(manifesto)
#'
#' @keywords datasets
#'
#' @references
#'  Volkens, Andrea / Krause, Werner / Lehmann, Pola / Matthieß, Theres / Merz,
#'  Nicolas / Regel, Sven / Weßels, Bernhard(2019):
#'  The Manifesto Data Collection. Manifesto Project (MRG / CMP / MARPOR). Version 2019a.
#'  Berlin: Wissenschaftszentrum Berlin für Sozialforschung (WZB).
#'  \href{https://doi.org/10.25522/manifesto.mpds.2019a}
#'
#'  Budge, Ian / Klingemann, Hans-Dieter / Volkens, Andrea / Bara, Judith with Tanenbaum,
#'  Eric / Fording, Richard C. / Hearl, Derek J. / Kim, Hee Min / McDonald, Michael / Mendez,
#'  Silvia (2001): Mapping Policy Preferences. Estimates for Parties, Electors, and Governments
#'  1945-1998. Oxford: Oxford University Press.
#'
#'  Klingemann, Hans-Dieter / Volkens, Andrea / Bara, Judith / Budge, Ian / McDonald, Michael (2006):
#'  Mapping Policy Preferences II. Estimates for Parties, Electors, and Governments in Eastern Europe,
#'  the European Union and the OECD, 1990-2003. Oxford: Oxford University Press.
#'
#' @source \href{https://manifesto-project.wzb.eu/datasets}{Manifesto Project}
#'
#' @examples
#' data(manifesto)
#'
"manifesto"


#' Correlates of State Policy, version 2.1
#'
#' Website description: The Correlates of State Policy Project includes more than nine-hundred variables,
#' with observations across the U.S. 50 states and time (1900 – 2016). These variables
#' represent policy outputs or political, social, or economic factors that may influence
#' policy differences across the states. The codebook includes the variable name, a short
#' description of the variable, the variable time frame, a longer description of the variable,
#' and the variable source(s) and notes.
#'
#' See the codebook here: https://github.com/vladtarko/ppeldata/tree/master/codebooks.
#'
#' @docType data
#'
#' @usage
#'    data(csp)
#'
#' @keywords datasets
#'
#' @references
#'     Boehmke, Frederick J., and Paul Skinner. 2012. "State Policy Innovativeness Revisited."
#'     _State Politics and Policy Quarterly_ 12(3):303-29.
#'
#'     Caughey, Devin, and Christopher Warshaw. 2015. "The Dynamics of State Policy Liberalism, 1936–2014."
#'     _American Journal of Political Science_ 60 (4): 899–913.
#'
#'     Jordan, Marty P. and Matt Grossmann. 2017. The Correlates of State Policy Project v.2.1.
#'     East Lansing, MI: Institute for Public Policy and Social Research (IPPSR).
#'
#' @source \href{http://ippsr.msu.edu/public-policy/correlates-state-policy}{Correlates of State Policy}
#'
#' @examples
#' data(csp)
#'
"csp"