build county adjacency from us census bureau

%23%20%2F%2F%2F%20script%0A%23%20requires-python%20%3D%20%22%3E%3D3.14%22%0A%23%20dependencies%20%3D%20%5B%0A%23%20%20%20%20%20%22marimo%3E%3D0.20.4%22%2C%0A%23%20%20%20%20%20%22pandas%3D%3D3.0.1%22%2C%0A%23%20%20%20%20%20%22requests%3D%3D2.32.5%22%2C%0A%23%20%5D%0A%23%20%2F%2F%2F%0A%0Aimport%20marimo%0A%0A__generated_with%20%3D%20%220.20.4%22%0Aapp%20%3D%20marimo.App(width%3D%22medium%22)%0A%0A%0A%40app.cell(hide_code%3DTrue)%0Adef%20_(mo)%3A%0A%20%20%20%20mo.md(r%22%22%22%0A%20%20%20%20%23%202025%20Census%20County%20Adjacency%20Builder%0A%0A%20%20%20%20*Dataset%3A%20U.S.%20Census%20County%20Adjacency%20File%20(2025%20release)*%0A%0A%20%20%20%20Download%20and%20prepare%20the%20**U.S.%20Census%202025%20County%20Adjacency%20File**%2C%20which%20lists%20each%20county%20(or%20county%20equivalent)%20and%20its%20neighboring%20counties.%0A%0A%20%20%20%20**Source**%0A%20%20%20%20U.S.%20Census%20Bureau%20%E2%80%93%20County%20Adjacency%20File%0A%20%20%20%20https%3A%2F%2Fwww.census.gov%2Fgeographies%2Freference-files%2Ftime-series%2Fgeo%2Fcounty-adjacency.html%0A%0A%20%20%20%20**Dataset**%0A%0A%20%20%20%20-%20Pipe-delimited%20national%20file%20(%60%7C%60)%0A%20%20%20%20-%20Includes%20counties%20from%20all%20**50%20states%2C%20DC%2C%20Puerto%20Rico%2C%20and%20Island%20Areas**%0A%20%20%20%20-%20Each%20row%20represents%20one%20**county%20%E2%86%92%20neighboring%20county%20relationship**%0A%20%20%20%20-%20Relationships%20appear%20**in%20both%20directions**%20(A%20%E2%86%92%20B%20and%20B%20%E2%86%92%20A)%0A%0A%20%20%20%20**Columns**%0A%0A%20%20%20%20-%20%60County%20Name%60%0A%20%20%20%20-%20%60County%20GEOID%60%20(state%20FIPS%20%2B%20county%20FIPS)%0A%20%20%20%20-%20%60Neighbor%20Name%60%0A%20%20%20%20-%20%60Neighbor%20GEOID%60%0A%20%20%20%20-%20%60Length%60%20(shared%20boundary%20length%20in%20meters%2C%20introduced%20in%202025)%0A%0A%20%20%20%20**Common%20Uses**%0A%0A%20%20%20%20-%20Building%20**county%20adjacency%20graphs**%0A%20%20%20%20-%20Regional%20clustering%20or%20spatial%20modeling%0A%20%20%20%20-%20Identifying%20**neighboring%20counties%20for%20spillover%20analysis**%0A%20%20%20%20-%20Geographic%20joins%20across%20**county-level%20datasets**%0A%0A%20%20%20%20**Outputs**%0A%0A%20%20%20%20-%20%60data%2Fprocessed%2Fcounty_adjacency2025.txt%60%0A%20%20%20%20-%20%60data%2Fprocessed%2Fcounty_adjacency2025.csv%60%0A%20%20%20%20%22%22%22)%0A%20%20%20%20return%0A%0A%0A%40app.cell%0Adef%20_()%3A%0A%20%20%20%20import%20marimo%20as%20mo%0A%20%20%20%20import%20pandas%20as%20pd%0A%20%20%20%20import%20requests%0A%20%20%20%20from%20pathlib%20import%20Path%0A%0A%20%20%20%20return%20Path%2C%20mo%2C%20pd%2C%20requests%0A%0A%0A%40app.cell%0Adef%20_(Path)%3A%0A%20%20%20%20%23%20----------------------------------------------------------%0A%20%20%20%20%23%201.%20DIRECTORY%20CONFIGURATION%0A%20%20%20%20%23%20----------------------------------------------------------%0A%20%20%20%20BASE_DIR%20%3D%20Path(%22data%22)%0A%20%20%20%20RAW_DIR%20%3D%20BASE_DIR%20%2F%20%22raw%22%20%20%20%20%20%20%20%20%20%20%20%20%23%20Original%20Census%2Fraw%20files%0A%20%20%20%20PROCESSED_DIR%20%3D%20BASE_DIR%20%2F%20%22processed%22%20%23%20Processed%20output%20files%0A%0A%20%20%20%20RAW_DIR.mkdir(parents%3DTrue%2C%20exist_ok%3DTrue)%0A%20%20%20%20PROCESSED_DIR.mkdir(parents%3DTrue%2C%20exist_ok%3DTrue)%0A%20%20%20%20return%20PROCESSED_DIR%2C%20RAW_DIR%0A%0A%0A%40app.cell%0Adef%20_(PROCESSED_DIR%2C%20RAW_DIR%2C%20pd%2C%20requests)%3A%0A%20%20%20%20%23%20----------------------------------------------------------%0A%20%20%20%20%23%202.%20SOURCE%20FILES%20(US%20Census%202025%20County%20Adjacency%20File)%0A%20%20%20%20%23%20----------------------------------------------------------%0A%20%20%20%20COUNTY_ADJACENCY_URL%20%3D%20%22https%3A%2F%2Fwww2.census.gov%2Fgeo%2Fdocs%2Freference%2Fcounty_adjacency%2Fcounty_adjacency2025.txt%22%0A%0A%20%20%20%20COUNTY_ADJACENCY_FILE%20%3D%20RAW_DIR%20%2F%20%22county_adjacency2025.txt%22%0A%0A%20%20%20%20%23%20----------------------------------------------------------%0A%20%20%20%20%23%203.%20DOWNLOAD%20FUNCTION%0A%20%20%20%20%23%20----------------------------------------------------------%0A%20%20%20%20def%20download_file(url%2C%20path)%3A%0A%20%20%20%20%20%20%20%20%22%22%22Download%20file%20if%20not%20already%20present.%22%22%22%0A%20%20%20%20%20%20%20%20if%20not%20path.exists()%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20print(f%22Downloading%20%7Bpath.name%7D%22)%0A%20%20%20%20%20%20%20%20%20%20%20%20resp%20%3D%20requests.get(url)%0A%20%20%20%20%20%20%20%20%20%20%20%20resp.raise_for_status()%0A%20%20%20%20%20%20%20%20%20%20%20%20path.write_bytes(resp.content)%0A%20%20%20%20%20%20%20%20else%3A%0A%20%20%20%20%20%20%20%20%20%20%20%20print(f%22%7Bpath.name%7D%20already%20exists%20(skipping%20download)%22)%0A%0A%20%20%20%20download_file(COUNTY_ADJACENCY_URL%2C%20COUNTY_ADJACENCY_FILE)%0A%0A%20%20%20%20%23%20---------------------------------------------------------------%0A%20%20%20%20%23%203.%20Load%20Data%0A%20%20%20%20%23%20---------------------------------------------------------------%0A%20%20%20%20%23%20County%20adjacency%20data%20is%20pipe-delimited%0A%20%20%20%20df_county_adjacency%20%3D%20pd.read_csv(COUNTY_ADJACENCY_FILE%2C%20sep%3D%22%7C%22%2C%20dtype%3Dstr)%0A%0A%20%20%20%20%23%20---------------------------------------------------------------%0A%20%20%20%20%23%204.%20Export%0A%20%20%20%20%23%20---------------------------------------------------------------%0A%20%20%20%20print(f%22%5CnSummary%3A%22)%0A%20%20%20%20print(f%22Rows%3A%20%7Blen(df_county_adjacency)%3A%2C%7D%22)%0A%20%20%20%20%23%20TXT%20version%20(pipe-delimited%2C%20preserves%20raw%20structure)%0A%20%20%20%20df_county_adjacency_txt%20%3D%20PROCESSED_DIR%20%2F%20%22county_adjacency2025.txt%22%0A%20%20%20%20df_county_adjacency.to_csv(%0A%20%20%20%20%20%20%20%20df_county_adjacency_txt%2C%0A%20%20%20%20%20%20%20%20sep%3D%22%7C%22%2C%0A%20%20%20%20%20%20%20%20index%3DFalse%0A%20%20%20%20)%0A%20%20%20%20print(%22%5CnCounty%20adjacency%20in%20TXT%20format%20export%20complete%3A%22%2C%20df_county_adjacency_txt)%0A%0A%20%20%20%20%23%20CSV%20version%20(comma-delimited%2C%20quotes%20FIPS%20columns%20to%20preserve%20leading%20zeros)%0A%20%20%20%20df_county_adjacency_csv%20%3D%20PROCESSED_DIR%20%2F%20%22county_adjacency2025.csv%22%0A%20%20%20%20df_county_adjacency.to_csv(%0A%20%20%20%20%20%20%20%20df_county_adjacency_csv%2C%0A%20%20%20%20%20%20%20%20index%3DFalse%0A%20%20%20%20)%0A%20%20%20%20print(%22%5CnCounty%20adjacency%20in%20CSV%20format%20export%20complete%3A%22%2C%20df_county_adjacency_csv)%0A%0A%20%20%20%20%23%20---------------------------------------------------------------%0A%20%20%20%20%23%205.%20Display%20DataFrame%0A%20%20%20%20%23%20---------------------------------------------------------------%0A%20%20%20%20df_county_adjacency%0A%20%20%20%20return%0A%0A%0Aif%20__name__%20%3D%3D%20%22__main__%22%3A%0A%20%20%20%20app.run()%0A