Fator de Capacidade de Geração Eólica e Solar¶
Resumo¶
Fator de capacidade de usinas e conjuntos eólicos e solares despachados pelo ONS, em base horária: a razão entre a geração e a capacidade instalada.
Ficha técnica¶
| Campo | Valor |
|---|---|
| Dataset | ons/fator-capacidade-2 |
| Órgão | Operador Nacional do Sistema Elétrico (ONS) |
| Página oficial | https://dados.ons.org.br/dataset/fator-capacidade-2 |
| Licença | Creative Commons Atribuição (CC BY), conforme o portal de dados abertos do ONS: https://dados.ons.org.br/dataset/fator-capacidade-2 |
| Periodicidade | diária (o ONS atualiza duas vezes ao dia) |
| Cobertura | 2009 a em-curso |
| Unidade (uma linha) | o fator de capacidade de uma usina ou conjunto eólico ou solar em uma hora |
| Granularidade | espacial: usina ou conjunto, com ponto de conexão e coordenadas; temporal: horária |
| Formato bruto | arquivos Parquet (ou CSV com ponto e vírgula, quando não há Parquet) no bucket público S3 do ONS, um por ano e, desde 2022, um por mês |
| Estado no lake | convertido |
| Partições | ano, mes |
| Chave | ano, mes, nom_usina_conjunto, id_ons, din_instante |
| Colunas | 22 |
| Unidades de medida | val_latitudesecoletora: graus; val_longitudesecoletora: graus; val_latitudepontoconexao: graus; val_longitudepontoconexao: graus; val_geracaoprogramada: MWmed; val_geracaoverificada: MWmed; val_capacidadeinstalada: MW; val_fatorcapacidade: razão geração/capacidade |
| 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
fator-capacidade-2, https://dados.ons.org.br/dataset/fator-capacidade-2). Os arquivos ficam no bucket público S3 do ONS, emdataset/fator_capacidade_2_di/. - O ONS publica um arquivo por ano (2000 a 2021) e por mês (desde 2022) com o prefixo
FATOR_CAPACIDADE-2(FATOR_CAPACIDADE-2_AAAA.parquet; mensais..._AAAA_MM), cada um também em CSV e em XLSX. Listagem do bucket em 2026-11-15: 72 arquivos Parquet e 72 CSV, de 2009 a 2026. - No bruto, o arquivo fica em
geracao/fator-capacidade-2_AAAA[_MM]@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.
- Conferência por amostra. Os arquivos deste conjunto são grandes; esta página foi conferida em 5 arquivos (de 72 Parquet publicados), escolhidos para cobrir os extremos e as quebras de formato.
Conteúdo¶
- Unidade de análise: o fator de capacidade de uma usina ou conjunto eólico ou solar em uma hora.
- 5 arquivos convertidos (amostra), de 2009 a 2026-10: 6.958 linhas no primeiro e 175.560 no último; 1.764.382 linhas no total. O arquivo do ano corrente cresce a cada atualização.
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 | Identificador do subsistema | — | todo |
nom_subsistema |
nom_subsistema |
texto | Nome do subsistema | — | todo |
id_estado |
id_estado |
texto | Sigla do Estado | — | todo |
nom_estado |
nom_estado |
texto | Nome do Estado | — | todo |
cod_pontoconexao |
cod_pontoconexao |
texto | Código do ponto de conexão da usina/conjunto | — | todo |
nom_pontoconexao |
nom_pontoconexao |
texto | Nome do ponto de conexão da usina/conjunto | — | todo |
nom_localizacao |
nom_localizacao |
texto | Localização da usina/conjunto O conteúdo está disponível apenas para Usinas da região Nordeste | — | todo |
val_latitudesecoletora |
val_latitudesecoletora |
decimal | Latitude da usina/conjunto | graus | todo |
val_longitudesecoletora |
val_longitudesecoletora |
decimal | Longitude da usina/conjunto | graus | todo |
val_latitudepontoconexao |
val_latitudepontoconexao |
decimal | Latitude do Ponto de Conexão | graus | todo |
val_longitudepontoconexao |
val_longitudepontoconexao |
decimal | Longitude do Ponto de Conexão | graus | todo |
nom_modalidadeoperacao |
nom_modalidadeoperacao |
texto | Modalidade de operação | — | todo |
nom_tipousina |
nom_tipousina |
texto | Tipo da usina | — | todo |
nom_usina_conjunto |
nom_usina_conjunto |
texto | Nome da usina/conjunto | — | todo |
id_ons |
id_ons |
texto | Identificador da usina ou conjunto no ONS | — | todo |
ceg |
ceg |
texto | Código Único do Empreendimento de Geração (CEG), estabelecido pela ANEEL | — | todo |
din_instante |
din_instante |
data e hora | Data | — | todo |
val_geracaoprogramada |
val_geracaoprogramada |
decimal | Geração Programada, em MWmed | MWmed | todo |
val_geracaoverificada |
val_geracaoverificada |
decimal | Geração Verificada, em MWmed | MWmed | todo |
val_capacidadeinstalada |
val_capacidadeinstalada |
decimal | Capacidade instalada, em MW | MW | todo |
val_fatorcapacidade |
val_fatorcapacidade |
decimal | Fator de capacidade, obtida pela relação entre a geração e a capacidade instalada | razão geração/capacidade | todo |
periodicidade |
— (gerada) | texto | Periodicidade do arquivo de origem: anual ou mensal |
anual, mensal |
todo |
ano |
— (partição) | inteiro | Ano do arquivo de origem | — | todo |
mes |
— (partição) | inteiro | Mês do arquivo de origem; 0 nos arquivos anuais | — | todo |
No lake¶
- Dataset
ons/fator-capacidade-2, particionado porano,mes; 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. - A partição vem do nome do arquivo (
FATOR_CAPACIDADE-2_AAAA;_AAAA_MMnos mensais, commes = 0nos anuais); se o arquivo não tiver a coluna, o conversor a acrescenta. - A coluna
periodicidade(anualoumensal) é acrescentada pelo conversor.
Cuidados de uso¶
- Cada arquivo é a série do período, com o ano corrente em atualização. O ONS reenvia o arquivo do ano (ou do mês) corrente e avisa que os dados passam por consistência; valores já publicados podem mudar. Reconverta depois de cada atualização antes de fechar um período.
- Granularidade mista: os arquivos anuais (de 2009 a 2021, com o prefixo
FATOR_CAPACIDADE) e os mensais (desde 2022,FATOR_CAPACIDADE-2) convivem emanoemes, commes = 0para os anuais e a colunaperiodicidade. val_geracaoprogramada,val_geracaoverificadaeval_capacidadeinstaladasão texto na origem em todos os arquivos (val_fatorcapacidadetambém, exceto no arquivo mais recente); o conversor os grava comodouble. Parte das linhas deval_geracaoprogramadavem com texto vazio no Parquet; o lake as grava como nulo, igual ao CSV de origem.- A coluna
nom_localizacaosó tem conteúdo para usinas da região Nordeste (descrição oficial).
Exemplos¶
Fator de capacidade médio das usinas solares e eólicas em 2026-10, por tipo.
import duckdb
duckdb.sql("""
SELECT nom_tipousina, round(avg(val_fatorcapacidade), 3) AS fator_medio
FROM read_parquet('lake/ons/fator-capacidade-2/**/*.parquet', hive_partitioning = true, union_by_name = true)
WHERE ano = 2026 AND mes = 10
GROUP BY 1
""").show()
Referências¶
- Conjunto no portal de dados abertos do ONS: https://dados.ons.org.br/dataset/fator-capacidade-2
- Dicionário de dados (PDF): https://ons-aws-prod-opendata.s3.amazonaws.com/dataset/fator_capacidade_2_di/DicionarioDados_FatorCapacidade.pdf
- Programa de dados abertos da AWS com o catálogo do ONS: https://registry.opendata.aws/ons-opendata-portal/