read_comparable_areas: Download spatial data of historically comparable...

View source: R/read_comparable_areas.R

read_comparable_areasR Documentation

Download spatial data of historically comparable municipalities

Description

This function downloads the shape file of minimum comparable area of municipalities, known in Portuguese as 'Areas minimas comparaveis (AMCs)'. The data is available for any combination of census years between 1872-2010. These data sets are generated based on the Stata code originally developed by doi: 10.1590/0101-416147182phePhilipp Ehrl, and translated into R by the geobr team.

Usage

read_comparable_areas(
  start_year = 1970,
  end_year = 2010,
  simplified = TRUE,
  showProgress = TRUE
)

Arguments

start_year

Numeric. Start year to the period.

end_year

Numeric. End year to the period. (defaults to 2010)

simplified

Logic FALSE or TRUE, indicating whether the function should return the data set with 'original' spatial resolution or a data set with 'simplified' geometry. Defaults to TRUE. For spatial analysis and statistics users should set simplified = FALSE. Borders have been simplified by removing vertices of borders using st_simplify{sf} preserving topology with a dTolerance of 100.

showProgress

Logical. Defaults to TRUE display progress bar.

Details

These data sets are generated based on the original Stata code developed by Philipp Ehrl. If you use these data, please cite:

  • Ehrl, P. (2017). Minimum comparable areas for the period 1872-2010: an aggregation of Brazilian municipalities. Estudos Econômicos (São Paulo), 47(1), 215-229. https://doi.org/10.1590/0101-416147182phe

Value

An "sf" "data.frame" object

See Also

Other general area functions: read_amazon(), read_biomes(), read_census_tract(), read_conservation_units(), read_country(), read_health_region(), read_immediate_region(), read_intermediate_region(), read_meso_region(), read_micro_region(), read_municipality(), read_neighborhood(), read_region(), read_semiarid(), read_state(), read_statistical_grid(), read_weighting_area()

Examples

## Not run:  if (interactive()) {

  amc <- read_comparable_areas(start_year=1970, end_year=2010)
}
## End(Not run)

geobr documentation built on Aug. 16, 2022, 9:05 a.m.