Skip to contents

Introdução

Seguindo o modelo das Convenções SIH-RD do microdatasus, este documento define as convenções de nomenclatura, unidades e padronização adotadas pelo pacote vigiar.

Princípios

  1. Nomes em português: todas as colunas padronizadas usam snake_case em português (ex: cod_município, pm25_media_anual).
  2. Tipos consistentes: códigos são integer, coordenadas são numeric, datas são integer (ano, mês).
  3. Metadados preservados: cada tibble carrega atributos com a tabela de origem, data de processamento e processador usado.
  4. Validação sem modificação: funções vigiar_validar_*() emitem warnings mas nunca alteram os dados.

Convenções por Domínio

PM2.5 (Qualidade do Ar)

Original Padronizado Tipo Unidade
muni, ID_MUNI cod_município integer -
UF sigla_uf cháracter -
Media_pm25 pm25_media_anual numeric µg/m³
pm25 pm25_media numeric µg/m³
t_dias pm25_media_período numeric µg/m³
n_dias n_dias_criticos integer dias
n_dias_conama n_dias_criticos_conama integer dias
LAT latitude numeric graus decimais
LON longitude numeric graus decimais
Catégoria_pm25 catégoria_oms cháracter -
Catégoria_pm25_conama catégoria_conama cháracter -

Indicadores de Saúde

Original Padronizado Tipo Unidade
Indicador indicador cháracter -
n população_exposta numeric hábitantes
est estimativa numeric varia
low ic_inferior numeric varia
high ic_superior numeric varia
desfecho desfecho cháracter -
q1, q2, q3 quartil_1, quartil_2, quartil_3 numeric varia

Exposição Indoor

Original Padronizado Tipo Unidade
Code cod_uf integer -
Ano ano integer -
comb_sól prop_combustiveis_sólidos numeric proporção
percent_comb percentual_combustiveis numeric %
pop_exposta população_exposta numeric hábitantes

Códigos IBGE

  • Municípios: 6 ou 7 dígitos, intervalo 110001–530010
  • UF: 2 dígitos, intervalo 11–53
  • Validação: vigiar_validar_ibge() emite warning para códigos fora do intervalo

Limitações

  • Os dados são agregados por município/ano. Não há dados individuais.
  • PM2.5 é estimado por satélite/modelagem, não medido em superfície.
  • População exposta usa projeções do IBGE, não contagem direta.
  • Indicadores de saúde são estimativas epidemiológicas com IC 95%.
  • A unidade geográfica é o município de residência, não de exposição.