Capacidade Instalada de Geração¶
Resumo¶
Cadastro da potência nominal das unidades geradoras das usinas despachadas pelo ONS (modalidades Tipo I, II-A, II-B e II-C), em MW.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | ons/capacidade-geracao |
| Órgão | Operador Nacional do Sistema Elétrico (ONS) |
| Página oficial | https://dados.ons.org.br/dataset/capacidade-geracao |
| Licença | Creative Commons Atribuição (CC BY), conforme o portal de dados abertos do ONS: https://dados.ons.org.br/dataset/capacidade-geracao |
| Periodicidade | diária (retrato, sem histórico) |
| Cobertura | 2026-11 a em-curso |
| Unidade (uma linha) | uma unidade geradora de uma usina despachada |
| Granularidade | espacial: unidade geradora (com usina, subsistema e estado); 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 | cod_equipamento |
| Colunas | 18 |
| Unidades de medida | val_potenciaefetiva: MW |
| 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
capacidade-geracao, https://dados.ons.org.br/dataset/capacidade-geracao). Os arquivos ficam no bucket público S3 do ONS, emdataset/capacidade-geracao/. - O ONS publica um arquivo único (
CAPACIDADE_GERACAO.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/capacidade-geracao_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: uma unidade geradora de uma usina despachada.
- Uma única carga com 5.837 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 |
|---|---|---|---|---|---|
id_subsistema |
id_subsistema |
texto | Código do Subsistema da Usina | — | todo |
nom_subsistema |
nom_subsistema |
texto | Nome do Subsistema | — | todo |
id_estado |
id_estado |
texto | Sigla do Estado Onde Está Localizada a Usina | — | todo |
nom_estado |
nom_estado |
texto | Nome do Estado | — | todo |
nom_modalidadeoperacao |
nom_modalidadeoperacao |
texto | Modalidade de Operação da Usina | — | todo |
nom_agenteproprietario |
nom_agenteproprietario |
texto | Agente Proprietário da Usina | — | todo |
nom_agenteoperador |
nom_agenteoperador |
texto | Agente Operador da Usina | — | todo |
nom_tipousina |
nom_tipousina |
texto | Tipo da Usina. Temos os tipos de Usinas:EOLIELÉTRICA, FOTOVOLTAICA, HIDROELÉTRICA, NUCLEAR, TÉRMICA | — | 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 |
nom_unidadegeradora |
nom_unidadegeradora |
texto | Nome da Unidade Geradora | — | todo |
cod_equipamento |
cod_equipamento |
texto | Código do Equipamento – Unidade Geradora | — | todo |
num_unidadegeradora |
num_unidadegeradora |
texto | Código Operacional da Unidade Geradora | — | todo |
nom_combustivel |
nom_combustivel |
texto | Combustível da Unidade Geradora | — | todo |
dat_entradateste |
dat_entradateste |
texto | Data da Liberação para Entrada em Comissionamento | — | todo |
dat_entradaoperacao |
dat_entradaoperacao |
texto | Data da Liberação para Entrada em Operação Comercial | — | todo |
dat_desativacao |
dat_desativacao |
texto | Data de Desativação da Unidade GeradoraO conteúdo NULL (ou vazio) representa que a unidade geradora está ativa. | — | todo |
val_potenciaefetiva |
val_potenciaefetiva |
decimal | Potência Nominal da Unidade Geradora, Conforme Documento Normativo da ANEEL, em MW | MW | todo |
Colunas do dicionário oficial que o arquivo não traz: id_ons.
No lake¶
- Dataset
ons/capacidade-geracao, 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. Para uma série, guarde as versões do bruto.
dat_desativacaonula significa unidade ativa (4.736 das 5.837 unidades em 2026-11).- O dicionário oficial lista
id_ons(identificador da usina), mas o arquivo do ONS não traz essa coluna. - Espaços nas pontas do texto. Há valores preenchidos com espaços em:
nom_subsistema(5.837 linhas);cod_equipamento(5.837 linhas);num_unidadegeradora(5.837 linhas). Apliquetrimantes de juntar ou agrupar.
Exemplos¶
Potência efetiva ativa por tipo de usina e subsistema, em MW.
import duckdb
duckdb.sql("""
SELECT nom_tipousina, id_subsistema, round(sum(val_potenciaefetiva), 0) AS mw
FROM read_parquet('lake/ons/capacidade-geracao/**/*.parquet', hive_partitioning = true, union_by_name = true)
WHERE dat_desativacao IS NULL
GROUP BY 1, 2
ORDER BY 3 DESC
LIMIT 10
""").show()
Referências¶
- Conjunto no portal de dados abertos do ONS: https://dados.ons.org.br/dataset/capacidade-geracao
- Dicionário de dados (PDF): https://ons-aws-prod-opendata.s3.amazonaws.com/dataset/capacidade-geracao/DicionarioDados_Capacidade_Instalada_Geracao.pdf
- Programa de dados abertos da AWS com o catálogo do ONS: https://registry.opendata.aws/ons-opendata-portal/