bifsg 0.1.1

Bayesian Improved First-Firstname Surname Geocoding

bifsg

Bayesian Improved First-Firstname Surname Geocoding (BIFSG) Python package.

This package is a realization of the Bayesian Improved First Name Surname Geocoding (BIFSG) method published by Ioan Voicu, U.S Department of Treaury, Office of the Comptroller of the Currency. https://doi.org/10.1080/2330443X.2018.1427012

Census tract - https://www.ffiec.gov/censusapp.htm Source: FFIEC Census Flat Files 2020 The FFIEC Census flat files are a convenient method of accessing and analyzing the FFIEC census data that are used to create the HMDA and CRA Aggregate and Disclosure Reports. They contain over 1,000 fields of census data and are updated annually to reflect changes to MSA/MD boundaries announced by the Office of Management and Budget (OMB) and CRA Distressed/Underserved Census Tracts as announced by the Federal banking regulatory agencies.

Surnames - https://www.census.gov/topics/population/genealogy/data/2010_surnames.html Source: Frequently Occurring Surnames from the 2010 Census

First Names - https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/TYJKEZ Source: Data for: Demographic aspects of first names The list includes 4,250 first names and information on their respective count and proportions across six mutually exclusive racial and Hispanic origin groups. These six categories are consistent with the categories used in the Census Bureau's surname list. (2017-11-14) Author: Tzioumis, Konstantinos (Office of the Comptroller of the Currency)

Installation

pip install bifsg

CENSUS_API_KEY=<your-key>

from bifsg import BIFSG

b = BIFSG(
    census_api_key=CENSUS_API_KEY,
    one_line_address="1600 Pennsylvania Ave NW, Washington, DC 20500",
    surname="Smith",
    firstname="Alice"
)
print(b.BIFSG_predict())