geobr: read_immediate_region – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

read_immediate_region

Download spatial data of Brazil's Immediate Geographic Areas

Description

The Immediate Geographic Areas are part of the geographic division of Brazil created in 2017 by IBGE. These regions were created to replace the "Micro Regions" division. Data at scale 1:250,000, using Geodetic reference system "SIRGAS2000" and CRS(4674)

Usage

read_immediate_region(
  code_immediate = "all",
  year = 2019,
  simplified = TRUE,
  showProgress = TRUE
)

Arguments

`code_immediate`	6-digit code of an immediate region. If the two-digit code or a two-letter uppercase abbreviation of a state is passed, (e.g. 33 or "RJ") the function will load all immediate regions of that state. If `code_immediate="all"` (Default), all immediate regions of the country are loaded.
`year`	A date number in YYYY format (defaults to 2019)
`simplified`	Logic `FALSE` or `TRUE`, indicating whether the function returns the data set with original' resolution or a data set with 'simplified' borders. Defaults to `TRUE`. For spatial analysis and statistics users should set `simplified = FALSE`. Borders have been simplified by removing vertices of borders using `sf::st_simplify()` preserving topology with a `dTolerance` of 100.
`showProgress`	Logical. Defaults to `TRUE` display progress bar

Value

An "sf" "data.frame" object

Examples

## Not run:  if (interactive()) {
# Read an specific immediate region
  im <- read_immediate_region(code_immediate=110006)

# Read immediate regions of a state
  im <- read_immediate_region(code_immediate=12)
  im <- read_immediate_region(code_immediate="AM")

# Read all immediate regions of the country
  im <- read_immediate_region()
  im <- read_immediate_region(code_immediate="all")
}
## End(Not run)

geobr

Download Official Spatial Data Sets of Brazil

v1.6.1

MIT + file LICENSE

Authors

Rafael H. M. Pereira [aut, cre] (<https://orcid.org/0000-0003-2125-7465>), Caio Nogueira Goncalves [aut], Paulo Henrique Fernandes de Araujo [ctb], Guilherme Duarte Carvalho [ctb], Rodrigo Almeida de Arruda [ctb], Igor Nascimento [ctb], Barbara Santiago Pedreira da Costa [ctb], Welligtton Silva Cavedo [ctb], Pedro R. Andrade [ctb], Alan da Silva [ctb], Carlos Kauê Vieira Braga [ctb], Carl Schmertmann [ctb], Alessandro Samuel-Rosa [ctb], Daniel Ferreira [ctb], Ipea - Institue for Applied Economic Research [cph, fnd]

Initial release

2021-04-15