VIGIAR: Vigilância em Saúde Ambiental

Guia prático para download, processamento e diagnóstico de dados de qualidade do ar e indicadores de saúde ambiental com o pacote vigiar

Autor

Ryan Santos

Data de Publicação

10 de outubro de 2026

Bem-vindo

Este é o guia prático do pacote vigiar para a linguagem R. Aqui você aprenderá a baixar, processar, validar e analisar dados de vigilância em saúde ambiental do Brasil diretamente do dashboard VIGIAR do Ministério da Saúde.

vigiar desconfia dos dados antes de seduzir o pesquisador com gráficos.

O que é o VIGIAR?

O VIGIAR (Vigilância em Saúde Ambiental) é um sistema do Ministério da Saúde brasileiro que monitora:

  • Qualidade do ar (PM2.5) por município brasileiro
  • Dados populacionais expostos à poluição atmosférica
  • Indicadores de saúde associados (doenças respiratórias, internações, óbitos)
  • Exposição indoor a combustíveis sólidos
  • Indicadores agrupados por Brasil, UF e município
  • Fração atribuível da carga de doença à poluição do ar

O que é o pacote vigiar?

O vigiar é um pacote R que automatiza o download dos dados públicos do dashboard VIGIAR no Power BI. Ele implementa o protocolo “Publish to Web” da API do Power BI para extrair os dados de forma programática, permitindo que pesquisadores, gestores e analistas de saúde pública trabalhem com esses dados de forma reprodutível e auditável.

Principais funcionalidades

  • ✅ Conexão automática ao dashboard Power BI do VIGIAR
  • ✅ Download de 14+ tabelas de dados ambientais e de saúde
  • ✅ Foco especial no estado do Rio de Janeiro (92 municípios, 9 macrorregiões)
  • ✅ Processamento e padronização de colunas
  • ✅ Validação: IBGE, datas, unidades, integridade
  • ✅ Diagnóstico de séries temporais (severidade: ok | aviso | problema | crítico)
  • ✅ Auditoria completa com checksums SHA256
  • ✅ Compliance multi-perfil: básico, rigoroso, RJ, corrupção
  • ✅ Cache local, snapshots e reprodutibilidade
  • ✅ Logging estruturado de todas as operações
  • ✅ Exportação: CSV, RDS, Parquet, JSON
  • ✅ Dicionário de variáveis consultável e auditável
  • ✅ vigiar_lifecycle(): status de estabilidade de toda a API pública
  • ✅ Testes offline determinísticos, cobertura monitorada e lint bloqueante

Como este guia está organizado

Capítulo Conteúdo
Começo rápido O fluxo essencial em ~20 linhas, explicado passo a passo
Instalação Como instalar o pacote e suas dependências
Conexão Estabelecendo sessão com o dashboard Power BI
Exploração Navegando pelo esquema de dados
Download Baixando tabelas e filtrando dados
Rio de Janeiro Funcionalidades específicas para o estado do RJ
Processamento Padronização e tipagem dos dados
Validação Validando códigos IBGE, datas e unidades
Diagnóstico Diagnosticando qualidade das séries temporais
Auditoria Auditoria completa e compliance
Cache e Reprodutibilidade Cache local, snapshots e schema locking
Qualidade, Testes e Desenvolvimento Testes offline, cobertura, lint, CI e ciclo de vida da API
Exportação Exportando dados em múltiplos formatos
Exemplos Práticos Análises completas passo a passo
FAQ Perguntas frequentes e solução de problemas
Considerações legais e uso responsável Termos de uso e precauções para uso institucional

Citação

Para citar o pacote em trabalhos acadêmicos:

Santos, R. (2026). vigiar: Download de dados do dashboard VIGIAR de Vigilância em Saúde Ambiental. Pacote R versão 0.7.2. https://github.com/santosry/vigiar

Licença

O pacote vigiar é distribuído sob a licença MIT. Os dados baixados pertencem ao Ministério da Saúde / VIGIAR.