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.
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.
# }