Meteorologia de Superfície — Aeródromos Brasileiros

Coleta, processa e visualiza dados meteorológicos horários de aeródromos brasileiros a partir do portal de dados de superfície do ICEA/DECEA.

Início rápido

Clone o repositório, entre na pasta do módulo e execute:

cd softwares/test/meteorologia_aeroportos

Windows (PowerShell)

.\run\run.bat

Windows (CMD)

run\run.bat

Linux / macOS

chmod +x run/run.sh && ./run/run.sh

O script cria o ambiente virtual, instala as dependências e abre o dashboard em http://localhost:8501.

Pré-requisito: Python 3.10+ e Google Chrome instalados.

No PowerShell o .\ antes do caminho é obrigatório para executar arquivos .bat por caminho relativo.

Estrutura

meteorologia_aeroportos/
├── README.md           este arquivo
├── LICENSE             MIT License
├── docs/               documentação técnica e autoria
├── _apps/              módulos Python
│   ├── dashboard.py        dashboard interativo (Streamlit)
│   ├── pipeline.py         orquestrador completo
│   ├── scraper_meteorologia.py  coleta de dados via web
│   ├── concat_meteorologia.py  concatenação de CSVs
│   ├── db.py               camada SQLite
│   └── _diag_outliers.py   diagnóstico de qualidade
├── run/
│   ├── run.bat         inicialização Windows
│   └── run.sh          inicialização Linux/macOS
├── env/
│   └── requirements.txt
└── db/
    ├── met.db          banco SQLite principal
    └── dados/          CSVs temporários (removidos após coleta)

CSVs analíticos permanentes ficam fora da pasta do módulo:

dataset/tabelas/preproc/meteorologia_aeroportos/<ICAO>/

Uso via linha de comando

Todos os comandos são executados a partir da pasta meteorologia_aeroportos/.

Coletar histórico completo de um aeródromo:

python _apps/pipeline.py --aerodrome SBGR --all-years

Coletar um intervalo de anos:

python _apps/pipeline.py --aerodrome SBGR --start-year 2020 --end-year 2025

Abrir o dashboard:

streamlit run _apps/dashboard.py

Diagnóstico de qualidade do banco:

python _apps/_diag_outliers.py

Parâmetro	Descrição
`--aerodrome`	Código ICAO (ex: `SBGR`, `SBSP`)
`--all-years`	Coleta todo o histórico disponível
`--start-year` / `--end-year`	Intervalo de anos
`--no-headless`	Abre o Chrome de forma visível (debug)
`--no-cleanup`	Mantém CSVs trimestrais intermediários

Banco de dados

db/met.db — SQLite com três tabelas:

Tabela	Conteúdo
`observations`	Série temporal horária (10 variáveis por observação)
`outlier_log`	Auditoria de valores tratados por limites físicos
`aerodromes`	Catálogo de aeródromos disponíveis no portal ICEA

Variáveis na tabela observations:

Coluna	Descrição	Unidade
`T`	Temperatura do bulbo seco	°C
`Td`	Ponto de orvalho	°C
`UR`	Umidade relativa	%
`QNH`	Pressão atmosférica ao nível do mar	hPa
`WS`	Velocidade do vento	kt
`WG`	Rajada máxima de vento	kt
`WD`	Direção do vento	°
`VIS`	Visibilidade predominante	dam
`TETO`	Teto de nuvens	dam
`PREC`	Precipitação acumulada	mm

Categorias ICAO de condições de voo

Categoria	Teto (dam)	Visibilidade (dam)	Condição
LIFR	< 15	< 50	IFR Severo
IFR	15–30	50–100	Voo por instrumentos
MVFR	30–100	100–300	VFR Marginal
VMC	> 100	> 300	Condições visuais

Documentação e autoria

docs/about.md — descrição técnica detalhada, limitações e oportunidades de melhoria
docs/authors.md — autoria, licença e guia para contribuições futuras
docs/changelog.md — histórico de versões por autor

Fonte dos dados

Portal ICEA/DECEA — Dados de Superfície: https://pesquisa.icea.decea.mil.br/superficie_list/

IED — Instituto de Estudos para o Desenvolvimento · ITA — Instituto Tecnológico de Aeronáutica

4.4 KiB Raw Permalink Blame History Unescape Escape