tunned-geobr 1.0.20

Fork personalizado do geobr com funcionalidades extras como download de dados da ANM

geobr: Download Official Spatial Data Sets of Brazil

geobr is a computational package to download official spatial data sets of Brazil. The package includes a wide range of geospatial data in geopackage format (like shapefiles but better), available at various geographic scales and for various years with harmonized attributes, projection and topology (see detailed list of available data sets below).

READ FULL DOCS

Contribute

To start the development environment run

uv sync

Test with

uv run pytest -n auto

You can use a helper to translate a function from R. If you want to add read_biomes, just run

uv run python helpers/translate_from_R.py read_biomes

It will scrape the original R function to get documentation and metadata. It adds:

• default year
• function name
• documentation one liner
• larger documentation
• very basic tests

! Be aware that if the function that you are adding is more complicated than the template. So, always double check !

System Dependencies

Some functions in geobr require additional system tools to be installed:

For RAR file extraction (read_baze_sites)

This function requires one of the following tools to be installed:

• unrar:

  • macOS: brew install unrar
  • Ubuntu/Debian: sudo apt-get install unrar
  • Windows: Install WinRAR

• unar:

  • macOS: brew install unar
  • Ubuntu/Debian: sudo apt-get install unar
  • Windows: Install The Unarchiver

• 7-Zip:

  • macOS: brew install p7zip
  • Ubuntu/Debian: sudo apt-get install p7zip-full
  • Windows: Install 7-Zip

For ZIP file extraction (IBGE files)

Some IBGE files use compression methods not supported by Python's built-in zipfile module. The following functions use the system's unzip command:

• read_census_tract_2022
• read_neighborhoods_2022

Make sure you have the unzip command available on your system:

• macOS: Typically pre-installed
• Ubuntu/Debian: sudo apt-get install unzip
• Windows: Install a tool like 7-Zip or add unzip via WSL

Translation Status

Function	Translated?	Easy?
read_amazon	Yes	Super
read_biomes	Yes	Super
read_census_tract	Yes	No
read_comparable_areas	Yes	Yes
read_conservation_units	Yes	Super
read_country	Yes	Super
read_disaster_risk_area	Yes	Super
read_health_facilities	Yes	Super
read_health_region	Yes	Super
read_immediate_region	Yes	Yes
read_indigenous_land	Yes	Super
read_intermediate_region	Yes	Yes
read_meso_region	Yes	No
read_metro_area	Yes	Super
read_micro_region	Yes	No
read_municipal_seat	Yes	Super
read_municipality	Yes	No
read_region	Yes	Super
read_semiarid	Yes	Super
read_state	Yes	Super
read_statistical_grid	Yes	No
read_urban_area	Yes	Super
read_urban_concentrations	Yes	Super
read_weighting_area	Yes	No
list_geobr	Yes	Yes
lookup_muni	Yes	No
read_neighborhood	Yes	Yes

Release new version

poetry version [patch|minor|major]
poetry publish --build