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
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
lintbloqueante
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.