Skip to contents

Agrega os agregados por setor censitario do Censo

Source: R/agregar.R
agregar_setores.Rd

Le censobr::read_tracts() e soma as variaveis pedidas por setor censitario, municipio ou Brasil. Sao contagens do universo, logo nao se ponderam; valores ".", "", "X" e "-" do IBGE viram NA e entram como zero na soma.

Usage

agregar_setores(
  dataset = "Basico",
  ano = 2022,
  variaveis,
  nivel = c("municipio", "setor", "brasil", "bairro", "subdistrito"),
  corte = NULL,
  show_progress = FALSE
)

Arguments

dataset

Subbase do read_tracts. Para 2022: "Basico", "Domicilio", "Pessoas", "Indigenas", "Quilombolas", "ResponsavelRenda", "Entorno", "Obitos" ou "Preliminares" (2010: "Basico", "Domicilio", "DomicilioRenda", "Responsavel", "ResponsavelRenda", "Pessoa", "PessoaRenda", "Entorno"). Use censo_variaveis() para ver qual subbase tem cada codigo.

ano

Ano do censo (2022 publico).

variaveis

Vetor de variaveis de contagem, no formato tema_V00xxx (ex.: "demografia_V01007"), como saem do dicionario.

nivel

"municipio" (default), "setor", "bairro", "subdistrito" ou "brasil"; a chave e code_muni, code_tract (convencao geobr do censobr; o codigo de setor tem 15 digitos e ainda nao encaixa nos niveis do DW do beep), code_neighborhood, code_subdistrict ou nenhuma, respectivamente. Os niveis bairro/subdistrito so existem quando a base do ano traz as colunas (Censo 2022; o de 2010 nao publica bairro nos tracts); setores sem codigo publicado ficam fora da agregacao (aviso), nunca inferidos. O codigo de subdistrito e o oficial IBGE de 11 digitos; o de bairro sai na convencao do DW beep, municipio(7) + sequencial zerado a 4.

corte

Expressao de recorte (character), opcional, ex.: "code_muni == 5300108" para o Distrito Federal; roda no Arrow, antes de trazer os dados para a memoria.

show_progress

Repassado ao censobr (barra de download).

Value

Lista nomeada por variavel, cada item um data.frame long com local, periodo e valor; veja o contrato completo em censoagg-package.

See also

agregar_microdados() para estatisticas ponderadas de microdados e censo_variaveis() para descobrir os codigos das variaveis.

Other agregadores: agregar_microdados()

Examples

if (FALSE) { # \dontrun{
# populacao por municipio
agregar_setores("Basico", 2022, variaveis = c("V0001"),
                nivel = "municipio")

# homens e mulheres por setor censitario no DF
agregar_setores("Pessoas", 2022,
                variaveis = c("demografia_V01007",
                              "demografia_V01008"),
                nivel = "setor", corte = "code_muni == 5300108")

# populacao por subdistrito (RA) no DF
agregar_setores("Basico", 2022, variaveis = c("V0001"),
                nivel = "subdistrito", corte = "code_muni == 5300108")
} # }