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
-
Nomes em português: todas as colunas padronizadas
usam snake_case em português (ex:
cod_município,
pm25_media_anual).
-
Tipos consistentes: códigos são
integer, coordenadas são numeric, datas são
integer (ano, mês).
-
Metadados preservados: cada tibble carrega
atributos com a tabela de origem, data de processamento e processador
usado.
-
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)
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
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
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.