=======================================================================================================================
DOCUMENTATION FOR US_VEP_TURNOUT_RATES
Version: 1.0
Date: 7/28/2023
Authors and Licenses:
These data are derived from the Census Bureau's Current Population Survey Voting and Registration Supplement (CPS) 
available at: https://www.census.gov/data/datasets/time-series/demo/cps/cps-supp_cps-repwgt/cps-voting.html
Theses survey data are reweigted using a procedure proposed by Hur and Achen (2013), to reweight the CPS
state level turnout rates to equal the voting-eligible population turnout rates, available at:
https://academic.oup.com/poq/article/77/4/985/1843466 
These weight-adjusted turnout rates are released under an Creative Commons 4.0 Attribution License. See: https://creativecommons.org/licenses/by/4.0/
=======================================================================================================================

============
VARIABLES
============

============
YEAR
============
Year of election


============
CPS_ADJ_NHWHITE_RATE, 
CPS_ADJ_NHBLACK_RATE, 
CPS_ADJ_HISPANIC_RATE,
CPS_ADJ_OTHER_RATE
============
Race and Hispanic ethnicity turnout RATEs calculated from various 
Current Population Survey Voting and Registration Supplements (CPS) using PTDTRACE (race) and PEHSPNON (Hispanic ethnicity),
available at: https://www.census.gov/data/datasets/time-series/demo/cps/cps-supp_cps-repwgt/cps-voting.html

Theses survey data are ADJusted or reweigted using a procedure proposed by Hur and Achen (2013), to reweight the CPS
state level turnout rates to equal the voting-eligible population turnout rates, described at:
https://academic.oup.com/poq/article/77/4/985/1843466 

NHWHITE = Non-Hispanic White
NHBLACK = Non-Hispanic Black
HISPANIC = Hispanic
OTHER = All other non-Hispanic races (caluclated this way primarily due to small sample-sizes)

Sample Stata code to calculate these variables:

gen race_cat4 = 0
replace race_cat4 = 1 if(PTDTRACE==1&PEHSPNON==2)
replace race_cat4 = 2 if((PTDTRACE==2|PTDTRACE==6|PTDTRACE==10|PTDTRACE==11|PTDTRACE==12|PTDTRACE==15|PTDTRACE==16|PTDTRACE==19)&PEHSPNON==2)
replace race_cat4 = 3 if(PEHSPNON==1)
replace race_cat4 = 4 if(race_cat4 ==0)

NOTE: **CPS Variable names and item categories may change over time**


============
CPS_ADJ_NHWHITE_SHARE,
CPS_ADJ_NHBLACK_SHARE,
CPS_ADJ_HISPANIC_SHARE,
CPS_ADJ_OTHER_SHARE
============
Same as prior, except weight-adjusted SHARE of the electorate instead of turnout rate.


============
CPS_UNADJ_NHWHITE_RATE,
CPS_UNADJ_NHBLACK_RATE,	
CPS_UNADJ_HISPANIC_RATE,
CPS_UNADJ_OTHER_RATE
============
Same as prior turnout RATE, but using the UNADJusted Census Bureau weight (usually PWSSWGT, but may vary).

These statistics are provided primarily as a verification check against Census Bureauy reports
available at: https://www.census.gov/data/datasets/time-series/demo/cps/cps-supp_cps-repwgt/cps-voting.html


============
CPS_UNADJ_NHWHITE_SHARE,
CPS_UNADJ_NHBLACK_SHARE,
CPS_UNADJ_HISPANIC_SHARE,
CPS_UNADJ_OTHER_SHARE
============
Same as prior, except unadjusted weight SHARE of the electorate instead of turnout rate.


============
CPS_ADJ_AGE1829_RATE,
CPS_ADJ_AGE3044_RATE,
CPS_ADJ_AGE4559_RATE,
CPS_ADJ_AGE60_RATE
============
Age turnout RATEs calculated from various 
Current Population Survey Voting and Registration Supplements (CPS) using PRTAGE (age),
available at: https://www.census.gov/data/datasets/time-series/demo/cps/cps-supp_cps-repwgt/cps-voting.html

