Minor changes

  • The read_municipality() has a new parameter keep_areas_operacionais, which allows users to control wether the data should keep the polygons of Lagoas dos Patos and Lagoa Mirim in the State of Rio Grande do Sul (considered as areas estaduais operacionais). The default FALSE drops these two polygons. Closes #176.
  • Functions now include a cache parameter that allows users to decide whehter to keep files in cache or to force downloading them again. At the moment, files are only cached during the R session, but this is a step towards a future version of {geobr} when files will be based on permanent caching.
  • Now using curl::multi_download() to download files in parallel
  • Removed dependency on the {httr} package
  • {geobr} now imports {fs} to use robust cross-platform file system operations
  • Simplified and streamlined internal functions

Major changes

  • Function read_health_facilities() now has a new parameter date, which will allow users to access data for different dates of reference. The plan is to have at least one update of this data set per year. Closes #334.
  • Functions read_urban_area() and read_metro_area() now have a new parameter code_state, which will allow users to filter selected states. Closes #338

Bug fix

  • Using data.table::rbindlist() to rind data was throwing errors when some observations were of class POLYGONS and others were MULTIPOLYGONS. This has now been replaced with dplyr::bind_rows() at a very small performance penalty. Closes #346.

New data

  • schools for 2023
  • health facilities for 202303
  • census tracts for 2020 and 2022

CRAN request

  • Fixed issue to make sure geobr uses suggested packages conditionally

Minor changes

CRAN request

  • geobr now uses suggested packages conditionally

New function

  • read_capitals() to download either a spatial sf object with the location of the municipal seats (sede dos municipios) of state capitals, or a data.frame with the names of codes of state capitals. Closes #243

Minor changes

  • Update intro vignette to show how to use geobr together with the new censobr sister package.

Bug fixes

Major changes

  • All data sets are now simultaneously stored on github and on Ipea’s server. The package first tries to download the data from Ipea’s server. In case Ipea’s link is off line for some reason, then the package tries to download the data from github. For users, the effect of this change is that the package is much more stable and less vulnerable to instabilities in data server connection.

Minor changes

  • Started using package documentation templates with Roxygen
  • Reduced a lot of code redundancy
  • Important update tothe check_connection() function

Minor changes

  • another attempt to make geobr fail gracefully when there is no connection to server.
  • Improved documentation of read_statistical_grid() Closed #289.

Minor changes

  • Remove packages cruland readr from geobr dependencies.
  • geobr now fails gracefully when server connection times out. Closed #259.

Bug fixes

  • Fixed check_connection() that was failing on Linux. Closed #269.

bug fixes

  • Attempt to make package “fail gracefully”.

bug fixes

  • Attempt to make package “fail gracefully”.

bug fixes

  • Fixed bug crashing on Solaris.

bug fix

  • Fixed bug with readr v2.0 that was crashing on Solaris.

Minor changes

  • Added package crul to geobr dependencies.

Minor changes

New data sets/functions

  • From v1.6 onwards, geobr stores downloaded in temporary cache in tempdir(). Closes #225.
  • New function read_comparable_areas to read historically comparable municipalities, aka Areas minimas comparaveis (AMCs). Closes issue #17
  • New data set of macro regions og health, which can be accessed using the new macro parameter added to read_health_region() function. Closes issue #219.
  • New internal support function is_online()to check internet connection with Ipea server. Closes #229
  • New data/function read_urban_concentrations. Closes #232
  • New data/function read_pop_arrangements. Closes #231
  • updated data sets for 2020:
    • Country
    • Regions
    • States
    • Micro regions
    • Meso regions
    • Immediate regions
    • Intermediate regions
    • Municipalities
    • Census tracts
  • Updated data of indigenous land March 2021

Minor changes

  • Improved package test coverage to 99.16%.
  • Improved documentation considering Roxygen: list(markdown = TRUE)
  • fix column names of grid_state_correspondence_table
  • Improve warning message regarding connection to geobr server at Ipea
  • Fix read_municipality when reading a state abbreviation before 1991.

Minor changes

  • Fixed unnecessary warning about internet connection. Closes #200.

New data sets/functions

  • new function read_schools to read the schools data - closes issue #190 (added in 2020-10).
  • data of census_tracts 2017 from the agricultural census - closes issue #171 (added in 2020-11).
  • new function cep_to_state to determine the state of a given CEP postal code (added in 2021-01).

