Reservatórios¶
Resumo¶
Cadastro dos reservatórios do sistema: tipo, usina, bacia, rio, REE, cotas e volumes operativos, produtividade e perda de carga.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | ons/reservatorio |
| Órgão | Operador Nacional do Sistema Elétrico (ONS) |
| Página oficial | https://dados.ons.org.br/dataset/reservatorio |
| Licença | Creative Commons Atribuição (CC BY), conforme o portal de dados abertos do ONS: https://dados.ons.org.br/dataset/reservatorio |
| Periodicidade | diária (retrato, sem histórico) |
| Cobertura | 2026-11 a em-curso |
| Unidade (uma linha) | um reservatório (ou conjunto reservatório e usina) |
| Granularidade | espacial: reservatório; temporal: retrato do dia (sem histórico) |
| Formato bruto | um arquivo Parquet (ou CSV) único no bucket público S3 do ONS, substituído a cada atualização |
| Estado no lake | convertido |
| Partições | — |
| Chave | nom_reservatorio, nom_usina, cod_posto |
| Colunas | 24 |
| Unidades de medida | val_cotamaxima: m; val_cotaminima: m; val_volmax: hm3; val_volmin: hm3; val_volutiltot: hm3; val_produtibilidadeespecifica: MW por altura de queda (unidade não detalhada pela fonte); val_produtividade65volutil: % (descrição oficial); val_perda: % ou m, conforme val_tipoperda; val_latitude: graus; val_longitude: graus; cod_resplanejamento: código (sem unidade); cod_posto: código (sem unidade) |
| Dados pessoais | nenhum |
| Eras | nenhuma |
| Revisado em | 2026-11-15 |
| Versão do fetcher | 0.3.0 |
Origem e coleta¶
- Fonte: Portal de Dados Abertos do ONS (conjunto
reservatorio, https://dados.ons.org.br/dataset/reservatorio). Os arquivos ficam no bucket público S3 do ONS, emdataset/reservatorio/. - O ONS publica um arquivo único (
RESERVATORIOS.parquet, e as mesmas tabelas em CSV e XLSX) e o atualiza todo dia, sem guardar histórico. - No bruto, o arquivo fica em
cadastros/reservatorio_AAAA@AAAAMMDD.<extensão>; o carimbo é a data da coleta e o lake converte a versão mais recente. - O dicionário de dados do ONS (PDF e JSON) fica no mesmo diretório e o fetcher não o baixa; as descrições da seção Variáveis vêm do JSON do dicionário, conferidas contra os valores observados.
Conteúdo¶
- Unidade de análise: um reservatório (ou conjunto reservatório e usina).
- Uma única carga com 162 linhas em 2026-11-15 (retrato do dia; sem histórico).
Variáveis¶
Descrições do dicionário de dados do ONS (JSON publicado com o conjunto). O conversor normaliza os nomes de coluna (minúsculas, sem acento e sem separadores soltos); quando o nome do lake difere do dicionário, a coluna 'Na fonte' mostra o nome do dicionário.
| Coluna no lake | Na fonte | Tipo | Descrição | Unidade / códigos | Período |
|---|---|---|---|---|---|
nom_reservatorio |
nom_reservatorio |
texto | Nome do Reservatório | — | todo |
tip_reservatorio |
tip_reservatorio |
texto | Tipo de Reservatório | — | todo |
cod_resplanejamento |
cod_resplanejamento |
inteiro | Código do Reservatório nos Modelos de Planejamento | código (sem unidade) | todo |
cod_posto |
cod_posto |
inteiro | Posto de Vazão da Usina | código (sem unidade) | todo |
nom_usina |
nom_usina |
texto | Nome da Usina | — | todo |
ceg |
ceg |
texto | Código Único do Empreendimento de Geração (CEG), estabelecido pela ANEEL | — | todo |
id_subsistema |
id_subsistema |
texto | Código do Subsistema | — | todo |
nom_subsistema |
nom_subsistema |
texto | Nome do Subsistema | — | todo |
nom_bacia |
nom_bacia |
texto | Nome da Bacia Hidro-Energética | — | todo |
nom_rio |
nom_rio |
texto | Nome do Rio | — | todo |
nom_ree |
nom_ree |
texto | Nome do Reservatório Equivalente | — | todo |
dat_entrada |
dat_entrada |
texto | Data de Entrada em Operação | — | todo |
val_cotamaxima |
val_cotamaxima |
decimal | Cota Máxima Para Operação. Altura máxima do nível d'água de um reservatório, considerado para fins de operação normal medido em metros(m) | m | todo |
val_cotaminima |
val_cotaminima |
decimal | Cota Mínima Para Operação. Altura mínima do nível d'água de um reservatório considerado para fins de operação normal medido em metros(m). | m | todo |
val_volmax |
val_volmax |
decimal | Volume Máximo. Volume do reservatório correspondente ao nível máximo operativo medido em hectômetro cúbico (hm3) | hm3 | todo |
val_volmin |
val_volmin |
decimal | Volume Mínimo. Volume do reservatório correspondente ao nível mínimo operativo medido em hectômetro cúbico (hm3) | hm3 | todo |
val_volutiltot |
val_volutiltot |
decimal | Volume Útil Total. Volume do reservatório compreendido entre o nível máximo de operação e mínimo normal de operação medido em hectômetro cúbico (hm3) | hm3 | todo |
val_produtibilidadeespecifica |
val_produtibilidadeespecifica |
decimal | Produtividade Específica, que indica quantos MW serão ganhos pela altura da queda | MW por altura de queda (unidade não detalhada pela fonte) | todo |
val_produtividade65volutil |
val_produtividade65volutil |
decimal | Produtividade a 65% do volume útil medido em % | % (descrição oficial) | todo |
val_tipoperda |
val_tipoperda |
texto | Tipo da Perda de Carga. Indica se o tipo de perda de carga está em porcentagem (%) ou Metros(m). | — | todo |
val_perda |
val_perda |
decimal | Valor da perda de carga. Estes valores são os mesmos utilizados pelo programa Newave. | % ou m, conforme val_tipoperda | todo |
val_latitude |
val_latitude |
decimal | Latitude do Reservatório | graus | todo |
val_longitude |
val_longitude |
decimal | Longitude do Reservatório | graus | todo |
res_id |
res_id |
texto | Sem descrição no dicionário oficial (coluna presente no arquivo). | — | todo |
Colunas do dicionário oficial que o arquivo não traz: id_reservatorio.
No lake¶
- Dataset
ons/reservatorio, sem partição (arquivo único); um Parquet por arquivo de origem. - O conversor lê o Parquet ou o CSV (separador
;, UTF-8 ou ISO-8859-1), detecta o separador decimal de cada coluna numérica (os CSV do ONS usam ponto decimal), normaliza os nomes de coluna e grava as colunas numéricas comodoubleem todos os anos, inclusive as que o ONS publica como texto (oito casas decimais, zero como0E-8); texto vazio vira nulo. Códigos, nomes e datas mantêm o tipo do arquivo de origem.
Cuidados de uso¶
- Sem histórico. O ONS lê os dados das origens e atualiza o arquivo todo dia; o lake guarda só o retrato mais recente.
- As colunas de cotas e volumes (
val_cotamaxima,val_cotaminima,val_volmax,val_volmin,val_volutiltot) são texto com três casas decimais na origem; o conversor os grava comodouble. A unidade dos volumes é hm3 e a das cotas, metros (descrição oficial). val_tipoperdaindica seval_perdaestá em porcentagem ou em metros (mou%; nulo em parte dos reservatórios).cod_resplanejamentose repete em 3 códigos (ITAIPU,P. AFONSO 1,2,3eHENRY BORDENtêm mais de uma linha); use o nome do reservatório, a usina e o posto de vazão.- Espaços nas pontas do texto. Há valores preenchidos com espaços em:
res_id(19 linhas). Apliquetrimantes de juntar ou agrupar.
Exemplos¶
Reservatórios com maior volume útil total, em hm3.
import duckdb
duckdb.sql("""
SELECT nom_reservatorio, nom_usina, val_volutiltot AS volume_util_hm3
FROM read_parquet('lake/ons/reservatorio/**/*.parquet', hive_partitioning = true, union_by_name = true)
ORDER BY 3 DESC NULLS LAST
LIMIT 10
""").show()
Referências¶
- Conjunto no portal de dados abertos do ONS: https://dados.ons.org.br/dataset/reservatorio
- Dicionário de dados (PDF): https://ons-aws-prod-opendata.s3.amazonaws.com/dataset/reservatorio/DicionarioDados_Reservatorio.pdf
- Programa de dados abertos da AWS com o catálogo do ONS: https://registry.opendata.aws/ons-opendata-portal/