Funciona com QUALQUER `data.frame` que tenha uma coluna de CEP — dados do DATASUS ou seus próprios dados. Cada linha recebe o bairro (pelo CNEFE 2022, ver [cep_bairro()]), as coordenadas do CEP e do bairro, e um diagnóstico da qualidade do CEP (`situacao_cep`).
Usage
adicionar_bairro(
dados,
uf,
col_cep = "CEP",
col_mun = NULL,
col_id = NULL,
pct_min = 0.6,
limite_excesso = 20
)Arguments
- dados
Um `data.frame`.
- uf
Sigla da UF dos CEPs (a tabela CEP-bairro é montada por UF).
- col_cep
Nome da coluna de CEP.
- col_mun
Nome da coluna do município de residência (6 ou 7 dígitos), opcional. Permite detectar CEPs de outro município.
- col_id
Nome de uma coluna que identifica a pessoa ou o episódio, opcional. Usada para que pessoas com muitos registros (ex.: diálise mensal) não sejam confundidas com CEPs genéricos.
- pct_min
Fração mínima dos endereços de um CEP no mesmo bairro.
- limite_excesso
Razão máxima entre a fração de pessoas/registros e a fração de endereços de um CEP (valor esperado: ~1).
Colunas adicionadas
- cep_paciente
CEP normalizado (8 dígitos).
- codmun_paciente
município de residência (6 dígitos), se `col_mun` for dado.
- situacao_cep
se o CEP permitiu atribuir bairro e, se não, por quê.
- id_bairro, bairro, fonte_bairro, cd_bairro_ibge
o bairro (só quando `situacao_cep == "bairro atribuído"`).
- lat_bairro, lon_bairro
ponto do bairro (mediana dos endereços).
- lat_cep, lon_cep
ponto do CEP (mediana dos endereços do CEP). Preenchido para todo CEP que existe no CNEFE — inclusive CEPs gerais, cujo ponto representa o centro da área que eles cobrem; use `situacao_cep` e `n_end_cep` para julgar.
- codmun_cep, n_end_cep, pct_bairro
município do CEP, nº de endereços do CEP e fração deles no bairro atribuído.
Examples
if (FALSE) { # interactive()
minha_tabela <- data.frame(id = 1:3, cep = c("20031170", "22041001", "24020005"))
adicionar_bairro(minha_tabela, "RJ", col_cep = "cep")
}