HydroBr reúne consultas de dados hidrológicos brasileiros em DataFrames do pandas. A biblioteca busca manter a origem, a unidade e as ausências dos dados visíveis, sem interpolar ou preencher valores automaticamente.
- Instale a biblioteca.
- Consulte estações e séries da ANA.
- Consulte estações e dados ambientais do CEMADEN.
- Consulte estações e observações do INMET via WIS2.
- Consulte reservatórios e grandezas do ONS.
- Consulte reservatórios do SIN e Nordeste no SAR.
- Consulte índices climáticos observados NOAA.
- Consulte estimativas climáticas NASA POWER por coordenada.
- Veja máximas, tendências, assinaturas e clusters.
- Veja qualidade, estiagens, extremos diários e SPI.
- Veja a referência rápida da API.
| Fonte | Dados implementados | Autenticação |
|---|---|---|
| ANA | Inventário e busca de estações; séries diárias e telemetria; qualidade, sedimentos, descargas e perfis | REST com credenciais ou ServiceANA legado sem credenciais para parte dos dados |
| CEMADEN | Estações, sensores, dados ambientais, acumulados e históricos agendados | Conta PED ou JWT |
| INMET/WIS2 | Estações WIGOS; SYNOP horário e manual; valores climáticos diários DAYCLI | Não exige credenciais |
| ONS | Catálogo aberto; cadastro de reservatórios; dados hidráulicos diários e horários | Não exige credenciais |
| SAR | Cadastro e histórico operacional do SIN, Nordeste e Outros Sistemas Hídricos | Não exige credenciais |
| NOAA/CPC/PSL | Índices climáticos observados | Não exige credenciais |
| NASA POWER | Estimativas em grade horárias, diárias, mensais e climatológicas por coordenada | Não exige credenciais |
- Datas são índices ou colunas
datetime64, conforme o formato natural do conjunto. - Valores ausentes permanecem como
NaN. - Nenhuma interpolação ou preenchimento é realizado no download.
- Os atributos
DataFrame.attrsregistram fonte, conjunto, variável ou unidade quando aplicável. - Consultas grandes são divididas conforme os limites da fonte e reunidas ao final.