Skip to main content

sintetizador-newave

tests codecov PyPI Python docs license

Sobre

O sintetizador-newave é uma aplicação CLI para formatação e consolidação dos arquivos de saída do modelo NEWAVE, desenvolvido pelo CEPEL e utilizado no planejamento da operação do Sistema Interligado Nacional (SIN). A ferramenta lê os arquivos textuais e binários gerados pelo NEWAVE e os converte em tabelas normalizadas e estruturadas em DataFrames Polars, prontas para análise e integração com outros sistemas.

O modelo de dados adotado para as saídas sintetizadas é compatível com o ecossistema de ferramentas de síntese do planejamento energético brasileiro, facilitando a interoperabilidade entre casos de diferentes modelos. Internamente, a aplicação utiliza o módulo inewave para abstrair as regras de leitura dos arquivos proprietários do NEWAVE.

A ferramenta é destinada a engenheiros, pesquisadores e desenvolvedores que trabalham com análise de resultados de planejamento energético e necessitam de acesso programático eficiente às saídas do NEWAVE em formatos modernos e interoperáveis.

Funcionalidades

  • Síntese de dados de operação (NWLISTOP): variáveis como CMO, EARM, GTER, VAGUA e dezenas de outras por submercado, REE e UHE
  • Síntese de dados de cenários: afluências e outras variáveis estocásticas geradas pelo modelo
  • Síntese de dados de política (NWLISTCF): função de custo futuro e cortes de Benders
  • Síntese de dados de sistema: configuração de submercados, REEs, usinas e intercâmbios
  • Síntese de dados de execução: tempo de processamento, convergência e informações do caso
  • Saída em formato Parquet por padrão, com suporte opcional a CSV
  • Paralelização da leitura de arquivos via argumento --processadores
  • Seleção granular de variáveis individuais ou síntese completa com um único comando
  • Suporte a Python 3.11, 3.12, 3.13 e 3.14

Início Rápido

Instalação

pip install sintetizador-newave

Ou com uv:

uv pip install sintetizador-newave

Uso

Execute a síntese completa de um caso NEWAVE a partir do diretório onde estão os arquivos de saída:

$ sintetizador-newave completa

Para sintetizar apenas categorias específicas ou variáveis individuais:

$ sintetizador-newave operacao CMO_SBM EARMF_SIN GTER_SBM

Para paralelizar a leitura dos arquivos:

$ sintetizador-newave operacao --processadores 4

Saída esperada no terminal:

2024-04-22 09:53:56,845 INFO: # Realizando síntese da OPERACAO #
2024-04-22 09:53:56,868 INFO: Sinteses: [CMO_SBM, VAGUA_REE, VAGUA_UHE, ...]
2024-04-22 09:53:56,870 INFO: Realizando sintese de CMO_SBM
2024-04-22 09:53:58,734 INFO: Tempo para obter dados de SBM: 1.85 s
2024-04-22 09:53:58,753 INFO: Tempo para exportacao dos dados: 0.01 s
2024-04-22 09:53:58,754 INFO: Tempo para sintese de CMO_SBM: 1.88 s
...
2024-04-22 09:51:19,529 INFO: Tempo para sintese da operacao: 33.33 s
2024-04-22 09:51:19,529 INFO: # Fim da síntese #

Documentação

Guias, tutoriais e referências completas estão disponíveis no site oficial do pacote: https://rjmalves.github.io/sintetizador-newave

Licença

Este projeto está licenciado sob a licença MIT.

Metadata

Release files for sintetizador-newave 2.4.6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for sintetizador-newave 2.4.6
File Size Uploaded Provenance Actions
sintetizador_newave-2.4.6.tar.gz 6.3 MB With provenance Details for sintetizador_newave-2.4.6.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for sintetizador-newave 2.4.6
File Interpreter ABI Platform Actions
sintetizador_newave-2.4.6-py3-none-any.whl Python 3 none any Details for sintetizador_newave-2.4.6-py3-none-any.whl

Total release size: 6.5 MB

Release files / sintetizador_newave-2.4.6.tar.gz

Download URL sintetizador_newave-2.4.6.tar.gz
Size 6.3 MB
Tags Source
SHA-256 checksum
How to use checksums
67695f48bb54af54faa3ddbd602c6c9f634439a7115182b773def331fd4497af
BLAKE2b-256 checksum
How to use checksums
f1d99a2533bb0238569b8b009f4be0589db318abc3338637d14383727519e169
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Release files / sintetizador_newave-2.4.6-py3-none-any.whl

Download URL sintetizador_newave-2.4.6-py3-none-any.whl
Size 174.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ce0a253ca500441325ce20cdbac8791247de195309a44fa7b5a39cbda37b99ed
BLAKE2b-256 checksum
How to use checksums
0468e9e9f13862c4e3290816281b551260351926609e1695ae85b6ddf490ca10
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

Security for sintetizador-newave 2.4.6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for sintetizador_newave-2.4.6.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 14, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page