dados-abertos-setor-eletrico 0.1.2

Coleta e tratamento de dados públicos do setor elétrico brasileiro (ONS e ANEEL).

⚡ Dados Abertos do Setor Elétrico

Este projeto oferece uma interface simples em Python para acessar e baixar dados públicos do Setor Elétrico nos 3 principais órgãos: CCEE (Câmara de Comercialização de Energia Elétrica), ONS (Operador Nacional do Sistema) e ANEEL (Agência Nacional de Energia Elétrica).

Introdução

Através da classe dadosAbertosSetorEletrico, você pode listar produtos disponíveis e baixar os dados completos de forma paginada e organizada com pandas.

✅ Funcionalidades

• 🔍 Listagem de produtos disponíveis na API da CCEE
• ⬇️ Download completo e incremental dos datasets
• 📦 Conversão automática para pandas.DataFrame

⚙️ Pré-requisitos

Antes de começar, certifique-se de ter os seguintes softwares instalados:

• Python 3.8 ou superior → Download Python
• pip (gerenciador de pacotes do Python)
• Git → Download Git
• Editor de código (sugestão: Visual Studio Code)

📦 Instalação

Clone este repositório e instale as dependências:

# Clone o repositório
git clone https://github.com/seu-usuario/seu-repositorio.git
cd seu-repositorio

# (Opcional) Crie e ative um ambiente virtual
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate

# Instale as dependências
pip install -r requirements.txt

Exemplo de uso

from dados_ccee import dadosAbertosSetorEletrico

# Inicializa o cliente
cliente = dadosAbertosSetorEletrico("ccee")

# Lista os produtos disponíveis na API da CCEE
produtos = cliente.listar_produtos_disponiveis()
print(produtos)

# Baixa todos os dados do produto desejado como DataFrame
df = cliente.baixar_dados_produto_completo("parcela_carga_consumo")
print(df.head())

Observações Importantes

• Nem todos os datasets possuem dados acessíveis via API (datastore_search). Quando não disponíveis, o script mostra a URL para download manual.

• Alguns datasets podem conter muitos registros — a paginação automática com limit e offset evita estouro de memória.

• A classe trata de forma unificada três instituições distintas, facilitando reuso do código.

Contribuições

Contribuições são muito bem-vindas! Se você quiser sugerir melhorias, corrigir bugs ou adicionar novas funcionalidades, sinta-se à vontade para abrir uma issue ou pull request.

Fontes oficiais

• Portal de Dados Abertos da CCEE → Acessar Portal

• Portal de Dados Abertos da ONS → Acessar Portal

• Portal de Dados Abertos da ANEEL → Acessar Portal

• CKAN API Reference (oficial) → Acessar Documentação (Inglês)