Minor changes

  • geobr now automatically detects if there is an internet connection problem and throws an error. Closes issue #178
  • imports data.table to use rbindlist and improve package speed when downloading data for the whole country. Closes issue #199.
  • new intro vignette for Python users

New data sets/functions

  • data set read_health_region to read the health regions - closes issue #149 (added in 2020-07).
  • updated 2019 data sets of intermediate, immediate micro and meso regions, states and municipalities.

Minor changes

  • improved documentation of argument simplified
  • included documentation of argument zone in the read_census_tract function
  • read_municipality() function now also takes additional inputs for data sets before 1992. Closes issue #163 (added in 2020-06)
  • harmonized the st_geometry_type() of data sets to MULTIPOLYGON, when appropriate. Closes issues #41 #151 #135 #172
  • fix typo in geobr::grid_state_correspondence_table. Closes #187
  • argument tp fully deprecated and replaced with simplified. No more warning message
  • sample data with life expectancy of Brazilian states in 2017. To be used in vignette

New data sets/functions

  • data set read_neighborhood to read neighborhood limits of Brazilian municipalities - closes issue #104 (added in 2020-03).

Major changes

  • New argument showProgress to display progress bar. Defaults to TRUE
  • Argument tp was deprecated and replaced by argument simplified that needs to be either TRUE or FALSE. This should only affect user who have previously used tp=TRUE, who now should write simplified=FALSE

Minor changes

  • reorganization of internal support functions to reduce code redundancy
  • substantial improvment in test coverage of functions
  • substantial improvment in test coverage of functions
  • modified package tests using new format of crs objects. Following sf package update v0.9-0

New data sets/functions

  • data set read_metro_area to read official metropolitan areas - closes issue #2 (added in 2019-12).
  • data set read_municipal_seat to read the spatial coordinates of municipal seats- closes issue #86 (added in 2019-12).
  • function lookup_muni to look up municipality codes by their name, or the other way around. closes issue #58 (added in 2019-12)
  • function list_geobr to list all the datasets available in geobr - Closes issue #57.

Major changes

  • MAJOR change of geobr to read geopackage files, instead of .rds. A structural change that will make it easier to maintain both versions of geobr in R and Python (2020-02)
  • All functions now have an additional argument tp as in data ‘type’. This argument defaults to read data sets with ‘simplified’ borders, what makes the package much more efficient for downloading and plotting the data. Closes issue #76 (2020-02)
  • Pretty much all functions now download the data for the entire country as a default. Closes issue #77. The only exceptions are read_statistical_grid and read_census_tract. These two functions do take a really long time to load the data for the whole country and it might crash R due to memory limits, so the user must be more ‘aware’ about her choice (2020-02)

Minor changes

  • New utils.R script containing support functions to reduce code redundancy (2020-02)

New data sets/functions

  • data set read_indigenous_land to read official data of indigenous lands of all ethnicities according to stage of demarcation - closes issue #47 (2019-09-04).
  • data set read_disaster_risk_area to read official data of areas exposed to risks of geodynamic and hydro-meteorological disasters capable of triggering landslides and floods - closes issue #14 (added in 2019-09-24).
  • data set read_biomes to read official data of polygons of all of all biomes present in Brazilian territory - closes issue #45 (added in 2019-09-24).
  • data set read_amazon to read official data of Brazil’s Legal Amazon - closes issue #38 (added in 2019-10-07).
  • data set read_conservation_units to read official data of Environmental Conservation Units - closes issue #59 (added in 2019-10-08).
  • data set read_urban_area to read official data of urban footprint of Brazilian cities - closes issue #52 (added in 2019-10-17).
  • data set of biomes (2019) available at scale 1:250.000. (added in 2019-10-31) - closes issue #72
  • data set of read_intermediate_region (2017) (added in 2019-11-28)
  • data set of read_immediate_region (2017) (added in 2019-11-28)
  • function download_metadata simply the download of df with data set addresses.

Minor changes

  • Changes to read_region function to improve speed and remove dplyrdependency (added in 2019-10-22).
  • Shows a single download progress bar when *_code="all". This fixes the output of vignette and closes issue #42 (2019-08-05)
  • Launch of geobr v1.0 on CRAN with the following data sets:
    • Country
    • States
    • Regions
    • Meso regions
    • Micro regions
    • Municipalities
    • Census weighting areas
    • Census tracts
    • Statistical Grid