census_data_preflight

internal

Predicts individual race/ethnicity using surname, first name,
middle name, geolocation, and other attributes, such as gender and
age. The method utilizes Bayes' Rule (with optional measurement error
correction) to compute the posterior probability of each racial
category for any given individual. The package implements methods
described in Imai and Khanna (2016) "Improving Ecological Inference by
Predicting Individual Ethnicity from Voter Registration Records"
Political Analysis <DOI:10.1093/pan/mpw001> and Imai, Olivella, and
Rosenman (2022) "Addressing census data problems in race imputation
via fully Bayesian Improved Surname Geocoding and name supplements"
<DOI:10.1126/sciadv.adc9824>. The package also incorporates the data
described in Rosenman, Olivella, and Imai (2023) "Race and ethnicity
data for first, middle, and surnames"
<DOI:10.1038/s41597-023-02202-2>.

Brandon Bertelsen

Who are You? Bayesian Prediction of Racial Category Using
Surname, First Name, Middle Name, and Geolocation

Kabir Khanna

Santiago Olivella

Evan Rosenman

Alexander Rossell Hayes

Kosuke Imai

census_data_preflight function

<dl><dt>census.data</dt>
<dd>A list indexed by two-letter state abbreviations,
which contains pre-saved Census geographic data.
Can be generated using <code>get_census_data</code> function.</dd>
<dt>census.geo</dt>
<dd>An optional character vector specifying what level of
geography to use to merge in U.S. Census geographic data. Currently
<code>"county"</code>, <code>"tract"</code>, <code>"block_group"</code>, <code>"block"</code>, and <code>"place"</code>
are supported.
Note: sufficient information must be in user-defined <code><var>voter.file</var></code> object.
If <code><var>census.geo</var> = "county"</code>, then <code><var>voter.file</var></code>
must have column named <code>county</code>.
If <code><var>census.geo</var> = "tract"</code>, then <code><var>voter.file</var></code>
must have columns named <code>county</code> and <code>tract</code>.
And if <code><var>census.geo</var> = "block"</code>, then <code><var>voter.file</var></code>
must have columns named <code>county</code>, <code>tract</code>, and <code>block</code>.
If <code><var>census.geo</var> = "place"</code>, then <code><var>voter.file</var></code>
must have column named <code>place</code>.
If <code>census.geo = "zcta"</code>, then <code>voter.file</code> must have column named <code>zcta</code>.
Specifying <code><var>census.geo</var></code> will call <code>census_helper</code> function
to merge Census geographic data at specified level of geography.</dd>
<dt>year</dt>
<dd>An optional character vector specifying the year of U.S. Census geographic
data to be downloaded. Use <code>"2010"</code>, or <code>"2020"</code>. Default is <code>"2020"</code>.</dd></dl>

Arguments

Preflight census data — census_data_preflight

<dl>

<dt>census.data</dt>
<dd>A list indexed by two-letter state abbreviations,
which contains pre-saved Census geographic data.
Can be generated using <code>get_census_data</code> function.</dd>


<dt>census.geo</dt>
<dd>An optional character vector specifying what level of
geography to use to merge in U.S. Census geographic data. Currently
<code>"county"</code>, <code>"tract"</code>, <code>"block_group"</code>, <code>"block"</code>, and <code>"place"</code>
are supported.
Note: sufficient information must be in user-defined <code><var>voter.file</var></code> object.
If <code><var>census.geo</var> = "county"</code>, then <code><var>voter.file</var></code>
must have column named <code>county</code>.
If <code><var>census.geo</var> = "tract"</code>, then <code><var>voter.file</var></code>
must have columns named <code>county</code> and <code>tract</code>.
And if <code><var>census.geo</var> = "block"</code>, then <code><var>voter.file</var></code>
must have columns named <code>county</code>, <code>tract</code>, and <code>block</code>.
If <code><var>census.geo</var> = "place"</code>, then <code><var>voter.file</var></code>
must have column named <code>place</code>.
If <code>census.geo = "zcta"</code>, then <code>voter.file</code> must have column named <code>zcta</code>.
Specifying <code><var>census.geo</var></code> will call <code>census_helper</code> function
to merge Census geographic data at specified level of geography.</dd>


<dt>year</dt>
<dd>An optional character vector specifying the year of U.S. Census geographic
data to be downloaded. Use <code>"2010"</code>, or <code>"2020"</code>. Default is <code>"2020"</code>.</dd>

</dl>

Preflight census data

census_data_preflight: Preflight census data

Description

Usage

Arguments