Add R-parity Python functions and datasets

[JoaoCarabetta]

Summary

• Add cep_to_state, remove_islands, read_capitals, read_favela, read_polling_places, read_quilombola_land
• Bundle br_offcoast.parquet for island clipping and export new symbols from __init__.py

Test plan

• Unit tests for each new function (pytest -m "not network")

Depends on #418

Made with Cursor

[camilagb]

One function that is missing is the grid_state_correspondence_table, that returns the data in https://github.com/ipeaGIT/geobr/blob/v1.9.1/python-package/geobr/data/grid_state_correspondence_table.csv. Maybe include a new file?

from geobr import __path__ as geobr_directory
import pandas as pd

grid_file_path = geobr_directory[0] + "/data/grid_state_correspondence_table.csv"
dtypes = {"name_state": str, "abbrev_state": str, "code_grid": str}

def get_grid_state_table() -> pd.DataFrame:
    grid_state_correspondence_table = pd.read_csv(
        grid_file_path, encoding="latin-1", dtype=dtypes
    )
    return grid_state_correspondence_table 

[camilagb]

Suggested change

	output: str = "sf",
	show_progress: bool = True,
	cache: bool = True,
	verbose: bool = False,
	year: int = 2010,
	year: int,
	output: str = "gpd",
	show_progress: bool = True,
	cache: bool = True,
	verbose: bool = False

[camilagb]

Suggested change

	``"sf"`` for GeoDataFrame (default), ``"duckdb"``, or ``"arrow"``.
	``"gpd"`` for GeoDataFrame (default), ``"duckdb"``, or ``"arrow"``.

[camilagb]

For this update, it's necessary to also update the read_municipal_seat function and use the filter_by_code proposed in #418

Suggested change

	if output == "sf":
	gdf = read_municipal_seat(year=year, verbose=verbose)
	gdf = gdf[gdf["code_muni"].isin(codes)]
	return gdf.sort_values("code_muni").reset_index(drop=True)
	from geobr.utils import read_geobr_v2
	results = []
	for code in codes:
	part = read_geobr_v2(
	geography="municipalseat",
	year=year,
	code=code,
	simplified=True,
	output=output,
	show_progress=show_progress,
	cache=cache,
	verbose=False,
	)
	results.append(part)
	if output == "sf":
	import geopandas as gpd
	return gpd.GeoDataFrame(
	pd.concat(results, ignore_index=True)
	).sort_values("code_muni").reset_index(drop=True)
	return results
	return read_municipal_seat(
	year=year,
	code_muni=codes,
	output=output,
	show_progress=show_progress,
	cache=cache,
	verbose=verbose
	)

[camilagb]

Suggested change

	output: str = "sf",
	output: str = "gpd",

[camilagb]

Suggested change

	output: str = "sf",
	output: str = "gpd",

[camilagb]

Suggested change

	output: str = "sf",
	output: str = "gpd",