Skip to content

create_crosswalk

sdc_census10to20.create_crosswalk 

create_crosswalk(geoids: list[str], *, state_fips: str = '51') -> pd.DataFrame

Create a combined crosswalk for all GEOID resolutions present in geoids.

Handles 11-character tract IDs and 12-character block-group IDs; other lengths are skipped with a printed notice.

Source code in packages/sdc-census10to20/src/sdc_census10to20/crosswalk.py 
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
def create_crosswalk(geoids: list[str], *, state_fips: str = "51") -> pd.DataFrame:
    """Create a combined crosswalk for all GEOID resolutions present in ``geoids``.

    Handles 11-character tract IDs and 12-character block-group IDs; other
    lengths are skipped with a printed notice.
    """
    resolutions = sorted({len(g) for g in geoids})
    crosswalks: list[pd.DataFrame] = []

    for res in resolutions:
        if res == 11:
            crosswalks.append(
                get_2010_2020_bound_changes(res="tract", geoids=geoids, state_fips=state_fips)
            )
        elif res == 12:
            crosswalks.append(
                get_2010_2020_bound_changes(
                    res="block group", geoids=geoids, state_fips=state_fips
                )
            )
        else:
            print(f"crosswalk not available for resolution: {res}")

    if not crosswalks:
        return pd.DataFrame(
            columns=["geoid20", "geoid10", "area20", "area10", "area_part", "type_change"]
        )

    return pd.concat(crosswalks, ignore_index=True)