kintsugi

Collection of commonly used datasets and functions. Datasets are stored in kintsugi-data.

Installation

# with uv via HTTPS
uv add git+https://github.com/winter-again/kintsugi
# with uv via SSH
uv add git+ssh://git@github.com/winter-again/kintsugi
# with pip via HTTPS
pip install git+https://github.com/winter-again/kintsugi
# with pip via SSH
pip install git+ssh://git@github.com/winter-again/kintsugi

Datasets

Currently supported datasets. Where appropriate, you can pass as_pandas=True to get a pandas dataframe back:

County neighbors

fromkintsugi.neighborsimportcounty_neighborsneighbors=county_neighbors()

State and county shapefiles

fromkintsugi.geoimportcounty_geo, state_geocounties=county_geo(2024)
states=state_geo(2024)

State and county population data, stratified by several different variables:

fromkintsugi.populationimportcounty_pop, state_age_poplf_county_pop=county_pop(2024)
lf_state_age_pop=state_age_pop(2024)

Low-population county groups

fromkintsugi.county_groupsimportcounty_groupslf_county_grps=county_groups()

State FIPS codes, names, and abbreviations

fromkintsugi.metadataimportstateslf_states=states()

Year-specific county FIPS codes

fromkintsugi.metadataimportcountieslf_counties=counties(2020)

Crosswalk 2010 PUMAs to 2020 counties

fromkintsugi.crosswalkimportpuma_2010_county_2020crosswalk=puma_2010_county_2020()