Centro de Ajuda Metodológica

Propósito, fluxo de dados, interpretação, alertas de confiança e referências do módulo Clima.

Propósito do módulo

O módulo Clima consolida dados meteorológicos municipalizados brasileiros — precipitação, temperaturas, radiação, umidade, vento e evapotranspiração — a partir de fontes científicas versionadas (ex.: BR-DWGD), com rastreabilidade completa da ingestão até a visualização. Ele sustenta análises de saúde pública, estresse térmico e estudos ambientais, com governança operacional de grau científico.

Como o módulo está organizado

Retrato climático

Mapa de uma variável em uma data específica.

Finalidade: Visualizar a distribuição espacial de uma variável climática entre municípios em um recorte temporal.
Série temporal

Evolução de uma variável em um município ao longo do tempo.

Finalidade: Observar tendências, sazonalidade, anomalias e lacunas de cobertura em um município específico.
Painel do Clima

Visão executiva consolidada do domínio.

Finalidade: Oferecer leitura rápida da prontidão operacional, cobertura, qualidade e últimos eventos de ingestão.
Datasets climáticos

Catálogo versionado das bases climáticas ingeridas.

Finalidade: Governar qual dataset é a fonte autoritativa do domínio (is_active=true) e manter histórico de versões.
Ingestão climática

Pipeline único de entrada de dados: Local, Drive, GEE e BR-DWGD Cloud.

Finalidade: Transformar dados brutos em registros ClimateAggMunicipio vinculados a um dataset versionado.
Jobs climáticos

Fila unificada de execuções de ingestão e manutenção — inclui Google Earth Engine.

Finalidade: Rastrear cada execução (ingest_csv_agg, gee_export, reindex, etc.) com duração, volume, erros e linhagem.
Qualidade climática

Relatório consolidado multidimensional de saúde do domínio.

Finalidade: Monitorar completude, consistência, validade, atualidade, rastreabilidade e coerência territorial/temporal.

Alertas de confiança

Cada dataset é classificado automaticamente por regras objetivas. Aparece como badge em todas as abas.

  • Confiável
    Dataset ativo, atualizado nos últimos 30 dias, sem inconsistências operacionais.
    Regra: quality_status=healthy AND is_active=true AND última atualização ≤ 30 dias.
  • Validado
    Dataset revisado manualmente por um operador e marcado como validado.
    Regra: validation_status=validated (revisão manual registrada).
  • Parcial
    Ingestão concluída com linhas inválidas ou cobertura incompleta.
    Regra: quality_status=partial OR cobertura efetiva < declarada.
  • Em validação
    Dataset ingerido porém ainda não promovido a ativo ou em revisão de homologação.
    Regra: is_active=false OR data_origin=synthetic_homolog/homologation.
  • Com lacunas
    Presença significativa de períodos ou municípios sem registro.
    Regra: quality_status=degraded OR quality_report.gaps_pct > 5%.
  • Desatualizado
    Última atualização com mais de 30 dias.
    Regra: ingestion_date < hoje − 30 dias.
  • Inconsistente
    Falhas operacionais críticas — use com cautela e confira Jobs e Qualidade.
    Regra: quality_status=failed.
  • Baixa cobertura
    Menos de 500 municípios com registro — cobertura nacional insuficiente.
    Regra: coverage_municipal_count < 500.
  • Dependente de processamento
    Há jobs de ingestão em andamento que podem alterar os resultados exibidos.
    Regra: Existe ClimateJob em status running para este dataset.
  • Indisponível
    Não há dataset ativo — recursos dependentes estão inoperantes.
    Regra: Nenhum ClimateDataset com is_active=true.

Origem dos dados e pipeline

  1. Fonte primária: bases científicas oficiais (ex.: BR-DWGD com resolução de 0,1°).
  2. Ingestão: upload local, Google Drive ou Google Earth Engine, validados via cabeçalho canônico.
  3. Agregação municipal: aplicada conforme política declarada (soma para precipitação, média para temperaturas).
  4. Persistência versionada: um ClimateDataset por versão, com apenas um ativo por nome.
  5. Qualidade: dimensões objetivas com scores 0–100 (completude, atualidade, rastreabilidade etc.).
  6. Apresentação: Snapshot, Série, Dashboard, com proveniência e alertas de confiança em todos os pontos.

Cautelas de interpretação

  • Não interpolamos lacunas de dados — descontinuidades são preservadas.
  • Datasets marcados como homologação não refletem a realidade meteorológica e servem apenas à validação técnica.
  • Resolução espacial de 0,1° ≈ 11 km: municípios muito pequenos podem compartilhar pixels com vizinhos.
  • Um valor extremo pode ser real — sempre compare com a série histórica e o contexto regional.