Skip to contents

Validates that municipality codes are within the valid Brazilian range (110001-530010), flags non-RJ codes when scope is RJ, and reports missing or invalid codes.

Usage

vigiar_checar_ibge(diag, dados, col_muni, uf = "RJ", escopo = "rj")

Arguments

diag

A vigiar_diagnostic object (modified in place).

dados

Data frame.

col_muni

Municipality code column name.

uf

Expected UF.

escopo

Scope for checks.

Value

The modified diagnostic object.

Examples

# \dontrun{
diag <- vigiar_diagnosticar_serie(pm25_rj_sample)
vigiar_checar_ibge(diag, pm25_rj_sample, "cod_municipio")
#> 
#> ── Relatorio Diagnostico VIGIAR ────────────────────────────────────────────────
#> Tabela: df_anual
#> Data: 2026-10-10 15:50:28
#> Dimensoes: 15 linhas x 7 colunas
#> ────────────────────────────────────────────────────────────────────────────────
#> 
#> ── Severidade: PROBLEMA ──
#> 
#> ── Resultados ──
#> 
#> ✖ Cobertura RJ baixa: 5% (5/92) municipios. Inferencias limitadas.
#> ✖ Macrorregiao 'Metropolitana I': apenas 2/13 municipios.
#> ✖ Macrorregiao 'Norte': apenas 1/10 municipios.
#> ✖ Macrorregiao 'Serrana': apenas 2/15 municipios.
#> 
#> ── Metricas ──
#> 
#> n_ibge_validos: 15
#> n_ibge_invalidos: 0
#> n_ibge_ausentes: 0
#> ano_min: 2020
#> ano_max: 2022
#> n_anos: 3
#> anos_ausentes: 0
#> n_municipios: 5
#> rj_presentes: 5
#> rj_faltantes: 87
#> rj_cobertura_pct: 5.4
#> pm25_media: 9.66
#> pm25_mediana: 10.2
#> pm25_dp: 2.45
#> pm25_min: 4.4
#> pm25_max: 13
#> pm25_pct_ausente: 0
#> n_duplicatas: 0
#> n_quebras_serie: 0
#> 
#> ── Recomendacoes ──
#> 
#> • [PROBLEMA] Cobertura RJ baixa: 5% (5/92) municipios. Inferencias limitadas.
#> Investigue a causa antes de modelar.
#> • [PROBLEMA] Macrorregiao 'Metropolitana I': apenas 2/13 municipios. Investigue
#> a causa antes de modelar.
#> • [PROBLEMA] Macrorregiao 'Norte': apenas 1/10 municipios. Investigue a causa
#> antes de modelar.
#> • [PROBLEMA] Macrorregiao 'Serrana': apenas 2/15 municipios. Investigue a causa
#> antes de modelar.
#> • [AVISO] Cobertura municipal insuficiente para inferencias por macrorregiao.
#> Considere analise exploratoria apenas.
# }