geo

module wittgenstein_catalog_builder.geo

Brazilian geographic classification helpers.

Maps free-text region labels (as they appear in government Excel files) to a canonical 5-tuple: (regiao, nivel, macro_regiao, uf, rm).

Useful for any Brazilian data source that mixes macro-region names, state names, metropolitan region names and state abbreviations in the same column.

Functions

• classificar_regiao — Classify a free-text region label into (regiao, nivel, macro_regiao, uf, rm).

wittgenstein_catalog_builder.geo.classificar_regiao

classificar_regiao(r: str) → pd.Series

Classify a free-text region label into (regiao, nivel, macro_regiao, uf, rm).

Resolution order: macro_regiao → UF → RM with '(XX)' suffix → RM nominal → 'outro'. Returns a pd.Series so DataFrame.apply expands it into 5 columns automatically.