census_geo_api_names

census_geo_api_url

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_geo_api_names function

<dl><dt>year</dt>
<dd>A character object specifying the year of U.S. Census data to be downloaded.
Use <code>"2010"</code>, or <code>"2020"</code>. Default is <code>"2020"</code>.
Warning: 2020 U.S. Census data is downloaded only when <code><var>age</var></code> and
<code><var>sex</var></code> are both <code>FALSE</code>.</dd>
<dt>age</dt>
<dd>A <code>TRUE</code>/<code>FALSE</code> object indicating whether to condition on
age or not. If <code>FALSE</code> (default), function will return Pr(Geolocation | Race).
If <code>TRUE</code>, function will return Pr(Geolocation, Age | Race).
If <code><var>sex</var></code> is also <code>TRUE</code>, function will return Pr(Geolocation, Age, Sex | Race).</dd>
<dt>sex</dt>
<dd>A <code>TRUE</code>/<code>FALSE</code> object indicating whether to condition on
sex or not. If <code>FALSE</code> (default), function will return Pr(Geolocation | Race).
If <code>TRUE</code>, function will return Pr(Geolocation, Sex | Race).
If <code><var>age</var></code> is also <code>TRUE</code>, function will return Pr(Geolocation, Age, Sex | Race).</dd></dl>

Arguments

Census geo API helper functions — census_geo_api_names

<dl>

<dt>year</dt>
<dd>A character object specifying the year of U.S. Census data to be downloaded.
Use <code>"2010"</code>, or <code>"2020"</code>. Default is <code>"2020"</code>.
Warning: 2020 U.S. Census data is downloaded only when <code><var>age</var></code> and
<code><var>sex</var></code> are both <code>FALSE</code>.</dd>


<dt>age</dt>
<dd>A <code>TRUE</code>/<code>FALSE</code> object indicating whether to condition on
age or not. If <code>FALSE</code> (default), function will return Pr(Geolocation | Race).
If <code>TRUE</code>, function will return Pr(Geolocation, Age | Race).
If <code><var>sex</var></code> is also <code>TRUE</code>, function will return Pr(Geolocation, Age, Sex | Race).</dd>


<dt>sex</dt>
<dd>A <code>TRUE</code>/<code>FALSE</code> object indicating whether to condition on
sex or not. If <code>FALSE</code> (default), function will return Pr(Geolocation | Race).
If <code>TRUE</code>, function will return Pr(Geolocation, Sex | Race).
If <code><var>age</var></code> is also <code>TRUE</code>, function will return Pr(Geolocation, Age, Sex | Race).</dd>

</dl>

Census geo API helper functions

census_geo_api_names: Census geo API helper functions

Description

Usage

Value

Arguments