sintetizador-newave
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)
| 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)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| 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 logRelease 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 logSecurity 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.
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 logA 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.