Theses survey data are ADJusted or reweigted using a procedure proposed by Hur and Achen (2013), to reweight the CPS
state level turnout rates to equal the voting-eligible population turnout rates, described at:
https://academic.oup.com/poq/article/77/4/985/1843466 

AGE1829 = Age 18 to 29
AGE3044 = Age 30 to 44
AGE4559 = Age 45 to 59
AGE60   = Age 60+

Sample Stata code to calculate these variables:

gen age4 = 0
replace age4 = 1 if(PRTAGE>29)
replace age4 = 2 if(PRTAGE>44)
replace age4 = 3 if(PRTAGE>59)

NOTE: **CPS Variable names and item categories may change over time**


============
CPS_ADJ_AGE1829_SHARE,
CPS_ADJ_AGE3044_SHARE,
CPS_ADJ_AGE4559_SHARE,
CPS_ADJ_AGE60_SHARE
============
Same as prior, except weight-adjusted SHARE of the electorate instead of turnout rate.


============
CPS_UNADJ_AGE1829_RATE,
CPS_UNADJ_AGE3044_RATE,
CPS_UNADJ_AGE4559_RATE,
CPS_ADJ_UNAGE60_RATE
============
Same as prior turnout RATE, but using the UNADJusted Census Bureau weight (usually PWSSWGT, but may vary).

These statistics are provided primarily as a verification check against Census Bureauy reports
available at: https://www.census.gov/data/datasets/time-series/demo/cps/cps-supp_cps-repwgt/cps-voting.html


============
CPS_ADJ_UNAGE1829_SHARE,
CPS_ADJ_UNAGE3044_SHARE,
CPS_ADJ_UNAGE4559_SHARE,
CPS_ADJ_UNAGE60_SHARE
============
Same as prior, except unadjusted weight SHARE of the electorate instead of turnout rate.


============
CPS_ADJ_NOHS_RATE,
CPS_ADJ_HS_RATE,
CPS_ADJ_COLLEGE_RATE,
CPS_ADJ_POST_RATE
============
Education turnout RATEs calculated from various 
Current Population Survey Voting and Registration Supplements (CPS) using PEEDUCA (education),
available at: https://www.census.gov/data/datasets/time-series/demo/cps/cps-supp_cps-repwgt/cps-voting.html

Theses survey data are ADJusted or reweigted using a procedure proposed by Hur and Achen (2013), to reweight the CPS
state level turnout rates to equal the voting-eligible population turnout rates, described at:
https://academic.oup.com/poq/article/77/4/985/1843466 

NOHS    = Not a high school graduate
HS      = High school graduate
COLLEGE = Any college including graduate
POST    = Post-undergraduate degree

Sample Stata code to calculate these variables:

gen educ = 0
replace educ = 1 if(PEEDUCA>38)
replace educ = 2 if(PEEDUCA>39)
replace educ = 3 if(PEEDUCA>43)

NOTE: **CPS Variable names and item categories may change over time**


============
CPS_ADJ_NOHS_SHARE,
CPS_ADJ_HS_SHARE,
CPS_ADJ_COLLEGE_SHARE,
CPS_ADJ_POST_SHARE
============
Same as prior, except weight-adjusted SHARE of the electorate instead of turnout rate.


============
CPS_UNADJ_NOHS_RATE,
CPS_UNADJ_HS_RATE,
CPS_UNADJ_COLLEGE_RATE,
CPS_UNADJ_POST_RATE
============
Same as prior turnout RATE, but using the UNADJusted Census Bureau weight (usually PWSSWGT, but may vary).

These statistics are provided primarily as a verification check against Census Bureauy reports
available at: https://www.census.gov/data/datasets/time-series/demo/cps/cps-supp_cps-repwgt/cps-voting.html


============
CPS_UNADJ_NOHS_SHARE,
CPS_UNADJ_HS_SHARE,
CPS_UNADJ_COLLEGE_SHARE,
CPS_UNADJ_POST_SHARE
============
Same as prior, except unadjusted weight SHARE of the electorate instead of turnout rate.